giget 1.0.0 → 1.1.1

package/README.md

@@ -36,7 +36,7 @@ npx giget@latest <template> [<dir>] [...options]
 
 ### Options
 
-- `--force`: Clone to exsiting directory even if exists.
+- `--force`: Clone to existing directory even if exists.
 - `--offline`: Do not attempt to download and use cached version.
 - `--prefer-offline`: Use cache if exists otherwise try to download.
 - `--force-clean`: ⚠️ Remove any existing directory or file recusively before cloning.
@@ -92,7 +92,7 @@ A custom registry should provide an endpoint with dynamic path `/:template.json`
 - `subdir`: (optional) Directory inside the tar file.
 - `headers`: (optional) Custom headers to send while downloading template.
 
-Because of the simplicity, you can even use a github repository as template registry but also you can build something more powerful by bringing your own API.
+Because of the simplicity, you can even use a GitHub repository as template registry but also you can build something more powerful by bringing your own API.
 
 ## Usage (Programmatic)
 
@@ -113,10 +113,10 @@ Import:
 
 ```js
 // ESM
-import { downloadTemplate } from 'giget'
+import { downloadTemplate } from "giget";
 
 // CommonJS
-const { downloadTemplate } = require('giget')
+const { downloadTemplate } = require("giget");
 ```
 
 ### `downloadTemplate(source, options?)`
@@ -124,14 +124,14 @@ const { downloadTemplate } = require('giget')
 **Example:**
 
 ```js
-const { source, dir } = await downloadTemplate('github:unjs/template')
+const { source, dir } = await downloadTemplate("github:unjs/template");
 ```
 
 **Options:**
 
 - `source`: (string) Input source in format of `[provider]:repo[/subpath][#ref]`.
-- `dir`: (string) Destination directory to clone to. If not provided, `user-name` will be used relative to the current directory.
 - `options`: (object) Options are usually inferred from the input string. You can customize them.
+  - `dir`: (string) Destination directory to clone to. If not provided, `user-name` will be used relative to the current directory.
   - `provider`: (string) Either `github`, `gitlab`, `bitbucket` or `sourcehut`. The default is `github`.
   - `repo`: (string) Name of repository in format of `{username}/{reponame}`.
   - `ref`: (string) Git ref (branch or commit or tag). The default value is `main`.
@@ -159,19 +159,21 @@ The return value is a promise that resolves to the resolved template.
 Using programmatic method, you can make your own custom template providers.
 
 ```ts
-import type { TemplateProvider } from 'giget'
+import type { TemplateProvider } from "giget";
 
 const rainbow: TemplateProvider = async (input, { auth }) => {
   return {
-    name: 'rainbow',
+    name: "rainbow",
     version: input,
-    headers: { Authorization: auth },
+    headers: { authorization: auth },
     url: `https://rainbow.template/?variant=${input}`,
-    tar: `https://rainbow.template/dl/rainbow.${input}.tar.gz`
-  }
-}
+    tar: `https://rainbow.template/dl/rainbow.${input}.tar.gz`,
+  };
+};
 
-const { source, dir } = await downloadRepo('rainbow:one', { providers: { rainbow } })
+const { source, dir } = await downloadRepo("rainbow:one", {
+  providers: { rainbow },
+});
 ```
 
 ### Custom Registry Providers
@@ -179,16 +181,20 @@ const { source, dir } = await downloadRepo('rainbow:one', { providers: { rainbow
 You can define additional [custom registry](#custom-registry) providers using `registryProvider` utility and register to `providers`.
 
 ```ts
-import { registryProvider } from 'giget'
+import { registryProvider } from "giget";
 
-const themes = registryProvider('https://raw.githubusercontent.com/unjs/giget/main/templates')
+const themes = registryProvider(
+  "https://raw.githubusercontent.com/unjs/giget/main/templates"
+);
 
