create-jst 0.4.30 → 0.4.33

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-jst",
-  "version": "0.4.30",
+  "version": "0.4.33",
   "description": "Create a web application from the JST template.",
   "type": "module",
   "packageManager": "npm@11.6.2",
@@ -14,13 +14,13 @@
   "engines": {
     "node": ">=22.14.0"
   },
-	"scripts": {
-		"audit:sources": "node scripts/audit-sources.mjs",
-		"canary:migrate": "node scripts/migration-canary.mjs",
+  "scripts": {
+    "audit:sources": "node scripts/audit-sources.mjs",
+    "canary:migrate": "node scripts/migration-canary.mjs",
     "lint": "eslint . --max-warnings 0",
     "benchmark": "node scripts/run-benchmarks.mjs",
     "benchmark:update": "node scripts/run-benchmarks.mjs --write-baseline",
-		"test": "node --test test/integration.test.mjs test/migration.test.mjs test/nodeMigrationGateway.test.mjs test/nodeProjectGateway.test.mjs test/options.test.mjs test/projectInitializer.test.mjs",
+    "test": "node --test test/degitTemplateGateway.test.mjs test/integration.test.mjs test/migration.test.mjs test/nodeMigrationGateway.test.mjs test/nodeProjectGateway.test.mjs test/options.test.mjs test/projectInitializer.test.mjs",
     "test:generated": "node --test test/generatedProject.test.mjs",
     "check": "npm run lint && npm test && npm pack --dry-run",
     "prepublishOnly": "npm run check"

package/src/domain/projectSpecification.mjs

@@ -18,7 +18,7 @@ export const PRIMARY_COLORS = [
 export const PACKAGE_MANAGERS = ['npm', 'pnpm']
 export const STYLE_LANGUAGES = ['css', 'scss']
 export const EXAMPLES = ['clean', 'showcase']
-export const TEMPLATE_SOURCE = 'jst-stack/jst#v0.4.30'
+export const TEMPLATE_SOURCE = 'jst-stack/jst#v0.4.32'
 export const SHOWCASE_SOURCE = 'jst-stack/jst-showcase#da0fbe07b2a2d529dce7a0178ea756caa87238f4'
 
 export function buildProjectSpecification(input) {

package/src/infrastructure/degitTemplateGateway.mjs

@@ -1,14 +1,57 @@
 import degit from 'degit'
-import { cp } from 'node:fs/promises'
+import { execFile } from 'node:child_process'
+import { cp, mkdir, rm } from 'node:fs/promises'
 import { isAbsolute, resolve } from 'node:path'
+import { promisify } from 'node:util'
 
-export function createDegitTemplateGateway() {
+const execute = promisify(execFile)
+const COMMIT_REFERENCE = /^[\da-f]{40}$/u
+
+export function createDegitTemplateGateway({
+	gitExecutable = 'git',
+	gitTimeout = 180_000,
+	resolveRemote = (repository) => `https://github.com/${repository}.git`,
+} = {}) {
 	return {
-		clone(source, destination) {
+		async clone(source, destination) {
 			if (isAbsolute(source) || source.startsWith('.')) {
 				return cp(resolve(source), destination, { recursive: true })
 			}
+
+			const [repository, reference] = splitSource(source)
+			if (COMMIT_REFERENCE.test(reference)) {
+				return cloneCommit({ destination, gitExecutable, gitTimeout, reference, remote: resolveRemote(repository), repository })
+			}
+
 			return degit(source, { disableCache: true, force: false, verbose: false }).clone(destination)
 		},
 	}
 }
+
+function splitSource(source) {
+	const [repository, reference = ''] = source.split('#')
+	return [repository, reference]
+}
+
+async function cloneCommit({ destination, gitExecutable, gitTimeout, reference, remote, repository }) {
+	await mkdir(destination, { recursive: true })
+
+	try {
+		await git(gitExecutable, ['init', '--quiet'], destination, gitTimeout)
+		await git(gitExecutable, ['fetch', '--quiet', '--depth=1', remote, reference], destination, gitTimeout)
+		await git(gitExecutable, ['checkout', '--quiet', '--detach', 'FETCH_HEAD'], destination, gitTimeout)
+	} catch (error) {
+		throw new Error(`Could not download ${repository}#${reference}: ${describeFailure(error)}`, { cause: error })
+	} finally {
+		await rm(resolve(destination, '.git'), { force: true, recursive: true })
+	}
+}
+
+function git(executable, args, cwd, timeout) {
+	return execute(executable, args, { cwd, maxBuffer: 8 * 1024 * 1024, timeout })
+}
+
+function describeFailure(error) {
+	const stderr = error?.stderr?.trim()
+	return stderr ? stderr.split('\n').at(-1) : (error?.message ?? String(error))
+}