@serverkgg/bridge 0.1.6 → 0.1.8

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@serverkgg/bridge",
-	"version": "0.1.6",
+	"version": "0.1.8",
 	"description": "Serverk game bridge and driver runtime, wire protocol, manifest schema, and maintainer CLI",
 	"homepage": "https://serverk.gg",
 	"license": "SEE LICENSE IN LICENSE.md",

package/rules/package.md

@@ -51,6 +51,7 @@ One Serverk package (a game or a bot runtime) on `@serverkgg/bridge`, with no pi
 - Write `ar:` before `en:` in every localized field.
 - `secrets` are platform API keys the game can use, `required: false`; customer settings are a panel form, and a bot customer's own values go through `environment.vault`.
 - Change an outcome by changing the declared value (`reset.keep: []`, `backup.only`), never by asking the platform to ignore a field.
+- `files.protected` holds only `.serverk` paths: the stamp, sidecars, journals and driver scratch under `.serverk-staging/`. Never a drop point under `.serverk-uploads/`, a `files.notable` match, an `@[open](files:…)` target or a folder the customer collects a file from; `serverk-bridge validate` fails each but the last, a runtime path.
 
 ## Guides and image
 

package/src/bot/botCauses.test.ts

@@ -13,6 +13,10 @@ const CASES: readonly {
 		line: "Error [TokenInvalid]: An invalid token was provided.",
 		cause: BridgeCrashCause.TokenInvalid,
 	},
