Skip to content
Source
Sign inSign up
TanStack/cli
Open History to see the last commit

npm-resolver.ts

65 lines1.9 KB

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​
9const cache = new Map<string, string>()
10​
11export async function resolveNpmVersion(pkg: string): Promise<string | null> {
12 if (cache.has(pkg)) {
13 return cache.get(pkg)!
14 }
15​
16 try {
17 const res = await fetch(`https://registry.npmjs.org/${pkg}/latest`, {
18 headers: { Accept: 'application/vnd.npm.install-v1+json' },
19 })
20 if (!res.ok) return null
21 const data = (await res.json()) as { version?: string }
22 const version = data.version ?? null
23 if (version) cache.set(pkg, version)
24 return version
25 } catch {
26 return null
27 }
29​
30/**
31 * Walk a deps object and resolve any "latest" values to pinned versions.
32 * Non-"latest" values are left untouched.
33 */
34export async function resolveLatestVersions(
35 deps: Record<string, string>,
36): Promise<Record<string, string>> {
37 const entries = Object.entries(deps)
38 const resolved = await Promise.all(
39 entries.map(async ([name, version]) => {
40 if (version !== 'latest') return [name, version] as const
41 const pinned = await resolveNpmVersion(name)
42 return [name, pinned ?? 'latest'] as const
43 }),
44 )
45 return Object.fromEntries(resolved)
47​
48/**
49 * Resolve all "latest" version specifiers in a package.json object's
50 * dependencies and devDependencies in-place, returning a new object.
51 */
52export async function resolvePackageJSONLatest(
53 packageJSON: Record<string, any>,
54): Promise<Record<string, any>> {
55 const result = { ...packageJSON }
56​
57 if (result.dependencies) {
58 result.dependencies = await resolveLatestVersions(result.dependencies)
59 }
60 if (result.devDependencies) {
61 result.devDependencies = await resolveLatestVersions(result.devDependencies)
62 }
63​
64 return result