@serverkgg/bridge 0.0.8 → 0.0.9

package/src/wire/panel.test.ts

@@ -8,6 +8,7 @@ import {
 	BridgeKind,
 	BridgeLayout,
 	type BridgeManifest,
+	BridgeUploadMode,
 } from "@serverkgg/bridge/protocol";
 import { bridgeManifestSchema } from "./panel";
 
@@ -283,3 +284,168 @@ describe("the panel mirror", () => {
 		).toBe(false);
 	});
 });
+
+const detailManifest = (): BridgeManifest => ({
+	version: "1.0.0",
+	panel: {
+		tabs: [
+			{
+				id: "version",
+				title: text("Version"),
+				sections: [
+					{
+						layout: BridgeLayout.Form,
+						id: "version",
+						target: BridgeFormTarget.Variables,
+						reinstall: true,
+						fields: [
+							{
+								key: "MC_VERSION",
+								control: BridgeControl.Text,
+								label: text("Version"),
+							},
+						],
+						clears: [
+							{
+								variable: "MODPACK",
+								warning: text("Applying this removes the modpack"),
+							},
+						],
+					},
+					{
+						layout: BridgeLayout.Detail,
+						id: "modpack-status",
+						title: text("Running a modpack"),
+						module: "modpackStatus",
+						reinstall: true,
+						variable: "MODPACK",
+						confirm: BridgeConfirm.Strong,
+						related: {
+							tab: "modpacks",
+							label: text("Browse modpacks"),
+						},
+						actions: [
+							{
+								id: "update",
+								label: text("Update"),
+								confirm: BridgeConfirm.Strong,
+							},
+						],
+					},
+				],
+			},
+		],
+	},
+	terminal: null,
+	modules: [
+		{
+			id: "modpackStatus",
+			kind: BridgeKind.Detail,
+			requiresRunning: false,
+			refreshSeconds: null,
+			pageSize: null,
+			dependsOn: [],
+			actions: [
+				BridgeAction.Read,
+				"update",
+			],
+		},
+	],
+	events: [],
+});
+
+describe("detail sections", () => {
+	test("round-trips a detail section and a clearing form", () => {
+		const source = detailManifest();
+
+		expect(bridgeManifestSchema.parse(source)).toEqual(source);
+	});
+
+	test("refuses a clear whose variable is not an env key", () => {
+		const source = detailManifest();
+		const [form] = source.panel?.tabs[0]?.sections ?? [];
+
+		if (form?.layout !== BridgeLayout.Form) {
+			throw new Error("fixture is missing its form section");
+		}
+
+		form.clears = [
+			{
+				variable: "mod pack",
+				warning: text("Broken"),
+			},
+		];
+
+		expect(bridgeManifestSchema.safeParse(source).success).toBe(false);
+	});
+});
+
+const uploadManifest = (mode?: BridgeUploadMode): BridgeManifest => ({
+	version: "1.0.0",
+	panel: {
+		tabs: [
+			{
+				id: "modpacks",
+				title: text("Modpacks"),
+				sections: [
+					{
+						layout: BridgeLayout.Table,
+						id: "pending",
+						module: "pending",
+						columns: [
+							{
+								key: "name",
+								label: text("Name"),
+							},
+						],
+						upload: {
+							label: text("Upload"),
+							extensions: [
+								"jar",
+							],
+							staging: ".serverk-staging/pending-upload",
+							mode,
+						},
+					},
+				],
+			},
+		],
+	},
+	terminal: null,
+	modules: [
+		{
+			id: "pending",
+			kind: BridgeKind.Collection,
+			requiresRunning: false,
+			refreshSeconds: null,
+			pageSize: null,
+			dependsOn: [],
+			actions: [],
+		},
+	],
+	events: [],
+});
+
+describe("the upload mirror", () => {
+	test("carries the file upload mode through unchanged", () => {
+		const source = uploadManifest(BridgeUploadMode.File);
+		const parsed = bridgeManifestSchema.parse(source);
+		const [section] = parsed.panel?.tabs[0]?.sections ?? [];
+
+		if (section?.layout !== BridgeLayout.Table) {
+			throw new Error("fixture is missing its table section");
+		}
+
+		expect(section.upload?.mode).toBe(BridgeUploadMode.File);
+	});
+
+	test("takes an upload that declares no mode", () => {
+		expect(bridgeManifestSchema.safeParse(uploadManifest()).success).toBe(true);
+	});
+
+	test("refuses an upload mode the platform does not know", () => {
+		const source = uploadManifest("stream" as BridgeUploadMode);
+
+		expect(bridgeManifestSchema.safeParse(source).success).toBe(false);
+	});
+});

