Files
picpeak/backend/__tests__/services/updateCheckRegistryMigration.test.js
T
Paul Nothaft 137a42f259 feat(admin): surface the registry move through the update check (#993)
Relates to #985 — does NOT close it.

Adds registryMigrationRequired to the update-check payload (stable channel below
3.45.0) and an amber block in UpdateNotification explaining that the retired
registry path still responds, so `docker compose pull` appears to succeed while
serving the same frozen build.

Known limitation, established in review and merged deliberately: this cannot
reach the operators #985 describes. PicPeak is self-hosted, so the update-check
code runs inside the operator's own image — a v3.44.0 install runs v3.44.0's
backend forever, and the only external call returns release metadata, not logic.
Every build containing this predicate is >= 3.45.0, where it is false by
definition. The release-notes fallback fails too: the changelog modal shipped
2026-05-29, two days after the freeze.

Correct for any future rename, no runtime cost, but #985 stays open — the
population it describes still has no in-app channel. Viable routes are external
(retired GHCR package description, repo README, docs).

'0.0.0' is excluded from the predicate: that is getCurrentVersion's fallback for
an unreadable package.json, i.e. a broken install, not a pre-rename one.
2026-08-04 16:36:50 +02:00

53 lines
2.4 KiB
JavaScript

/**
* Pre-rename detection for the registry-move notice (#985).
*
* The in-app MigrationBanner shipped 2026-06-29, a month AFTER
* ghcr.io/the-luap/picpeak/* stopped receiving images on 2026-05-27. Anyone
* still pulling the retired path is therefore running a build that predates the
* banner and can never render it — the structural gap that keeps producing
* reports like #982. The update check is the one channel that still reaches
* them, so it carries the notice instead.
*
* The boundary is exact rather than heuristic: v3.44.0 shipped on the freeze
* date and v3.45.0 followed on 2026-07-09 to the org registry only, with
* nothing published in between.
*/
const { isPreRenameStable, REGISTRY_RENAME_STABLE_FLOOR } = require('../../src/services/updateCheckService');
describe('isPreRenameStable (#985)', () => {
it('pins the floor to the first org-registry-only stable release', () => {
expect(REGISTRY_RENAME_STABLE_FLOOR).toBe('3.45.0');
});
it('flags stable installs below the floor', () => {
// v3.44.0 is the last stable that reached the retired path.
expect(isPreRenameStable('3.44.0', 'stable')).toBe(true);
expect(isPreRenameStable('3.43.1', 'stable')).toBe(true);
expect(isPreRenameStable('2.6.5', 'stable')).toBe(true);
});
it('leaves stable installs at or above the floor alone', () => {
expect(isPreRenameStable('3.45.0', 'stable')).toBe(false);
expect(isPreRenameStable('3.45.13', 'stable')).toBe(false);
expect(isPreRenameStable('3.99.0', 'stable')).toBe(false);
});
it('never fires on the beta channel', () => {
// The beta boundary is inferred, not clean — 3.59.0-beta.0 landed two days
// after the freeze. A false positive would tell a correctly-configured
// operator their registry is retired, so beta is deliberately excluded even
// where the number looks old.
expect(isPreRenameStable('3.44.0-beta.0', 'beta')).toBe(false);
expect(isPreRenameStable('3.58.0-beta.0', 'beta')).toBe(false);
expect(isPreRenameStable('3.99.0-beta.0', 'beta')).toBe(false);
});
it('does not fire on an unresolvable version', () => {
// getCurrentVersion() falls back to '0.0.0' when package.json is
// unreadable. That is a broken install, not a pre-rename one — claiming its
// registry is retired would send the operator down the wrong path.
expect(isPreRenameStable('0.0.0', 'stable')).toBe(false);
});
});