fix: restore ArchiveTeam Warrior as a proper integration

The widget-only integrations refactor incorrectly removed the
ArchiveTeam Warrior integration entirely. It only needed to be
excluded from auto-seeding (by removing defaultUrl), not deleted.

This restores the integration class, reverts the widget/router/handler
to use integration middleware, and removes archiveTeamWarrior from the
widget-only-integrations migration.

.gitignore

@@ -2,6 +2,7 @@
 
 # dependencies
 node_modules
+.pnpm-store/
 .pnp
 .pnp.js
 .idea/
@@ -70,6 +71,8 @@ apps/nextjs/public/images/background.png
 
 # personal agent config
 .opencode
+.agents/
+skills-lock.json
 
 # docusaurus
 apps/docs/.docusaurus

packages/api/src/router/widgets/archive-team-warrior.ts

@@ -1,37 +1,39 @@
 import { observable } from "@trpc/server/observable";
-import { z } from "zod/v4";
 
-import type { ArchiveTeamWarriorStatus } from "@homarr/request-handler/archive-team-warrior";
+import type { ArchiveTeamWarriorStatus } from "@homarr/integrations";
 import { archiveTeamWarriorRequestHandler } from "@homarr/request-handler/archive-team-warrior";
 
+import { createOneIntegrationMiddleware } from "../../middlewares/integration";
 import { createTRPCRouter, publicProcedure } from "../../trpc";
 
-const inputSchema = z.object({ url: z.string().url() });
-
 export const archiveTeamWarriorRouter = createTRPCRouter({
-  getStatus: publicProcedure.input(inputSchema).query(async ({ input }) => {
-    const handler = archiveTeamWarriorRequestHandler.handler({ url: input.url });
-    const { data, timestamp } = await handler.getCachedOrUpdatedDataAsync({ forceUpdate: false });
+  getStatus: publicProcedure
+    .concat(createOneIntegrationMiddleware("query", "archiveTeamWarrior"))
+    .query(async ({ ctx }) => {
+      const handler = archiveTeamWarriorRequestHandler.handler(ctx.integration, {});
+      const { data, timestamp } = await handler.getCachedOrUpdatedDataAsync({ forceUpdate: false });
 
-    return {
-      status: data,
-      updatedAt: timestamp,
-    };
-  }),
-
-  subscribeStatus: publicProcedure.input(inputSchema).subscription(({ input }) => {
-    return observable<{ status: ArchiveTeamWarriorStatus; updatedAt: Date }>((emit) => {
-      const handler = archiveTeamWarriorRequestHandler.handler({ url: input.url });
-      const unsubscribe = handler.subscribe((status) => {
-        emit.next({
-          status,
-          updatedAt: new Date(),
-        });
-      });
-
-      return () => {
-        unsubscribe();
+      return {
+        status: data,
+        updatedAt: timestamp,
       };
-    });
-  }),
+    }),
+
+  subscribeStatus: publicProcedure
+    .concat(createOneIntegrationMiddleware("query", "archiveTeamWarrior"))
+    .subscription(({ ctx }) => {
+      return observable<{ status: ArchiveTeamWarriorStatus; updatedAt: Date }>((emit) => {
+        const handler = archiveTeamWarriorRequestHandler.handler(ctx.integration, {});
+        const unsubscribe = handler.subscribe((status) => {
+          emit.next({
+            status,
+            updatedAt: new Date(),
+          });
+        });
+
+        return () => {
+          unsubscribe();
+        };
+      });
+    }),
 });

packages/db/migrations/custom/0003_remove_widget_only_integrations.ts

@@ -14,7 +14,6 @@ const removedIntegrationKinds = [
   "gitHubContainerRegistry",
   "quay",
   "searchCh",
-  "archiveTeamWarrior",
 ] as const;
 
 type RemovedIntegrationKind = (typeof removedIntegrationKinds)[number];
@@ -65,7 +64,7 @@ export async function migrateWidgetOnlyIntegrationsToOptionsAsync(db: Database)
     }, new Map());
 
   const existingItems = await db.query.items.findMany({
-    where: (items, { inArray }) => inArray(items.kind, ["releases", "timetable", "archiveTeamWarrior"]),
+    where: (items, { inArray }) => inArray(items.kind, ["releases", "timetable"]),
   });
 
   const updatedItems: { id: string; options: object }[] = [];
@@ -97,11 +96,6 @@ export async function migrateWidgetOnlyIntegrationsToOptionsAsync(db: Database)
       updatedItems.push({ id: item.id, options: { ...options, baseUrl: linkedIntegration.url } });
       unlinkItemIds.push(item.id);
     }
