feat(plugins): install marketplace packages via dbx deep link

apps/desktop/src/lib/plugins/__tests__/pluginInstallDeepLink.spec.ts

@@ -0,0 +1,26 @@
+import { describe, expect, it } from "vitest";
+import { parsePluginInstallDeepLink } from "../pluginInstallDeepLink";
+
+const PACKAGE_URL = "https://dl.dbxio.com/plugins/io.dbx.ssh/0.4.73/io.dbx.ssh-0.4.73-darwin-arm64.dbxp";
+
+describe("parsePluginInstallDeepLink", () => {
+  it("extracts the encoded package url", () => {
+    const draft = parsePluginInstallDeepLink(`dbx://plugins/install?url=${encodeURIComponent(PACKAGE_URL)}`);
+    expect(draft).toEqual({ url: PACKAGE_URL });
+  });
+
+  it("returns null for non-plugin links and junk", () => {
+    expect(parsePluginInstallDeepLink("dbx://connection/new?type=mysql")).toBeNull();
+    expect(parsePluginInstallDeepLink("dbx://plugins/installed?url=https://example.com/a.dbxp")).toBeNull();
+    expect(parsePluginInstallDeepLink("dbx://plugins/installation?url=https://example.com/a.dbxp")).toBeNull();
+    expect(parsePluginInstallDeepLink("")).toBeNull();
+    expect(parsePluginInstallDeepLink("not a url")).toBeNull();
+  });
+
+  it("throws for matching links without a usable url param", () => {
+    expect(() => parsePluginInstallDeepLink("dbx://plugins/install")).toThrow(/Missing url/);
+    expect(() => parsePluginInstallDeepLink("dbx://plugins/install?url=")).toThrow(/Missing url/);
+    expect(() => parsePluginInstallDeepLink(`dbx://plugins/install?url=${encodeURIComponent("ftp://example.com/a.dbxp")}`)).toThrow(/http/);
+    expect(() => parsePluginInstallDeepLink(`dbx://plugins/install?url=${encodeURIComponent(`https://example.com/${"a".repeat(2100)}`)}`)).toThrow(/too long/);
+  });
+});

apps/desktop/src/lib/plugins/pluginInstallDeepLink.ts

@@ -0,0 +1,31 @@
+const PLUGIN_INSTALL_DEEP_LINK_HOST = "plugins";
+const PLUGIN_INSTALL_DEEP_LINK_PATH = "/install";
+const MAX_DEEP_LINK_LENGTH = 4096;
+const MAX_PACKAGE_URL_LENGTH = 2048;
+
+export interface PluginInstallDeepLinkDraft {
+  url: string;
+}
+
+/**
+ * Parses `dbx://plugins/install?url=<encoded package url>` links.
+ * Returns null for non-matching links and throws for malformed ones,
+ * mirroring the AI config deep-link parser contract.
+ */
+export function parsePluginInstallDeepLink(value: string): PluginInstallDeepLinkDraft | null {
+  const trimmed = value.trim();
+  if (!trimmed || trimmed.length > MAX_DEEP_LINK_LENGTH) return null;
+  if (!trimmed.startsWith("dbx://")) return null;
+
+  const url = new URL(trimmed);
+  if (url.host !== PLUGIN_INSTALL_DEEP_LINK_HOST || url.pathname !== PLUGIN_INSTALL_DEEP_LINK_PATH) return null;
+
+  const packageUrl = url.searchParams.get("url")?.trim() ?? "";
+  if (!packageUrl) throw new Error("Missing url");
+  if (packageUrl.length > MAX_PACKAGE_URL_LENGTH) throw new Error("Package url is too long");
+
+  const protocol = new URL(packageUrl).protocol;
+  if (protocol !== "http:" && protocol !== "https:") throw new Error("Package url must be http(s)");
+
+  return { url: packageUrl };
+}