create-gasket-app 7.4.12 → 7.4.14

package/EXAMPLES.md

@@ -0,0 +1,48 @@
+# Create Gasket App Examples
+
+This document provides working examples for interfaces and utilities from the `create-gasket-app` package.
+
+## Primary Usage (CLI)
+
+The main interface for `create-gasket-app` is the command line:
+
+```bash
+# Basic app creation
+npx create-gasket-app@latest my-app
+
+# With presets
+npx create-gasket-app@latest my-app --presets @gasket/preset-nextjs
+
+# With package manager selection
+npx create-gasket-app@latest my-app --package-manager pnpm
+
+# With configuration
+npx create-gasket-app@latest my-app --config '{"typescript": true}'
+
+# With config file
+npx create-gasket-app@latest my-app --config-file ./create-config.json
+
+# Skip prompts (for CI)
+npx create-gasket-app@latest my-app --presets @gasket/preset-nextjs --no-prompts
+```
+
+## Templates
+
+Templates provide complete Gasket applications ready to use:
+
+```bash
+# Use an npm template package
+npx create-gasket-app@latest my-app --template @gasket/template-nextjs-pages-js
+
+# Use a versioned template
+npx create-gasket-app@latest my-app --template @gasket/template-api@^2.0.0
+
+# Use a tagged template
+npx create-gasket-app@latest my-app --template @gasket/template-nextjs@beta
+
+# Use a local template during development
+npx create-gasket-app@latest my-app --template-path ./my-gasket-template
+
+# Use local template with absolute path
+npx create-gasket-app@latest my-app --template-path /path/to/my-template
+```

package/README.md

@@ -43,6 +43,10 @@ Options:
   -p, --presets [presets]              Initial Gasket preset(s) to use.
         Can be set as short name with version (e.g. --presets nextjs@^1.0.0)
         Or other (multiple) custom presets (e.g. --presets my-gasket-preset@1.0.0.beta-1,nextjs@^1.0.0)
+  --template [template]                Selects which template you would like to use during
+        installation. (e.g. --template @gasket/template-nextjs-pages-js)
+  --template-path [template-path]      (INTERNAL) Path to a local template package. Can be absolute
+        or relative to the current working directory.
   --package-manager [package-manager]  Selects which package manager you would like to use during
         installation. (e.g. --package-manager yarn)
   -r, --require [require]              Require module(s) before Gasket is initialized
@@ -51,6 +55,48 @@ Options:
   -h, --help                           display help for command
 ```
 
+#### Templates
+
+Templates provide a complete Gasket application ready to use, unlike presets which build apps through a plugin-based creation process.
+
+##### Using Templates
+
+```bash
+# Use an official template from npm
+npx create-gasket-app@latest my-app --template @gasket/template-nextjs-pages-js
+
+# Use a versioned template
+npx create-gasket-app@latest my-app --template @gasket/template-api@^2.0.0
+
+# Use a local template (development)
+npx create-gasket-app@latest my-app --template-path ./path/to/my-template
+
+# Use a template with tag
+npx create-gasket-app@latest my-app --template @gasket/template-nextjs-pages-js@beta
+```
+
+##### Template Structure
+
+Templates are npm packages that follow this structure:
+
+```
+@gasket/template-example/
+├── package.json
+├── template/
+│   ├── package.json      # App's package.json
+│   ├── gasket.js         # App's gasket config
+│   ├── src/              # App source files
+│   └── ...               # Other app files
+└── README.md
+```
+
+When using templates:
+- The entire `template/` directory is copied to your new app
+- Template dependencies are installed with `npm ci`  
+- No preset processing or plugin creation flows are run
+
+**Note:** Templates currently require npm as they come with `package-lock.json` files.
+
 #### Package Managers
 
 With `create-gasket-app`, you can choose either [npm] or [yarn] as the package

package/lib/commands/create.js

@@ -6,6 +6,10 @@ import { rm } from 'fs/promises';
 import { makeGasket } from '@gasket/core';
 import globalPrompts from '../scaffold/actions/global-prompts.js';
 import loadPreset from '../scaffold/actions/load-preset.js';
+import loadTemplate from '../scaffold/actions/load-template.js';
+import copyTemplate from '../scaffold/actions/copy-template.js';
+import customizeTemplate from '../scaffold/actions/customize-template.js';
+import installTemplateDep from '../scaffold/actions/install-template-deps.js';
 import presetPromptHooks from '../scaffold/actions/preset-prompt-hooks.js';
 import presetConfigHooks from '../scaffold/actions/preset-config-hooks.js';
 import promptHooks from '../scaffold/actions/prompt-hooks.js';
@@ -19,6 +23,7 @@ import installModules from '../scaffold/actions/install-modules.js';
 import linkModules from '../scaffold/actions/link-modules.js';
 import postCreateHooks from '../scaffold/actions/post-create-hooks.js';
 import printReport from '../scaffold/actions/print-report.js';
+import gitInit from '../scaffold/actions/git-init.js';
 
 /**
  * Parses comma separated option input to array
@@ -45,6 +50,17 @@ const createCommand = {
       Or other (multiple) custom presets (e.g. --presets my-gasket-preset@1.0.0.beta-1,nextjs@^1.0.0)`,
       parse: commasToArray
     },
