@vltpkg/git 1.0.0-rc.13 → 1.0.0-rc.14

package/dist/clone.d.ts

@@ -9,5 +9,5 @@ import type { GitOptions } from './index.ts';
  * as well.
  */
 export declare const shallowHosts: Set<string>;
-export declare const clone: (repo: string, ref?: string, target?: string | undefined, opts?: GitOptions) => Promise<string>;
+export declare const clone: (repo: string, ref?: string, target?: string, opts?: GitOptions) => Promise<string>;
 //# sourceMappingURL=clone.d.ts.map

package/dist/clone.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clone.d.ts","sourceRoot":"","sources":["../src/clone.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAM5C;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,aAMvB,CAAA;AAEF,eAAO,MAAM,KAAK,SACV,MAAM,yBAEJ,MAAM,GAAG,SAAS,SACpB,UAAU,oBAajB,CAAA"}
+{"version":3,"file":"clone.d.ts","sourceRoot":"","sources":["../src/clone.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAM5C;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,aAMvB,CAAA;AAEF,eAAO,MAAM,KAAK,SACV,MAAM,yBAEH,MAAM,SACT,UAAU,oBAajB,CAAA"}

package/dist/clone.js

@@ -27,7 +27,7 @@ export const shallowHosts = new Set([
     'bitbucket.com',
     'bitbucket.org',
 ]);
-export const clone = async (repo, ref = 'HEAD', target = undefined, opts = {}) => {
+export const clone = async (repo, ref = 'HEAD', target, opts = {}) => {
     repo = String(gitScpURL(repo) ?? repo).replace(/^git\+/, '');
     if (repo.startsWith('file://'))
         repo = fileURLToPath(repo);

package/dist/clone.js.map

@@ -1 +1 @@
-{"version":3,"file":"clone.js","sourceRoot":"","sources":["../src/clone.ts"],"names":[],"mappings":"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","sourcesContent":["// The goal here is to minimize both git workload and\n// the number of refs we download over the network.\n//\n// Every method ends up with the checked out working dir\n// at the specified ref, and resolves with the git sha.\n\nimport type { RevDoc, RevDocEntry } from '@vltpkg/types'\nimport { gitScpURL } from '@vltpkg/git-scp-url'\nimport { mkdir, stat } from 'node:fs/promises'\nimport { basename, resolve } from 'node:path'\nimport { fileURLToPath } from 'node:url'\nimport type { GitOptions } from './index.ts'\nimport { isWindows } from './is-windows.ts'\nimport { resolveRef } from './resolve.ts'\nimport { revs as getRevs } from './revs.ts'\nimport { spawn } from './spawn.ts'\n\n/**\n * Only these whitelisted hosts get shallow cloning. Many hosts (including GHE)\n * don't always support it. A failed shallow fetch takes a LOT longer than a\n * full fetch in most cases, so we skip it entirely. Set opts.gitShallow =\n * true/false to force this behavior one way or the other.\n *\n * If other hosts are added to this set, then they will be shallowly cloned\n * as well.\n */\nexport const shallowHosts = new Set([\n  'github.com',\n  'gist.github.com',\n  'gitlab.com',\n  'bitbucket.com',\n  'bitbucket.org',\n])\n\nexport const clone = async (\n  repo: string,\n  ref = 'HEAD',\n  target: string | undefined = undefined,\n  opts: GitOptions = {},\n) => {\n  repo = String(gitScpURL(repo) ?? repo).replace(/^git\\+/, '')\n  if (repo.startsWith('file://')) repo = fileURLToPath(repo)\n  const revs = await getRevs(repo, opts)\n  return await clone_(\n    repo,\n    revs,\n    ref,\n    revs && resolveRef(revs, ref, opts),\n    target || defaultTarget(repo, opts.cwd),\n    opts,\n  )\n}\n\nconst maybeShallow = (repo: string, opts: GitOptions) => {\n  if (opts['git-shallow'] === false || opts['git-shallow']) {\n    return opts['git-shallow']\n  }\n  const host = gitScpURL(repo)?.host ?? ''\n  return shallowHosts.has(host)\n}\n\nconst defaultTarget = (\n  repo: string,\n  /* c8 ignore next */ cwd = process.cwd(),\n) => resolve(cwd, basename(repo.replace(/[/\\\\]?\\.git$/, '')))\n\nconst clone_ = (\n  repo: string,\n  revs: RevDoc | undefined,\n  ref: string,\n  revDoc: RevDocEntry | undefined,\n  target: string,\n  opts: GitOptions,\n) => {\n  if (!revDoc || !revs) {\n    return unresolved(repo, ref, target, opts)\n  }\n  if (revDoc.sha === revs.refs.HEAD?.sha) {\n    return plain(repo, revDoc, target, opts)\n  }\n  if (revDoc.type === 'tag' || revDoc.type === 'branch') {\n    return branch(repo, revDoc, target, opts)\n  }\n  return other(repo, revDoc, target, opts)\n}\n\n// pull request or some other kind of advertised ref\nconst other = async (\n  repo: string,\n  revDoc: RevDocEntry,\n  target: string,\n  opts: GitOptions,\n) => {\n  const shallow = maybeShallow(repo, opts)\n\n  const fetchOrigin = ['fetch', 'origin', revDoc.rawRef].concat(\n    shallow ? ['--depth=1'] : [],\n  )\n\n  const git = (args: string[]) =>\n    spawn(args, { ...opts, cwd: target })\n  await mkdir(target, { recursive: true })\n  await git(['init'])\n  if (isWindows(opts)) {\n    await git([\n      'config',\n      '--local',\n      '--add',\n      'core.longpaths',\n      'true',\n    ])\n  }\n  await git(['remote', 'add', 'origin', repo])\n  await git(fetchOrigin)\n  await git(['checkout', revDoc.sha])\n  await updateSubmodules(target, opts)\n  return revDoc.sha\n}\n\n// tag or branches.  use -b\nconst branch = async (\n  repo: string,\n  revDoc: RevDocEntry,\n  target: string,\n  opts: GitOptions,\n) => {\n  const args = [\n    'clone',\n    '-b',\n    revDoc.ref,\n    repo,\n    target,\n    '--recurse-submodules',\n  ]\n  if (maybeShallow(repo, opts)) {\n    args.push('--depth=1')\n  }\n  if (isWindows(opts)) {\n    args.push('--config', 'core.longpaths=true')\n  }\n  await spawn(args, opts)\n  return revDoc.sha\n}\n\n// just the head.  clone it\nconst plain = async (\n  repo: string,\n  revDoc: RevDocEntry,\n  target: string,\n  opts: GitOptions,\n) => {\n  const args = ['clone', repo, target, '--recurse-submodules']\n  if (maybeShallow(repo, opts)) {\n    args.push('--depth=1')\n  }\n  if (isWindows(opts)) {\n    args.push('--config', 'core.longpaths=true')\n  }\n  await spawn(args, opts)\n  return revDoc.sha\n}\n\nconst updateSubmodules = async (target: string, opts: GitOptions) => {\n  const hasSubmodules = await stat(`${target}/.gitmodules`)\n    .then(() => true)\n    .catch(() => false)\n  if (!hasSubmodules) {\n    return\n  }\n  await spawn(\n    ['submodule', 'update', '-q', '--init', '--recursive'],\n    { ...opts, cwd: target },\n  )\n}\n\nconst unresolved = async (\n  repo: string,\n  ref: string,\n  target: string,\n  opts: GitOptions,\n) => {\n  // can't do this one shallowly, because the ref isn't advertised\n  // but we can avoid checking out the working dir twice, at least\n  const lp =\n    isWindows(opts) ? ['--config', 'core.longpaths=true'] : []\n  const cloneArgs = [\n    'clone',\n    '--mirror',\n    '-q',\n    repo,\n    target + '/.git',\n  ]\n  const git = (args: string[]) =>\n    spawn(args, { ...opts, cwd: target })\n  await mkdir(target, { recursive: true })\n  await git(cloneArgs.concat(lp))\n  await git(['init'])\n  await git(['checkout', ref])\n  await updateSubmodules(target, opts)\n  const result = await git(['rev-parse', '--revs-only', 'HEAD'])\n  return result.stdout\n}\n"]}
+{"version":3,"file":"clone.js","sourceRoot":"","sources":["../src/clone.ts"],"names":[],"mappings":"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","sourcesContent":["// The goal here is to minimize both git workload and\n// the number of refs we download over the network.\n//\n// Every method ends up with the checked out working dir\n// at the specified ref, and resolves with the git sha.\n\nimport type { RevDoc, RevDocEntry } from '@vltpkg/types'\nimport { gitScpURL } from '@vltpkg/git-scp-url'\nimport { mkdir, stat } from 'node:fs/promises'\nimport { basename, resolve } from 'node:path'\nimport { fileURLToPath } from 'node:url'\nimport type { GitOptions } from './index.ts'\nimport { isWindows } from './is-windows.ts'\nimport { resolveRef } from './resolve.ts'\nimport { revs as getRevs } from './revs.ts'\nimport { spawn } from './spawn.ts'\n\n/**\n * Only these whitelisted hosts get shallow cloning. Many hosts (including GHE)\n * don't always support it. A failed shallow fetch takes a LOT longer than a\n * full fetch in most cases, so we skip it entirely. Set opts.gitShallow =\n * true/false to force this behavior one way or the other.\n *\n * If other hosts are added to this set, then they will be shallowly cloned\n * as well.\n */\nexport const shallowHosts = new Set([\n  'github.com',\n  'gist.github.com',\n  'gitlab.com',\n  'bitbucket.com',\n  'bitbucket.org',\n])\n\nexport const clone = async (\n  repo: string,\n  ref = 'HEAD',\n  target?: string,\n  opts: GitOptions = {},\n) => {\n  repo = String(gitScpURL(repo) ?? repo).replace(/^git\\+/, '')\n  if (repo.startsWith('file://')) repo = fileURLToPath(repo)\n  const revs = await getRevs(repo, opts)\n  return await clone_(\n    repo,\n    revs,\n    ref,\n    revs && resolveRef(revs, ref, opts),\n    target || defaultTarget(repo, opts.cwd),\n    opts,\n  )\n}\n\nconst maybeShallow = (repo: string, opts: GitOptions) => {\n  if (opts['git-shallow'] === false || opts['git-shallow']) {\n    return opts['git-shallow']\n  }\n  const host = gitScpURL(repo)?.host ?? ''\n  return shallowHosts.has(host)\n}\n\nconst defaultTarget = (\n  repo: string,\n  /* c8 ignore next */ cwd = process.cwd(),\n) => resolve(cwd, basename(repo.replace(/[/\\\\]?\\.git$/, '')))\n\nconst clone_ = (\n  repo: string,\n  revs: RevDoc | undefined,\n  ref: string,\n  revDoc: RevDocEntry | undefined,\n  target: string,\n  opts: GitOptions,\n) => {\n  if (!revDoc || !revs) {\n    return unresolved(repo, ref, target, opts)\n  }\n  if (revDoc.sha === revs.refs.HEAD?.sha) {\n    return plain(repo, revDoc, target, opts)\n  }\n  if (revDoc.type === 'tag' || revDoc.type === 'branch') {\n    return branch(repo, revDoc, target, opts)\n  }\n  return other(repo, revDoc, target, opts)\n}\n\n// pull request or some other kind of advertised ref\nconst other = async (\n  repo: string,\n  revDoc: RevDocEntry,\n  target: string,\n  opts: GitOptions,\n) => {\n  const shallow = maybeShallow(repo, opts)\n\n  const fetchOrigin = ['fetch', 'origin', revDoc.rawRef].concat(\n    shallow ? ['--depth=1'] : [],\n  )\n\n  const git = (args: string[]) =>\n    spawn(args, { ...opts, cwd: target })\n  await mkdir(target, { recursive: true })\n  await git(['init'])\n  if (isWindows(opts)) {\n    await git([\n      'config',\n      '--local',\n      '--add',\n      'core.longpaths',\n      'true',\n    ])\n  }\n  await git(['remote', 'add', 'origin', repo])\n  await git(fetchOrigin)\n  await git(['checkout', revDoc.sha])\n  await updateSubmodules(target, opts)\n  return revDoc.sha\n}\n\n// tag or branches.  use -b\nconst branch = async (\n  repo: string,\n  revDoc: RevDocEntry,\n  target: string,\n  opts: GitOptions,\n) => {\n  const args = [\n    'clone',\n    '-b',\n    revDoc.ref,\n    repo,\n    target,\n    '--recurse-submodules',\n  ]\n  if (maybeShallow(repo, opts)) {\n    args.push('--depth=1')\n  }\n  if (isWindows(opts)) {\n    args.push('--config', 'core.longpaths=true')\n  }\n  await spawn(args, opts)\n  return revDoc.sha\n}\n\n// just the head.  clone it\nconst plain = async (\n  repo: string,\n  revDoc: RevDocEntry,\n  target: string,\n  opts: GitOptions,\n) => {\n  const args = ['clone', repo, target, '--recurse-submodules']\n  if (maybeShallow(repo, opts)) {\n    args.push('--depth=1')\n  }\n  if (isWindows(opts)) {\n    args.push('--config', 'core.longpaths=true')\n  }\n  await spawn(args, opts)\n  return revDoc.sha\n}\n\nconst updateSubmodules = async (target: string, opts: GitOptions) => {\n  const hasSubmodules = await stat(`${target}/.gitmodules`)\n    .then(() => true)\n    .catch(() => false)\n  if (!hasSubmodules) {\n    return\n  }\n  await spawn(\n    ['submodule', 'update', '-q', '--init', '--recursive'],\n    { ...opts, cwd: target },\n  )\n}\n\nconst unresolved = async (\n  repo: string,\n  ref: string,\n  target: string,\n  opts: GitOptions,\n) => {\n  // can't do this one shallowly, because the ref isn't advertised\n  // but we can avoid checking out the working dir twice, at least\n  const lp =\n    isWindows(opts) ? ['--config', 'core.longpaths=true'] : []\n  const cloneArgs = [\n    'clone',\n    '--mirror',\n    '-q',\n    repo,\n    target + '/.git',\n  ]\n  const git = (args: string[]) =>\n    spawn(args, { ...opts, cwd: target })\n  await mkdir(target, { recursive: true })\n  await git(cloneArgs.concat(lp))\n  await git(['init'])\n  await git(['checkout', ref])\n  await updateSubmodules(target, opts)\n  const result = await git(['rev-parse', '--revs-only', 'HEAD'])\n  return result.stdout\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vltpkg/git",
   "description": "a util for spawning git from npm CLI contexts",
-  "version": "1.0.0-rc.13",
+  "version": "1.0.0-rc.14",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/vltpkg/vltpkg.git",
@@ -13,13 +13,13 @@
     "lru-cache": "^11.2.4",
     "promise-retry": "^2.0.1",
     "retry": "^0.13.1",
-    "@vltpkg/pick-manifest": "1.0.0-rc.13",
-    "@vltpkg/error-cause": "1.0.0-rc.13",
-    "@vltpkg/git-scp-url": "1.0.0-rc.13",
-    "@vltpkg/promise-spawn": "1.0.0-rc.13",
-    "@vltpkg/semver": "1.0.0-rc.13",
-    "@vltpkg/spec": "1.0.0-rc.13",
-    "@vltpkg/which": "1.0.0-rc.13"
+    "@vltpkg/error-cause": "1.0.0-rc.14",
+    "@vltpkg/pick-manifest": "1.0.0-rc.14",
+    "@vltpkg/git-scp-url": "1.0.0-rc.14",
+    "@vltpkg/promise-spawn": "1.0.0-rc.14",
+    "@vltpkg/which": "1.0.0-rc.14",
+    "@vltpkg/semver": "1.0.0-rc.14",
+    "@vltpkg/spec": "1.0.0-rc.14"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.1",
@@ -31,7 +31,7 @@
     "typedoc": "~0.27.9",
     "typescript": "5.7.3",
     "typescript-eslint": "^8.49.0",
-    "@vltpkg/types": "1.0.0-rc.13"
+    "@vltpkg/types": "1.0.0-rc.14"
   },
   "license": "ISC",
   "engines": {