+	{
+		line: "Error [TOKEN_INVALID]: An invalid token was provided.",
+		cause: BridgeCrashCause.TokenInvalid,
+	},
 	{
 		line: "discord.errors.LoginFailure: Improper token has been passed.",
 		cause: BridgeCrashCause.TokenInvalid,
@@ -45,6 +49,38 @@ const CASES: readonly {
 		line: "pyrogram.errors.exceptions.bad_request_400.AccessTokenExpired: Telegram says: [400 ACCESS_TOKEN_EXPIRED] - The bot token has expired",
 		cause: BridgeCrashCause.TokenInvalid,
 	},
+	{
+		line: "TypeError: expected token to be a str, received NoneType instead",
+		cause: BridgeCrashCause.TokenInvalid,
+	},
+	{
+		line: "TypeError: expected token to be a str, received <class 'NoneType'> instead",
+		cause: BridgeCrashCause.TokenInvalid,
+	},
+	{
+		line: "TypeError: token must be of type str, not NoneType",
+		cause: BridgeCrashCause.TokenInvalid,
+	},
+	{
+		line: "TypeError: token must be of type str, got NoneType instead",
+		cause: BridgeCrashCause.TokenInvalid,
+	},
+	{
+		line: "TypeError: The token provided was of type <class 'NoneType'> but was expected to be str",
+		cause: BridgeCrashCause.TokenInvalid,
+	},
+	{
+		line: "Error: Empty token!",
+		cause: BridgeCrashCause.TokenInvalid,
+	},
+	{
+		line: "aiogram.utils.token.TokenValidationError: Token is invalid!",
+		cause: BridgeCrashCause.TokenInvalid,
+	},
+	{
+		line: "aiogram.utils.token.TokenValidationError: Token is invalid! It must be 'str' type instead of <class 'NoneType'> type.",
+		cause: BridgeCrashCause.TokenInvalid,
+	},
 	{
 		line: "Error: Used disallowed intents",
 		cause: BridgeCrashCause.IntentsDisallowed,
@@ -53,6 +89,10 @@ const CASES: readonly {
 		line: "Error [DisallowedIntents]: Privileged intent provided is not enabled or whitelisted.",
 		cause: BridgeCrashCause.IntentsDisallowed,
 	},
+	{
+		line: "Error [DISALLOWED_INTENTS]: Privileged intent provided is not enabled or whitelisted.",
+		cause: BridgeCrashCause.IntentsDisallowed,
+	},
 	{
 		line: "discord.errors.PrivilegedIntentsRequired: Shard ID None is requesting privileged intents that have not been explicitly enabled in the developer portal.",
 		cause: BridgeCrashCause.IntentsDisallowed,
@@ -265,6 +305,14 @@ describe("BOT_CRASH_EVIDENCE", () => {
 		expect(ring.crash(recordOf())).toBe(BridgeCrashCause.Unknown);
 	});
 
+	it("leaves a TypeError about something other than the token unexplained", () => {
+		const { ring, print } = botRing();
+
+		print("TypeError: expected str, bytes or os.PathLike object, not NoneType");
+
+		expect(ring.crash(recordOf())).toBe(BridgeCrashCause.Unknown);
+	});
+
 	it("calls exit 137 out of memory only when the record carries the flag", () => {
 		const unflagged = botRing();
 

package/src/bot/botCauses.ts

@@ -13,7 +13,13 @@ export const BOT_CRASH_EVIDENCE: readonly BridgeEventPattern[] = [
 		emit: BridgeEventName.TokenInvalid,
 	},
 	{
-		match: /Used disallowed intents|\[DisallowedIntents\]|PrivilegedIntentsRequired|close code:? 4014\b/,
+		match:
+			/TypeError: (?:expected token to be a str, received|token must be of type str, (?:not|got) |The token provided was of type .+ but was expected to be str)|\bError: Empty token!|TokenValidationError: Token is invalid!/,
+		emit: BridgeEventName.TokenInvalid,
+	},
+	{
+		match:
+			/Used disallowed intents|\[DisallowedIntents\]|Privileged intent provided is not enabled or whitelisted|PrivilegedIntentsRequired|close code:? 4014\b/,
 		emit: BridgeEventName.IntentsDisallowed,
 	},
 	{

package/src/bot/detect/corpus/anidiotsguide-guidebot.json

@@ -18,6 +18,7 @@
 		"yarn.lock"
 	],
 	"contents": {
+		".env-example": "DISCORD_TOKEN=\nOWNER=",
 		"package.json": "{\n  \"name\": \"guidebot\",\n  \"version\": \"2.1.0\",\n  \"description\": \"A boilerplate example bot with command handler and reloadable commands. Updated and Maintained by the Idiot's Guide Community\",\n  \"main\": \"index.js\",\n  \"scripts\": {\n    \"start\": \"node index.js\"\n  },\n  \"engines\": {\n    \"node\": \">=16\"\n  },\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/AnIdiotsGuide/guidebot.git\"\n  },\n  \"author\": \"Evelyne Lachance <eslachance@gmail.com> (http://evie.codes)\",\n  \"contributors\": [\n    \"York (http://anidiots.guide)\"\n  ],\n  \"license\": \"MIT\",\n  \"bugs\": {\n    \"url\": \"https://github.com/AnIdiotsGuide/guidebot/issues\"\n  },\n  \"homepage\": \"https://github.com/AnIdiotsGuide/guidebot#readme\",\n  \"dependencies\": {\n    \"@discordjs/builders\": \"^0.2.0\",\n    \"@sapphire/time-utilities\": \"^1.3.8\",\n    \"colorette\": \"^1.3.0\",\n    \"discord.js\": \"^13.0.1\",\n    \"dotenv\": \"^10.0.0\",\n    \"enmap\": \"^5.8.5\"\n  },\n  \"devDependencies\": {\n    \"eslint\": \"^7.30.0\",\n    \"eslint-config-airbnb-base\": \"^14.2.1\",\n    \"eslint-config-standard\": \"^16.0.3\",\n    \"eslint-plugin-import\": \"^2.23.4\",\n    \"eslint-plugin-node\": \"^11.1.0\",\n    \"eslint-plugin-promise\": \"^5.1.0\"\n  }\n}\n"
 	},
 	"expected": {
@@ -30,7 +31,7 @@
 		"start": "node index.js",
 		"nodeVersion": "16",
 		"pythonVersion": null,
-		"tokenKey": null,
+		"tokenKey": "DISCORD_TOKEN",
 		"warnings": []
 	}
 }

package/src/bot/detect/corpus/latand-tgbot_template_v3.json

@@ -17,6 +17,7 @@
 		"requirements.txt"
 	],
 	"contents": {
+		".env.dist": "BOT_TOKEN=123456:Your-TokEn_ExaMple\nADMINS=123456,654321\nUSE_REDIS=False\n\n#POSTGRES_USER=someusername\n#POSTGRES_PASSWORD=postgres_pass12345\n#POSTGRES_DB=bot\n#DB_HOST=pg_database\n\n# REDIS_HOST=redis_cache\n# REDIS_PORT=6388\n# REDIS_DB=1\n# REDIS_PASSWORD=someredispass\n\n\n#WEBHOOK_EXPOSE=8001\n#WEBHOOK_APP_NAME=webhook\n",
 		"requirements.txt": "aiogram~=3.0\nenvirons~=9.0\nredis\nbetterlogging\n\n# # For enabling api:\n# backoff\n# ujson\n# yarl\n\n# # For PostgreSQL sqlalchemy + alembic:\n# sqlalchemy~=2.0\n# alembic~=1.0\n# asyncpg\n"
 	},
 	"expected": {
@@ -29,7 +30,7 @@
 		"start": "python bot.py",
 		"nodeVersion": null,
 		"pythonVersion": null,
-		"tokenKey": null,
+		"tokenKey": "BOT_TOKEN",
 		"warnings": [
 			"unpinned-requirements"
 		]

package/src/bot/detect/corpus/nezdemkovski-telegram-bot-boilerplate.json

@@ -21,6 +21,7 @@
 		"tsconfig.json"
 	],
 	"contents": {
+		".env-sample": "BOT_TOKEN=\"\"\nUSERNAME=\"\"\nWEBHOOK_URL=\"\"\nPORT=\"3000\"\nNODE_ENV=\"development\"\n",
 		"package.json": "{\n  \"name\": \"telegram-bot-boilerplate\",\n  \"version\": \"1.0.0\",\n  \"description\": \"Telegram Bot Boilerplate\",\n  \"author\": \"Yuri Nezdemkovski <yuri@nezdemkovski.com> (https://nezdemkovski.com/)\",\n  \"homepage\": \"https://github.com/nezdemkovski/telegram-bot-boilerplate\",\n  \"license\": \"MIT\",\n  \"engines\": {\n    \"bun\": \">=1\"\n  },\n  \"dependencies\": {\n    \"grammy\": \"^1.40.0\"\n  },\n  \"devDependencies\": {\n    \"bun-types\": \"1.3.9\",\n    \"eslint\": \"^10.0.1\",\n    \"eslint-config-prettier\": \"^10.1.8\",\n    \"prettier\": \"^3.8.1\",\n    \"typescript\": \"^5.9.3\",\n    \"typescript-eslint\": \"^8.56.0\"\n  },\n  \"scripts\": {\n    \"dev\": \"bun --watch src/index.ts\",\n    \"build\": \"bun build src/index.ts --outdir dist --target bun --minify\",\n    \"start\": \"NODE_ENV=production bun dist/index.js\",\n    \"typecheck\": \"tsc --noEmit\",\n    \"lint\": \"eslint src\",\n    \"format\": \"prettier --write 'src/**/*.ts'\"\n  }\n}\n"
 	},
 	"expected": {
@@ -33,7 +34,7 @@
 		"start": "NODE_ENV=production bun dist/index.js",
 		"nodeVersion": null,
 		"pythonVersion": null,
-		"tokenKey": null,
+		"tokenKey": "BOT_TOKEN",
 		"warnings": []
 	}
 }

package/src/bot/detect/detect.test.ts

@@ -813,6 +813,45 @@ describe("detect env suggestions", () => {
 		]);
 	});
 