-const { source, dir } = await downloadRepo('themes:test', { providers: { themes } })
+const { source, dir } = await downloadRepo("themes:test", {
+  providers: { themes },
+});
 ```
 
 ## Related projects
 
-Giget wouldn't be possible without inspering from former projects. In comparation giget does not depend on any local command which increases stability and performance, supports custom template providers, auth and many more features out of the box.
+Giget wouldn't be possible without inspiration from former projects. In comparison, giget does not depend on any local command which increases stability and performance, supports custom template providers, auth and many more features out of the box.
 
 - https://github.com/samsonjs/gitter
 - https://github.com/tiged/tiged

package/dist/cli.cjs

@@ -4,28 +4,38 @@
 const node_path = require('node:path');
 const mri = require('mri');
 const colorette = require('colorette');
-const giget = require('./shared/giget.1028e17a.cjs');
+const giget = require('./shared/giget.e7e76a83.cjs');
 require('node:fs/promises');
-require('node:os');
 require('node:fs');
 require('tar');
 require('pathe');
 require('defu');
 require('node:stream');
 require('node:child_process');
+require('node:os');
 require('node:util');
 require('node-fetch-native');
 require('https-proxy-agent');
 
 async function main() {
   const arguments_ = mri(process.argv.slice(2), {
-    boolean: ["help", "force", "force-clean", "offline", "prefer-offline", "shell", "verbose"],
+    boolean: [
+      "help",
+      "force",
+      "force-clean",
+      "offline",
+      "prefer-offline",
+      "shell",
+      "verbose"
+    ],
     string: ["registry", "cwd", "auth"]
   });
   const input = arguments_._[0];
   const dir = arguments_._[1];
   if (!input || arguments_.help || arguments_.h) {
-    console.error("Usage: npx getgit@latest <input> [<dir>] [--force] [--force-clean] [--offline] [--prefer-offline] [--shell] [--registry]  [--no-registry] [--verbose] [--cwd] [--auth]");
+    console.error(
+      "Usage: npx giget@latest <input> [<dir>] [--force] [--force-clean] [--offline] [--prefer-offline] [--shell] [--registry]  [--no-registry] [--verbose] [--cwd] [--auth]"
+    );
     process.exit(1);
   }
   if (arguments_.verbose) {
@@ -40,8 +50,12 @@ async function main() {
     cwd: arguments_.cwd,
     auth: arguments_.auth
   });
-  console.log(`\u2728 Successfully cloned ${colorette.cyan(r.name || r.url)} to ${colorette.cyan(node_path.relative(process.cwd(), r.dir))}
-`);
+  console.log(
+    `\u2728 Successfully cloned ${colorette.cyan(r.name || r.url)} to ${colorette.cyan(
+      node_path.relative(process.cwd(), r.dir)
+    )}
+`
+  );
   if (arguments_.shell) {
     giget.startShell(r.dir);
   }

package/dist/cli.d.ts

@@ -1 +1,2 @@
 
+export { }

package/dist/cli.mjs

@@ -2,28 +2,38 @@
 import { relative } from 'node:path';
 import mri from 'mri';
 import { cyan } from 'colorette';
-import { d as downloadTemplate, s as startShell } from './shared/giget.5e7ec864.mjs';
+import { d as downloadTemplate, s as startShell } from './shared/giget.c3d868f5.mjs';
 import 'node:fs/promises';
-import 'node:os';
 import 'node:fs';
 import 'tar';
 import 'pathe';
 import 'defu';
 import 'node:stream';
 import 'node:child_process';
+import 'node:os';
 import 'node:util';
 import 'node-fetch-native';
 import 'https-proxy-agent';
 
 async function main() {
   const arguments_ = mri(process.argv.slice(2), {
-    boolean: ["help", "force", "force-clean", "offline", "prefer-offline", "shell", "verbose"],
+    boolean: [
+      "help",
+      "force",
+      "force-clean",
+      "offline",
+      "prefer-offline",
+      "shell",
+      "verbose"
+    ],
     string: ["registry", "cwd", "auth"]
   });
   const input = arguments_._[0];
   const dir = arguments_._[1];
   if (!input || arguments_.help || arguments_.h) {
-    console.error("Usage: npx getgit@latest <input> [<dir>] [--force] [--force-clean] [--offline] [--prefer-offline] [--shell] [--registry]  [--no-registry] [--verbose] [--cwd] [--auth]");
+    console.error(
+      "Usage: npx giget@latest <input> [<dir>] [--force] [--force-clean] [--offline] [--prefer-offline] [--shell] [--registry]  [--no-registry] [--verbose] [--cwd] [--auth]"
+    );
     process.exit(1);
   }
   if (arguments_.verbose) {
@@ -38,8 +48,12 @@ async function main() {
     cwd: arguments_.cwd,
     auth: arguments_.auth
   });
-  console.log(`\u2728 Successfully cloned ${cyan(r.name || r.url)} to ${cyan(relative(process.cwd(), r.dir))}
-`);
+  console.log(
+    `\u2728 Successfully cloned ${cyan(r.name || r.url)} to ${cyan(
+      relative(process.cwd(), r.dir)
+    )}
+`
+  );
   if (arguments_.shell) {
     startShell(r.dir);
   }

package/dist/index.cjs

@@ -1,14 +1,14 @@
 'use strict';
 
-const giget = require('./shared/giget.1028e17a.cjs');
+const giget = require('./shared/giget.e7e76a83.cjs');
 require('node:fs/promises');
-require('node:os');
 require('node:fs');
 require('tar');
 require('pathe');
 require('defu');
 require('node:stream');
 require('node:child_process');
+require('node:os');
 require('node:util');
 require('node-fetch-native');
 require('https-proxy-agent');

package/dist/index.d.ts

@@ -16,7 +16,7 @@ interface TemplateInfo {
     dir?: never;
     [key: string]: any;
 }
-declare type TemplateProvider = (input: string, options: {
+type TemplateProvider = (input: string, options: {
     auth?: string;
 }) => TemplateInfo | Promise<TemplateInfo> | null;
 
@@ -32,13 +32,15 @@ interface DownloadTemplateOptions {
     cwd?: string;
     auth?: string;
 }
-declare type DownloadTemplateResult = Omit<TemplateInfo, "dir" | "source"> & {
+type DownloadTemplateResult = Omit<TemplateInfo, "dir" | "source"> & {
     dir: string;
     source: string;
 };
 declare function downloadTemplate(input: string, options?: DownloadTemplateOptions): Promise<DownloadTemplateResult>;
 
-declare const registryProvider: (registryEndpoint?: string) => TemplateProvider;
+declare const registryProvider: (registryEndpoint?: string, options?: {
+    auth?: string;
+}) => TemplateProvider;
 
 declare function startShell(cwd: string): void;
 

package/dist/index.mjs

@@ -1,12 +1,12 @@
-export { d as downloadTemplate, r as registryProvider, s as startShell } from './shared/giget.5e7ec864.mjs';
+export { d as downloadTemplate, r as registryProvider, s as startShell } from './shared/giget.c3d868f5.mjs';
 import 'node:fs/promises';
-import 'node:os';
 import 'node:fs';
 import 'tar';
 import 'pathe';
 import 'defu';
 import 'node:stream';
 import 'node:child_process';
+import 'node:os';
 import 'node:util';
 import 'node-fetch-native';
 import 'https-proxy-agent';

package/dist/shared/{giget.5e7ec864.mjs → giget.c3d868f5.mjs}

@@ -1,19 +1,24 @@
 import { readFile, writeFile, rm, mkdir } from 'node:fs/promises';
-import { homedir } from 'node:os';
 import { existsSync, createWriteStream, readdirSync } from 'node:fs';
 import { extract } from 'tar';
 import { resolve, relative, dirname } from 'pathe';
 import { defu } from 'defu';
 import { pipeline } from 'node:stream';
 import { spawnSync } from 'node:child_process';
+import { homedir } from 'node:os';
 import { promisify } from 'node:util';
 import { fetch } from 'node-fetch-native';
 import createHttpsProxyAgent from 'https-proxy-agent';
 
 async function download(url, filePath, options = {}) {
   const infoPath = filePath + ".json";
-  const info = JSON.parse(await readFile(infoPath, "utf8").catch(() => "{}"));
-  const headResponse = await sendFetch(url, { method: "HEAD", headers: options.headers }).catch(() => void 0);
+  const info = JSON.parse(
+    await readFile(infoPath, "utf8").catch(() => "{}")
+  );
+  const headResponse = await sendFetch(url, {
+    method: "HEAD",
+    headers: options.headers
+  }).catch(() => void 0);
   const etag = headResponse?.headers.get("etag");
   if (info.etag === etag && existsSync(filePath)) {
     return;
@@ -21,7 +26,9 @@ async function download(url, filePath, options = {}) {
   info.etag = etag;
   const response = await sendFetch(url, { headers: options.headers });
   if (response.status >= 400) {
-    throw new Error(`Failed to download ${url}: ${response.status} ${response.statusText}`);
+    throw new Error(
+      `Failed to download ${url}: ${response.status} ${response.statusText}`
+    );
   }
   const stream = createWriteStream(filePath);
   await promisify(pipeline)(response.body, stream);
@@ -41,10 +48,30 @@ function debug(...arguments_) {
     console.debug("[giget]", ...arguments_);
   }
 }
-async function sendFetch(url, options) {
-  const proxy = process.env.HTTPS_PROXY || process.env.https_proxy || process.env.HTTP_PROXY || process.env.http_proxy;
-  const requestOptions = proxy ? { agent: createHttpsProxyAgent(proxy), ...options } : options;
-  return await fetch(url, requestOptions);
+async function sendFetch(url, options = {}) {
+  if (!options.agent) {
+    const proxyEnv = process.env.HTTPS_PROXY || process.env.https_proxy || process.env.HTTP_PROXY || process.env.http_proxy;
+    if (proxyEnv) {
+      options.agent = createHttpsProxyAgent(proxyEnv);
+    }
+  }
+  if (options?.headers) {
+    options.headers = normalizeHeaders(options.headers);
+  }
+  return await fetch(url, options);
+}
+function cacheDirectory() {
+  return process.env.XDG_CACHE_HOME ? resolve(process.env.XDG_CACHE_HOME, "giget") : resolve(homedir(), ".cache/giget");
+}
+function normalizeHeaders(headers) {
+  const normalized = {};
+  for (const [key, value] of Object.entries(headers)) {
+    if (!value) {
+      continue;
+    }
+    normalized[key.toLowerCase()] = value;
+  }
+  return normalized;
 }
 function currentShell() {
   if (process.env.SHELL) {
@@ -58,7 +85,9 @@ function currentShell() {
 function startShell(cwd) {
   cwd = resolve(cwd);
   const shell = currentShell();
-  console.info(`(experimental) Opening shell in ${relative(process.cwd(), cwd)}...`);
+  console.info(
+    `(experimental) Opening shell in ${relative(process.cwd(), cwd)}...`
+  );
   spawnSync(shell, [], {
     cwd,
     shell: true,
@@ -68,24 +97,30 @@ function startShell(cwd) {
 
 const github = (input, options) => {
   const parsed = parseGitURI(input);
+  const github2 = process.env.GIGET_GITHUB_URL || "https://github.com";
   return {
     name: parsed.repo.replace("/", "-"),
     version: parsed.ref,
     subdir: parsed.subdir,
-    headers: { Authorization: options.auth ? `Bearer ${options.auth}` : void 0 },
-    url: `https://github.com/${parsed.repo}/tree/${parsed.ref}${parsed.subdir}`,
-    tar: `https://github.com/${parsed.repo}/archive/${parsed.ref}.tar.gz`
+    headers: {
+      authorization: options.auth ? `Bearer ${options.auth}` : void 0
+    },
+    url: `${github2}/${parsed.repo}/tree/${parsed.ref}${parsed.subdir}`,
+    tar: `${github2}/${parsed.repo}/archive/${parsed.ref}.tar.gz`
   };
 };
 const gitlab = (input, options) => {
   const parsed = parseGitURI(input);
+  const gitlab2 = process.env.GIGET_GITLAB_URL || "https://gitlab.com";
   return {
     name: parsed.repo.replace("/", "-"),
     version: parsed.ref,
     subdir: parsed.subdir,
-    headers: { Authorization: options.auth ? `Bearer ${options.auth}` : void 0 },
-    url: `https://gitlab.com/${parsed.repo}/tree/${parsed.ref}${parsed.subdir}`,
-    tar: `https://gitlab.com/${parsed.repo}/-/archive/${parsed.ref}.tar.gz`
+    headers: {
+      authorization: options.auth ? `Bearer ${options.auth}` : void 0
+    },
+    url: `${gitlab2}/${parsed.repo}/tree/${parsed.ref}${parsed.subdir}`,
+    tar: `${gitlab2}/${parsed.repo}/-/archive/${parsed.ref}.tar.gz`
   };
 };
 const bitbucket = (input, options) => {
@@ -94,7 +129,9 @@ const bitbucket = (input, options) => {
     name: parsed.repo.replace("/", "-"),
     version: parsed.ref,
     subdir: parsed.subdir,
-    headers: { Authorization: options.auth ? `Bearer ${options.auth}` : void 0 },
+    headers: {
+      authorization: options.auth ? `Bearer ${options.auth}` : void 0
+    },
     url: `https://bitbucket.com/${parsed.repo}/src/${parsed.ref}${parsed.subdir}`,
     tar: `https://bitbucket.org/${parsed.repo}/get/${parsed.ref}.tar.gz`
   };
@@ -105,7 +142,9 @@ const sourcehut = (input, options) => {
     name: parsed.repo.replace("/", "-"),
     version: parsed.ref,
     subdir: parsed.subdir,
-    headers: { Authorization: options.auth ? `Bearer ${options.auth}` : void 0 },
+    headers: {
+      authorization: options.auth ? `Bearer ${options.auth}` : void 0
+    },
     url: `https://git.sr.ht/~${parsed.repo}/tree/${parsed.ref}/item${parsed.subdir}`,
     tar: `https://git.sr.ht/~${parsed.repo}/archive/${parsed.ref}.tar.gz`
   };
@@ -119,30 +158,44 @@ const providers = {
 };
 
 const DEFAULT_REGISTRY = "https://raw.githubusercontent.com/unjs/giget/main/templates";
-const registryProvider = (registryEndpoint = DEFAULT_REGISTRY) => {
+const registryProvider = (registryEndpoint = DEFAULT_REGISTRY, options) => {
+  options = options || {};
   return async (input) => {
     const start = Date.now();
     const registryURL = `${registryEndpoint}/${input}.json`;
-    const result = await sendFetch(registryURL);
+    const result = await sendFetch(registryURL, {
+      headers: {
+        authorization: options.auth ? `Bearer ${options.auth}` : void 0
+      }
+    });
     if (result.status >= 400) {
-      throw new Error(`Failed to download ${input} template info from ${registryURL}: ${result.status} ${result.statusText}`);
+      throw new Error(
+        `Failed to download ${input} template info from ${registryURL}: ${result.status} ${result.statusText}`
+      );
     }
     const info = await result.json();
     if (!info.tar || !info.name) {
-      throw new Error(`Invalid template info from ${registryURL}. name or tar fields are missing!`);
+      throw new Error(
+        `Invalid template info from ${registryURL}. name or tar fields are missing!`
+      );
     }
-    debug(`Fetched ${input} template info from ${registryURL} in ${Date.now() - start}ms`);
+    debug(
+      `Fetched ${input} template info from ${registryURL} in ${Date.now() - start}ms`
+    );
     return info;
   };
 };
 
 const sourceProtoRe = /^([\w-.]+):/;
 async function downloadTemplate(input, options = {}) {
-  options = defu({
-    registry: process.env.GIGET_REGISTRY,
-    auth: process.env.GIGET_AUTH
-  }, options);
-  const registry = options.registry !== false ? registryProvider(options.registry) : void 0;
+  options = defu(
+    {
+      registry: process.env.GIGET_REGISTRY,
+      auth: process.env.GIGET_AUTH
+    },
+    options
+  );
+  const registry = options.registry !== false ? registryProvider(options.registry, { auth: options.auth }) : void 0;
   let providerName = options.provider || (registryProvider ? "registry" : "github");
   let source = input;
   const sourceProvierMatch = input.match(sourceProtoRe);
@@ -155,10 +208,15 @@ async function downloadTemplate(input, options = {}) {
     throw new Error(`Unsupported provider: ${providerName}`);
   }
   const template = await Promise.resolve().then(() => provider(source, { auth: options.auth })).catch((error) => {
-    throw new Error(`Failed to download template from ${providerName}: ${error.message}`);
+    throw new Error(
+      `Failed to download template from ${providerName}: ${error.message}`
+    );
   });
   template.name = (template.name || "template").replace(/[^\da-z-]/gi, "-");
-  template.defaultDir = (template.defaultDir || template.name).replace(/[^\da-z-]/gi, "-");
+  template.defaultDir = (template.defaultDir || template.name).replace(
+    /[^\da-z-]/gi,
+    "-"
+  );
   const cwd = resolve(options.cwd || ".");
   const extractPath = resolve(cwd, options.dir || template.defaultDir);
   if (options.forceClean) {
@@ -168,15 +226,27 @@ async function downloadTemplate(input, options = {}) {
     throw new Error(`Destination ${extractPath} already exists.`);
   }
   await mkdir(extractPath, { recursive: true });
-  const temporaryDirectory = resolve(homedir(), ".giget", options.provider, template.name);
-  const tarPath = resolve(temporaryDirectory, (template.version || template.name) + ".tar.gz");
+  const temporaryDirectory = resolve(
+    cacheDirectory(),
+    options.provider,
+    template.name
+  );
+  const tarPath = resolve(
+    temporaryDirectory,
+    (template.version || template.name) + ".tar.gz"
+  );
   if (options.preferOffline && existsSync(tarPath)) {
     options.offline = true;
   }
   if (!options.offline) {
     await mkdir(dirname(tarPath), { recursive: true });
     const s2 = Date.now();
-    await download(template.tar, tarPath, { headers: template.headers }).catch((error) => {
+    await download(template.tar, tarPath, {
+      headers: {
+        authorization: options.auth ? `Bearer ${options.auth}` : void 0,
+        ...normalizeHeaders(template.headers)
+      }
+    }).catch((error) => {
       if (!existsSync(tarPath)) {
         throw error;
       }
@@ -186,7 +256,9 @@ async function downloadTemplate(input, options = {}) {
     debug(`Downloaded ${template.tar} to ${tarPath} in ${Date.now() - s2}ms`);
   }
   if (!existsSync(tarPath)) {
-    throw new Error(`Tarball not found: ${tarPath} (offline: ${options.offline})`);
+    throw new Error(
+      `Tarball not found: ${tarPath} (offline: ${options.offline})`
+    );
   }
   const s = Date.now();
   const subdir = template.subdir?.replace(/^\//, "") || "";

package/dist/shared/{giget.1028e17a.cjs → giget.e7e76a83.cjs}

@@ -1,21 +1,26 @@
 'use strict';
 
 const promises = require('node:fs/promises');
-const node_os = require('node:os');
 const node_fs = require('node:fs');
 const tar = require('tar');
 const pathe = require('pathe');
 const defu = require('defu');
 const node_stream = require('node:stream');
 const node_child_process = require('node:child_process');
+const node_os = require('node:os');
 const node_util = require('node:util');
 const nodeFetchNative = require('node-fetch-native');
 const createHttpsProxyAgent = require('https-proxy-agent');
 
 async function download(url, filePath, options = {}) {
   const infoPath = filePath + ".json";
-  const info = JSON.parse(await promises.readFile(infoPath, "utf8").catch(() => "{}"));
-  const headResponse = await sendFetch(url, { method: "HEAD", headers: options.headers }).catch(() => void 0);
+  const info = JSON.parse(
+    await promises.readFile(infoPath, "utf8").catch(() => "{}")
+  );
+  const headResponse = await sendFetch(url, {
+    method: "HEAD",
+    headers: options.headers
+  }).catch(() => void 0);
   const etag = headResponse?.headers.get("etag");
   if (info.etag === etag && node_fs.existsSync(filePath)) {
     return;
@@ -23,7 +28,9 @@ async function download(url, filePath, options = {}) {
   info.etag = etag;
   const response = await sendFetch(url, { headers: options.headers });
   if (response.status >= 400) {
-    throw new Error(`Failed to download ${url}: ${response.status} ${response.statusText}`);
+    throw new Error(
+      `Failed to download ${url}: ${response.status} ${response.statusText}`
+    );
   }
   const stream = node_fs.createWriteStream(filePath);
   await node_util.promisify(node_stream.pipeline)(response.body, stream);
@@ -43,10 +50,30 @@ function debug(...arguments_) {
     console.debug("[giget]", ...arguments_);
   }
 }
-async function sendFetch(url, options) {
-  const proxy = process.env.HTTPS_PROXY || process.env.https_proxy || process.env.HTTP_PROXY || process.env.http_proxy;
-  const requestOptions = proxy ? { agent: createHttpsProxyAgent(proxy), ...options } : options;
-  return await nodeFetchNative.fetch(url, requestOptions);
+async function sendFetch(url, options = {}) {
+  if (!options.agent) {
+    const proxyEnv = process.env.HTTPS_PROXY || process.env.https_proxy || process.env.HTTP_PROXY || process.env.http_proxy;
+    if (proxyEnv) {
+      options.agent = createHttpsProxyAgent(proxyEnv);
+    }
+  }
+  if (options?.headers) {
+    options.headers = normalizeHeaders(options.headers);
+  }
+  return await nodeFetchNative.fetch(url, options);
+}
+function cacheDirectory() {
+  return process.env.XDG_CACHE_HOME ? pathe.resolve(process.env.XDG_CACHE_HOME, "giget") : pathe.resolve(node_os.homedir(), ".cache/giget");
+}
+function normalizeHeaders(headers) {
+  const normalized = {};
+  for (const [key, value] of Object.entries(headers)) {
+    if (!value) {
+      continue;
+    }
+    normalized[key.toLowerCase()] = value;
+  }
+  return normalized;
 }
 function currentShell() {
   if (process.env.SHELL) {
@@ -60,7 +87,9 @@ function currentShell() {
 function startShell(cwd) {
   cwd = pathe.resolve(cwd);
   const shell = currentShell();
-  console.info(`(experimental) Opening shell in ${pathe.relative(process.cwd(), cwd)}...`);
+  console.info(
+    `(experimental) Opening shell in ${pathe.relative(process.cwd(), cwd)}...`
+  );
   node_child_process.spawnSync(shell, [], {
     cwd,
     shell: true,
@@ -70,24 +99,30 @@ function startShell(cwd) {
 
 const github = (input, options) => {
   const parsed = parseGitURI(input);
+  const github2 = process.env.GIGET_GITHUB_URL || "https://github.com";
   return {
     name: parsed.repo.replace("/", "-"),
     version: parsed.ref,
     subdir: parsed.subdir,
-    headers: { Authorization: options.auth ? `Bearer ${options.auth}` : void 0 },
-    url: `https://github.com/${parsed.repo}/tree/${parsed.ref}${parsed.subdir}`,
-    tar: `https://github.com/${parsed.repo}/archive/${parsed.ref}.tar.gz`
+    headers: {
+      authorization: options.auth ? `Bearer ${options.auth}` : void 0
+    },
+    url: `${github2}/${parsed.repo}/tree/${parsed.ref}${parsed.subdir}`,
+    tar: `${github2}/${parsed.repo}/archive/${parsed.ref}.tar.gz`
   };
 };
 const gitlab = (input, options) => {
   const parsed = parseGitURI(input);
+  const gitlab2 = process.env.GIGET_GITLAB_URL || "https://gitlab.com";
   return {
     name: parsed.repo.replace("/", "-"),
     version: parsed.ref,
     subdir: parsed.subdir,
-    headers: { Authorization: options.auth ? `Bearer ${options.auth}` : void 0 },
-    url: `https://gitlab.com/${parsed.repo}/tree/${parsed.ref}${parsed.subdir}`,
-    tar: `https://gitlab.com/${parsed.repo}/-/archive/${parsed.ref}.tar.gz`
+    headers: {
+      authorization: options.auth ? `Bearer ${options.auth}` : void 0
+    },
+    url: `${gitlab2}/${parsed.repo}/tree/${parsed.ref}${parsed.subdir}`,
+    tar: `${gitlab2}/${parsed.repo}/-/archive/${parsed.ref}.tar.gz`
   };
 };
 const bitbucket = (input, options) => {
@@ -96,7 +131,9 @@ const bitbucket = (input, options) => {
     name: parsed.repo.replace("/", "-"),
     version: parsed.ref,
     subdir: parsed.subdir,
-    headers: { Authorization: options.auth ? `Bearer ${options.auth}` : void 0 },
+    headers: {
+      authorization: options.auth ? `Bearer ${options.auth}` : void 0
+    },
     url: `https://bitbucket.com/${parsed.repo}/src/${parsed.ref}${parsed.subdir}`,
     tar: `https://bitbucket.org/${parsed.repo}/get/${parsed.ref}.tar.gz`
   };
@@ -107,7 +144,9 @@ const sourcehut = (input, options) => {
     name: parsed.repo.replace("/", "-"),
     version: parsed.ref,
     subdir: parsed.subdir,
-    headers: { Authorization: options.auth ? `Bearer ${options.auth}` : void 0 },
+    headers: {
+      authorization: options.auth ? `Bearer ${options.auth}` : void 0
+    },
     url: `https://git.sr.ht/~${parsed.repo}/tree/${parsed.ref}/item${parsed.subdir}`,
     tar: `https://git.sr.ht/~${parsed.repo}/archive/${parsed.ref}.tar.gz`
   };
@@ -121,30 +160,44 @@ const providers = {
 };
 
 const DEFAULT_REGISTRY = "https://raw.githubusercontent.com/unjs/giget/main/templates";
-const registryProvider = (registryEndpoint = DEFAULT_REGISTRY) => {
+const registryProvider = (registryEndpoint = DEFAULT_REGISTRY, options) => {
+  options = options || {};
   return async (input) => {
     const start = Date.now();
     const registryURL = `${registryEndpoint}/${input}.json`;
-    const result = await sendFetch(registryURL);
+    const result = await sendFetch(registryURL, {
+      headers: {
+        authorization: options.auth ? `Bearer ${options.auth}` : void 0
+      }
+    });
     if (result.status >= 400) {
-      throw new Error(`Failed to download ${input} template info from ${registryURL}: ${result.status} ${result.statusText}`);
+      throw new Error(
+        `Failed to download ${input} template info from ${registryURL}: ${result.status} ${result.statusText}`
+      );
     }
     const info = await result.json();
     if (!info.tar || !info.name) {
-      throw new Error(`Invalid template info from ${registryURL}. name or tar fields are missing!`);
+      throw new Error(
+        `Invalid template info from ${registryURL}. name or tar fields are missing!`
+      );
     }
-    debug(`Fetched ${input} template info from ${registryURL} in ${Date.now() - start}ms`);
+    debug(
+      `Fetched ${input} template info from ${registryURL} in ${Date.now() - start}ms`
+    );
     return info;
   };
 };
 
 const sourceProtoRe = /^([\w-.]+):/;
 async function downloadTemplate(input, options = {}) {
-  options = defu.defu({
-    registry: process.env.GIGET_REGISTRY,
-    auth: process.env.GIGET_AUTH
-  }, options);
-  const registry = options.registry !== false ? registryProvider(options.registry) : void 0;
+  options = defu.defu(
+    {
+      registry: process.env.GIGET_REGISTRY,
+      auth: process.env.GIGET_AUTH
+    },
+    options
+  );
+  const registry = options.registry !== false ? registryProvider(options.registry, { auth: options.auth }) : void 0;
   let providerName = options.provider || (registryProvider ? "registry" : "github");
   let source = input;
   const sourceProvierMatch = input.match(sourceProtoRe);
@@ -157,10 +210,15 @@ async function downloadTemplate(input, options = {}) {
     throw new Error(`Unsupported provider: ${providerName}`);
   }
   const template = await Promise.resolve().then(() => provider(source, { auth: options.auth })).catch((error) => {
-    throw new Error(`Failed to download template from ${providerName}: ${error.message}`);
+    throw new Error(
+      `Failed to download template from ${providerName}: ${error.message}`
+    );
   });
   template.name = (template.name || "template").replace(/[^\da-z-]/gi, "-");
-  template.defaultDir = (template.defaultDir || template.name).replace(/[^\da-z-]/gi, "-");
+  template.defaultDir = (template.defaultDir || template.name).replace(
+    /[^\da-z-]/gi,
+    "-"
+  );
   const cwd = pathe.resolve(options.cwd || ".");
   const extractPath = pathe.resolve(cwd, options.dir || template.defaultDir);
   if (options.forceClean) {
@@ -170,15 +228,27 @@ async function downloadTemplate(input, options = {}) {
     throw new Error(`Destination ${extractPath} already exists.`);
   }
   await promises.mkdir(extractPath, { recursive: true });
-  const temporaryDirectory = pathe.resolve(node_os.homedir(), ".giget", options.provider, template.name);
-  const tarPath = pathe.resolve(temporaryDirectory, (template.version || template.name) + ".tar.gz");
+  const temporaryDirectory = pathe.resolve(
+    cacheDirectory(),
+    options.provider,
+    template.name
+  );
+  const tarPath = pathe.resolve(
+    temporaryDirectory,
+    (template.version || template.name) + ".tar.gz"
+  );
   if (options.preferOffline && node_fs.existsSync(tarPath)) {
     options.offline = true;
   }
   if (!options.offline) {
     await promises.mkdir(pathe.dirname(tarPath), { recursive: true });
     const s2 = Date.now();
-    await download(template.tar, tarPath, { headers: template.headers }).catch((error) => {
+    await download(template.tar, tarPath, {
+      headers: {
+        authorization: options.auth ? `Bearer ${options.auth}` : void 0,
+        ...normalizeHeaders(template.headers)
+      }
+    }).catch((error) => {
       if (!node_fs.existsSync(tarPath)) {
         throw error;
       }
@@ -188,7 +258,9 @@ async function downloadTemplate(input, options = {}) {
     debug(`Downloaded ${template.tar} to ${tarPath} in ${Date.now() - s2}ms`);
   }
   if (!node_fs.existsSync(tarPath)) {
-    throw new Error(`Tarball not found: ${tarPath} (offline: ${options.offline})`);
+    throw new Error(
+      `Tarball not found: ${tarPath} (offline: ${options.offline})`
+    );
   }
   const s = Date.now();
   const subdir = template.subdir?.replace(/^\//, "") || "";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "giget",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "Download templates and git repositories with pleasure!",
   "repository": "unjs/giget",
   "license": "MIT",
@@ -26,32 +26,34 @@
     "build": "unbuild",
     "dev": "vitest dev",
     "giget": "jiti ./src/cli.ts",
-    "lint": "eslint --ext .ts,.js,.mjs,.cjs .",
+    "lint": "eslint --ext .ts,.js,.mjs,.cjs . && prettier -c src test",
+    "lint:fix": "eslint --ext .ts,.js,.mjs,.cjs . --fix && prettier -w src test",
     "prepack": "unbuild",
     "play": "pnpm giget --force-clean --verbose unjs .tmp/clone",
-    "release": "pnpm test && standard-version && git push --follow-tags && pnpm publish",
+    "release": "pnpm test && changelogen --release && npm publish && git push --follow-tags",
     "test": "pnpm lint && vitest run --coverage"
   },
   "dependencies": {
     "colorette": "^2.0.19",
-    "defu": "^6.1.1",
+    "defu": "^6.1.2",
     "https-proxy-agent": "^5.0.1",
     "mri": "^1.2.0",
-    "node-fetch-native": "^1.0.1",
-    "pathe": "^1.0.0",
-    "tar": "^6.1.12"
+    "node-fetch-native": "^1.0.2",
+    "pathe": "^1.1.0",
+    "tar": "^6.1.13"
   },
   "devDependencies": {
-    "@types/node": "^18.11.9",
-    "@types/tar": "^6.1.3",
-    "@vitest/coverage-c8": "^0.25.2",
-    "eslint": "^8.27.0",
-    "eslint-config-unjs": "^0.0.2",
-    "jiti": "^1.16.0",
-    "standard-version": "^9.5.0",
-    "typescript": "^4.8.4",
-    "unbuild": "^0.9.4",
-    "vitest": "^0.25.2"
+    "@types/node": "^18.13.0",
+    "@types/tar": "^6.1.4",
+    "@vitest/coverage-c8": "^0.28.5",
+    "changelogen": "^0.4.1",
+    "eslint": "^8.34.0",
+    "eslint-config-unjs": "^0.1.0",
+    "jiti": "^1.17.1",
+    "prettier": "^2.8.4",
+    "typescript": "^4.9.5",
+    "unbuild": "^1.1.2",
+    "vitest": "^0.28.5"
   },
-  "packageManager": "pnpm@7.16.0"
+  "packageManager": "pnpm@7.27.0"
 }