-
-    if (item.kind === "archiveTeamWarrior" && linkedIntegration?.kind === "archiveTeamWarrior") {
-      updatedItems.push({ id: item.id, options: { ...options, url: linkedIntegration.url } });
-      unlinkItemIds.push(item.id);
-    }
   }
 
   for (const update of updatedItems) {

packages/definitions/src/docs/integration-doc-slugs.ts

@@ -49,5 +49,6 @@ export const integrationDocSlugs: Record<IntegrationKind, string | null> = {
   gluetun: "gluetun",
   peaNut: "peanut",
   beszel: "beszel",
+  archiveTeamWarrior: null,
   mock: null,
 };

packages/definitions/src/integration.ts

@@ -425,6 +425,13 @@ export const integrationDefs = {
     category: ["vpn"],
     documentationUrl: createDocumentationLink("/docs/integrations/gluetun"),
   },
+  archiveTeamWarrior: {
+    name: "ArchiveTeam Warrior",
+    secretKinds: [[], ["username", "password"]],
+    iconUrl: "https://cdn.jsdelivr.net/gh/selfhst/icons/png/archiveteam-warrior.png",
+    category: ["archiving"],
+    documentationUrl: null,
+  },
   // This integration only returns mock data, it is used during development (but can also be used in production by directly going to the create page)
   mock: {
     name: "Mock",
@@ -532,6 +539,7 @@ export const integrationCategories = [
   "speedtest",
   "analytics",
   "vpn",
+  "archiving",
   "ups",
   "documents",
   "mediaLibrary",

packages/definitions/src/release-provider.ts

@@ -73,5 +73,6 @@ export const normalizeReleaseProviderIdentifier = (provider: ReleaseProviderKind
       ? trimmedIdentifier.slice(registryPrefix.length)
       : trimmedIdentifier;
 
-  return removeContainerImageVersion(withoutRegistry);
+  // ponytail: only strip container image versions/digests for providers that use them
+  return registryPrefix ? removeContainerImageVersion(withoutRegistry) : withoutRegistry;
 };

packages/definitions/src/widget-integration-map.ts

@@ -38,6 +38,7 @@ export const widgetIntegrationSupport: Partial<Record<WidgetKind, readonly Integ
   uptimeKuma: ["uptimeKuma"],
   audioStats: ["navidrome", "audiobookshelf"],
   vpn: getIntegrationKindsByCategory("vpn"),
+  archiveTeamWarrior: ["archiveTeamWarrior"],
   anchorNote: ["anchor"],
 };
 

packages/integrations/src/archive-team-warrior/archive-team-warrior-integration.ts

@@ -0,0 +1,386 @@
+import { Buffer } from "node:buffer";
+import { randomUUID } from "node:crypto";
+import WebSocket from "ws";
+import type { RawData } from "ws";
+import { z } from "zod/v4";
+
+import { fetchWithTrustedCertificatesAsync } from "@homarr/core/infrastructure/http";
+
+import type { IntegrationTestingInput } from "../base/integration";
+import { Integration } from "../base/integration";
+import { TestConnectionError } from "../base/test-connection/test-connection-error";
+import type { TestingResult } from "../base/test-connection/test-connection-service";
+import {
+  bandwidthMessageSchema,
+  itemStatusMessageSchema,
+  pipelineStartItemMessageSchema,
+  projectRefreshMessageSchema,
+  seesawFrameSchema,
+  warriorBroadcastMessageSchema,
+  warriorProjectSelectedMessageSchema,
+  warriorStatusMessageSchema,
+} from "./archive-team-warrior-schemas";
+import type { SeesawFrame, WarriorItem, WarriorProject } from "./archive-team-warrior-schemas";
+import type { ArchiveTeamWarriorItem, ArchiveTeamWarriorStatus } from "./archive-team-warrior-types";
+
+const SOCKJS_SNAPSHOT_TIMEOUT_MS = 2500;
+
+interface WarriorSnapshotState {
+  status: string;
+  runnerStatus?: string;
+  selectedProject: string | null;
+  broadcastMessage: string | null;
+  project: ArchiveTeamWarriorStatus["project"];
+  bandwidth: ArchiveTeamWarriorStatus["bandwidth"];
+  items: Map<string, ArchiveTeamWarriorItem>;
+}
+
+export class ArchiveTeamWarriorIntegration extends Integration {
+  protected async testingAsync(input: IntegrationTestingInput): Promise<TestingResult> {
+    const response = await input.fetchAsync(this.url("/index.html"), {
+      headers: this.createAuthHeaders(),
+    });
+
+    if (!response.ok) return TestConnectionError.StatusResult(response);
+
+    return { success: true };
+  }
+
+  public async getStatusAsync(): Promise<ArchiveTeamWarriorStatus> {
+    const baseUrl = this.url("/").toString().replace(/\/$/, "");
+
+    await fetchWithTrustedCertificatesAsync(`${baseUrl}/index.html`, {
+      headers: this.createAuthHeaders(),
+    });
+
+    return await this.readSockJsSnapshotAsync(baseUrl);
+  }
+
+  private async readSockJsSnapshotAsync(baseUrl: string): Promise<ArchiveTeamWarriorStatus> {
+    const snapshot: WarriorSnapshotState = {
+      status: "Unknown",
+      selectedProject: null,
+      broadcastMessage: null,
+      project: null,
+      bandwidth: null,
+      items: new Map<string, ArchiveTeamWarriorItem>(),
+    };
+
+    await new Promise<void>((resolve, reject) => {
+      let isSettled = false;
+
+      const socket = new WebSocket(this.createSockJsWebSocketUrl(baseUrl), {
+        headers: this.createAuthHeaders(),
+      });
+
+      const finish = () => {
+        if (isSettled) return;
+
+        isSettled = true;
+        clearTimeout(timeout);
+
+        if (socket.readyState === WebSocket.OPEN || socket.readyState === WebSocket.CONNECTING) {
+          socket.close();
+        }
+
+        resolve();
+      };
+
+      const fail = () => {
+        if (isSettled) return;
+
+        isSettled = true;
+        clearTimeout(timeout);
+        reject(new Error("Failed to connect to ArchiveTeam Warrior websocket"));
+      };
+
+      const timeout = setTimeout(finish, SOCKJS_SNAPSHOT_TIMEOUT_MS);
+
+      socket.on("message", (data: RawData) => {
+        const frames = this.parseSockJsMessage(this.decodeWebSocketData(data));
+
+        for (const frame of frames) {
+          this.applyFrameToSnapshot(frame, snapshot);
+        }
+      });
+
+      socket.on("error", fail);
+      socket.on("close", finish);
+    });
+
+    return this.createStatusFromSnapshot(snapshot);
+  }
+
+  private applyFrameToSnapshot(frame: SeesawFrame, snapshot: WarriorSnapshotState) {
+    switch (frame.event_name) {
+      case "warrior.status":
+        this.applyWarriorStatusFrame(frame, snapshot);
+        break;
+
+      case "warrior.project_selected":
+        this.applyProjectSelectedFrame(frame, snapshot);
+        break;
+
+      case "warrior.broadcast_message":
+        this.applyBroadcastMessageFrame(frame, snapshot);
+        break;
+
+      case "runner.status":
+        this.applyRunnerStatusFrame(frame, snapshot);
+        break;
+
+      case "project.refresh":
+        this.applyProjectRefreshFrame(frame, snapshot);
+        break;
+
+      case "pipeline.start_item":
+        this.applyPipelineStartItemFrame(frame, snapshot);
+        break;
+
+      case "item.complete":
+        this.applyItemStatusFrame(frame, snapshot, "completed");
+        break;
+
+      case "item.fail":
+        this.applyItemStatusFrame(frame, snapshot, "failed");
+        break;
+
+      case "item.cancel":
+        this.applyItemStatusFrame(frame, snapshot, "canceled");
+        break;
+
+      case "bandwidth":
+        this.applyBandwidthFrame(frame, snapshot);
+        break;
+    }
+  }
+
+  private applyWarriorStatusFrame(frame: SeesawFrame, snapshot: WarriorSnapshotState) {
+    const message = warriorStatusMessageSchema.safeParse(frame.message);
+    if (!message.success) return;
+
+    snapshot.status = this.normalizeDisplayStatus(message.data.status);
+  }
+
+  private applyProjectSelectedFrame(frame: SeesawFrame, snapshot: WarriorSnapshotState) {
+    const message = warriorProjectSelectedMessageSchema.safeParse(frame.message);
+    if (!message.success) return;
+
+    snapshot.selectedProject = message.data.project;
+  }
+
+  private applyBroadcastMessageFrame(frame: SeesawFrame, snapshot: WarriorSnapshotState) {
+    const message = warriorBroadcastMessageSchema.safeParse(frame.message);
+    if (!message.success) return;
+
+    snapshot.broadcastMessage = message.data.message;
+  }
+
+  private applyRunnerStatusFrame(frame: SeesawFrame, snapshot: WarriorSnapshotState) {
+    const message = warriorStatusMessageSchema.safeParse(frame.message);
+    if (!message.success) return;
+
+    snapshot.runnerStatus = this.normalizeDisplayStatus(message.data.status);
+  }
+
+  private applyProjectRefreshFrame(frame: SeesawFrame, snapshot: WarriorSnapshotState) {
+    const message = projectRefreshMessageSchema.safeParse(frame.message);
+    if (!message.success) return;
+
+    snapshot.project = this.mapProject(message.data?.project);
+    snapshot.runnerStatus = message.data?.status
+      ? this.normalizeDisplayStatus(message.data.status)
+      : snapshot.runnerStatus;
+
+    for (const item of message.data?.items ?? []) {
+      snapshot.items.set(item.id, this.mapItem(item));
+    }
+  }
+
+  private applyPipelineStartItemFrame(frame: SeesawFrame, snapshot: WarriorSnapshotState) {
+    const message = pipelineStartItemMessageSchema.safeParse(frame.message);
+    if (!message.success) return;
+
+    snapshot.items.set(message.data.item.id, this.mapItem(message.data.item));
+  }
+
+  private applyItemStatusFrame(
+    frame: SeesawFrame,
+    snapshot: WarriorSnapshotState,
+    status: ArchiveTeamWarriorItem["status"],
+  ) {
+    const message = itemStatusMessageSchema.safeParse(frame.message);
+    if (!message.success) return;
+
+    this.updateItemStatus(snapshot.items, message.data.item_id, status);
+  }
+
+  private applyBandwidthFrame(frame: SeesawFrame, snapshot: WarriorSnapshotState) {
+    const message = bandwidthMessageSchema.safeParse(frame.message);
+    if (!message.success) return;
+
+    snapshot.bandwidth = message.data;
+  }
+
+  private createStatusFromSnapshot(snapshot: WarriorSnapshotState): ArchiveTeamWarriorStatus {
+    const itemList = Array.from(snapshot.items.values());
+
+    return {
+      status: snapshot.status,
+      runnerStatus: snapshot.runnerStatus,
+      project: snapshot.project,
+      selectedProject: snapshot.selectedProject,
+      broadcastMessage: snapshot.broadcastMessage,
+      bandwidth: snapshot.bandwidth,
+      items: itemList,
+      counts: {
+        running: itemList.filter((item) => item.status === "running").length,
+        completed: itemList.filter((item) => item.status === "completed").length,
+        failed: itemList.filter((item) => item.status === "failed").length,
+        canceled: itemList.filter((item) => item.status === "canceled").length,
+      },
+      updatedAt: new Date().toISOString(),
+    };
+  }
+
+  private createAuthHeaders() {
+    const authorization = this.createBasicAuthHeader();
+
+    return authorization ? { Authorization: authorization } : undefined;
+  }
+
+  private createBasicAuthHeader() {
+    if (!this.hasSecretValue("username") || !this.hasSecretValue("password")) return undefined;
+
+    const username = this.getSecretValue("username");
+    const password = this.getSecretValue("password");
+    const credentials = Buffer.from(`${username}:${password}`, "utf8").toString("base64");
+
+    return `Basic ${credentials}`;
+  }
+
+  private decodeWebSocketData(data: RawData) {
+    if (typeof data === "string") return data;
+    if (Buffer.isBuffer(data)) return data.toString("utf8");
+    if (Array.isArray(data)) return Buffer.concat(data).toString("utf8");
+
+    return Buffer.from(data).toString("utf8");
+  }
+
+  private parseSockJsMessage(raw: string): SeesawFrame[] {
+    if (raw === "o" || raw === "h" || raw.length === 0) return [];
+    if (!raw.startsWith("a")) return [];
+
+    const rawPayload = this.parseJsonSafely(raw.slice(1));
+    const payload = z.array(z.string()).safeParse(rawPayload);
+    if (!payload.success) return [];
+
+    return payload.data.flatMap((frame) => {
+      const rawFrame = this.parseJsonSafely(frame);
+      const result = seesawFrameSchema.safeParse(rawFrame);
+
+      return result.success ? [result.data] : [];
+    });
+  }
+
+  private parseJsonSafely(value: string) {
+    try {
+      return JSON.parse(value) as unknown;
+    } catch {
+      return null;
+    }
+  }
+
+  private createSockJsWebSocketUrl(baseUrl: string) {
+    const url = new URL(baseUrl);
+    url.protocol = url.protocol === "https:" ? "wss:" : "ws:";
+    url.pathname = `/${Date.now()}/${randomUUID()}/websocket`;
+    return url.toString();
+  }
+
+  private mapProject(project?: WarriorProject): ArchiveTeamWarriorStatus["project"] {
+    if (!project) return null;
+
+    return {
+      id: project.project_id?.toString(),
+      title: project.title ?? "Unknown Project",
+    };
+  }
+
+  private mapItem(item: WarriorItem): ArchiveTeamWarriorItem {
+    return {
+      id: item.id,
+      name: this.formatItemName(item.name),
+      status: this.normalizeItemStatus(item.status),
+      project: item.project,
+      startTime: item.start_time,
+    };
+  }
+
+  private normalizeDisplayStatus(status?: string | null) {
+    if (!status) return "Unknown";
+
+    switch (status) {
+      case "RUNNING_PROJECT":
+        return "Running";
+      case "STOPPED":
+        return "Stopped";
+      case "IDLE":
+        return "Idle";
+      default:
+        return status
+          .replaceAll("_", " ")
+          .toLowerCase()
+          .replace(/\b\w/g, (character) => character.toUpperCase());
+    }
+  }
+
+  private formatItemName(name: string) {
+    const cleaned = name.replace(/^Item\s+/i, "");
+    const parts = cleaned.split("\u0000").filter(Boolean);
+
+    if (parts.length === 0) return "Item";
+
+    const first = parts[0];
+
+    if (!first) return "Item";
+
+    const label = parts.length === 1 ? first : `${first} + ${parts.length - 1} more`;
+
+    return label.length <= 80 ? label : `${label.slice(0, 77)}...`;
+  }
+
+  private normalizeItemStatus(status?: string | null): ArchiveTeamWarriorItem["status"] {
+    if (!status) return "running";
+
+    switch (status.toLowerCase()) {
+      case "running":
+      case "running_project":
+        return "running";
+      case "completed":
+        return "completed";
+      case "failed":
+      case "fail":
+        return "failed";
+      case "canceled":
+      case "cancel":
+        return "canceled";
+      default:
+        return "unknown";
+    }
+  }
+
+  private updateItemStatus(
+    items: Map<string, ArchiveTeamWarriorItem>,
+    itemId: string,
+    status: ArchiveTeamWarriorItem["status"],
+  ) {
+    const item = items.get(itemId);
+    if (!item) return;
+
+    items.set(itemId, {
+      ...item,
+      status,
+    });
+  }
+}

packages/integrations/src/archive-team-warrior/archive-team-warrior-schemas.ts

@@ -0,0 +1,61 @@
+import { z } from "zod/v4";
+
+export const seesawFrameSchema = z.object({
+  event_name: z.string(),
+  message: z.unknown(),
+});
+
+export const warriorStatusMessageSchema = z.object({
+  status: z.string(),
+});
+
+export const warriorBroadcastMessageSchema = z.object({
+  message: z.string().nullable(),
+});
+
+export const warriorProjectSelectedMessageSchema = z.object({
+  project: z.string().nullable(),
+});
+
+export const warriorProjectSchema = z.object({
+  project_id: z.number().optional(),
+  title: z.string().optional(),
+  project_html: z.string().optional(),
+  utc_deadline: z.string().nullable().optional(),
+});
+
+export const warriorItemSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  status: z.string().nullable().optional(),
+  project: z.string().nullable().optional(),
+  start_time: z.number().optional(),
+});
+
+export const projectRefreshMessageSchema = z
+  .object({
+    project: warriorProjectSchema.optional(),
+    status: z.string().optional(),
+    items: z.array(warriorItemSchema).optional(),
+  })
+  .nullable();
+
+export const itemStatusMessageSchema = z.object({
+  item_id: z.string(),
+});
+
+export const pipelineStartItemMessageSchema = z.object({
+  item: warriorItemSchema,
+});
+
+export const bandwidthMessageSchema = z.object({
+  received: z.number().optional(),
+  sent: z.number().optional(),
+  receiving: z.number().optional(),
+  sending: z.number().optional(),
+  session_id: z.string().optional(),
+});
+
+export type WarriorProject = z.infer<typeof warriorProjectSchema>;
+export type WarriorItem = z.infer<typeof warriorItemSchema>;
+export type SeesawFrame = z.infer<typeof seesawFrameSchema>;