+	const CASES: readonly {
+		file: string;
+	}[] = [
+		{
+			file: ".env-example",
+		},
+		{
+			file: ".env-sample",
+		},
+		{
+			file: ".env.dist",
+		},
+	];
+
+	for (const item of CASES) {
+		it(`reads ${item.file} the way it reads .env.example`, () => {
+			const result = project({
+				"package.json": "{}",
+				[item.file]: "DISCORD_TOKEN=\nOWNER=\n",
+			});
+
+			expect(result.env).toEqual([
+				{
+					key: "DISCORD_TOKEN",
+					sensitive: true,
+					source: item.file,
+					example: null,
+				},
+				{
+					key: "OWNER",
+					sensitive: false,
+					source: item.file,
+					example: null,
+				},
+			]);
+			expect(result.tokenKey).toBe("DISCORD_TOKEN");
+		});
+	}
+
 	it("suggests the keys of a skipped .env after the example files, never its values", () => {
 		const result = detect({
 			files: [

package/src/bot/detect/envExample.test.ts

@@ -57,6 +57,14 @@ describe("isSecretEnvFile", () => {
 			name: ".env.template",
 			secret: false,
 		},
+		{
+			name: ".env-example",
+			secret: false,
+		},
+		{
+			name: ".env-sample",
+			secret: false,
+		},
 		{
 			name: ".env.dist",
 			secret: false,

package/src/bot/detect/envExample.ts

@@ -4,11 +4,13 @@ export const ENV_EXAMPLE_FILES: readonly string[] = [
 	".env.example",
 	".env.sample",
 	".env.template",
+	".env-example",
+	".env-sample",
+	".env.dist",
 ];
 
 const ENV_TEMPLATE_FILES: ReadonlySet<string> = new Set([
 	...ENV_EXAMPLE_FILES,
-	".env.dist",
 	".env.defaults",
 ]);
 

package/src/cli/validate.test.ts

@@ -4,9 +4,9 @@ import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { renderDetectTable } from "../bot/detect";
 import { BridgeKind, BridgeSetupStepKind } from "../core";
-import { GuideOpenTab } from "../guides";
-import { MANIFEST_SCHEMA_VERSION, PackageKind } from "../manifest";
-import type { BridgeDriver, BridgeSetupModule } from "../modules";
+import { GuideOpenTab, type GuidePack, type ParsedBlock, type ParsedLeafBlock } from "../guides";
+import { MANIFEST_SCHEMA_VERSION, PackageKind, type RunnableManifest } from "../manifest";
+import type { BridgeDriver, BridgePendingModule, BridgeSetupModule } from "../modules";
 import {
 	type BridgeCatalogSection,
 	BridgeConfirm,
@@ -23,9 +23,13 @@ import { RULES_FILE, readShippedRules, writeRules } from "./rules";
 import {
 	availabilityReportLines,
 	confirmReportLines,
+	notableReportLines,
+	openTargetReportLines,
 	placementReportLines,
+	protectedNameReportLines,
 	runValidate,
 	setupReportLines,
+	uploadStagingReportLines,
 } from "./validate";
 
 const text = (value: string) => ({
@@ -822,3 +826,425 @@ describe("the confirm report", () => {
 		).toEqual([]);
 	});
 });
+
+const manifestWith = (rules: string[], notes: string[] = []) => {
+	return {
+		files: {
+			protected: rules,
+			notable: notes.map((match) => ({
+				match,
+			})),
+		},
+	} as unknown as RunnableManifest;
+};
+
+const worldsWith = (staging: string): BridgeTableSection => ({
+	layout: BridgeLayout.Table,
+	id: "worlds",
+	module: "worlds",
+	columns: [
+		{
+			key: "name",
+			label: text("Name"),
+		},
+	],
+	upload: {
+		label: text("Upload a world"),
+		extensions: [
+			"zip",
+		],
+		staging,
+	},
+});
+
+const pendingWith = (staging: string): BridgePendingModule => ({
+	kind: BridgeKind.Pending,
+	staging,
+	extensions: [
+		"jar",
+	],
+	list: async () => [],
+	add: async () => {
+		return;
+	},
+});
+
+const driverWith = (
+	sections: BridgeTab["sections"],
+	pending?: BridgePendingModule,
+	setup?: BridgeSetupModule,
+): BridgeDriver => ({
+	install: {
+		kind: BridgeKind.Install,
+		run: async () => {
+			return;
+		},
+	},
+	lifecycle: {
+		kind: BridgeKind.Lifecycle,
+		command: async () => [
+			"run",
+		],
+	},
+	pending,
+	setup,
+	panel: {
+		tabs: [
+			{
+				id: "worlds",
+				title: text("Worlds"),
+				sections,
+			},
+		],
+	},
+});
+
+const packWith = (blocks: ParsedBlock[]): GuidePack => ({
+	drafts: [
+		{
+			id: "getting-started",
+			title: text("Getting started"),
+			summary: text("Start here"),
+			tags: [],
+			surfaces: [],
+			videoId: null,
+			body: {
+				ar: blocks,
+				en: blocks,
+			},
+		},
+	],
+	files: [],
+	images: [],
+	commands: [],
+});
+
+const filesOpenWith = (path: string | null): ParsedLeafBlock => ({
+	type: "open",
+	target: {
+		tab: GuideOpenTab.Files,
+		path,
+	},
+});
+
+const SERVERK_RULES = [
+	".serverk-install.json",
+	".serverk/**",
+	"plugins/.serverk-catalog.json",
+	".serverk-staging/**",
+	".serverk-wipe",
+	"Server/mods/.serverk-mods.json",
+];
+
+const FOREIGN_RULES = [
+	"bedrock_server",
+	"*.so",
+	"worlds/*/db/**",
+	"config",
+	".serverkfoo",
+];
+
+const JAVA_RULES = [
+	".serverk-install.json",
+	".serverk-crashscan.json",
+	".serverk-companions.json",
+	".serverk-modpack.json",
+	"plugins/.serverk-catalog.json",
+	"mods/.serverk-catalog.json",
+];
+
+describe("protectedNameReportLines", () => {
+	it("passes rules that each name a .serverk path", () => {
+		expect(protectedNameReportLines(manifestWith(SERVERK_RULES))).toEqual([]);
+	});
+
+	for (const rule of FOREIGN_RULES) {
+		it(`fails "${rule}", which names no .serverk path`, () => {
+			expect(
+				protectedNameReportLines(
+					manifestWith([
+						".serverk-install.json",
+						rule,
+					]),
+				),
+			).toEqual([
+				`  error: files.protected "${rule}" is not a .serverk path — a package protects only platform state, so drop the rule or move the file under a .serverk name`,
+			]);
+		});
+	}
+});
+
+describe("uploadStagingReportLines", () => {
+	it("fails a section upload that stages under a protected folder", () => {
+		const manifest = manifestWith([
+			".serverk-download/**",
+			".serverk-worlds/**",
+		]);
+
+		expect(
+			uploadStagingReportLines(
+				manifest,
+				driverWith([
+					worldsWith(".serverk-worlds"),
+				]),
+			),
+		).toEqual([
+			'  error: upload staging ".serverk-worlds" of tab "worlds" section "worlds" is protected by ".serverk-worlds/**" — a protected path refuses the customer\'s upload, so take the folder off `files.protected`',
+		]);
+	});
+
+	it("fails a pending upload that stages under a protected folder", () => {
+		const manifest = manifestWith([
+			".serverk-staging",
+		]);
+
+		expect(uploadStagingReportLines(manifest, driverWith([], pendingWith(".serverk-staging/pending-upload")))).toEqual([
+			'  error: upload staging ".serverk-staging/pending-upload" of the pending upload is protected by ".serverk-staging" — a protected path refuses the customer\'s upload, so take the folder off `files.protected`',
+		]);
+	});
+
+	it("passes when no protected rule reaches an upload staging folder", () => {
+		const manifest = manifestWith([
+			".serverk-download/**",
+			".serverk-install.json",
+			".serverk-staging/install/**",
+			"*.json",
+		]);
+
+		expect(
+			uploadStagingReportLines(
+				manifest,
+				driverWith(
+					[
+						worldsWith(".serverk-staging/world-upload"),
+					],
+					pendingWith(".serverk-staging/pending-upload"),
+				),
+			),
+		).toEqual([]);
+	});
+
+	it("passes an upload staging folder that sits beside a protected sibling", () => {
+		const manifest = manifestWith([
+			".serverk-staging/**",
+		]);
+
+		expect(
+			uploadStagingReportLines(
+				manifest,
+				driverWith([
+					worldsWith(".serverk-uploads/world"),
+				]),
+			),
+		).toEqual([]);
+	});
+
+	it("passes a staging folder that merely holds a protected sidecar", () => {
+		const manifest = manifestWith([
+			".serverk-staging/install/**",
+		]);
+
+		expect(
+			uploadStagingReportLines(
+				manifest,
+				driverWith([
+					worldsWith(".serverk-staging"),
+				]),
+			),
+		).toEqual([]);
+	});
+});
+
+describe("notableReportLines", () => {
+	it("fails a note on a protected file", () => {
+		const manifest = manifestWith(
+			[
+				".serverk-install.json",
+			],
+			[
+				".serverk-install.json",
+			],
+		);
+
+		expect(notableReportLines(manifest)).toEqual([
+			'  error: files.notable ".serverk-install.json" is protected by ".serverk-install.json" — the file manager hides a protected path before it annotates it, so the note never shows; take one of the two off',
+		]);
+	});
+
+	it("fails a note on a file inside a protected folder", () => {
+		const manifest = manifestWith(
+			[
+				".serverk/**",
+			],
+			[
+				".serverk/install.json",
+			],
+		);
+
+		expect(notableReportLines(manifest)).toEqual([
+			'  error: files.notable ".serverk/install.json" is protected by ".serverk/**" — the file manager hides a protected path before it annotates it, so the note never shows; take one of the two off',
+		]);
+	});
+
+	it("fails a wildcard note under a protected folder", () => {
+		const manifest = manifestWith(
+			[
+				".serverk-staging",
+			],
+			[
+				".serverk-staging/**",
+			],
+		);
+
+		expect(notableReportLines(manifest)).toEqual([
+			'  error: files.notable ".serverk-staging/**" is protected by ".serverk-staging" — the file manager hides a protected path before it annotates it, so the note never shows; take one of the two off',
+		]);
+	});
+
+	it("passes notes on folders that merely hold protected sidecars", () => {
+		const manifest = manifestWith(JAVA_RULES, [
+			"plugins",
+			"mods",
+			"world/**",
+			"*.json",
+		]);
+
+		expect(notableReportLines(manifest)).toEqual([]);
+	});
+});
+
+describe("openTargetReportLines", () => {
+	it("fails a guide link that opens a protected file", () => {
+		const manifest = manifestWith([
+			".serverk-install.json",
+		]);
+
+		expect(
+			openTargetReportLines(
+				manifest,
+				driverWith([]),
+				packWith([
+					filesOpenWith(".serverk-install.json"),
+				]),
+			),
+		).toEqual([
+			'  error: guide "getting-started" (ar) opens files at ".serverk-install.json", which ".serverk-install.json" protects — the panel refuses a protected path, so the link is dead; point it elsewhere or take the rule off `files.protected`',
+			'  error: guide "getting-started" (en) opens files at ".serverk-install.json", which ".serverk-install.json" protects — the panel refuses a protected path, so the link is dead; point it elsewhere or take the rule off `files.protected`',
+		]);
+	});
+
+	it("fails a guide link inside a conditional block", () => {
+		const manifest = manifestWith([
+			".serverk/**",
+		]);
+
+		expect(
+			openTargetReportLines(
+				manifest,
+				driverWith([]),
+				packWith([
+					{
+						type: "conditional",
+						key: "panel.modded",
+						when: [],
+						otherwise: [
+							filesOpenWith(".serverk/install.json"),
+						],
+					},
+				]),
+			),
+		).toEqual([
+			'  error: guide "getting-started" (ar) opens files at ".serverk/install.json", which ".serverk/**" protects — the panel refuses a protected path, so the link is dead; point it elsewhere or take the rule off `files.protected`',
+			'  error: guide "getting-started" (en) opens files at ".serverk/install.json", which ".serverk/**" protects — the panel refuses a protected path, so the link is dead; point it elsewhere or take the rule off `files.protected`',
+		]);
+	});
+
+	it("fails a setup step that opens a protected folder", () => {
+		const manifest = manifestWith([
+			".serverk-level/**",
+		]);
+
+		const setup: BridgeSetupModule = {
+			kind: BridgeKind.Setup,
+			steps: [
+				{
+					kind: BridgeSetupStepKind.Open,
+					id: "level",
+					title: text("Level"),
+					required: false,
+					target: {
+						tab: GuideOpenTab.Files,
+						path: ".serverk-level",
+					},
+				},
+			],
+			submit: async () => {
+				return;
+			},
+		};
+
+		expect(openTargetReportLines(manifest, driverWith([], undefined, setup), null)).toEqual([
+			'  error: setup step "level" opens files at ".serverk-level", which ".serverk-level/**" protects — the panel refuses a protected path, so the link is dead; point it elsewhere or take the rule off `files.protected`',
+		]);
+	});
+
+	it("passes files links with no path, other tabs and unprotected paths", () => {
+		const manifest = manifestWith([
+			".serverk-install.json",
+			".serverk-staging/**",
+		]);
+
+		const setup: BridgeSetupModule = {
+			kind: BridgeKind.Setup,
+			steps: [
+				{
+					kind: BridgeSetupStepKind.Open,
+					id: "files",
+					title: text("Files"),
+					required: false,
+					target: {
+						tab: GuideOpenTab.Files,
+						path: null,
+					},
+				},
+				{
+					kind: BridgeSetupStepKind.Open,
+					id: "invite",
+					title: text("Invite"),
+					required: false,
+					target: {
+						tab: GuideOpenTab.Access,
+					},
+				},
+			],
+			submit: async () => {
+				return;
+			},
+		};
+
+		expect(
+			openTargetReportLines(
+				manifest,
+				driverWith([], undefined, setup),
+				packWith([
+					filesOpenWith(null),
+					filesOpenWith("server.properties"),
+					filesOpenWith(".serverk-uploads/world"),
+					{
+						type: "open",
+						target: {
+							tab: GuideOpenTab.Panel,
+							tabId: "settings",
+						},
+					},
+					{
+						type: "open",
+						target: {
+							tab: GuideOpenTab.Console,
+						},
+					},
+				]),
+			),
+		).toEqual([]);
+	});
+});