bowenliang123
018e92964f
The Context tab's Plugin-info card already hinted at a newer npm release; the Context Insights page head had no such hint. Add one beside the balance capsule, in that page's own capsule idiom rather than the card's inline chip: label plus the version in the warn token, linking the release notes through the page's portaled hover bubble. The registry check moves out of pluginInfo into a useNewerVersion hook both surfaces read, so the second hint costs no new fetch path, state, or mechanism — one TTL-cached read still answers both. Its own coverage moves with it into latestVersion.spec, leaving each surface's spec asserting only what that surface renders. The two head capsules share one CSS chrome instead of a copy, and the head's gap drops to 8px so the capsule cluster tightens; the title keeps its wider 16px lead-in, and the fold at narrow widths leaves every wrapped row on the same left edge with no overflow.
221 lines
8.5 KiB
TypeScript
221 lines
8.5 KiB
TypeScript
// Latest-version check (src/client/latestVersion.ts): registry fetch with a 1h TTL, the semver comparator,
|
|
// and the useNewerVersion hook every surface's update hint reads.
|
|
// The fetch is stubbed per test — the suite never hits the network — and each fetch test re-imports the module
|
|
// (vi.resetModules) to reset the module-level cache. Two registries are tried in order (official npm, then npmmirror).
|
|
|
|
import { createElement as h } from 'react'
|
|
import assert from 'node:assert/strict'
|
|
import { afterEach, describe, test, vi } from 'vitest'
|
|
import { isNewerVersion } from '../../src/client/latestVersion'
|
|
import { flush, mount } from './helpers/kit'
|
|
|
|
const HOUR_MS = 60 * 60 * 1000
|
|
|
|
afterEach(() => {
|
|
vi.unstubAllGlobals()
|
|
vi.useRealTimers()
|
|
vi.resetModules()
|
|
delete (globalThis as Record<string, unknown>).__DSH_CTX_VERSION__
|
|
})
|
|
|
|
async function freshModule(): Promise<typeof import('../../src/client/latestVersion')> {
|
|
vi.resetModules()
|
|
return await import('../../src/client/latestVersion')
|
|
}
|
|
|
|
describe('fetchLatestVersion', () => {
|
|
test('an ok response with a string version resolves to it', async () => {
|
|
vi.stubGlobal('fetch', async () => ({ ok: true, json: async () => ({ version: '9.9.9' }) }))
|
|
const { fetchLatestVersion } = await freshModule()
|
|
assert.equal(await fetchLatestVersion(), '9.9.9')
|
|
})
|
|
|
|
test('an ok response without a version resolves to null', async () => {
|
|
vi.stubGlobal('fetch', async () => ({ ok: true, json: async () => ({}) }))
|
|
const { fetchLatestVersion } = await freshModule()
|
|
assert.equal(await fetchLatestVersion(), null)
|
|
})
|
|
|
|
test('an ok response with a non-string version resolves to null', async () => {
|
|
vi.stubGlobal('fetch', async () => ({ ok: true, json: async () => ({ version: 9 }) }))
|
|
const { fetchLatestVersion } = await freshModule()
|
|
assert.equal(await fetchLatestVersion(), null)
|
|
})
|
|
|
|
test('a non-ok response resolves to null', async () => {
|
|
vi.stubGlobal('fetch', async () => ({ ok: false, json: async () => ({ version: '9.9.9' }) }))
|
|
const { fetchLatestVersion } = await freshModule()
|
|
assert.equal(await fetchLatestVersion(), null)
|
|
})
|
|
|
|
test('a rejected fetch resolves to null', async () => {
|
|
vi.stubGlobal('fetch', async () => { throw new Error('offline') })
|
|
const { fetchLatestVersion } = await freshModule()
|
|
assert.equal(await fetchLatestVersion(), null)
|
|
})
|
|
|
|
test('a second call within the TTL does not refetch', async () => {
|
|
vi.useFakeTimers()
|
|
vi.setSystemTime(1_000_000)
|
|
let fetches = 0
|
|
vi.stubGlobal('fetch', async () => {
|
|
fetches++
|
|
return { ok: true, json: async () => ({ version: '1.0.0' }) }
|
|
})
|
|
const { fetchLatestVersion } = await freshModule()
|
|
assert.equal(await fetchLatestVersion(), '1.0.0')
|
|
vi.setSystemTime(1_000_000 + HOUR_MS - 1)
|
|
assert.equal(await fetchLatestVersion(), '1.0.0')
|
|
assert.equal(fetches, 1)
|
|
})
|
|
|
|
test('a call after the TTL expires refetches', async () => {
|
|
vi.useFakeTimers()
|
|
vi.setSystemTime(1_000_000)
|
|
let fetches = 0
|
|
vi.stubGlobal('fetch', async () => {
|
|
fetches++
|
|
return { ok: true, json: async () => ({ version: '1.0.' + fetches }) }
|
|
})
|
|
const { fetchLatestVersion } = await freshModule()
|
|
assert.equal(await fetchLatestVersion(), '1.0.1')
|
|
vi.setSystemTime(1_000_000 + HOUR_MS)
|
|
assert.equal(await fetchLatestVersion(), '1.0.2')
|
|
assert.equal(fetches, 2)
|
|
})
|
|
|
|
test('falls back to npmmirror when the official registry fails', async () => {
|
|
const urls: string[] = []
|
|
vi.stubGlobal('fetch', async (input: unknown) => {
|
|
const url = String(input)
|
|
urls.push(url)
|
|
if (url.startsWith('https://registry.npmjs.org/')) {
|
|
return { ok: false, json: async () => ({}) }
|
|
}
|
|
return { ok: true, json: async () => ({ version: '2.0.0' }) }
|
|
})
|
|
const { fetchLatestVersion } = await freshModule()
|
|
assert.equal(await fetchLatestVersion(), '2.0.0')
|
|
assert.deepEqual(urls, [
|
|
'https://registry.npmjs.org/dsh-context/latest',
|
|
'https://registry.npmmirror.com/dsh-context/latest',
|
|
])
|
|
})
|
|
|
|
test('falls back to npmmirror when the official fetch rejects', async () => {
|
|
const urls: string[] = []
|
|
vi.stubGlobal('fetch', async (input: unknown) => {
|
|
const url = String(input)
|
|
urls.push(url)
|
|
if (url.startsWith('https://registry.npmjs.org/')) {
|
|
throw new Error('offline')
|
|
}
|
|
return { ok: true, json: async () => ({ version: '3.0.0' }) }
|
|
})
|
|
const { fetchLatestVersion } = await freshModule()
|
|
assert.equal(await fetchLatestVersion(), '3.0.0')
|
|
assert.equal(urls.length, 2)
|
|
})
|
|
|
|
test('resolves to null when every source fails', async () => {
|
|
const urls: string[] = []
|
|
vi.stubGlobal('fetch', async (input: unknown) => {
|
|
const url = String(input)
|
|
urls.push(url)
|
|
return { ok: false, json: async () => ({}) }
|
|
})
|
|
const { fetchLatestVersion } = await freshModule()
|
|
assert.equal(await fetchLatestVersion(), null)
|
|
assert.equal(urls.length, 2)
|
|
})
|
|
})
|
|
|
|
describe('isNewerVersion', () => {
|
|
test('a strictly newer version is newer', () => {
|
|
assert.equal(isNewerVersion('1.2.3', '1.2.2'), true)
|
|
})
|
|
|
|
test('equal and lower versions are not newer', () => {
|
|
assert.equal(isNewerVersion('1.2.3', '1.2.3'), false)
|
|
assert.equal(isNewerVersion('1.2.2', '1.2.3'), false)
|
|
})
|
|
|
|
test('a v prefix is stripped', () => {
|
|
assert.equal(isNewerVersion('v1.3.0', '1.2.9'), true)
|
|
})
|
|
|
|
test('a pre-release suffix is ignored', () => {
|
|
assert.equal(isNewerVersion('1.3.0-rc.1', '1.3.0'), false)
|
|
assert.equal(isNewerVersion('1.3.0-rc.1', '1.2.0'), true)
|
|
})
|
|
|
|
test('missing segments compare as zero', () => {
|
|
assert.equal(isNewerVersion('1.2', '1.2.1'), false)
|
|
assert.equal(isNewerVersion('1.2.1', '1.2'), true)
|
|
})
|
|
|
|
test('garbage segments parse as zero', () => {
|
|
assert.equal(isNewerVersion('x.y', '0.0.0'), false)
|
|
})
|
|
})
|
|
|
|
/** Mount the hook through a throwaway component; `version` emulates the tsdown define. The settled value is
|
|
* what the hook last reported — an empty string stands for null, and a late setState still re-renders. */
|
|
async function renderUseNewerVersion(version?: string): Promise<{ settled: () => string; unmount: () => Promise<void> }> {
|
|
vi.resetModules()
|
|
if (version === undefined) delete (globalThis as Record<string, unknown>).__DSH_CTX_VERSION__
|
|
else (globalThis as Record<string, unknown>).__DSH_CTX_VERSION__ = version
|
|
const { useNewerVersion } = await import('../../src/client/latestVersion')
|
|
const seen: string[] = []
|
|
function Probe(): null {
|
|
seen.push(useNewerVersion() ?? '')
|
|
return null
|
|
}
|
|
const m = await mount(h(Probe, {}))
|
|
await flush()
|
|
return { settled: () => seen[seen.length - 1], unmount: () => m.unmount() }
|
|
}
|
|
|
|
describe('useNewerVersion', () => {
|
|
test('a newer registry version is served to the caller', async () => {
|
|
vi.stubGlobal('fetch', async () => ({ ok: true, json: async () => ({ version: '1.1.0' }) }))
|
|
const { settled, unmount } = await renderUseNewerVersion('1.0.0')
|
|
assert.equal(settled(), '1.1.0')
|
|
await unmount()
|
|
})
|
|
|
|
test('a dev build never checks the registry', async () => {
|
|
const fetchMock = vi.fn()
|
|
vi.stubGlobal('fetch', fetchMock)
|
|
const { settled, unmount } = await renderUseNewerVersion() // PLUGIN_VERSION = 0.0.0-dev
|
|
assert.equal(fetchMock.mock.calls.length, 0)
|
|
assert.equal(settled(), '')
|
|
await unmount()
|
|
})
|
|
|
|
test('a version that is not newer stays null', async () => {
|
|
vi.stubGlobal('fetch', async () => ({ ok: true, json: async () => ({ version: '1.0.0' }) }))
|
|
const { settled, unmount } = await renderUseNewerVersion('1.0.0')
|
|
assert.equal(settled(), '')
|
|
await unmount()
|
|
})
|
|
|
|
test('every registry failing stays null', async () => {
|
|
vi.stubGlobal('fetch', async () => ({ ok: false, json: async () => ({}) }))
|
|
const { settled, unmount } = await renderUseNewerVersion('1.0.0')
|
|
assert.equal(settled(), '')
|
|
await unmount()
|
|
})
|
|
|
|
test('unmounting before the answer lands drops the late result', async () => {
|
|
let resolveFetch: ((res: { ok: boolean; json: () => Promise<{ version: string }> }) => void) | null = null
|
|
vi.stubGlobal('fetch', vi.fn(() => new Promise((resolve) => { resolveFetch = resolve })))
|
|
const { settled, unmount } = await renderUseNewerVersion('1.0.0')
|
|
await unmount()
|
|
resolveFetch!({ ok: true, json: () => Promise.resolve({ version: '2.0.0' }) })
|
|
await flush()
|
|
// No state update after unmount, no act warning, and the value never lands.
|
|
assert.equal(settled(), '')
|
|
})
|
|
})
|