packages/integrations/src/archive-team-warrior/archive-team-warrior-types.ts

@@ -0,0 +1,37 @@
+export interface ArchiveTeamWarriorItem {
+  id: string;
+  name: string;
+  status: "running" | "completed" | "failed" | "canceled" | "unknown";
+  project?: string | null;
+  startTime?: number;
+}
+
+export interface ArchiveTeamWarriorBandwidth {
+  received?: number;
+  sent?: number;
+  receiving?: number;
+  sending?: number;
+  session_id?: string;
+}
+
+export interface ArchiveTeamWarriorProject {
+  id?: string;
+  title: string;
+}
+
+export interface ArchiveTeamWarriorStatus {
+  status: string;
+  runnerStatus?: string;
+  project?: ArchiveTeamWarriorProject | null;
+  selectedProject?: string | null;
+  broadcastMessage?: string | null;
+  bandwidth?: ArchiveTeamWarriorBandwidth | null;
+  items: ArchiveTeamWarriorItem[];
+  counts: {
+    running: number;
+    completed: number;
+    failed: number;
+    canceled: number;
+  };
+  updatedAt: string;
+}

packages/integrations/src/base/creator.ts

@@ -15,6 +15,7 @@ import { SlskdIntegration } from "../download-client/slskd/slskd-integration";
 import { TransmissionIntegration } from "../download-client/transmission/transmission-integration";
 import { EmbyIntegration } from "../emby/emby-integration";
 import { GlancesIntegration } from "../glances/glances-integration";
