1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
|
import { onMounted, ref } from 'vue';
import {
type GitHubRelease,
type Platform,
platformReleases,
} from './releaseAssets';
const REPO = 'm1sk9/LunaticChat';
const PROTOCOL_FILE_PATH =
'engine/src/main/kotlin/dev/m1sk9/lunaticChat/engine/protocol/ProtocolVersion.kt';
export interface ProtocolVersion {
major: number;
minor: number;
patch: number;
minSupportedMinor: number;
}
export interface PlatformReleaseEntry {
platform: Platform;
version: string;
tag: string;
publishedAt: string;
releaseUrl: string;
protocol: ProtocolVersion | null;
}
export interface CompatibilityData {
paper: PlatformReleaseEntry[];
velocity: PlatformReleaseEntry[];
}
function parseProtocolVersion(source: string): ProtocolVersion | null {
const match = (key: string): number | null => {
const re = new RegExp(`const\\s+val\\s+${key}\\s*=\\s*(\\d+)`);
const m = source.match(re);
return m ? Number.parseInt(m[1], 10) : null;
};
const major = match('MAJOR');
const minor = match('MINOR');
const patch = match('PATCH');
const minSupportedMinor = match('MIN_SUPPORTED_MINOR');
if (
major === null ||
minor === null ||
patch === null ||
minSupportedMinor === null
) {
return null;
}
return { major, minor, patch, minSupportedMinor };
}
async function fetchProtocolAtTag(
tag: string,
): Promise<ProtocolVersion | null> {
const url = `https://raw.githubusercontent.com/${REPO}/${encodeURIComponent(tag)}/${PROTOCOL_FILE_PATH}`;
try {
const res = await fetch(url);
if (!res.ok) return null;
const text = await res.text();
return parseProtocolVersion(text);
} catch {
return null;
}
}
function buildEntries(
releases: GitHubRelease[],
platform: Platform,
): PlatformReleaseEntry[] {
return platformReleases(releases, platform).map((entry) => ({
platform,
version: entry.version,
tag: entry.release.tag_name,
publishedAt: entry.release.published_at,
releaseUrl: entry.release.html_url,
protocol: null,
}));
}
export function useCompatibilityData() {
const data = ref<CompatibilityData>({ paper: [], velocity: [] });
const loading = ref(true);
const error = ref(false);
onMounted(async () => {
try {
const res = await fetch(
`https://api.github.com/repos/${REPO}/releases?per_page=100`,
);
if (!res.ok) {
error.value = true;
return;
}
const releases: GitHubRelease[] = await res.json();
const paper = buildEntries(releases, 'paper');
const velocity = buildEntries(releases, 'velocity');
const all = [...paper, ...velocity];
const protocols = await Promise.all(
all.map((entry) => fetchProtocolAtTag(entry.tag)),
);
all.forEach((entry, i) => {
entry.protocol = protocols[i];
});
data.value = {
paper: paper.filter((e) => e.protocol !== null),
velocity: velocity.filter((e) => e.protocol !== null),
};
} catch {
error.value = true;
} finally {
loading.value = false;
}
});
return { data, loading, error };
}
export type CompatibilityResult =
| 'compatible'
| 'degraded'
| 'major-mismatch'
| 'paper-too-new'
| 'paper-too-old';
// The first three checks mirror the gatekeeping done by Velocity in
// platform-velocity/.../PluginMessageHandler.kt — Paper does not validate.
export function checkCompatibility(
paper: ProtocolVersion,
velocity: ProtocolVersion,
): CompatibilityResult {
if (paper.major !== velocity.major) return 'major-mismatch';
if (paper.minor > velocity.minor) return 'paper-too-new';
if (paper.minor < velocity.minSupportedMinor) return 'paper-too-old';
// The handshake is decided by MAJOR and MINOR alone, so what is left is how
// much of the protocol both ends speak. ProtocolVersion bumps PATCH for
// sub-channels a peer can safely ignore and MINOR for ones whose absence
// degrades behaviour, which makes any accepted difference a feature the newer
// side offers and the older one will never answer — connected, yet short of
// what the pair advertises.
if (paper.minor !== velocity.minor || paper.patch !== velocity.patch) {
return 'degraded';
}
return 'compatible';
}
export function isCompatible(
paper: ProtocolVersion,
velocity: ProtocolVersion,
): boolean {
const result = checkCompatibility(paper, velocity);
return result === 'compatible' || result === 'degraded';
}
// Which end lags the other, given the pair already connects.
export function olderSide(
paper: ProtocolVersion,
velocity: ProtocolVersion,
): 'paper' | 'velocity' {
if (paper.minor !== velocity.minor) {
return paper.minor < velocity.minor ? 'paper' : 'velocity';
}
return paper.patch < velocity.patch ? 'paper' : 'velocity';
}
export function formatProtocol(p: ProtocolVersion): string {
return `${p.major}.${p.minor}.${p.patch}`;
}
|
