Open History to see the last commit
1/**
2 * Resolves npm package versions at generation time.
3 *
4 * When a template specifies "latest" for a package, we fetch the actual
5 * current version from the npm registry and pin it exactly, so generated
6 * projects don't silently drift over time.
7 */
8
9export async function resolveNpmVersion(pkg: string): Promise<string | null> {
10 try {
11 const res = await fetch(`https://registry.npmjs.org/${pkg}/latest`, {
12 headers: { Accept: 'application/json' },
13 })
14 if (!res.ok) return null
15 const data = (await res.json()) as { version?: string }
16 const version = data.version ?? null
17 return version
18 } catch {
19 return null
20 }
21}
22
23/**
24 * Walk a deps object and resolve any "latest" values to pinned versions.
25 * Non-"latest" values are left untouched.
26 */
27export async function resolveLatestVersions(
28 deps: Record<string, string>,
29): Promise<Record<string, string>> {
30 const entries = Object.entries(deps)
31 const resolved = await Promise.all(
32 entries.map(async ([name, version]) => {
33 if (version !== 'latest') return [name, version] as const
34 const pinned = await resolveNpmVersion(name)
35 return [name, pinned ?? 'latest'] as const
36 }),
37 )
38 return Object.fromEntries(resolved)
39}
40
41/**
42 * Resolve all "latest" version specifiers in a package.json object's
43 * dependencies and devDependencies in-place, returning a new object.
44 */
45export async function resolvePackageJSONLatest(
46 packageJSON: Record<string, any>,
47): Promise<Record<string, any>> {
48 const result = { ...packageJSON }
49
50 if (result.dependencies) {
51 result.dependencies = await resolveLatestVersions(result.dependencies)
52 }
53 if (result.devDependencies) {
54 result.devDependencies = await resolveLatestVersions(result.devDependencies)
55 }
56
57 return result
58}