+import { ArchiveTeamWarriorIntegration } from "../archive-team-warrior/archive-team-warrior-integration";
 import { GluetunIntegration } from "../gluetun/gluetun-integration";
 import { HomeAssistantIntegration } from "../homeassistant/homeassistant-integration";
 import { ICalIntegration } from "../ical/ical-integration";
@@ -120,6 +121,7 @@ export const integrationCreators = {
   navidrome: NavidromeIntegration,
   umami: UmamiIntegration,
   gluetun: GluetunIntegration,
+  archiveTeamWarrior: ArchiveTeamWarriorIntegration,
   uptimeKuma: UptimeKumaIntegration,
   peaNut: PeaNutIntegration,
   beszel: BeszelIntegration,

packages/integrations/src/index.ts

@@ -1,4 +1,5 @@
 // General integrations
+export { ArchiveTeamWarriorIntegration } from "./archive-team-warrior/archive-team-warrior-integration";
 export { AdGuardHomeIntegration } from "./adguard-home/adguard-home-integration";
 export { TechnitiumDnsIntegration } from "./technitium/technitium-integration";
 export { AnchorIntegration } from "./anchor/anchor-integration";
@@ -79,6 +80,11 @@ export type { AudiobookshelfDashboardData } from "./audiobookshelf/audiobookshel
 export type { NavidromeDashboardData } from "./navidrome/navidrome-types";
 export type { UptimeKumaDashboardData } from "./uptime-kuma/uptime-kuma-types";
 export type { UmamiVisitorStats } from "./umami/umami-types";
+export type {
+  ArchiveTeamWarriorBandwidth,
+  ArchiveTeamWarriorItem,
+  ArchiveTeamWarriorStatus,
+} from "./archive-team-warrior/archive-team-warrior-types";
 
 // Schemas
 export { anchorNotesListInputSchema } from "./anchor/anchor-types";

packages/request-handler/package.json

@@ -33,12 +33,10 @@
     "octokit": "catalog:",
     "superjson": "catalog:",
     "undici": "catalog:",
-    "ws": "catalog:",
     "zod": "catalog:"
   },
   "devDependencies": {
     "@homarr/tsconfig": "workspace:^0.1.0",
-    "@types/ws": "catalog:",
     "typescript": "catalog:"
   }
 }

