@serverkgg/bridge 0.1.2 → 0.1.3

package/src/codecs/ini.test.ts

@@ -1,4 +1,4 @@
-import { describe, expect, test } from "bun:test";
+import { describe, expect, it } from "bun:test";
 import { mergeIni, parseIni } from "./ini";
 
 const SAMPLE = [
@@ -14,38 +14,38 @@ const SAMPLE = [
 ].join("\n");
 
 describe("parseIni", () => {
-	test("reads the keys of one section", () => {
+	it("reads the keys of one section", () => {
 		expect(parseIni(SAMPLE, "Server")).toEqual({
 			name: "serverk",
 			maxPlayers: "10",
 		});
 	});
 
-	test("reads another section without leaking keys", () => {
+	it("reads another section without leaking keys", () => {
 		expect(parseIni(SAMPLE, "Admin")).toEqual({
 			password: "secret",
 		});
 	});
 
-	test("reads the keys before the first header when no section is asked for", () => {
+	it("reads the keys before the first header when no section is asked for", () => {
 		expect(parseIni("welcome=hello\n[Server]\nname=x\n")).toEqual({
 			welcome: "hello",
 		});
 	});
 
-	test("keeps the last of a repeated key", () => {
+	it("keeps the last of a repeated key", () => {
 		expect(parseIni("[S]\nmod=a\nmod=b\n", "S")).toEqual({
 			mod: "b",
 		});
 	});
 
-	test("returns nothing for an unknown section", () => {
+	it("returns nothing for an unknown section", () => {
 		expect(parseIni(SAMPLE, "Nothing")).toEqual({});
 	});
 });
 
 describe("mergeIni", () => {
-	test("rewrites a value in place and keeps comments and order", () => {
+	it("rewrites a value in place and keeps comments and order", () => {
 		expect(
 			mergeIni(
 				SAMPLE,
@@ -69,7 +69,7 @@ describe("mergeIni", () => {
 		);
 	});
 
-	test("appends an unknown key at the end of its section", () => {
+	it("appends an unknown key at the end of its section", () => {
 		expect(
 			mergeIni(
 				SAMPLE,
@@ -93,7 +93,7 @@ describe("mergeIni", () => {
 		);
 	});
 
-	test("creates a section that does not exist yet", () => {
+	it("creates a section that does not exist yet", () => {
 		expect(
 			mergeIni(
 				"[Server]\nname=x\n",
@@ -105,7 +105,7 @@ describe("mergeIni", () => {
 		).toBe("[Server]\nname=x\n\n[Game]\nlevel=3\n");
 	});
 
-	test("drops repeated occurrences of a key it rewrites", () => {
+	it("drops repeated occurrences of a key it rewrites", () => {
 		expect(
 			mergeIni(
 				"[S]\nmod=a\nmod=b\nother=1\n",
@@ -117,7 +117,7 @@ describe("mergeIni", () => {
 		).toBe("[S]\nmod=c\nother=1\n");
 	});
 
-	test("writes into an empty file", () => {
+	it("writes into an empty file", () => {
 		expect(
 			mergeIni(
 				"",
@@ -129,7 +129,7 @@ describe("mergeIni", () => {
 		).toBe("[Server]\nname=x\n");
 	});
 
-	test("writes preamble keys when no section is asked for", () => {
+	it("writes preamble keys when no section is asked for", () => {
 		expect(
 			mergeIni("welcome=hello\n[Server]\nname=x\n", {
 				welcome: "salam",
@@ -138,7 +138,7 @@ describe("mergeIni", () => {
 		).toBe("welcome=salam\nextra=1\n[Server]\nname=x\n");
 	});
 
-	test("leaves other sections untouched", () => {
+	it("leaves other sections untouched", () => {
 		expect(
 			mergeIni(
 				"[A]\nkey=1\n[B]\nkey=2\n",

package/src/codecs/javaProperties.test.ts

@@ -1,33 +1,33 @@
-import { describe, expect, test } from "bun:test";
+import { describe, expect, it } from "bun:test";
 import { escapeJavaProperty, mergeJavaProperties, parseJavaProperties, unescapeJavaProperty } from "./javaProperties";
 
 const ARABIC = "سيرفرك";
 
 describe("parseJavaProperties", () => {
-	test("decodes the unicode escapes the java server writes", () => {
+	it("decodes the unicode escapes the java server writes", () => {
 		expect(parseJavaProperties("motd=\\u0633\\u064A\\u0631\\u0641\\u0631\\u0643\n")).toEqual({
 			motd: ARABIC,
 		});
 	});
 
-	test("decodes backslash escapes in values", () => {
+	it("decodes backslash escapes in values", () => {
 		expect(parseJavaProperties("resource-pack=https\\://example.com/pack.zip\nmotd=a\\tb\\\\c\n")).toEqual({
 			"resource-pack": "https://example.com/pack.zip",
 			motd: "a\tb\\c",
 		});
 	});
 
-	test("repairs a value the server stored as latin-1 bytes of utf-8", () => {
+	it("repairs a value the server stored as latin-1 bytes of utf-8", () => {
 		expect(parseJavaProperties("motd=ddss \\u00D9\\u008A\\u00D8\\u00AA\n")).toEqual({
 			motd: "ddss يت",
 		});
 	});
 
-	test("keeps plain latin-1 text that is not utf-8", () => {
+	it("keeps plain latin-1 text that is not utf-8", () => {
 		expect(unescapeJavaProperty("caf\\u00E9")).toBe("café");
 	});
 
-	test("keeps comments and plain values", () => {
+	it("keeps comments and plain values", () => {
 		expect(parseJavaProperties("#Minecraft server properties\nmax-players=20\n")).toEqual({
 			"max-players": "20",
 		});
@@ -35,7 +35,7 @@ describe("parseJavaProperties", () => {
 });
 
 describe("mergeJavaProperties", () => {
-	test("writes non ascii text as unicode escapes", () => {
+	it("writes non ascii text as unicode escapes", () => {
 		expect(
 			mergeJavaProperties("motd=A Minecraft Server\nmax-players=20\n", {
 				motd: ARABIC,
@@ -43,21 +43,21 @@ describe("mergeJavaProperties", () => {
 		).toBe("motd=\\u0633\\u064A\\u0631\\u0641\\u0631\\u0643\nmax-players=20\n");
 	});
 
-	test("escapes the characters java treats as separators", () => {
+	it("escapes the characters java treats as separators", () => {
 		expect(escapeJavaProperty("https://a.b#c=d!e")).toBe("https\\://a.b\\#c\\=d\\!e");
 	});
 
-	test("escapes a leading space and control characters", () => {
+	it("escapes a leading space and control characters", () => {
 		expect(escapeJavaProperty(" a\tb\\c")).toBe("\\ a\\tb\\\\c");
 	});
 
-	test("round trips astral characters", () => {
+	it("round trips astral characters", () => {
 		const value = "hi 🎮";
 
 		expect(unescapeJavaProperty(escapeJavaProperty(value))).toBe(value);
 	});
 
-	test("appends a key the file does not have yet", () => {
+	it("appends a key the file does not have yet", () => {
 		expect(
 			mergeJavaProperties("", {
 				motd: "hello",

package/src/codecs/sourceCfg.test.ts

@@ -1,4 +1,4 @@
-import { describe, expect, test } from "bun:test";
+import { describe, expect, it } from "bun:test";
 import {
 	decodeSourceCfgValue,
 	encodeSourceCfgValue,
@@ -8,21 +8,21 @@ import {
 } from "./sourceCfg";
 
 describe("readSourceCfgEntry", () => {
-	test("splits a key from its value", () => {
+	it("splits a key from its value", () => {
 		expect(readSourceCfgEntry('hostname "serverk"')).toEqual({
 			key: "hostname",
 			value: '"serverk"',
 		});
 	});
 
-	test("accepts a key with no value", () => {
+	it("accepts a key with no value", () => {
 		expect(readSourceCfgEntry("sv_lan")).toEqual({
 			key: "sv_lan",
 			value: "",
 		});
 	});
 
-	test("ignores comments and blank lines", () => {
+	it("ignores comments and blank lines", () => {
 		expect(readSourceCfgEntry("// a comment")).toBeNull();
 		expect(readSourceCfgEntry("# a comment")).toBeNull();
 		expect(readSourceCfgEntry("   ")).toBeNull();
@@ -31,32 +31,32 @@ describe("readSourceCfgEntry", () => {
 });
 
 describe("decodeSourceCfgValue", () => {
-	test("unquotes a string and unescapes it", () => {
+	it("unquotes a string and unescapes it", () => {
 		expect(decodeSourceCfgValue('"a \\"b\\" c"')).toBe('a "b" c');
 	});
 
-	test("reads booleans and numbers", () => {
+	it("reads booleans and numbers", () => {
 		expect(decodeSourceCfgValue("true")).toBe(true);
 		expect(decodeSourceCfgValue("false")).toBe(false);
 		expect(decodeSourceCfgValue("42")).toBe(42);
 		expect(decodeSourceCfgValue("-1.5")).toBe(-1.5);
 	});
 
-	test("leaves a bare word alone", () => {
+	it("leaves a bare word alone", () => {
 		expect(decodeSourceCfgValue("de_dust2")).toBe("de_dust2");
 	});
 });
 
 describe("encodeSourceCfgValue", () => {
-	test("quotes and escapes text", () => {
+	it("quotes and escapes text", () => {
 		expect(encodeSourceCfgValue('a "b"')).toBe('"a \\"b\\""');
 	});
 
-	test("flattens newlines", () => {
+	it("flattens newlines", () => {
 		expect(encodeSourceCfgValue("a\nb")).toBe('"a b"');
 	});
 
-	test("writes booleans and numbers bare", () => {
+	it("writes booleans and numbers bare", () => {
 		expect(encodeSourceCfgValue(true)).toBe("true");
 		expect(encodeSourceCfgValue(7)).toBe("7");
 		expect(encodeSourceCfgValue(null)).toBe('""');
@@ -64,7 +64,7 @@ describe("encodeSourceCfgValue", () => {
 });
 
 describe("parseSourceCfg", () => {
-	test("reads a source cfg file", () => {
+	it("reads a source cfg file", () => {
 		expect(parseSourceCfg('// header\nhostname "serverk"\nsv_maxplayers 24\nsv_cheats false\n')).toEqual({
 			hostname: "serverk",
 			sv_maxplayers: 24,
@@ -74,7 +74,7 @@ describe("parseSourceCfg", () => {
 });
 
 describe("mergeSourceCfg", () => {
-	test("rewrites a value and keeps the comments", () => {
+	it("rewrites a value and keeps the comments", () => {
 		expect(
 			mergeSourceCfg('// header\nhostname "old"\nsv_maxplayers 24\n', {
 				hostname: "new",
@@ -82,7 +82,7 @@ describe("mergeSourceCfg", () => {
 		).toBe('// header\nhostname "new"\nsv_maxplayers 24\n');
 	});
 
-	test("appends an unknown key", () => {
+	it("appends an unknown key", () => {
 		expect(
 			mergeSourceCfg('hostname "x"\n', {
 				rcon_password: "abc",
@@ -90,7 +90,7 @@ describe("mergeSourceCfg", () => {
 		).toBe('hostname "x"\nrcon_password "abc"\n');
 	});
 
-	test("collapses a repeated key it rewrites", () => {
+	it("collapses a repeated key it rewrites", () => {
 		expect(
 			mergeSourceCfg("map de_dust2\nmap de_nuke\n", {
 				map: "de_inferno",

package/src/codecs/xmlProperties.test.ts

@@ -1,4 +1,4 @@
-import { describe, expect, test } from "bun:test";
+import { describe, expect, it } from "bun:test";
 import { mergeXmlProperties, parseXmlProperties } from "./xmlProperties";
 
 const SAMPLE = [
@@ -13,7 +13,7 @@ const SAMPLE = [
 ].join("\n");
 
 describe("parseXmlProperties", () => {
-	test("reads every property whichever way the attributes are ordered", () => {
+	it("reads every property whichever way the attributes are ordered", () => {
 		expect(parseXmlProperties(SAMPLE)).toEqual({
 			ServerName: "serverk",
 			ServerPort: "26900",
@@ -21,25 +21,25 @@ describe("parseXmlProperties", () => {
 		});
 	});
 
-	test("decodes entities", () => {
+	it("decodes entities", () => {
 		expect(parseXmlProperties('<property name="ServerName" value="a &amp; b &lt;c&gt;"/>')).toEqual({
 			ServerName: "a & b <c>",
 		});
 	});
 
-	test("accepts single quoted attributes and an empty value", () => {
+	it("accepts single quoted attributes and an empty value", () => {
 		expect(parseXmlProperties("<property name='ServerPassword' value=''/>")).toEqual({
 			ServerPassword: "",
 		});
 	});
 
-	test("ignores everything that is not a property", () => {
+	it("ignores everything that is not a property", () => {
 		expect(parseXmlProperties('<ServerSettings>\n<other name="x" value="1"/>\n</ServerSettings>')).toEqual({});
 	});
 });
 
 describe("mergeXmlProperties", () => {
-	test("rewrites a value in place and keeps order, comments and the header", () => {
+	it("rewrites a value in place and keeps order, comments and the header", () => {
 		expect(
 			mergeXmlProperties(SAMPLE, {
 				ServerPort: "26950",
@@ -58,7 +58,7 @@ describe("mergeXmlProperties", () => {
 		);
 	});
 
-	test("rewrites a property whose value attribute comes first", () => {
+	it("rewrites a property whose value attribute comes first", () => {
 		expect(
 			mergeXmlProperties(SAMPLE, {
 				ServerMaxPlayerCount: "16",
@@ -66,7 +66,7 @@ describe("mergeXmlProperties", () => {
 		).toContain('<property value="16" name="ServerMaxPlayerCount"/>');
 	});
 
-	test("adds an unknown property before the closing tag with the same indent", () => {
+	it("adds an unknown property before the closing tag with the same indent", () => {
 		expect(
 			mergeXmlProperties(SAMPLE, {
 				ServerPassword: "1234",
@@ -86,7 +86,7 @@ describe("mergeXmlProperties", () => {
 		);
 	});
 
-	test("escapes a value it writes", () => {
+	it("escapes a value it writes", () => {
 		expect(
 			mergeXmlProperties(SAMPLE, {
 				ServerName: 'a & b "c"',
@@ -94,7 +94,7 @@ describe("mergeXmlProperties", () => {
 		).toContain('<property name="ServerName" value="a &amp; b &quot;c&quot;"/>');
 	});
 
-	test("adds a value attribute to a property that has none", () => {
+	it("adds a value attribute to a property that has none", () => {
 		expect(
 			mergeXmlProperties('<property name="ServerName"/>', {
 				ServerName: "x",

package/src/core/bridgePort.test.ts

@@ -1,8 +1,8 @@
-import { describe, expect, test } from "bun:test";
+import { describe, expect, it } from "bun:test";
 import { PortProtocol, portCountOf, SOCKET_PROTOCOLS, socketProtocolsOf } from "./bridgePort";
 
 describe("socketProtocolsOf", () => {
-	test("keeps a single socket protocol as it is", () => {
+	it("keeps a single socket protocol as it is", () => {
 		expect(socketProtocolsOf(PortProtocol.Tcp)).toEqual([
 			PortProtocol.Tcp,
 		]);
@@ -11,14 +11,14 @@ describe("socketProtocolsOf", () => {
 		]);
 	});
 
-	test("expands a pair into both socket protocols", () => {
+	it("expands a pair into both socket protocols", () => {
 		expect(socketProtocolsOf(PortProtocol.TcpUdp)).toEqual([
 			PortProtocol.Tcp,
 			PortProtocol.Udp,
 		]);
 	});
 
-	test("never hands out the shared list itself", () => {
+	it("never hands out the shared list itself", () => {
 		const expanded = socketProtocolsOf(PortProtocol.TcpUdp);
 
 		expanded.pop();
@@ -31,11 +31,11 @@ describe("socketProtocolsOf", () => {
 });
 
 describe("portCountOf", () => {
-	test("reads a port stored before blocks existed as a single port", () => {
+	it("reads a port stored before blocks existed as a single port", () => {
 		expect(portCountOf({})).toBe(1);
 	});
 
-	test("reads the count of a block", () => {
+	it("reads the count of a block", () => {
 		expect(
 			portCountOf({
 				count: 32,

package/src/core/bridgeUserError.test.ts

@@ -1,4 +1,4 @@
-import { describe, expect, test } from "bun:test";
+import { describe, expect, it } from "bun:test";
 import { Bridge } from "../modules";
 import { BridgeUserError } from "./bridgeUserError";
 
@@ -8,7 +8,7 @@ describe("BridgeUserError", () => {
 		en: "this is not a file we are waiting for",
 	};
 
-	test("reads as english in a log line and keeps both languages for the player", () => {
+	it("reads as english in a log line and keeps both languages for the player", () => {
 		const error = new BridgeUserError(text);
 
 		expect(error).toBeInstanceOf(Error);
@@ -17,7 +17,7 @@ describe("BridgeUserError", () => {
 		expect(error.text).toEqual(text);
 	});
 
-	test("keeps the cause a driver attaches for the staff log", () => {
+	it("keeps the cause a driver attaches for the staff log", () => {
 		const cause = new Error("cdn.modrinth.com answered 404");
 		const error = new BridgeUserError(text, {
 			cause,
@@ -27,7 +27,7 @@ describe("BridgeUserError", () => {
 		expect(error.message).toBe(text.en);
 	});
 
-	test("is the class a driver reaches through the published namespace", () => {
+	it("is the class a driver reaches through the published namespace", () => {
 		expect(new Bridge.UserError(text)).toBeInstanceOf(BridgeUserError);
 	});
 });

package/src/core/bridgeValue.test.ts

@@ -1,9 +1,9 @@
-import { describe, expect, test } from "bun:test";
+import { describe, expect, it } from "bun:test";
 import type { BridgeRow } from "./bridgeValue";
 import { isLocalizedText } from "./bridgeValue";
 
 describe("isLocalizedText", () => {
-	test("recognises the shape a driver authors copy in", () => {
+	it("recognises the shape a driver authors copy in", () => {
 		expect(
 			isLocalizedText({
 				ar: "التركيب",
@@ -12,7 +12,7 @@ describe("isLocalizedText", () => {
 		).toBe(true);
 	});
 
-	test("leaves every other bridge value alone", () => {
+	it("leaves every other bridge value alone", () => {
 		expect(isLocalizedText("Hytale")).toBe(false);
 		expect(isLocalizedText(12)).toBe(false);
 		expect(isLocalizedText(true)).toBe(false);
@@ -20,7 +20,7 @@ describe("isLocalizedText", () => {
 		expect(isLocalizedText(undefined)).toBe(false);
 	});
 
-	test("refuses a half-written text rather than rendering an empty language", () => {
+	it("refuses a half-written text rather than rendering an empty language", () => {
 		expect(
 			isLocalizedText({
 				en: "Setup",
@@ -30,7 +30,7 @@ describe("isLocalizedText", () => {
 });
 
 describe("BridgeRow", () => {
-	test('carries a localized cell beside its scalars so a driver never writes "English / عربي" into one string', () => {
+	it('carries a localized cell beside its scalars so a driver never writes "English / عربي" into one string', () => {
 		const row: BridgeRow = {
 			id: "u-1",
 			kills: 12,

package/src/core/describeDownloadFailure.test.ts

@@ -1,4 +1,4 @@
-import { describe, expect, test } from "bun:test";
+import { describe, expect, it } from "bun:test";
 import { BridgeDownloadError } from "./bridgeDownloadError";
 import { BridgeNetError } from "./bridgeNetError";
 import { describeDownloadFailure } from "./describeDownloadFailure";
@@ -6,7 +6,7 @@ import { describeDownloadFailure } from "./describeDownloadFailure";
 const SUBJECT = "All the Mods 9";
 
 describe("describeDownloadFailure", () => {
-	test("says the file is gone for 404 and 410", () => {
+	it("says the file is gone for 404 and 410", () => {
 		for (const status of [
 			404,
 			410,
@@ -17,39 +17,39 @@ describe("describeDownloadFailure", () => {
 		}
 	});
 
-	test("says the source refused for 401 and 403", () => {
+	it("says the source refused for 401 and 403", () => {
 		expect(describeDownloadFailure(new BridgeNetError(403, "forbidden"), SUBJECT).en).toBe(
 			"The source refused the download of All the Mods 9.",
 		);
 		expect(describeDownloadFailure(new BridgeDownloadError(401, "unauthorized"), SUBJECT).ar).toBe(
-			"المصدر رفض تنزيل All the Mods 9.",
+			"رفض المصدر تنزيل All the Mods 9.",
 		);
 	});
 
-	test("says the source is busy for 429", () => {
+	it("says the source is busy for 429", () => {
 		expect(describeDownloadFailure(new BridgeDownloadError(429, "slow down"), SUBJECT).en).toContain("busy");
 	});
 
-	test("says the source is down for a 5xx", () => {
+	it("says the source is down for a 5xx", () => {
 		expect(describeDownloadFailure(new BridgeNetError(503, "unavailable"), SUBJECT).en).toBe(
-			"The source of All the Mods 9 is down right now. Try again in a bit.",
+			"The source of All the Mods 9 is down right now. Try again in a moment.",
 		);
 	});
 
-	test("says the source could not be reached when there is no status", () => {
+	it("says the source could not be reached when there is no status", () => {
 		expect(describeDownloadFailure(new BridgeDownloadError(null, "ECONNRESET"), SUBJECT).en).toBe(
-			"We could not reach the source to download All the Mods 9. Try again.",
+			"We couldn't reach the source to download All the Mods 9. Try again.",
 		);
 	});
 
-	test("falls back to a plain download failure for anything else", () => {
-		const generic = "We could not download All the Mods 9. Try again.";
+	it("falls back to a plain download failure for anything else", () => {
+		const generic = "We couldn't download All the Mods 9. Try again.";
 
 		expect(describeDownloadFailure(new BridgeDownloadError(400, "bad request"), SUBJECT).en).toBe(generic);
 		expect(describeDownloadFailure(new Error("digest mismatch"), SUBJECT).en).toBe(generic);
 	});
 
-	test("always writes both languages", () => {
+	it("always writes both languages", () => {
 		const text = describeDownloadFailure(new BridgeDownloadError(500, "boom"), SUBJECT);
 
 		expect(text.ar.length).toBeGreaterThan(0);

package/src/core/describeDownloadFailure.ts

@@ -29,41 +29,41 @@ export const describeDownloadFailure = (error: unknown, subject: string): Locali
 
 	if (status === null) {
 		return {
-			ar: `ما قدرنا نوصل للمصدر عشان ننزّل ${subject}. جرّب مرة ثانية.`,
-			en: `We could not reach the source to download ${subject}. Try again.`,
+			ar: `تعذّر الوصول إلى المصدر لتنزيل ${subject}، جرب مرة ثانية.`,
+			en: `We couldn't reach the source to download ${subject}. Try again.`,
 		};
 	}
 
 	if (status !== undefined && REMOVED_STATUSES.includes(status)) {
 		return {
-			ar: `${subject} ما عاد موجود عند المصدر.`,
+			ar: `${subject} لم يعد متوفرًا لدى المصدر.`,
 			en: `${subject} is no longer available from its source.`,
 		};
 	}
 
 	if (status !== undefined && REFUSED_STATUSES.includes(status)) {
 		return {
-			ar: `المصدر رفض تنزيل ${subject}.`,
+			ar: `رفض المصدر تنزيل ${subject}.`,
 			en: `The source refused the download of ${subject}.`,
 		};
 	}
 
 	if (status === BUSY_STATUS) {
 		return {
-			ar: `المصدر مشغول الحين وما قدرنا ننزّل ${subject}. جرّب بعد شوي.`,
-			en: `The source is busy right now, so we could not download ${subject}. Try again in a bit.`,
+			ar: `المصدر مشغول حاليًا وتعذّر تنزيل ${subject}، عطه لحظة وجرب مرة ثانية.`,
+			en: `The source is busy right now, so we couldn't download ${subject}. Give it a moment and try again.`,
 		};
 	}
 
 	if (status !== undefined && status >= SERVER_ERROR_STATUS) {
 		return {
-			ar: `مصدر ${subject} فيه عطل الحين. جرّب بعد شوي.`,
-			en: `The source of ${subject} is down right now. Try again in a bit.`,
+			ar: `يواجه مصدر ${subject} عطلًا حاليًا، جرب مرة ثانية بعد لحظة.`,
+			en: `The source of ${subject} is down right now. Try again in a moment.`,
 		};
 	}
 
 	return {
-		ar: `ما قدرنا ننزّل ${subject}. جرّب مرة ثانية.`,
-		en: `We could not download ${subject}. Try again.`,
+		ar: `تعذّر تنزيل ${subject}، جرب مرة ثانية.`,
+		en: `We couldn't download ${subject}. Try again.`,
 	};
 };