@shopify/cli-kit 0.0.0-nightly-20230110194301

package/dist/file.js

@@ -0,0 +1,216 @@
+import { content as outputContent, token, debug } from './output.js';
+import { copy as fsCopy, ensureFile as fsEnsureFile, ensureFileSync as fsEnsureFileSync, remove as fsRemove, removeSync as fsRemoveSync, move as fsMove,
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-ignore
+ } from 'fs-extra/esm';
+import { temporaryDirectoryTask } from 'tempy';
+import { sep, join, extname } from 'pathe';
+import { mkdirSync as fsMkdirSync, readFileSync as fsReadFileSync, writeFileSync as fsWriteFileSync, appendFileSync as fsAppendFileSync, statSync as fsStatSync, createReadStream as fsCreateReadStream, constants as fsConstants, } from 'fs';
+import { mkdir as fsMkdir, writeFile as fsWriteFile, readFile as fsReadFile, realpath as fsRealPath, appendFile as fsAppendFile, mkdtemp as fsMkdtemp, stat as fsStat, lstat as fsLstat, chmod as fsChmod, access as fsAccess, } from 'fs/promises';
+const DEFAULT_PRETTIER_CONFIG = {
+    arrowParens: 'always',
+    singleQuote: true,
+    bracketSpacing: false,
+    trailingComma: 'all',
+};
+export function stripUp(path, strip) {
+    const parts = path.split(sep);
+    return join(...parts.slice(strip));
+}
+/**
+ * Creates a temporary directory and ties its lifecycle to the lifecycle of the callback.
+ * @param callback - The callback that receives the temporary directory.
+ */
+export async function inTemporaryDirectory(callback) {
+    return temporaryDirectoryTask(callback);
+}
+export async function read(path, options = { encoding: 'utf8' }) {
+    debug(outputContent `Reading the content of file at ${token.path(path)}...`);
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    return fsReadFile(path, options);
+}
+/**
+ * Given a path, it determines the actual path. This is useful when working
+ * with paths that represent symlinks.
+ * @param path - Path whose real path will be returned.
+ */
+export async function realpath(path) {
+    return fsRealPath(path);
+}
+export function readSync(path, options = { encoding: 'utf-8' }) {
+    debug(outputContent `Sync-reading the content of file at ${token.path(path)}...`);
+    const content = fsReadFileSync(path, options);
+    return content.toString();
+}
+/**
+ * Copies a file
+ * @param from - Path to the directory or file to be copied.
+ * @param to - Destination path.
+ */
+export async function copy(from, to) {
+    debug(outputContent `Copying file from ${token.path(from)} to ${token.path(to)}...`);
+    await fsCopy(from, to);
+}
+export async function touch(path) {
+    debug(outputContent `Creating an empty file at ${token.path(path)}...`);
+    await fsEnsureFile(path);
+}
+export async function appendFile(path, content) {
+    debug(outputContent `Appending the following content to ${token.path(path)}:
+    ${content
+        .split('\n')
+        .map((line) => `  ${line}`)
+        .join('\n')}
+  `);
+    await fsAppendFile(path, content);
+}
+export function touchSync(path) {
+    debug(outputContent `Creating an empty file at ${token.path(path)}...`);
+    fsEnsureFileSync(path);
+}
+export async function write(path, data) {
+    debug(outputContent `Writing some content to file at ${token.path(path)}...`);
+    await fsWriteFile(path, data, { encoding: 'utf8' });
+}
+export function writeSync(path, data) {
+    debug(outputContent `File-writing some content to file at ${token.path(path)}...`);
+    fsWriteFileSync(path, data);
+}
+export async function append(path, data) {
+    await fsAppendFile(path, data);
+}
+export function appendSync(path, data) {
+    fsAppendFileSync(path, data);
+}
+export async function mkdir(path) {
+    debug(outputContent `Creating directory at ${token.path(path)}...`);
+    await fsMkdir(path, { recursive: true });
+}
+export function mkdirSync(path) {
+    debug(outputContent `Sync-creating directory at ${token.path(path)}...`);
+    fsMkdirSync(path, { recursive: true });
+}
+export async function remove(path) {
+    debug(outputContent `Removing file at ${token.path(path)}...`);
+    await fsRemove(path);
+}
+export function removeSync(path) {
+    debug(outputContent `Sync-removing file at ${token.path(path)}...`);
+    fsRemoveSync(path);
+}
+export async function rmdir(path, { force } = {}) {
+    const { default: del } = await import('del');
+    debug(outputContent `Removing directory at ${token.path(path)}...`);
+    await del(path, { force });
+}
+export async function mkTmpDir() {
+    debug(outputContent `Creating a temporary directory...`);
+    const directory = await fsMkdtemp('tmp-');
+    return directory;
+}
+export async function isDirectory(path) {
+    debug(outputContent `Checking if ${token.path(path)} is a directory...`);
+    return (await fsLstat(path)).isDirectory();
+}
+export async function size(path) {
+    debug(outputContent `Getting the size of file file at ${token.path(path)}...`);
+    return (await fsStat(path)).size;
+}
+export function sizeSync(path) {
+    debug(outputContent `Sync-getting the size of file file at ${token.path(path)}...`);
+    return fsStatSync(path).size;
+}
+export function createReadStream(path) {
+    return fsCreateReadStream(path);
+}
+/**
+ * Returns the Date object for the last modification of a file.
+ * @param path - Path to the directory or file.
+ * @returns A unix timestamp.
+ */
+export async function lastUpdated(path) {
+    debug(outputContent `Getting last updated timestamp for file at ${token.path(path)}...`);
+    return (await fsStat(path)).ctime;
+}
+/**
+ * Returns the unix timestamp of the last modification of a file.
+ * @param path - Path to the directory or file.
+ * @returns A unix timestamp.
+ */
+export async function lastUpdatedTimestamp(path) {
+    try {
+        const lastUpdatedDateTime = await lastUpdated(path);
+        return lastUpdatedDateTime.getTime();
+        // eslint-disable-next-line no-catch-all/no-catch-all
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Moves a file.
+ * @param src - File to be moved.
+ * @param dest - Path to be moved to.
+ * @param options - Moving options.
+ */
+export async function move(src, dest, options = {}) {
+    await fsMove(src, dest, options);
+}
+/**
+ * Changes the permissions of a directory or file.
+ * @param path - Path to the file or directory whose permissions will be modified.
+ * @param mode - Permissions to set to the file or directory.
+ */
+export async function chmod(path, mode) {
+    await fsChmod(path, mode);
+}
+/**
+ * Checks if a file has executable permissions.
+ * @param path - Path to the file whose permissions will be checked.
+ */
+export async function hasExecutablePermissions(path) {
+    try {
+        await fsAccess(path, fsConstants.X_OK);
+        return true;
+        // eslint-disable-next-line no-catch-all/no-catch-all
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Returns true if a file or directory exists
+ * @param path - Path to the directory or file.
+ * @returns True if it exists.
+ */
+export async function exists(path) {
+    try {
+        await fsAccess(path);
+        return true;
+        // eslint-disable-next-line no-catch-all/no-catch-all
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Format a string using prettier. Return the formatted content.
+ */
+export async function format(content, options) {
+    const { default: prettier } = await import('prettier');
+    const ext = extname(options.path);
+    const prettierConfig = {
+        ...DEFAULT_PRETTIER_CONFIG,
+        parser: 'babel',
+    };
+    switch (ext) {
+        case '.html':
+        case '.css':
+            prettierConfig.parser = ext.slice(1);
+            break;
+    }
+    const formattedContent = await prettier.format(content, prettierConfig);
+    return formattedContent;
+}
+//# sourceMappingURL=file.js.map

package/dist/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../src/file.ts"],"names":[],"mappings":"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","sourcesContent":["import {content as outputContent, token, debug} from './output.js'\nimport {\n  copy as fsCopy,\n  ensureFile as fsEnsureFile,\n  ensureFileSync as fsEnsureFileSync,\n  remove as fsRemove,\n  removeSync as fsRemoveSync,\n  move as fsMove,\n  // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n  // @ts-ignore\n} from 'fs-extra/esm'\n\nimport {temporaryDirectoryTask} from 'tempy'\nimport {sep, join, extname} from 'pathe'\nimport {\n  mkdirSync as fsMkdirSync,\n  readFileSync as fsReadFileSync,\n  writeFileSync as fsWriteFileSync,\n  appendFileSync as fsAppendFileSync,\n  statSync as fsStatSync,\n  createReadStream as fsCreateReadStream,\n  constants as fsConstants,\n} from 'fs'\nimport {\n  mkdir as fsMkdir,\n  writeFile as fsWriteFile,\n  readFile as fsReadFile,\n  realpath as fsRealPath,\n  appendFile as fsAppendFile,\n  mkdtemp as fsMkdtemp,\n  stat as fsStat,\n  lstat as fsLstat,\n  chmod as fsChmod,\n  access as fsAccess,\n} from 'fs/promises'\nimport type {Options} from 'prettier'\n\nconst DEFAULT_PRETTIER_CONFIG: Options = {\n  arrowParens: 'always',\n  singleQuote: true,\n  bracketSpacing: false,\n  trailingComma: 'all',\n}\n\nexport function stripUp(path: string, strip: number) {\n  const parts = path.split(sep)\n  return join(...parts.slice(strip))\n}\n\n/**\n * Creates a temporary directory and ties its lifecycle to the lifecycle of the callback.\n * @param callback - The callback that receives the temporary directory.\n */\nexport async function inTemporaryDirectory<T>(callback: (tmpDir: string) => T | Promise<T>): Promise<T> {\n  return temporaryDirectoryTask(callback)\n}\n\n/**\n * It reads a file and returns its content as a string using the\n * utf-8 encoding\n * @param path - Path to the file to read.\n * @returns A promise that resolves with the content of the file.\n */\n\nexport type ReadOptions =\n  | undefined\n  | {flag?: string | undefined}\n  | {\n      encoding: BufferEncoding | string\n      flag?: string | undefined\n    }\nexport async function read(path: string, options?: ReadOptions): Promise<string>\nexport async function read(path: string, options?: ReadOptions): Promise<Buffer>\n\nexport async function read(path: string, options: ReadOptions = {encoding: 'utf8'}): Promise<string | Buffer> {\n  debug(outputContent`Reading the content of file at ${token.path(path)}...`)\n  // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n  // @ts-ignore\n  return fsReadFile(path, options)\n}\n\n/**\n * Given a path, it determines the actual path. This is useful when working\n * with paths that represent symlinks.\n * @param path - Path whose real path will be returned.\n */\nexport async function realpath(path: string): Promise<string> {\n  return fsRealPath(path)\n}\n\nexport function readSync(path: string, options: object = {encoding: 'utf-8'}): string {\n  debug(outputContent`Sync-reading the content of file at ${token.path(path)}...`)\n  const content = fsReadFileSync(path, options)\n  return content.toString()\n}\n\n/**\n * Copies a file\n * @param from - Path to the directory or file to be copied.\n * @param to - Destination path.\n */\nexport async function copy(from: string, to: string): Promise<void> {\n  debug(outputContent`Copying file from ${token.path(from)} to ${token.path(to)}...`)\n  await fsCopy(from, to)\n}\n\nexport async function touch(path: string): Promise<void> {\n  debug(outputContent`Creating an empty file at ${token.path(path)}...`)\n  await fsEnsureFile(path)\n}\n\nexport async function appendFile(path: string, content: string): Promise<void> {\n  debug(outputContent`Appending the following content to ${token.path(path)}:\n    ${content\n      .split('\\n')\n      .map((line) => `  ${line}`)\n      .join('\\n')}\n  `)\n  await fsAppendFile(path, content)\n}\n\nexport function touchSync(path: string) {\n  debug(outputContent`Creating an empty file at ${token.path(path)}...`)\n  fsEnsureFileSync(path)\n}\n\nexport async function write(path: string, data: string): Promise<void> {\n  debug(outputContent`Writing some content to file at ${token.path(path)}...`)\n  await fsWriteFile(path, data, {encoding: 'utf8'})\n}\n\nexport function writeSync(path: string, data: string): void {\n  debug(outputContent`File-writing some content to file at ${token.path(path)}...`)\n  fsWriteFileSync(path, data)\n}\n\nexport async function append(path: string, data: string): Promise<void> {\n  await fsAppendFile(path, data)\n}\n\nexport function appendSync(path: string, data: string): void {\n  fsAppendFileSync(path, data)\n}\n\nexport async function mkdir(path: string): Promise<void> {\n  debug(outputContent`Creating directory at ${token.path(path)}...`)\n  await fsMkdir(path, {recursive: true})\n}\n\nexport function mkdirSync(path: string): void {\n  debug(outputContent`Sync-creating directory at ${token.path(path)}...`)\n  fsMkdirSync(path, {recursive: true})\n}\n\nexport async function remove(path: string): Promise<void> {\n  debug(outputContent`Removing file at ${token.path(path)}...`)\n  await fsRemove(path)\n}\n\nexport function removeSync(path: string) {\n  debug(outputContent`Sync-removing file at ${token.path(path)}...`)\n  fsRemoveSync(path)\n}\n\nexport async function rmdir(path: string, {force}: {force?: boolean} = {}): Promise<void> {\n  const {default: del} = await import('del')\n  debug(outputContent`Removing directory at ${token.path(path)}...`)\n  await del(path, {force})\n}\n\nexport async function mkTmpDir(): Promise<string> {\n  debug(outputContent`Creating a temporary directory...`)\n  const directory = await fsMkdtemp('tmp-')\n  return directory\n}\n\nexport async function isDirectory(path: string): Promise<boolean> {\n  debug(outputContent`Checking if ${token.path(path)} is a directory...`)\n  return (await fsLstat(path)).isDirectory()\n}\n\nexport async function size(path: string): Promise<number> {\n  debug(outputContent`Getting the size of file file at ${token.path(path)}...`)\n  return (await fsStat(path)).size\n}\n\nexport function sizeSync(path: string): number {\n  debug(outputContent`Sync-getting the size of file file at ${token.path(path)}...`)\n  return fsStatSync(path).size\n}\n\nexport function createReadStream(path: string) {\n  return fsCreateReadStream(path)\n}\n\n/**\n * Returns the Date object for the last modification of a file.\n * @param path - Path to the directory or file.\n * @returns A unix timestamp.\n */\nexport async function lastUpdated(path: string): Promise<Date> {\n  debug(outputContent`Getting last updated timestamp for file at ${token.path(path)}...`)\n  return (await fsStat(path)).ctime\n}\n\n/**\n * Returns the unix timestamp of the last modification of a file.\n * @param path - Path to the directory or file.\n * @returns A unix timestamp.\n */\nexport async function lastUpdatedTimestamp(path: string): Promise<number | undefined> {\n  try {\n    const lastUpdatedDateTime = await lastUpdated(path)\n    return lastUpdatedDateTime.getTime()\n    // eslint-disable-next-line no-catch-all/no-catch-all\n  } catch {\n    return undefined\n  }\n}\n\n/**\n * Moves a file.\n * @param src - File to be moved.\n * @param dest - Path to be moved to.\n * @param options - Moving options.\n */\nexport async function move(src: string, dest: string, options: {overwrite?: boolean} = {}): Promise<void> {\n  await fsMove(src, dest, options)\n}\n\n/**\n * Changes the permissions of a directory or file.\n * @param path - Path to the file or directory whose permissions will be modified.\n * @param mode - Permissions to set to the file or directory.\n */\nexport async function chmod(path: string, mode: number | string): Promise<void> {\n  await fsChmod(path, mode)\n}\n\n/**\n * Checks if a file has executable permissions.\n * @param path - Path to the file whose permissions will be checked.\n */\nexport async function hasExecutablePermissions(path: string): Promise<boolean> {\n  try {\n    await fsAccess(path, fsConstants.X_OK)\n    return true\n    // eslint-disable-next-line no-catch-all/no-catch-all\n  } catch {\n    return false\n  }\n}\n\n/**\n * Returns true if a file or directory exists\n * @param path - Path to the directory or file.\n * @returns True if it exists.\n */\nexport async function exists(path: string): Promise<boolean> {\n  try {\n    await fsAccess(path)\n    return true\n    // eslint-disable-next-line no-catch-all/no-catch-all\n  } catch {\n    return false\n  }\n}\n\n/**\n * Format a string using prettier. Return the formatted content.\n */\nexport async function format(content: string, options: {path: string}) {\n  const {default: prettier} = await import('prettier')\n\n  const ext = extname(options.path)\n  const prettierConfig: Options = {\n    ...DEFAULT_PRETTIER_CONFIG,\n    parser: 'babel',\n  }\n\n  switch (ext) {\n    case '.html':\n    case '.css':\n      prettierConfig.parser = ext.slice(1)\n      break\n  }\n\n  const formattedContent = await prettier.format(content, prettierConfig)\n\n  return formattedContent\n}\n"]}

package/dist/git.d.ts

@@ -0,0 +1,36 @@
+import { Abort } from './error.js';
+import { DefaultLogFields, ListLogLine } from 'simple-git';
+export declare const factory: import("simple-git").SimpleGitFactory;
+export declare const GitNotPresentError: () => Abort;
+export declare const OutsideGitDirectoryError: (directory: string) => Abort;
+export declare const NoCommitError: () => Abort;
+export declare const DetachedHeadError: () => Abort;
+export declare function initializeRepository(directory: string, initialBranch?: string): Promise<void>;
+export interface GitIgnoreTemplate {
+    [section: string]: string[];
+}
+export declare function createGitIgnore(directory: string, template: GitIgnoreTemplate): void;
+export declare function downloadRepository({ repoUrl, destination, progressUpdater, shallow, latestTag, }: {
+    repoUrl: string;
+    destination: string;
+    progressUpdater?: (statusString: string) => void;
+    shallow?: boolean;
+    latestTag?: boolean;
+}): Promise<void>;
+export declare function getLatestCommit(directory?: string): Promise<DefaultLogFields & ListLogLine>;
+export declare function addAll(directory?: string): Promise<void>;
+export declare function commit(message: string, options?: {
+    directory?: string;
+    author?: string;
+}): Promise<string>;
+export declare function getHeadSymbolicRef(directory?: string): Promise<string>;
+/**
+ * If "git" is not present in the environment it throws
+ * an abort error.
+ */
+export declare function ensurePresentOrAbort(): Promise<void>;
+/**
+ * If command run from outside a .git directory tree
+ * it throws an abort error.
+ */
+export declare function ensureInsideGitDirectory(directory?: string): Promise<void>;

package/dist/git.js

@@ -0,0 +1,133 @@
+import { Abort } from './error.js';
+import { hasGit, isTerminalInteractive } from './environment/local.js';
+import { content, token, debug } from './output.js';
+import { appendSync } from './file.js';
+import git from 'simple-git';
+export const factory = git;
+export const GitNotPresentError = () => {
+    // eslint-disable-next-line rulesdir/no-error-factory-functions
+    return new Abort(`Git is necessary in the environment to continue`, content `Install ${token.link('git', 'https://git-scm.com/book/en/v2/Getting-Started-Installing-Git')}`);
+};
+export const OutsideGitDirectoryError = (directory) => {
+    // eslint-disable-next-line rulesdir/no-error-factory-functions
+    return new Abort(`${token.path(directory)} is not a Git directory`);
+};
+export const NoCommitError = () => {
+    // eslint-disable-next-line rulesdir/no-error-factory-functions
+    return new Abort('Must have at least one commit to run command', content `Run ${token.genericShellCommand("git commit -m 'Initial commit'")} to create your first commit.`);
+};
+export const DetachedHeadError = () => {
+    // eslint-disable-next-line rulesdir/no-error-factory-functions
+    return new Abort("Git HEAD can't be detached to run command", content `Run ${token.genericShellCommand('git checkout [branchName]')} to reattach HEAD or see git ${token.link('documentation', 'https://git-scm.com/book/en/v2/Git-Internals-Git-References')} for more details`);
+};
+export async function initializeRepository(directory, initialBranch = 'main') {
+    debug(content `Initializing git repository at ${token.path(directory)}...`);
+    await ensurePresentOrAbort();
+    // We use init and checkout instead of `init --initial-branch` because the latter is only supported in git 2.28+
+    const repo = git(directory);
+    await repo.init();
+    await repo.checkoutLocalBranch(initialBranch);
+}
+export function createGitIgnore(directory, template) {
+    debug(content `Creating .gitignore at ${token.path(directory)}...`);
+    const filePath = `${directory}/.gitignore`;
+    let fileContent = '';
+    for (const [section, lines] of Object.entries(template)) {
+        fileContent += `# ${section}\n`;
+        fileContent += `${lines.join('\n')}\n\n`;
+    }
+    appendSync(filePath, fileContent);
+}
+export async function downloadRepository({ repoUrl, destination, progressUpdater, shallow, latestTag, }) {
+    debug(content `Git-cloning repository ${repoUrl} into ${token.path(destination)}...`);
+    await ensurePresentOrAbort();
+    const [repository, branch] = repoUrl.split('#');
+    const options = { '--recurse-submodules': null };
+    if (branch && latestTag) {
+        throw new Abort("Error cloning the repository. Git can't clone the latest release with a 'branch'.");
+    }
+    if (branch) {
+        options['--branch'] = branch;
+    }
+    if (shallow && latestTag) {
+        throw new Abort("Error cloning the repository. Git can't clone the latest release with the 'shallow' property.");
+    }
+    if (shallow) {
+        options['--depth'] = 1;
+    }
+    const progress = ({ stage, progress, processed, total }) => {
+        const updateString = `${stage}, ${processed}/${total} objects (${progress}% complete)`;
+        if (progressUpdater)
+            progressUpdater(updateString);
+    };
+    const simpleGitOptions = {
+        progress,
+        ...(!isTerminalInteractive() && { config: ['core.askpass=true'] }),
+    };
+    try {
+        await git(simpleGitOptions).clone(repository, destination, options);
+        if (latestTag) {
+            const localGitRepository = git(destination);
+            const latestTag = await getLocalLatestTag(localGitRepository, repoUrl);
+            await localGitRepository.checkout(latestTag);
+        }
+    }
+    catch (err) {
+        if (err instanceof Error) {
+            const abortError = new Abort(err.message);
+            abortError.stack = err.stack;
+            throw abortError;
+        }
+        throw err;
+    }
+}
+async function getLocalLatestTag(repository, repoUrl) {
+    const latest = (await repository.tags()).latest;
+    if (!latest) {
+        throw new Abort(`Couldn't obtain the most recent tag of the repository ${repoUrl}`);
+    }
+    return latest;
+}
+export async function getLatestCommit(directory) {
+    const logs = await git({ baseDir: directory }).log({
+        maxCount: 1,
+    });
+    if (!logs.latest)
+        throw NoCommitError();
+    return logs.latest;
+}
+export async function addAll(directory) {
+    const simpleGit = git({ baseDir: directory });
+    await simpleGit.raw('add', '--all');
+}
+export async function commit(message, options) {
+    const simpleGit = git({ baseDir: options?.directory });
+    const commitOptions = options?.author ? { '--author': options.author } : undefined;
+    const result = await simpleGit.commit(message, commitOptions);
+    return result.commit;
+}
+export async function getHeadSymbolicRef(directory) {
+    const ref = await git({ baseDir: directory }).raw('symbolic-ref', '-q', 'HEAD');
+    if (!ref)
+        throw DetachedHeadError();
+    return ref.trim();
+}
+/**
+ * If "git" is not present in the environment it throws
+ * an abort error.
+ */
+export async function ensurePresentOrAbort() {
+    if (!(await hasGit())) {
+        throw GitNotPresentError();
+    }
+}
+/**
+ * If command run from outside a .git directory tree
+ * it throws an abort error.
+ */
+export async function ensureInsideGitDirectory(directory) {
+    if (!(await git({ baseDir: directory }).checkIsRepo())) {
+        throw OutsideGitDirectoryError(directory || process.cwd());
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"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","sourcesContent":["import {Abort} from './error.js'\nimport {hasGit, isTerminalInteractive} from './environment/local.js'\nimport {content, token, debug} from './output.js'\nimport {appendSync} from './file.js'\nimport git, {TaskOptions, SimpleGitProgressEvent, DefaultLogFields, ListLogLine, SimpleGit} from 'simple-git'\n\nexport const factory = git\n\nexport const GitNotPresentError = () => {\n  // eslint-disable-next-line rulesdir/no-error-factory-functions\n  return new Abort(\n    `Git is necessary in the environment to continue`,\n    content`Install ${token.link('git', 'https://git-scm.com/book/en/v2/Getting-Started-Installing-Git')}`,\n  )\n}\n\nexport const OutsideGitDirectoryError = (directory: string) => {\n  // eslint-disable-next-line rulesdir/no-error-factory-functions\n  return new Abort(`${token.path(directory)} is not a Git directory`)\n}\n\nexport const NoCommitError = () => {\n  // eslint-disable-next-line rulesdir/no-error-factory-functions\n  return new Abort(\n    'Must have at least one commit to run command',\n    content`Run ${token.genericShellCommand(\"git commit -m 'Initial commit'\")} to create your first commit.`,\n  )\n}\n\nexport const DetachedHeadError = () => {\n  // eslint-disable-next-line rulesdir/no-error-factory-functions\n  return new Abort(\n    \"Git HEAD can't be detached to run command\",\n    content`Run ${token.genericShellCommand('git checkout [branchName]')} to reattach HEAD or see git ${token.link(\n      'documentation',\n      'https://git-scm.com/book/en/v2/Git-Internals-Git-References',\n    )} for more details`,\n  )\n}\n\nexport async function initializeRepository(directory: string, initialBranch = 'main') {\n  debug(content`Initializing git repository at ${token.path(directory)}...`)\n  await ensurePresentOrAbort()\n  // We use init and checkout instead of `init --initial-branch` because the latter is only supported in git 2.28+\n  const repo = git(directory)\n  await repo.init()\n  await repo.checkoutLocalBranch(initialBranch)\n}\n\nexport interface GitIgnoreTemplate {\n  [section: string]: string[]\n}\nexport function createGitIgnore(directory: string, template: GitIgnoreTemplate): void {\n  debug(content`Creating .gitignore at ${token.path(directory)}...`)\n  const filePath = `${directory}/.gitignore`\n\n  let fileContent = ''\n  for (const [section, lines] of Object.entries(template)) {\n    fileContent += `# ${section}\\n`\n    fileContent += `${lines.join('\\n')}\\n\\n`\n  }\n\n  appendSync(filePath, fileContent)\n}\n\nexport async function downloadRepository({\n  repoUrl,\n  destination,\n  progressUpdater,\n  shallow,\n  latestTag,\n}: {\n  repoUrl: string\n  destination: string\n  progressUpdater?: (statusString: string) => void\n  shallow?: boolean\n  latestTag?: boolean\n}) {\n  debug(content`Git-cloning repository ${repoUrl} into ${token.path(destination)}...`)\n  await ensurePresentOrAbort()\n  const [repository, branch] = repoUrl.split('#')\n  const options: TaskOptions = {'--recurse-submodules': null}\n\n  if (branch && latestTag) {\n    throw new Abort(\"Error cloning the repository. Git can't clone the latest release with a 'branch'.\")\n  }\n  if (branch) {\n    options['--branch'] = branch\n  }\n\n  if (shallow && latestTag) {\n    throw new Abort(\"Error cloning the repository. Git can't clone the latest release with the 'shallow' property.\")\n  }\n  if (shallow) {\n    options['--depth'] = 1\n  }\n\n  const progress = ({stage, progress, processed, total}: SimpleGitProgressEvent) => {\n    const updateString = `${stage}, ${processed}/${total} objects (${progress}% complete)`\n    if (progressUpdater) progressUpdater(updateString)\n  }\n\n  const simpleGitOptions = {\n    progress,\n    ...(!isTerminalInteractive() && {config: ['core.askpass=true']}),\n  }\n  try {\n    await git(simpleGitOptions).clone(repository!, destination, options)\n\n    if (latestTag) {\n      const localGitRepository = git(destination)\n      const latestTag = await getLocalLatestTag(localGitRepository, repoUrl)\n      await localGitRepository.checkout(latestTag)\n    }\n  } catch (err) {\n    if (err instanceof Error) {\n      const abortError = new Abort(err.message)\n      abortError.stack = err.stack\n      throw abortError\n    }\n    throw err\n  }\n}\n\nasync function getLocalLatestTag(repository: SimpleGit, repoUrl: string) {\n  const latest = (await repository.tags()).latest\n\n  if (!latest) {\n    throw new Abort(`Couldn't obtain the most recent tag of the repository ${repoUrl}`)\n  }\n\n  return latest\n}\n\nexport async function getLatestCommit(directory?: string): Promise<DefaultLogFields & ListLogLine> {\n  const logs = await git({baseDir: directory}).log({\n    maxCount: 1,\n  })\n  if (!logs.latest) throw NoCommitError()\n  return logs.latest\n}\n\nexport async function addAll(directory?: string): Promise<void> {\n  const simpleGit = git({baseDir: directory})\n  await simpleGit.raw('add', '--all')\n}\n\nexport async function commit(message: string, options?: {directory?: string; author?: string}): Promise<string> {\n  const simpleGit = git({baseDir: options?.directory})\n\n  const commitOptions = options?.author ? {'--author': options.author} : undefined\n  const result = await simpleGit.commit(message, commitOptions)\n\n  return result.commit\n}\n\nexport async function getHeadSymbolicRef(directory?: string): Promise<string> {\n  const ref = await git({baseDir: directory}).raw('symbolic-ref', '-q', 'HEAD')\n  if (!ref) throw DetachedHeadError()\n  return ref.trim()\n}\n\n/**\n * If \"git\" is not present in the environment it throws\n * an abort error.\n */\nexport async function ensurePresentOrAbort() {\n  if (!(await hasGit())) {\n    throw GitNotPresentError()\n  }\n}\n\n/**\n * If command run from outside a .git directory tree\n * it throws an abort error.\n */\nexport async function ensureInsideGitDirectory(directory?: string) {\n  if (!(await git({baseDir: directory}).checkIsRepo())) {\n    throw OutsideGitDirectoryError(directory || process.cwd())\n  }\n}\n"]}

package/dist/http/fetch.d.ts

@@ -0,0 +1,22 @@
+import nodeFetch from 'node-fetch';
+import type { RequestInfo, RequestInit } from 'node-fetch';
+declare type Response = ReturnType<typeof nodeFetch>;
+/**
+ * An interface that abstracts way node-fetch. When Node has built-in
+ * support for "fetch" in the standard library, we can drop the node-fetch
+ * dependency from here.
+ * Note that we are exposing types from "node-fetch". The reason being is that
+ * they are consistent with the Web API so if we drop node-fetch in the future
+ * it won't require changes from the callers.
+ * @param url - This defines the resource that you wish to fetch.
+ * @param init - An object containing any custom settings that you want to apply to the request
+ * @returns A promise that resolves with the response.
+ */
+export default function fetch(url: RequestInfo, init?: RequestInit): Response;
+/**
+ * A fetch function to use with Shopify services. The function ensures the right
+ * TLS configuragion is used based on the environment in which the service is running
+ * (e.g. spin)
+ */
+export declare function shopifyFetch(url: RequestInfo, init?: RequestInit): Response;
+export {};

package/dist/http/fetch.js

@@ -0,0 +1,44 @@
+import { httpsAgent } from '../http.js';
+import { buildHeaders, sanitizedHeadersOutput } from '../api/common.js';
+import { content, debug } from '../output.js';
+import nodeFetch from 'node-fetch';
+import { performance } from 'perf_hooks';
+/**
+ * An interface that abstracts way node-fetch. When Node has built-in
+ * support for "fetch" in the standard library, we can drop the node-fetch
+ * dependency from here.
+ * Note that we are exposing types from "node-fetch". The reason being is that
+ * they are consistent with the Web API so if we drop node-fetch in the future
+ * it won't require changes from the callers.
+ * @param url - This defines the resource that you wish to fetch.
+ * @param init - An object containing any custom settings that you want to apply to the request
+ * @returns A promise that resolves with the response.
+ */
+export default async function fetch(url, init) {
+    const response = await nodeFetch(url, init);
+    return response;
+}
+/**
+ * A fetch function to use with Shopify services. The function ensures the right
+ * TLS configuragion is used based on the environment in which the service is running
+ * (e.g. spin)
+ */
+export async function shopifyFetch(url, init) {
+    const options = {
+        ...(init ?? {}),
+        headers: {
+            ...(await buildHeaders()),
+            ...(init?.headers ?? {}),
+        },
+    };
+    debug(content `
+Sending ${options.method ?? 'GET'} request to URL ${url.toString()} and headers:
+${sanitizedHeadersOutput((options?.headers ?? {}))}
+`);
+    const t0 = performance.now();
+    const response = await nodeFetch(url, { ...init, agent: await httpsAgent() });
+    const t1 = performance.now();
+    debug(`Request to ${url.toString()} completed with status ${response.status} in ${Math.round(t1 - t0)} ms`);
+    return response;
+}
+//# sourceMappingURL=fetch.js.map

package/dist/http/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../src/http/fetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,YAAY,CAAA;AACrC,OAAO,EAAC,YAAY,EAAE,sBAAsB,EAAC,MAAM,kBAAkB,CAAA;AACrE,OAAO,EAAC,OAAO,EAAE,KAAK,EAAC,MAAM,cAAc,CAAA;AAC3C,OAAO,SAAS,MAAM,YAAY,CAAA;AAClC,OAAO,EAAC,WAAW,EAAC,MAAM,YAAY,CAAA;AAItC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,KAAK,CAAC,GAAgB,EAAE,IAAkB;IACtE,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAC3C,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAgB,EAAE,IAAkB;IACrE,MAAM,OAAO,GAAgB;QAC3B,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;QACf,OAAO,EAAE;YACP,GAAG,CAAC,MAAM,YAAY,EAAE,CAAC;YACzB,GAAG,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC;SACzB;KACF,CAAA;IAED,KAAK,CAAC,OAAO,CAAA;UACL,OAAO,CAAC,MAAM,IAAI,KAAK,mBAAmB,GAAG,CAAC,QAAQ,EAAE;EAChE,sBAAsB,CAAC,CAAC,OAAO,EAAE,OAAO,IAAI,EAAE,CAA+B,CAAC;CAC/E,CAAC,CAAA;IACA,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;IAC5B,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,EAAC,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,UAAU,EAAE,EAAC,CAAC,CAAA;IAC3E,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;IAC5B,KAAK,CAAC,cAAc,GAAG,CAAC,QAAQ,EAAE,0BAA0B,QAAQ,CAAC,MAAM,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAA;IAC3G,OAAO,QAAQ,CAAA;AACjB,CAAC","sourcesContent":["import {httpsAgent} from '../http.js'\nimport {buildHeaders, sanitizedHeadersOutput} from '../api/common.js'\nimport {content, debug} from '../output.js'\nimport nodeFetch from 'node-fetch'\nimport {performance} from 'perf_hooks'\nimport type {RequestInfo, RequestInit} from 'node-fetch'\n\ntype Response = ReturnType<typeof nodeFetch>\n/**\n * An interface that abstracts way node-fetch. When Node has built-in\n * support for \"fetch\" in the standard library, we can drop the node-fetch\n * dependency from here.\n * Note that we are exposing types from \"node-fetch\". The reason being is that\n * they are consistent with the Web API so if we drop node-fetch in the future\n * it won't require changes from the callers.\n * @param url - This defines the resource that you wish to fetch.\n * @param init - An object containing any custom settings that you want to apply to the request\n * @returns A promise that resolves with the response.\n */\nexport default async function fetch(url: RequestInfo, init?: RequestInit): Response {\n  const response = await nodeFetch(url, init)\n  return response\n}\n\n/**\n * A fetch function to use with Shopify services. The function ensures the right\n * TLS configuragion is used based on the environment in which the service is running\n * (e.g. spin)\n */\nexport async function shopifyFetch(url: RequestInfo, init?: RequestInit): Response {\n  const options: RequestInit = {\n    ...(init ?? {}),\n    headers: {\n      ...(await buildHeaders()),\n      ...(init?.headers ?? {}),\n    },\n  }\n\n  debug(content`\nSending ${options.method ?? 'GET'} request to URL ${url.toString()} and headers:\n${sanitizedHeadersOutput((options?.headers ?? {}) as {[header: string]: string})}\n`)\n  const t0 = performance.now()\n  const response = await nodeFetch(url, {...init, agent: await httpsAgent()})\n  const t1 = performance.now()\n  debug(`Request to ${url.toString()} completed with status ${response.status} in ${Math.round(t1 - t0)} ms`)\n  return response\n}\n"]}

package/dist/http/formdata.d.ts

@@ -0,0 +1,3 @@
+import FormData from 'form-data';
+declare function formData(): FormData;
+export default formData;

package/dist/http/formdata.js

@@ -0,0 +1,6 @@
+import FormData from 'form-data';
+function formData() {
+    return new FormData();
+}
+export default formData;
+//# sourceMappingURL=formdata.js.map

package/dist/http/formdata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formdata.js","sourceRoot":"","sources":["../../src/http/formdata.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,WAAW,CAAA;AAEhC,SAAS,QAAQ;IACf,OAAO,IAAI,QAAQ,EAAE,CAAA;AACvB,CAAC;AAED,eAAe,QAAQ,CAAA","sourcesContent":["import FormData from 'form-data'\n\nfunction formData() {\n  return new FormData()\n}\n\nexport default formData\n"]}

package/dist/http/graphql.d.ts

@@ -0,0 +1,13 @@
+import { GraphQLClient } from 'graphql-request';
+interface GraphqlClientOptions {
+    url: string;
+    headers: {
+        [key: string]: string;
+    };
+}
+/**
+ * Creates a GraphQLClient instance with the right HTTPs agent baed on the service
+ * the client will interact with.
+ */
+export declare function graphqlClient(options: GraphqlClientOptions): Promise<GraphQLClient>;
+export {};

package/dist/http/graphql.js

@@ -0,0 +1,12 @@
+import { httpsAgent } from '../http.js';
+import { GraphQLClient } from 'graphql-request';
+/**
+ * Creates a GraphQLClient instance with the right HTTPs agent baed on the service
+ * the client will interact with.
+ */
+export async function graphqlClient(options) {
+    const clientOptions = { agent: await httpsAgent(), headers: options.headers };
+    const client = new GraphQLClient(options.url, clientOptions);
+    return client;
+}
+//# sourceMappingURL=graphql.js.map

package/dist/http/graphql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql.js","sourceRoot":"","sources":["../../src/http/graphql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,YAAY,CAAA;AACrC,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAA;AAO7C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAA6B;IAC/D,MAAM,aAAa,GAAG,EAAC,KAAK,EAAE,MAAM,UAAU,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAC,CAAA;IAC3E,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,aAAa,CAAC,CAAA;IAC5D,OAAO,MAAM,CAAA;AACf,CAAC","sourcesContent":["import {httpsAgent} from '../http.js'\nimport {GraphQLClient} from 'graphql-request'\n\ninterface GraphqlClientOptions {\n  url: string\n  headers: {[key: string]: string}\n}\n\n/**\n * Creates a GraphQLClient instance with the right HTTPs agent baed on the service\n * the client will interact with.\n */\nexport async function graphqlClient(options: GraphqlClientOptions) {\n  const clientOptions = {agent: await httpsAgent(), headers: options.headers}\n  const client = new GraphQLClient(options.url, clientOptions)\n  return client\n}\n"]}

package/dist/http.d.ts

@@ -0,0 +1,27 @@
+/// <reference types="node" />
+import https from 'https';
+export { default as fetch } from './http/fetch.js';
+export { graphqlClient } from './http/graphql.js';
+export { shopifyFetch } from './http/fetch.js';
+export { default as formData } from './http/formdata.js';
+export { createApp, createRouter, IncomingMessage, ServerResponse, CompatibilityEvent, createError, send, sendError, sendRedirect, H3Error, } from 'h3';
+/**
+ * This utility function returns the https.Agent to use for a given service. The agent
+ * includes the right configuration based on the service's environment. For example,
+ * if the service is running in a Spin environment, the attribute "rejectUnauthorized" is
+ * set to false
+ */
+export declare function httpsAgent(): Promise<https.Agent>;
+/**
+ * Spin stores the CA certificate in the keychain and it should be used when sending HTTP
+ * requests to Spin instances. However, Node doesn't read certificates from the Keychain
+ * by default, which leads to Shopifolks running into issues that they workaround by setting the
+ * NODE_TLS_REJECT_UNAUTHORIZED=0 environment variable, which applies to all the HTTP
+ * requests sent from the CLI (context: https://github.com/nodejs/node/issues/39657)
+ * This utility function allows controlling the behavior in a per-service level by returning
+ * the value of for the "rejectUnauthorized" attribute that's used in the https agent.
+ *
+ * @returns A promise that resolves with a boolean indicating whether
+ * unauthorized requests should be rejected or not.
+ */
+export declare function shouldRejectUnauthorizedRequests(): Promise<boolean>;

package/dist/http.js

@@ -0,0 +1,32 @@
+import { serviceEnvironment } from './environment/service.js';
+import https from 'https';
+export { default as fetch } from './http/fetch.js';
+export { graphqlClient } from './http/graphql.js';
+export { shopifyFetch } from './http/fetch.js';
+export { default as formData } from './http/formdata.js';
+export { createApp, createRouter, createError, send, sendError, sendRedirect, H3Error, } from 'h3';
+/**
+ * This utility function returns the https.Agent to use for a given service. The agent
+ * includes the right configuration based on the service's environment. For example,
+ * if the service is running in a Spin environment, the attribute "rejectUnauthorized" is
+ * set to false
+ */
+export async function httpsAgent() {
+    return new https.Agent({ rejectUnauthorized: await shouldRejectUnauthorizedRequests() });
+}
+/**
+ * Spin stores the CA certificate in the keychain and it should be used when sending HTTP
+ * requests to Spin instances. However, Node doesn't read certificates from the Keychain
+ * by default, which leads to Shopifolks running into issues that they workaround by setting the
+ * NODE_TLS_REJECT_UNAUTHORIZED=0 environment variable, which applies to all the HTTP
+ * requests sent from the CLI (context: https://github.com/nodejs/node/issues/39657)
+ * This utility function allows controlling the behavior in a per-service level by returning
+ * the value of for the "rejectUnauthorized" attribute that's used in the https agent.
+ *
+ * @returns A promise that resolves with a boolean indicating whether
+ * unauthorized requests should be rejected or not.
+ */
+export async function shouldRejectUnauthorizedRequests() {
+    return (await serviceEnvironment()) !== 'spin';
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kBAAkB,EAAC,MAAM,0BAA0B,CAAA;AAC3D,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAC,aAAa,EAAC,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAC,YAAY,EAAC,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAC,OAAO,IAAI,QAAQ,EAAC,MAAM,oBAAoB,CAAA;AAEtD,OAAO,EACL,SAAS,EACT,YAAY,EAIZ,WAAW,EACX,IAAI,EACJ,SAAS,EACT,YAAY,EACZ,OAAO,GACR,MAAM,IAAI,CAAA;AAEX;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,EAAC,kBAAkB,EAAE,MAAM,gCAAgC,EAAE,EAAC,CAAC,CAAA;AACxF,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,gCAAgC;IACpD,OAAO,CAAC,MAAM,kBAAkB,EAAE,CAAC,KAAK,MAAM,CAAA;AAChD,CAAC","sourcesContent":["import {serviceEnvironment} from './environment/service.js'\nimport https from 'https'\n\nexport {default as fetch} from './http/fetch.js'\nexport {graphqlClient} from './http/graphql.js'\nexport {shopifyFetch} from './http/fetch.js'\nexport {default as formData} from './http/formdata.js'\n\nexport {\n  createApp,\n  createRouter,\n  IncomingMessage,\n  ServerResponse,\n  CompatibilityEvent,\n  createError,\n  send,\n  sendError,\n  sendRedirect,\n  H3Error,\n} from 'h3'\n\n/**\n * This utility function returns the https.Agent to use for a given service. The agent\n * includes the right configuration based on the service's environment. For example,\n * if the service is running in a Spin environment, the attribute \"rejectUnauthorized\" is\n * set to false\n */\nexport async function httpsAgent() {\n  return new https.Agent({rejectUnauthorized: await shouldRejectUnauthorizedRequests()})\n}\n\n/**\n * Spin stores the CA certificate in the keychain and it should be used when sending HTTP\n * requests to Spin instances. However, Node doesn't read certificates from the Keychain\n * by default, which leads to Shopifolks running into issues that they workaround by setting the\n * NODE_TLS_REJECT_UNAUTHORIZED=0 environment variable, which applies to all the HTTP\n * requests sent from the CLI (context: https://github.com/nodejs/node/issues/39657)\n * This utility function allows controlling the behavior in a per-service level by returning\n * the value of for the \"rejectUnauthorized\" attribute that's used in the https agent.\n *\n * @returns A promise that resolves with a boolean indicating whether\n * unauthorized requests should be rejected or not.\n */\nexport async function shouldRejectUnauthorizedRequests(): Promise<boolean> {\n  return (await serviceEnvironment()) !== 'spin'\n}\n"]}