packages/request-handler/src/archive-team-warrior.ts

@@ -1,336 +1,20 @@
-import { randomUUID } from "node:crypto";
-import { Buffer } from "node:buffer";
 import dayjs from "dayjs";
-import WebSocket from "ws";
-import type { RawData } from "ws";
-import { z } from "zod/v4";
 
-import { fetchWithTrustedCertificatesAsync } from "@homarr/core/infrastructure/http";
-import { createWidgetOptionsChannel } from "@homarr/redis";
+import type { IntegrationKindByCategory } from "@homarr/definitions";
+import type { ArchiveTeamWarriorStatus } from "@homarr/integrations";
+import { createIntegrationAsync } from "@homarr/integrations";
 
-import { createCachedRequestHandler } from "./lib/cached-request-handler";
+import { createCachedIntegrationRequestHandler } from "./lib/cached-integration-request-handler";
 
-const SOCKJS_SNAPSHOT_TIMEOUT_MS = 2500;
-
-export interface ArchiveTeamWarriorItem {
-  id: string;
-  name: string;
-  status: "running" | "completed" | "failed" | "canceled" | "unknown";
-  project?: string | null;
-  startTime?: number;
-}
-
-export interface ArchiveTeamWarriorBandwidth {
-  received?: number;
-  sent?: number;
-  receiving?: number;
-  sending?: number;
-  session_id?: string;
-}
-
-export interface ArchiveTeamWarriorProject {
-  id?: string;
-  title: string;
-}
-
-export interface ArchiveTeamWarriorStatus {
-  status: string;
-  runnerStatus?: string;
-  project?: ArchiveTeamWarriorProject | null;
-  selectedProject: string | null;
-  broadcastMessage: string | null;
-  bandwidth?: ArchiveTeamWarriorBandwidth | null;
-  items: ArchiveTeamWarriorItem[];
-  counts: { running: number; completed: number; failed: number; canceled: number };
-  updatedAt: string;
-}
-
-interface WarriorSnapshotState {
-  status: string;
-  runnerStatus?: string;
-  selectedProject: string | null;
-  broadcastMessage: string | null;
-  project: ArchiveTeamWarriorStatus["project"];
-  bandwidth: ArchiveTeamWarriorStatus["bandwidth"];
-  items: Map<string, ArchiveTeamWarriorItem>;
-}
-
-export const archiveTeamWarriorRequestHandler = {
-  handler: (itemOptions: { url: string }) =>
-    createCachedRequestHandler<ArchiveTeamWarriorStatus, { url: string }>({
-      async requestAsync(input) {
-        return await getStatusAsync(input.url);
-      },
-      cacheDuration: dayjs.duration(5, "minute"),
-      queryKey: "archiveTeamWarriorStatus",
-      createRedisChannel(input, handlerOptions) {
-        return createWidgetOptionsChannel<ArchiveTeamWarriorStatus>(
-          "archiveTeamWarrior",
-          handlerOptions.queryKey,
-          input,
-        );
-      },
-    }).handler(itemOptions),
-};
-
-const getStatusAsync = async (url: string): Promise<ArchiveTeamWarriorStatus> => {
-  const baseUrl = url.replace(/\/$/, "");
-  await fetchWithTrustedCertificatesAsync(`${baseUrl}/index.html`);
-  return await readSockJsSnapshotAsync(baseUrl);
-};
-
-const readSockJsSnapshotAsync = async (baseUrl: string): Promise<ArchiveTeamWarriorStatus> => {
-  const snapshot: WarriorSnapshotState = {
-    status: "Unknown",
-    selectedProject: null,
-    broadcastMessage: null,
-    project: null,
-    bandwidth: null,
-    items: new Map<string, ArchiveTeamWarriorItem>(),
-  };
-
-  await new Promise<void>((resolve, reject) => {
-    let isSettled = false;
-    const socket = new WebSocket(createSockJsWebSocketUrl(baseUrl));
-
-    const finish = () => {
-      if (isSettled) return;
-      isSettled = true;
-      clearTimeout(timeout);
-      if (socket.readyState === WebSocket.OPEN || socket.readyState === WebSocket.CONNECTING) socket.close();
-      resolve();
-    };
-
-    const fail = () => {
-      if (isSettled) return;
-      isSettled = true;
-      clearTimeout(timeout);
-      reject(new Error("Failed to connect to ArchiveTeam Warrior websocket"));
-    };
-
-    const timeout = setTimeout(finish, SOCKJS_SNAPSHOT_TIMEOUT_MS);
-    socket.on("message", (data: RawData) => {
-      for (const frame of parseSockJsMessage(decodeWebSocketData(data))) {
-        applyFrameToSnapshot(frame, snapshot);
-      }
-    });
-    socket.on("error", fail);
-    socket.on("close", finish);
-  });
-
-  return createStatusFromSnapshot(snapshot);
-};
-
-const applyFrameToSnapshot = (frame: SeesawFrame, snapshot: WarriorSnapshotState) => {
-  switch (frame.event_name) {
-    case "warrior.status":
-    case "runner.status": {
-      const message = warriorStatusMessageSchema.safeParse(frame.message);
-      if (!message.success) return;
-      if (frame.event_name === "warrior.status") snapshot.status = normalizeDisplayStatus(message.data.status);
-      else snapshot.runnerStatus = normalizeDisplayStatus(message.data.status);
-      return;
-    }
-    case "warrior.project_selected": {
-      const message = warriorProjectSelectedMessageSchema.safeParse(frame.message);
-      if (message.success) snapshot.selectedProject = message.data.project;
-      return;
-    }
-    case "warrior.broadcast_message": {
-      const message = warriorBroadcastMessageSchema.safeParse(frame.message);
-      if (message.success) snapshot.broadcastMessage = message.data.message;
-      return;
-    }
-    case "project.refresh": {
-      const message = projectRefreshMessageSchema.safeParse(frame.message);
-      if (!message.success) return;
-      snapshot.project = mapProject(message.data?.project);
-      snapshot.runnerStatus = message.data?.status
-        ? normalizeDisplayStatus(message.data.status)
-        : snapshot.runnerStatus;
-      for (const item of message.data?.items ?? []) snapshot.items.set(item.id, mapItem(item));
-      return;
-    }
-    case "pipeline.start_item": {
-      const message = pipelineStartItemMessageSchema.safeParse(frame.message);
-      if (message.success) snapshot.items.set(message.data.item.id, mapItem(message.data.item));
-      return;
-    }
-    case "item.complete":
-      updateItemStatus(frame, snapshot, "completed");
-      return;
-    case "item.fail":
-      updateItemStatus(frame, snapshot, "failed");
-      return;
-    case "item.cancel":
-      updateItemStatus(frame, snapshot, "canceled");
-      return;
-    case "bandwidth": {
-      const message = bandwidthMessageSchema.safeParse(frame.message);
-      if (message.success) snapshot.bandwidth = message.data;
-    }
-  }
-};
-
-const updateItemStatus = (
-  frame: SeesawFrame,
-  snapshot: WarriorSnapshotState,
-  status: ArchiveTeamWarriorItem["status"],
-) => {
-  const message = itemStatusMessageSchema.safeParse(frame.message);
-  if (!message.success) return;
-  const item = snapshot.items.get(message.data.item_id);
-  if (item) snapshot.items.set(message.data.item_id, { ...item, status });
-};
-
-const createStatusFromSnapshot = (snapshot: WarriorSnapshotState): ArchiveTeamWarriorStatus => {
-  const itemList = Array.from(snapshot.items.values());
-  return {
-    status: snapshot.status,
-    runnerStatus: snapshot.runnerStatus,
-    project: snapshot.project,
-    selectedProject: snapshot.selectedProject,
-    broadcastMessage: snapshot.broadcastMessage,
-    bandwidth: snapshot.bandwidth,
-    items: itemList,
-    counts: {
-      running: itemList.filter((item) => item.status === "running").length,
-      completed: itemList.filter((item) => item.status === "completed").length,
-      failed: itemList.filter((item) => item.status === "failed").length,
-      canceled: itemList.filter((item) => item.status === "canceled").length,
-    },
-    updatedAt: new Date().toISOString(),
-  };
-};
-
-const decodeWebSocketData = (data: RawData) => {
-  if (typeof data === "string") return data;
-  if (Buffer.isBuffer(data)) return data.toString("utf8");
-  if (Array.isArray(data)) return Buffer.concat(data).toString("utf8");
-  return Buffer.from(data).toString("utf8");
-};
-
-const parseSockJsMessage = (raw: string): SeesawFrame[] => {
-  if (raw === "o" || raw === "h" || raw.length === 0) return [];
-  if (!raw.startsWith("a")) return [];
-  const payload = z.array(z.string()).safeParse(parseJsonSafely(raw.slice(1)));
-  if (!payload.success) return [];
-  return payload.data.flatMap((frame) => {
-    const result = seesawFrameSchema.safeParse(parseJsonSafely(frame));
-    return result.success ? [result.data] : [];
-  });
-};
-
-const parseJsonSafely = (value: string) => {
-  try {
-    return JSON.parse(value) as unknown;
-  } catch {
-    return null;
-  }
-};
-
-const createSockJsWebSocketUrl = (baseUrl: string) => {
-  const url = new URL(baseUrl);
-  url.protocol = url.protocol === "https:" ? "wss:" : "ws:";
-  url.pathname = `/${Date.now()}/${randomUUID()}/websocket`;
-  return url.toString();
-};
-
-const mapProject = (project?: WarriorProject): ArchiveTeamWarriorStatus["project"] => {
-  if (!project) return null;
-  return { id: project.project_id?.toString(), title: project.title ?? "Unknown Project" };
-};
-
-const mapItem = (item: WarriorItem): ArchiveTeamWarriorItem => ({
-  id: item.id,
-  name: formatItemName(item.name),
-  status: normalizeItemStatus(item.status),
-  project: item.project,
-  startTime: item.start_time,
+export const archiveTeamWarriorRequestHandler = createCachedIntegrationRequestHandler<
+  ArchiveTeamWarriorStatus,
+  IntegrationKindByCategory<"archiving">,
+  Record<string, never>
+>({
+  async requestAsync(integration) {
+    const integrationInstance = await createIntegrationAsync(integration);
+    return await integrationInstance.getStatusAsync();
+  },
+  cacheDuration: dayjs.duration(5, "minute"),
+  queryKey: "archiveTeamWarriorStatus",
 });
-
-const normalizeDisplayStatus = (status?: string | null) => {
-  if (!status) return "Unknown";
-  switch (status) {
-    case "RUNNING_PROJECT":
-      return "Running";
-    case "STOPPED":
-      return "Stopped";
-    case "IDLE":
-      return "Idle";
-    default:
-      return status
-        .replaceAll("_", " ")
-        .toLowerCase()
-        .replace(/\b\w/g, (character) => character.toUpperCase());
-  }
-};
-
-const formatItemName = (name: string) => {
-  const parts = name
-    .replace(/^Item\s+/i, "")
-    .split("\u0000")
-    .filter(Boolean);
-  const first = parts[0];
-  if (!first) return "Item";
-  const label = parts.length === 1 ? first : `${first} + ${parts.length - 1} more`;
-  return label.length <= 80 ? label : `${label.slice(0, 77)}...`;
-};
-
-const normalizeItemStatus = (status?: string | null): ArchiveTeamWarriorItem["status"] => {
-  switch (status?.toLowerCase()) {
-    case "running":
-    case "running_project":
-      return "running";
-    case "completed":
-      return "completed";
-    case "failed":
-    case "fail":
-      return "failed";
-    case "canceled":
-    case "cancel":
-      return "canceled";
-    case undefined:
-      return "running";
-    default:
-      return "unknown";
-  }
-};
-
-const seesawFrameSchema = z.object({ event_name: z.string(), message: z.unknown() });
-const warriorStatusMessageSchema = z.object({ status: z.string() });
-const warriorBroadcastMessageSchema = z.object({ message: z.string().nullable() });
-const warriorProjectSelectedMessageSchema = z.object({ project: z.string().nullable() });
-const warriorProjectSchema = z.object({
-  project_id: z.number().optional(),
-  title: z.string().optional(),
-  project_html: z.string().optional(),
-  utc_deadline: z.string().nullable().optional(),
-});
-const warriorItemSchema = z.object({
-  id: z.string(),
-  name: z.string(),
-  status: z.string().nullable().optional(),
-  project: z.string().nullable().optional(),
-  start_time: z.number().optional(),
-});
-const projectRefreshMessageSchema = z
-  .object({
-    project: warriorProjectSchema.optional(),
-    status: z.string().optional(),
-    items: z.array(warriorItemSchema).optional(),
-  })
-  .nullable();
-const itemStatusMessageSchema = z.object({ item_id: z.string() });
-const pipelineStartItemMessageSchema = z.object({ item: warriorItemSchema });
-const bandwidthMessageSchema = z.object({
-  received: z.number().optional(),
-  sent: z.number().optional(),
-  receiving: z.number().optional(),
-  sending: z.number().optional(),
-  session_id: z.string().optional(),
-});
-
-type WarriorProject = z.infer<typeof warriorProjectSchema>;
-type WarriorItem = z.infer<typeof warriorItemSchema>;
-type SeesawFrame = z.infer<typeof seesawFrameSchema>;

packages/translation/src/lang/en.json

@@ -1755,9 +1755,6 @@
       "name": "ArchiveTeam Warrior",
       "description": "Monitor ArchiveTeam Warrior status, projects, and active archival jobs.",
       "option": {
-        "url": {
-          "label": "Warrior URL"
-        },
         "showBroadcastMessage": {
           "label": "Show broadcast messages"
         }

packages/widgets/src/archive-team-warrior/component.tsx

@@ -4,33 +4,41 @@ import { Avatar, Badge, Card, Group, SimpleGrid, Stack, Text } from "@mantine/co
 
 import { clientApi } from "@homarr/api/client";
 import { humanFileSize } from "@homarr/common";
+import { getIconUrl } from "@homarr/definitions";
 
 import type { WidgetComponentProps } from "../definition";
 
-const archiveTeamWarriorIconUrl = "https://cdn.jsdelivr.net/gh/selfhst/icons/png/archiveteam-warrior.png";
+export default function ArchiveTeamWarriorWidget({
+  integrationIds,
+  options,
+}: WidgetComponentProps<"archiveTeamWarrior">) {
+  const integrationId = integrationIds[0];
 
-export default function ArchiveTeamWarriorWidget({ options }: WidgetComponentProps<"archiveTeamWarrior">) {
-  return <ArchiveTeamWarriorWidgetContent url={options.url} options={options} />;
+  if (!integrationId) {
+    return null;
+  }
+
+  return <ArchiveTeamWarriorWidgetContent integrationId={integrationId} options={options} />;
 }
 
 const ArchiveTeamWarriorWidgetContent = ({
-  url,
+  integrationId,
   options,
 }: {
-  url: string;
+  integrationId: string;
   options: WidgetComponentProps<"archiveTeamWarrior">["options"];
 }) => {
   const [data] = clientApi.widget.archiveTeamWarrior.getStatus.useSuspenseQuery({
-    url,
+    integrationId,
   });
 
   const utils = clientApi.useUtils();
 
   clientApi.widget.archiveTeamWarrior.subscribeStatus.useSubscription(
-    { url },
+    { integrationId },
     {
       onData: (next) => {
-        utils.widget.archiveTeamWarrior.getStatus.setData({ url }, next);
+        utils.widget.archiveTeamWarrior.getStatus.setData({ integrationId }, next);
       },
     },
   );
@@ -42,7 +50,7 @@ const ArchiveTeamWarriorWidgetContent = ({
     <Stack p="xs" gap="xs" h="100%">
       <Group justify="space-between" align="center" wrap="nowrap">
         <Group gap="xs" wrap="nowrap" miw={0}>
-          <Avatar size="sm" radius="md" src={archiveTeamWarriorIconUrl} />
+          <Avatar size="sm" radius="md" src={getIconUrl("archiveTeamWarrior")} />
           <Text size="sm" c="dimmed" lineClamp={1}>
             {projectName}
           </Text>

packages/widgets/src/archive-team-warrior/index.ts

@@ -1,5 +1,4 @@
 import { IconArchive } from "@tabler/icons-react";
-import { z } from "zod/v4";
 
 import { createWidgetDefinition } from "../definition";
 import { optionsBuilder } from "../options";
@@ -8,13 +7,10 @@ export const { definition, componentLoader } = createWidgetDefinition("archiveTe
   icon: IconArchive,
   createOptions() {
     return optionsBuilder.from((factory) => ({
-      url: factory.text({
-        defaultValue: "http://localhost:8001",
-        validate: z.string().url(),
-      }),
       showBroadcastMessage: factory.switch({
         defaultValue: true,
       }),
     }));
   },
+  supportedIntegrations: ["archiveTeamWarrior"],
 }).withDynamicImport(() => import("./component"));

packages/widgets/src/releases/component.tsx

@@ -531,7 +531,7 @@ const ExpandedDisplay = ({
         p={10}
       >
         <Group className="releases-repository-expanded-header" justify="space-between" align="center" gap="xs">
-          <Text className="releases-repository-expanded-header-identifier" size="xs" c="iconColor" ff="monospace">
+          <Text className="releases-repository-expanded-header-identifier" size="xs" c="dimmed" ff="monospace">
             {repository.identifier}
           </Text>
 
@@ -549,7 +549,7 @@ const ExpandedDisplay = ({
               <Text
                 className="releases-repository-expanded-header-provider-name"
                 size="xs"
-                c="iconColor"
+                c="dimmed"
                 ff="monospace"
               >
                 {repository.providerMetadata.name}
@@ -616,7 +616,7 @@ const ExpandedDisplay = ({
         {repository.error && (
           <>
             <Divider className="releases-repository-expanded-error-divider" mx="30%" />
-            <Title className="releases-repository-expanded-error-title" order={4} ta="center">
+            <Title className="releases-repository-expanded-error-title" order={4} ta="center" c="red">
               {t("error.label")}
             </Title>
             <Text