package/src/wire/panel.ts

@@ -17,6 +17,7 @@ import {
 	BridgeTerminalLevel,
 	type BridgeTerminalManifest,
 	type BridgeTerminalRuleManifest,
+	BridgeUploadMode,
 } from "@serverkgg/bridge/protocol";
 import { z } from "zod";
 import { zEnvKey } from "./zEnvKey";
@@ -27,6 +28,8 @@ const ACTION_FIELDS_LIMIT = 5;
 
 const SECTION_ACTIONS_LIMIT = 10;
 
+const FORM_CLEARS_LIMIT = 8;
+
 const zKey = z
 	.string()
 	.min(1)
@@ -107,6 +110,16 @@ export const bridgeSectionActionSchema = z.object({
 	fields: z.array(bridgeFieldSchema).max(ACTION_FIELDS_LIMIT).optional(),
 });
 
+export const bridgeTabRefSchema = z.object({
+	tab: zBridgeId,
+	label: panelTextSchema,
+});
+
+export const bridgeFormClearSchema = z.object({
+	variable: zEnvKey,
+	warning: panelTextSchema,
+});
+
 export const bridgeSectionAddSchema = z.object({
 	label: panelTextSchema,
 	placeholder: z.string().max(256).optional(),
@@ -116,6 +129,7 @@ export const bridgeSectionUploadSchema = z.object({
 	label: panelTextSchema,
 	extensions: z.array(z.string().min(1).max(16)).min(1).max(8),
 	staging: z.string().min(1).max(128),
+	mode: z.enum(BridgeUploadMode).optional(),
 });
 
 export const bridgeActionsSectionSchema = z.object({
@@ -141,6 +155,23 @@ export const bridgeFormSectionSchema = z.object({
 	confirm: z.enum(BridgeConfirm).optional(),
 	confirmText: panelTextSchema.optional(),
 	fields: z.array(bridgeFieldSchema).min(1).max(32),
+	clears: z.array(bridgeFormClearSchema).max(FORM_CLEARS_LIMIT).optional(),
+	visibleWhen: bridgeVisibleWhenSchema.optional(),
+	access: z.enum(BridgeAccess).optional(),
+});
+
+export const bridgeDetailSectionSchema = z.object({
+	layout: z.literal(BridgeLayout.Detail),
+	id: zBridgeId,
+	title: panelTextSchema.optional(),
+	module: zBridgeModuleId,
+	actions: z.array(bridgeSectionActionSchema).max(SECTION_ACTIONS_LIMIT).optional(),
+	reinstall: z.boolean().optional(),
+	variable: zEnvKey.optional(),
+	confirm: z.enum(BridgeConfirm).optional(),
+	confirmText: panelTextSchema.optional(),
+	related: bridgeTabRefSchema.optional(),
+	empty: panelTextSchema.optional(),
 	visibleWhen: bridgeVisibleWhenSchema.optional(),
 	access: z.enum(BridgeAccess).optional(),
 });
@@ -197,6 +228,7 @@ export const bridgeSectionSchema: z.ZodType<BridgeSection> = z.discriminatedUnio
 	bridgeActionsSectionSchema,
 	bridgeCardsSectionSchema,
 	bridgeCatalogSectionSchema,
+	bridgeDetailSectionSchema,
 	bridgeFormSectionSchema,
 	bridgeTableSectionSchema,
 ]);