+    {
+      name: 'template',
+      description: `Selects which template you would like to use during
+      installation. (e.g. --template @gasket/template-nextjs-pages-js)`
+    },
+    {
+      name: 'template-path',
+      description: `(INTERNAL) Path to a local template package. Can be absolute
+      or relative to the current working directory.`,
+      hidden: true
+    },
     {
       name: 'package-manager',
       description: `Selects which package manager you would like to use during
@@ -90,6 +106,87 @@ const createCommand = {
   ]
 };
 
+/**
+ * validateOption - We require at least one of the options to be provided
+ * @param {import('../internal.js').PartialCreateContext} context
+ * @returns {import('../internal.js').PartialCreateContext}
+ */
+function validateOptions(context) {
+  const hasOption = (context) => Boolean(context.template || context.templatePath || context.rawPresets.length || context.localPresets.length);
+
+  if (!hasOption(context)) {
+    console.warn('Warning: At least one of the options is required: --template, --template-path, --presets, --preset-path');
+    process.exit(1);
+  }
+
+  return context;
+}
+
+/**
+ * handleTemplate - Handles the template creation
+ * @param {import('../internal.js').PartialCreateContext} context
+ * @returns {Promise<void>}
+ */
+async function handleTemplate(context) {
+  await mkDir({ context });
+  await loadTemplate({ context });
+  await copyTemplate({ context });
+  await customizeTemplate({ context });
+  await installTemplateDep({ context });
+  await gitInit({ context });
+  printReport({ context });
+  return;
+}
+
+/**
+ * handlePresets - Handles the preset creation
+ * @param {import('../internal.js').PartialCreateContext} context
+ * @returns {Promise<void>}
+ */
+async function handlePresets(context) {
+  await loadPreset({ context });
+  await globalPrompts({ context });
+
+  const presetGasket = makeGasket({
+    plugins: context.presets
+  });
+
+  await presetPromptHooks({ gasket: presetGasket, context });
+  await presetConfigHooks({ gasket: presetGasket, context });
+
+  const pluginGasket = makeGasket({
+    ...context.presetConfig,
+    plugins: context.presetConfig.plugins.concat(context.presets)
+  });
+
+  await promptHooks({ gasket: pluginGasket, context });
+  await mkDir({ context });
+  await setupPkg({ context });
+  await createHooks({ gasket: pluginGasket, context });
+  await writePkg({ context });
+  await generateFiles({ context });
+  await writeGasketConfig({ context });
+  await installModules({ context });
+  await linkModules({ context });
+  await postCreateHooks({ gasket: pluginGasket, context });
+  if (context.tmpDir) await rm(context.tmpDir, { recursive: true });
+  printReport({ context });
+}
+
+/**
+ * handleCreate - Handles the create creation
+ * @param {import('../internal.js').PartialCreateContext} context
+ * @returns {Promise<void>}
+ */
+async function handleCreate(context) {
+  const { template, templatePath } = context;
+  if (template || templatePath) {
+    await handleTemplate(context);
+  } else {
+    await handlePresets(context);
+  }
+}
+
 /**
  * createCommand action
  * @type {import('../index.js').createCommandAction}
@@ -98,39 +195,10 @@ createCommand.action = async function run(appname, options, command) {
   // eslint-disable-next-line no-process-env
   process.env.GASKET_ENV = 'create';
   const context = makeCreateContext([appname], options);
-  const { rawPresets, localPresets } = context;
+  validateOptions(context);
 
   try {
-    await globalPrompts({ context });
-
-    if (rawPresets.length || localPresets.length) {
-      await loadPreset({ context });
-
-      const presetGasket = makeGasket({
-        plugins: context.presets
-      });
-
-      await presetPromptHooks({ gasket: presetGasket, context });
-      await presetConfigHooks({ gasket: presetGasket, context });
-    }
-
-    const pluginGasket = makeGasket({
-      ...context.presetConfig,
-      plugins: context.presetConfig.plugins.concat(context.presets)
-    });
-
-    await promptHooks({ gasket: pluginGasket, context });
-    await mkDir({ context });
-    await setupPkg({ context });
-    await createHooks({ gasket: pluginGasket, context });
-    await writePkg({ context });
-    await generateFiles({ context });
-    await writeGasketConfig({ context });
-    await installModules({ context });
-    await linkModules({ context });
-    await postCreateHooks({ gasket: pluginGasket, context });
-    if (context.tmpDir) await rm(context.tmpDir, { recursive: true });
-    printReport({ context });
+    await handleCreate(context);
   } catch (err) {
     // eslint-disable-next-line no-console
     console.error(chalk.red('Exiting with errors.'));

package/lib/index.d.ts

@@ -47,6 +47,8 @@ interface CommandOption {
 
 export interface CreateCommandOptions {
   presets?: string[];
+  template?: string;
+  templatePath?: string;
   npmLink?: string[];
   presetPath?: string[];
   packageManager?: string;
@@ -459,6 +461,18 @@ export interface CreateContext {
   /** temporary directory */
   tmpDir: string;
 
+  /** template to use for app creation */
+  template?: string;
+
+  /** path to local template package */
+  templatePath?: string;
+
+  /** resolved template directory path */
+  templateDir?: string;
+
+  /** resolved template name for display */
+  templateName?: string;
+
   /** Default to object w/empty plugins array to be populated by `presetConfig` hook */
   presetConfig: GasketConfigDefinition;
 

package/lib/internal.d.ts

@@ -104,6 +104,7 @@ export function promptForTestPlugin(
 export function allowExtantOverwriting(context: PartialCreateContext, prompt: CreatePrompt): Promise<void>;
 export function globalPrompts(params: { context: PartialCreateContext }): Promise<void>;
 export function loadPresets(params: { context: PartialCreateContext }): Promise<void>;
+
 export function presetPromptHooks(params: { gasket?: Gasket; context: PartialCreateContext }): Promise<void>;
 export function presetConfigHooks(params: { gasket?: Gasket; context: PartialCreateContext }): Promise<void>;
 export function promptHooks(params: { gasket?: Gasket; context: PartialCreateContext }): Promise<void>;
@@ -124,6 +125,16 @@ export type Descriptior = {
   from: string;
   overrides?: string;
 }
+
+/** Templates */
+export function loadTemplate(params: { context: PartialCreateContext }): Promise<void>;
+export function copyTemplate(params: { context: PartialCreateContext }): Promise<void>;
+export function customizeTemplate(params: { context: PartialCreateContext }): Promise<void>;
+export function installTemplateDeps(params: { context: PartialCreateContext }): Promise<void>;
+export function gitInit(params: { context: PartialCreateContext }): Promise<void>;
+
+
+/** Presets */
 export function generateFiles({ context, spinner }: { context: CreateContext, spinner: Ora }): Promise<void>;
 export function performGenerate(context: CreateContext, descriptors: Descriptior[]): boolean[];
 export function getDescriptors(context: CreateContext): Promise<Descriptior[]>;

package/lib/scaffold/actions/copy-template.js

@@ -0,0 +1,22 @@
+import path from 'path';
+import { withSpinner } from '../with-spinner.js';
+import { cp, readdir } from 'fs/promises';
+
+const EXCLUDED_FILES = ['node_modules'];
+
+/** @type {import('../../internal.d.ts').copyTemplate} */
+async function copyTemplate({ context }) {
+  if (!context.templateDir) return;
+
+  const entries = await readdir(context.templateDir, { withFileTypes: true });
+  const filesToCopy = entries.filter(entry => !EXCLUDED_FILES.includes(entry.name));
+
+  for (const entry of filesToCopy) {
+    const sourcePath = path.join(context.templateDir, entry.name);
+    const destPath = path.join(context.dest, entry.name);
+    await cp(sourcePath, destPath, { recursive: true });
+    context.generatedFiles.add(path.relative(context.cwd, destPath));
+  }
+}
+
+export default withSpinner('Copy template files', copyTemplate);

package/lib/scaffold/actions/customize-template.js

@@ -0,0 +1,92 @@
+import path from 'path';
+import { withSpinner } from '../with-spinner.js';
+import { readFile, writeFile } from 'fs/promises';
+
+/** @type {import('../../internal.d.ts').customizeTemplate} */
+async function customizeTemplate({ context }) {
+  if (!context.templateDir || !context.appName) return;
+
+  await Promise.all([
+    updatePackageJson(context),
+    updateReadme(context),
+    updateTemplateFiles(context)
+  ]);
+}
+
+/**
+ * Updates package.json name field with app name
+ * @param {object} context - Gasket context
+ * @returns {Promise<void>}
+ */
+async function updatePackageJson(context) {
+  const packageJsonPath = path.join(context.dest, 'package.json');
+
+  try {
+    const content = await readFile(packageJsonPath, 'utf8');
+    const packageJson = JSON.parse(content);
+
+    packageJson.name = context.appName;
+
+    await writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2) + '\n');
+  } catch (error) {
+    // Ignore if package.json doesn't exist or is malformed
+    if (error.code !== 'ENOENT') {
+      console.warn(`Warning: Could not update package.json: ${error.message}`);
+    }
+  }
+}
+
+/**
+ * Updates README.md with app name placeholders replaced
+ * @param {object} context - Gasket context
+ * @returns {Promise<void>}
+ */
+async function updateReadme(context) {
+  const readmePath = path.join(context.dest, 'README.md');
+
+  try {
+    const content = await readFile(readmePath, 'utf8');
+
+    // Replace all {appName} placeholders with actual app name
+    const updatedContent = content.replace(/{{{appName}}}/g, context.appName);
+
+    await writeFile(readmePath, updatedContent);
+  } catch (error) {
+    // Ignore if README.md doesn't exist
+    if (error.code !== 'ENOENT') {
+      console.warn(`Warning: Could not update README.md: ${error.message}`);
+    }
+  }
+}
+
+/**
+ * Updates template files with app name placeholders replaced
+ * @param {object} context - Gasket context
+ * @returns {Promise<void>}
+ */
+async function updateTemplateFiles(context) {
+  const templateFilePaths = [
+    path.join(context.dest, 'pages/index.tsx'),
+    path.join(context.dest, 'app/page.tsx')
+  ];
+
+  const updatePromises = templateFilePaths.map(async (filePath) => {
+    try {
+      const content = await readFile(filePath, 'utf8');
+
+      // Replace all {appName} placeholders with actual app name
+      const updatedContent = content.replace(/{{{appName}}}/g, context.appName);
+
+      await writeFile(filePath, updatedContent);
+    } catch (error) {
+      // Ignore if file doesn't exist (not all templates have these files)
+      if (error.code !== 'ENOENT') {
+        console.warn(`Warning: Could not update ${filePath}: ${error.message}`);
+      }
+    }
+  });
+
+  await Promise.all(updatePromises);
+}
+
+export default withSpinner('Customize template files', customizeTemplate);

package/lib/scaffold/actions/git-init.js

@@ -0,0 +1,15 @@
+import { withSpinner } from '../with-spinner.js';
+import { runShellCommand } from '@gasket/utils';
+
+/**
+ * Initialize git repository, create main branch, and make initial commit
+ * @type {import('../../internal.d.js').gitInit}
+ */
+async function gitInit({ context }) {
+  await runShellCommand('git', ['init'], { cwd: context.dest });
+  await runShellCommand('git', ['checkout', '-b', 'main'], { cwd: context.dest });
+  await runShellCommand('git', ['add', '.'], { cwd: context.dest });
+  await runShellCommand('git', ['commit', '-m', '🎉 Created new repository with create-gasket-app'], { cwd: context.dest });
+}
+
+export default withSpinner('Initialize git repo', gitInit);

package/lib/scaffold/actions/install-template-deps.js

@@ -0,0 +1,61 @@
+import { withSpinner } from '../with-spinner.js';
+import { PackageManager } from '@gasket/utils';
+import { rm } from 'fs/promises';
+
+/**
+ * Safely cleans up temporary directory
+ * @param {string} tmpDir - Temporary directory path
+ * @returns {Promise<void>}
+ */
+async function cleanupTempDir(tmpDir) {
+  if (!tmpDir) return;
+
+  try {
+    await rm(tmpDir, { recursive: true });
+  } catch {
+    // Ignore cleanup errors
+  }
+}
+
+/**
+ * Checks if an error is related to peer dependencies
+ * @param {Error & { stderr?: string }} error - The error to check
+ * @returns {boolean} True if error is peer dep related
+ */
+function isPeerDependencyError(error) {
+  const errorMessage = (error.stderr || error.message || '').toLowerCase();
+  return errorMessage.includes('peer dep') ||
+    errorMessage.includes('peerinvalid') ||
+    errorMessage.includes('peer dependencies') ||
+    errorMessage.includes('eresolve');
+}
+
+/** @type {import('../../internal.d.ts').installTemplateDeps} */
+async function installTemplateDeps({ context }) {
+  const destPkgManager = new PackageManager({
+    packageManager: 'npm',
+    dest: context.dest
+  });
+
+  try {
+    await destPkgManager.exec('ci');
+    await cleanupTempDir(context.tmpDir);
+  } catch (error) {
+    if (isPeerDependencyError(error)) {
+      console.warn('Peer dependency conflict detected, retrying with --legacy-peer-deps...');
+      try {
+        await destPkgManager.exec('ci', ['--legacy-peer-deps']);
+        await cleanupTempDir(context.tmpDir);
+        context.messages.push('Dependencies were installed with --legacy-peer-deps due to confilct');
+      } catch (retryError) {
+        await cleanupTempDir(context.tmpDir);
+        throw new Error(`Failed to install dependencies even with --legacy-peer-deps: ${retryError.message}`);
+      }
+    } else {
+      await cleanupTempDir(context.tmpDir);
+      throw error;
+    }
+  }
+}
+
+export default withSpinner('Install template dependencies', installTemplateDeps);

package/lib/scaffold/actions/load-template.js

@@ -0,0 +1,110 @@
+import path from 'path';
+import os from 'os';
+import { withSpinner } from '../with-spinner.js';
+import { PackageManager } from '@gasket/utils';
+import { mkdtemp, rm } from 'fs/promises';
+
+/**
+ * Parses template string into name and version components
+ * @param {string} template - Template string (e.g., "@gasket/template-api@1.0.0")
+ * @returns {{ name: string, version: string }} Parsed template name and version
+ */
+function parseTemplateNameAndVersion(template) {
+  // capture name and version, excluding `@`
+  const reNameVersion = /(^.[^@]+)[@](.+$)/i;
+  const [
+    name,
+    version = 'latest'
+  ] = template.split(reNameVersion).filter(Boolean);
+
+  return {
+    name,
+    version
+  };
+}
+
+/**
+ * Safely cleans up temporary directory
+ * @param {string} tmpDir - Temporary directory path
+ * @returns {Promise<void>}
+ */
+async function cleanupTempDir(tmpDir) {
+  if (!tmpDir) return;
+
+  try {
+    await rm(tmpDir, { recursive: true });
+  } catch {
+    // Ignore cleanup errors
+  }
+}
+
+/**
+ * Downloads and installs a remote template package
+ * @param {string} template - Template name with optional version
+ * @param {string} appName - App name for temp directory
+ * @returns {Promise<{ templateDir: string, templateName: string, tmpDir: string }>} Template installation details
+ */
+async function installRemoteTemplate(template, appName) {
+  const tmpDir = await mkdtemp(path.join(os.tmpdir(), `gasket-template-${appName}`));
+  const modPath = path.join(tmpDir, 'node_modules');
+  const pkgManager = new PackageManager({
+    packageManager: 'npm',
+    dest: tmpDir
+  });
+
+  const { name, version } = parseTemplateNameAndVersion(template);
+
+  try {
+    await pkgManager.exec('install', [`${name}@${version}`]);
+    return {
+      templateDir: path.join(modPath, name, 'template'),
+      templateName: `${name}@${version}`,
+      tmpDir
+    };
+  } catch (err) {
+    await cleanupTempDir(tmpDir);
+
+    const errorMessage = err.stderr || err.message;
+    if (err.stderr?.includes('is not in this registry')) {
+      const message = `Template not found in registry: ${name}@${version}. ` +
+        'Use npm_config_registry=<registry> to use privately scoped templates.';
+      throw new Error(message);
+    }
+    throw new Error(`Failed to install template ${name}@${version}: ${errorMessage}`);
+  }
+}
+
+/**
+ * Gets template directory and name based on context
+ * @param {object} context - Gasket creation context
+ * @returns {Promise<{ templateDir: string, templateName: string, tmpDir?: string }>} Template details
+ */
+async function getTemplateDetails(context) {
+  if (context.templatePath) {
+    return {
+      templateDir: path.resolve(context.templatePath, 'template'),
+      templateName: `local template at ${path.resolve(context.templatePath, 'template')}`
+    };
+  }
+
+  const result = await installRemoteTemplate(context.template, context.appName);
+  return {
+    templateDir: result.templateDir,
+    templateName: result.templateName,
+    tmpDir: result.tmpDir
+  };
+}
+
+/** @type {import('../../internal.d.ts').loadTemplate} */
+async function loadTemplate({ context }) {
+  if (!context.template && !context.templatePath) return;
+
+  const { templateDir, templateName, tmpDir } = await getTemplateDetails(context);
+
+  // Store template information in context for other actions to use
+  context.templateDir = templateDir;
+  context.templateName = templateName;
+  context.tmpDir = tmpDir;
+}
+
+export default withSpinner('Loading template', loadTemplate);

package/lib/scaffold/create-context.js

@@ -74,6 +74,8 @@ export function makeCreateContext(argv = [], options = {}) {
   const appName = argv[0] || 'templated-app';
   const {
     presets = [],
+    template,
+    templatePath,
     npmLink = [],
     presetPath = [],
     packageManager,
@@ -107,6 +109,8 @@ export function makeCreateContext(argv = [], options = {}) {
     pkgLinks,
     localPresets,
     rawPresets,
+    template,
+    templatePath,
     messages: [],
     warnings: [],
     errors: [],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-gasket-app",
-  "version": "7.4.12",
+  "version": "7.4.14",
   "description": "starter pack for creating a gasket app",
   "type": "module",
   "bin": {
@@ -9,7 +9,8 @@
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "files": [
-    "lib"
+    "lib",
+    "EXAMPLES.md"
   ],
   "repository": "godaddy/gasket.git",
   "publishConfig": {
@@ -31,33 +32,31 @@
     "mkdirp": "^1.0.4",
     "ora": "^3.4.0",
     "semver": "^7.7.1",
-    "@gasket/core": "^7.6.2",
-    "@gasket/plugin-command": "^7.5.2",
-    "@gasket/plugin-docs": "^7.4.7",
-    "@gasket/plugin-docusaurus": "^7.4.5",
-    "@gasket/plugin-dynamic-plugins": "^7.4.1",
-    "@gasket/plugin-git": "^7.4.6",
-    "@gasket/plugin-logger": "^7.3.7",
-    "@gasket/plugin-metadata": "^7.5.3",
-    "@gasket/request": "^7.5.3",
-    "@gasket/utils": "^7.6.2"
+    "@gasket/core": "^7.6.3",
+    "@gasket/plugin-command": "^7.5.3",
+    "@gasket/plugin-docs": "^7.4.8",
+    "@gasket/plugin-docusaurus": "^7.4.6",
+    "@gasket/plugin-dynamic-plugins": "^7.4.2",
+    "@gasket/plugin-git": "^7.4.7",
+    "@gasket/plugin-logger": "^7.3.8",
+    "@gasket/plugin-metadata": "^7.5.4",
+    "@gasket/request": "^7.5.4",
+    "@gasket/utils": "^7.6.3"
   },
   "devDependencies": {
     "@typescript-eslint/parser": "^8.38.0",
+    "@vitest/coverage-v8": "^3.2.0",
     "dotenv": "^16.4.7",
-    "jest": "^29.7.0",
-    "@gasket/request": "^7.5.3"
-  },
-  "jest": {
-    "transform": {}
+    "vitest": "^3.2.0",
+    "@gasket/request": "^7.5.4"
   },
   "scripts": {
     "lint": "eslint .",
     "lint:fix": "pnpm run lint --fix",
     "posttest": "pnpm run lint && pnpm run typecheck",
-    "test": "cross-env NODE_OPTIONS='--unhandled-rejections=strict --experimental-vm-modules' jest",
-    "test:coverage": "jest --coverage",
-    "test:watch": "pnpm run test --watch",
+    "test": "vitest run --globals",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest",
     "typecheck": "tsc",
     "typecheck:watch": "tsc --watch"
   }