@get-bb/plugin-sdk 0.4.4 → 0.4.8

package/dist/testing/app.js

@@ -57,6 +57,14 @@ function requireSlotId(kind, value) {
   }
   return value;
 }
+function requireProviderId(kind, value) {
+  if (typeof value !== "string" || !PLUGIN_SLOT_ID_PATTERN.test(value)) {
+    throw new Error(
+      `${kind}: "providerId" must match ${String(PLUGIN_SLOT_ID_PATTERN)}, got ${JSON.stringify(value)}`
+    );
+  }
+  return value;
+}
 function requireMessageDirectiveId(kind, value) {
   if (typeof value !== "string" || !PLUGIN_MESSAGE_DIRECTIVE_ID_PATTERN.test(value)) {
     throw new Error(
@@ -243,6 +251,318 @@ function collectComposerCustomization(registration, seenIds, onRejected) {
   }
 }
 
+// src/internal/plugin-app-collector.ts
+function collectPluginAppRegistrations(definition, onComposerCustomizationRejected = (reason) => console.warn(reason)) {
+  const collected = {
+    homepageSections: [],
+    settingsSections: [],
+    navPanels: [],
+    threadPanelActions: [],
+    newThreadPanelActions: [],
+    composerCustomizations: [],
+    pendingInteractions: [],
+    sidebarFooterActions: [],
+    threadLists: [],
+    threadHeaderActions: [],
+    fileOpeners: [],
+    messageDirectives: [],
+    messageActions: [],
+    providerIcons: [],
+    contentScripts: []
+  };
+  const seenIds = {
+    homepageSection: /* @__PURE__ */ new Set(),
+    settingsSection: /* @__PURE__ */ new Set(),
+    navPanel: /* @__PURE__ */ new Set(),
+    threadPanelAction: /* @__PURE__ */ new Set(),
+    newThreadPanelAction: /* @__PURE__ */ new Set(),
+    composerCustomization: /* @__PURE__ */ new Set(),
+    pendingInteraction: /* @__PURE__ */ new Set(),
+    sidebarFooterAction: /* @__PURE__ */ new Set(),
+    threadList: /* @__PURE__ */ new Set(),
+    threadHeaderAction: /* @__PURE__ */ new Set(),
+    fileOpener: /* @__PURE__ */ new Set(),
+    messageDirective: /* @__PURE__ */ new Set(),
+    messageAction: /* @__PURE__ */ new Set(),
+    providerIcon: /* @__PURE__ */ new Set(),
+    contentScript: /* @__PURE__ */ new Set()
+  };
+  definition.setup({
+    slots: {
+      homepageSection(registration) {
+        const kind = "slots.homepageSection";
+        const id = requireSlotId(kind, registration?.id);
+        requireUniqueId(kind, seenIds.homepageSection, id);
+        collected.homepageSections.push({
+          id,
+          title: requireNonEmptyString(kind, "title", registration.title),
+          component: requireComponent(kind, registration.component)
+        });
+      },
+      settingsSection(registration) {
+        const kind = "slots.settingsSection";
+        const id = requireSlotId(kind, registration?.id);
+        requireUniqueId(kind, seenIds.settingsSection, id);
+        const title = requireOptionalString(kind, "title", registration.title);
+        const description = requireOptionalString(
+          kind,
+          "description",
+          registration.description
+        );
+        collected.settingsSections.push({
+          id,
+          ...title !== void 0 ? { title } : {},
+          ...description !== void 0 ? { description } : {},
+          component: requireComponent(kind, registration.component)
+        });
+      },
+      navPanel(registration) {
+        const kind = "slots.navPanel";
+        const id = requireSlotId(kind, registration?.id);
+        requireUniqueId(kind, seenIds.navPanel, id);
+        const path = requireNonEmptyString(kind, "path", registration.path);
+        if (!PLUGIN_SLOT_ID_PATTERN.test(path)) {
+          throw new Error(
+            `${kind}: "path" must match ${String(PLUGIN_SLOT_ID_PATTERN)} (it becomes a URL segment), got ${JSON.stringify(path)}`
+          );
+        }
+        if (registration.headerContent !== void 0 && typeof registration.headerContent !== "function") {
+          throw new Error(
+            `${kind}: "headerContent" must be a React component function when set`
+          );
+        }
+        if (registration.experimental_sidebarAccessory !== void 0 && typeof registration.experimental_sidebarAccessory !== "function") {
+          throw new Error(
+            `${kind}: "experimental_sidebarAccessory" must be a React component function when set`
+          );
+        }
+        const experimentalFixedTabs = (() => {
+          if (registration.experimental_fixedTabs === void 0) return [];
+          if (!Array.isArray(registration.experimental_fixedTabs)) {
+            throw new Error(
+              `${kind}: "experimental_fixedTabs" must be an array when set`
+            );
+          }
+          const seenFixedTabIds = /* @__PURE__ */ new Set();
+          return registration.experimental_fixedTabs.map((value, index) => {
+            const fixedTabKind = `${kind}.experimental_fixedTabs[${index}]`;
+            const fixedTab = value;
+            const id2 = requireSlotId(fixedTabKind, fixedTab?.id);
+            requireUniqueId(fixedTabKind, seenFixedTabIds, id2);
+            const layout = fixedTab?.layout;
+            if (layout !== void 0 && layout !== "padded" && layout !== "flush") {
+              throw new Error(
+                `${fixedTabKind}: "layout" must be "padded" or "flush" when set`
+              );
+            }
+            return {
+              id: id2,
+              title: requireNonEmptyString(
+                fixedTabKind,
+                "title",
+                fixedTab?.title
+              ),
+              icon: requireNonEmptyString(
+                fixedTabKind,
+                "icon",
+                fixedTab?.icon
+              ),
+              component: requireComponent(fixedTabKind, fixedTab?.component),
+              ...layout === void 0 ? {} : { layout }
+            };
+          });
+        })();
+        collected.navPanels.push({
+          id,
+          title: requireNonEmptyString(kind, "title", registration.title),
+          icon: requireNonEmptyString(kind, "icon", registration.icon),
+          path,
+          component: requireComponent(kind, registration.component),
+          ...experimentalFixedTabs.length > 0 ? { experimental_fixedTabs: experimentalFixedTabs } : {},
+          ...registration.experimental_sidebarAccessory !== void 0 ? {
+            experimental_sidebarAccessory: registration.experimental_sidebarAccessory
+          } : {},
+          ...registration.headerContent !== void 0 ? { headerContent: registration.headerContent } : {}
+        });
+      },
+      threadPanelAction(registration) {
+        const kind = "slots.threadPanelAction";
+        const id = requireSlotId(kind, registration?.id);
+        requireUniqueId(kind, seenIds.threadPanelAction, id);
+        if (registration.run !== void 0 && typeof registration.run !== "function") {
+          throw new Error(`${kind}: "run" must be a function when set`);
+        }
+        if (registration.layout !== void 0 && registration.layout !== "padded" && registration.layout !== "flush") {
+          throw new Error(`${kind}: "layout" must be "padded" or "flush"`);
+        }
+        collected.threadPanelActions.push({
+          id,
+          title: requireNonEmptyString(kind, "title", registration.title),
+          ...registration.icon !== void 0 ? {
+            icon: requireNonEmptyString(kind, "icon", registration.icon)
+          } : {},
+          component: requireComponent(kind, registration.component),
+          ...registration.layout !== void 0 ? { layout: registration.layout } : {},
+          ...registration.run !== void 0 ? { run: registration.run } : {}
+        });
+      },
+      experimental_newThreadPanelAction(registration) {
+        const kind = "slots.experimental_newThreadPanelAction";
+        const id = requireSlotId(kind, registration?.id);
+        requireUniqueId(kind, seenIds.newThreadPanelAction, id);
+        if (registration.run !== void 0 && typeof registration.run !== "function") {
+          throw new Error(`${kind}: "run" must be a function when set`);
+        }
+        if (registration.layout !== void 0 && registration.layout !== "padded" && registration.layout !== "flush") {
+          throw new Error(`${kind}: "layout" must be "padded" or "flush"`);
+        }
+        collected.newThreadPanelActions.push({
+          id,
+          title: requireNonEmptyString(kind, "title", registration.title),
+          ...registration.icon !== void 0 ? {
+            icon: requireNonEmptyString(kind, "icon", registration.icon)
+          } : {},
+          component: requireComponent(kind, registration.component),
+          ...registration.layout !== void 0 ? { layout: registration.layout } : {},
+          ...registration.run !== void 0 ? { run: registration.run } : {}
+        });
+      },
+      pendingInteraction(registration) {
+        const kind = "slots.pendingInteraction";
+        const id = requireSlotId(kind, registration?.id);
+        requireUniqueId(kind, seenIds.pendingInteraction, id);
+        collected.pendingInteractions.push({
+          id,
+          component: requireComponent(kind, registration.component)
+        });
+      },
+      sidebarFooterAction(registration) {
+        const kind = "slots.sidebarFooterAction";
+        const id = requireSlotId(kind, registration?.id);
+        requireUniqueId(kind, seenIds.sidebarFooterAction, id);
+        if (typeof registration.run !== "function") {
+          throw new Error(`${kind}: "run" must be a function`);
+        }
+        collected.sidebarFooterActions.push({
+          id,
+          title: requireNonEmptyString(kind, "title", registration.title),
+          icon: requireNonEmptyString(kind, "icon", registration.icon),
+          run: registration.run
+        });
+      },
+      experimental_threadList(registration) {
+        const kind = "slots.experimental_threadList";
+        const id = requireSlotId(kind, registration?.id);
+        requireUniqueId(kind, seenIds.threadList, id);
+        const description = requireOptionalString(
+          kind,
+          "description",
+          registration.description
+        );
+        collected.threadLists.push({
+          id,
+          title: requireNonEmptyString(kind, "title", registration.title),
+          ...description !== void 0 ? { description } : {},
+          component: requireComponent(kind, registration.component)
+        });
+      },
+      experimental_threadHeaderAction(registration) {
+        const kind = "slots.experimental_threadHeaderAction";
+        const id = requireSlotId(kind, registration?.id);
+        requireUniqueId(kind, seenIds.threadHeaderAction, id);
+        collected.threadHeaderActions.push({
+          id,
+          title: requireNonEmptyString(kind, "title", registration.title),
+          component: requireComponent(kind, registration.component)
+        });
+      },
+      fileOpener(registration) {
+        const kind = "slots.fileOpener";
+        const id = requireSlotId(kind, registration?.id);
+        requireUniqueId(kind, seenIds.fileOpener, id);
+        const rawExtensions = registration?.extensions;
+        if (!Array.isArray(rawExtensions) || rawExtensions.length === 0) {
+          throw new Error(
+            `${kind}: "extensions" must be a non-empty array of lowercase extensions without the dot`
+          );
+        }
+        const extensions = rawExtensions.map((extension) => {
+          if (typeof extension !== "string" || !/^[a-z0-9]+$/.test(extension)) {
+            throw new Error(
+              `${kind}: extensions must be lowercase alphanumerics without the dot, got ${JSON.stringify(extension)}`
+            );
+          }
+          return extension;
+        });
+        collected.fileOpeners.push({
+          id,
+          title: requireNonEmptyString(kind, "title", registration.title),
+          extensions,
+          component: requireComponent(kind, registration.component)
+        });
+      },
+      messageDirective(registration) {
+        const kind = "slots.messageDirective";
+        const id = requireMessageDirectiveId(kind, registration?.id);
+        requireUniqueId(kind, seenIds.messageDirective, id);
+        collected.messageDirectives.push({
+          id,
+          component: requireComponent(kind, registration.component)
+        });
+      },
+      messageAction(registration) {
+        const kind = "slots.messageAction";
+        const id = requireSlotId(kind, registration?.id);
+        requireUniqueId(kind, seenIds.messageAction, id);
+        if (typeof registration.run !== "function") {
+          throw new Error(`${kind}: "run" must be a function`);
+        }
+        collected.messageActions.push({
+          id,
+          title: requireNonEmptyString(kind, "title", registration.title),
+          ...registration.icon !== void 0 ? {
+            icon: requireNonEmptyString(kind, "icon", registration.icon)
+          } : {},
+          run: registration.run
+        });
+      },
+      experimental_providerIcon(registration) {
+        const kind = "slots.experimental_providerIcon";
+        const providerId = requireProviderId(kind, registration?.providerId);
+        requireUniqueId(kind, seenIds.providerIcon, providerId);
+        collected.providerIcons.push({
+          providerId,
+          icon: requireComponent(kind, registration.icon)
+        });
+      }
+    },
+    composer: {
+      customize(registration) {
+        const customization = collectComposerCustomization(
+          registration,
+          seenIds.composerCustomization,
+          onComposerCustomizationRejected
+        );
+        if (customization !== null) {
+          collected.composerCustomizations.push(customization);
+        }
+      }
+    },
+    contentScripts: {
+      register(registration) {
+        const kind = "contentScripts.register";
+        const id = requireSlotId(kind, registration?.id);
+        requireUniqueId(kind, seenIds.contentScript, id);
+        if (typeof registration.mount !== "function") {
+          throw new Error(`${kind}: "mount" must be a function`);
+        }
+        collected.contentScripts.push({ id, mount: registration.mount });
+      }
+    }
+  });
+  return collected;
+}
+
 // src/testing/app.tsx
 import { jsx, jsxs } from "react/jsx-runtime";
 function SlotLifecycleGuard({
@@ -513,262 +833,6 @@ function installTestPluginRuntime() {
     pluginSdkApp: testPluginSdkApp
   };
 }
-function collectRegistrations(definition) {
-  const captured = {
-    homepageSections: [],
-    settingsSections: [],
-    navPanels: [],
-    threadPanelActions: [],
-    newThreadPanelActions: [],
-    composerCustomizations: [],
-    pendingInteractions: [],
-    sidebarFooterActions: [],
-    threadLists: [],
-    threadHeaderActions: [],
-    fileOpeners: [],
-    messageDirectives: [],
-    messageActions: [],
-    contentScripts: []
-  };
-  const seenIds = {
-    homepageSection: /* @__PURE__ */ new Set(),
-    settingsSection: /* @__PURE__ */ new Set(),
-    navPanel: /* @__PURE__ */ new Set(),
-    threadPanelAction: /* @__PURE__ */ new Set(),
-    newThreadPanelAction: /* @__PURE__ */ new Set(),
-    composerCustomization: /* @__PURE__ */ new Set(),
-    pendingInteraction: /* @__PURE__ */ new Set(),
-    sidebarFooterAction: /* @__PURE__ */ new Set(),
-    threadList: /* @__PURE__ */ new Set(),
-    threadHeaderAction: /* @__PURE__ */ new Set(),
-    fileOpener: /* @__PURE__ */ new Set(),
-    messageDirective: /* @__PURE__ */ new Set(),
-    messageAction: /* @__PURE__ */ new Set(),
-    contentScript: /* @__PURE__ */ new Set()
-  };
-  definition.setup({
-    slots: {
-      homepageSection(registration) {
-        const kind = "slots.homepageSection";
-        const id = requireSlotId(kind, registration?.id);
-        requireUniqueId(kind, seenIds.homepageSection, id);
-        captured.homepageSections.push({
-          id,
-          title: requireNonEmptyString(kind, "title", registration.title),
-          component: requireComponent(kind, registration.component)
-        });
-      },
-      settingsSection(registration) {
-        const kind = "slots.settingsSection";
-        const id = requireSlotId(kind, registration?.id);
-        requireUniqueId(kind, seenIds.settingsSection, id);
-        const title = requireOptionalString(kind, "title", registration.title);
-        const description = requireOptionalString(
-          kind,
-          "description",
-          registration.description
-        );
-        captured.settingsSections.push({
-          id,
-          ...title !== void 0 ? { title } : {},
-          ...description !== void 0 ? { description } : {},
-          component: requireComponent(kind, registration.component)
-        });
-      },
-      navPanel(registration) {
-        const kind = "slots.navPanel";
-        const id = requireSlotId(kind, registration?.id);
-        requireUniqueId(kind, seenIds.navPanel, id);
-        const path = requireNonEmptyString(kind, "path", registration.path);
-        if (!PLUGIN_SLOT_ID_PATTERN.test(path)) {
-          throw new Error(
-            `${kind}: "path" must match ${String(PLUGIN_SLOT_ID_PATTERN)} (it becomes a URL segment), got ${JSON.stringify(path)}`
-          );
-        }
-        if (registration.headerContent !== void 0 && typeof registration.headerContent !== "function") {
-          throw new Error(
-            `${kind}: "headerContent" must be a React component function when set`
-          );
-        }
-        if (registration.experimental_sidebarAccessory !== void 0 && typeof registration.experimental_sidebarAccessory !== "function") {
-          throw new Error(
-            `${kind}: "experimental_sidebarAccessory" must be a React component function when set`
-          );
-        }
-        captured.navPanels.push({
-          id,
-          title: requireNonEmptyString(kind, "title", registration.title),
-          icon: requireNonEmptyString(kind, "icon", registration.icon),
-          path,
-          component: requireComponent(kind, registration.component),
-          ...registration.experimental_sidebarAccessory !== void 0 ? {
-            experimental_sidebarAccessory: registration.experimental_sidebarAccessory
-          } : {},
-          ...registration.headerContent !== void 0 ? { headerContent: registration.headerContent } : {}
-        });
-      },
-      threadPanelAction(registration) {
-        const kind = "slots.threadPanelAction";
-        const id = requireSlotId(kind, registration?.id);
-        requireUniqueId(kind, seenIds.threadPanelAction, id);
-        if (registration.run !== void 0 && typeof registration.run !== "function") {
-          throw new Error(`${kind}: "run" must be a function when set`);
-        }
-        if (registration.layout !== void 0 && registration.layout !== "padded" && registration.layout !== "flush") {
-          throw new Error(`${kind}: "layout" must be "padded" or "flush"`);
-        }
-        captured.threadPanelActions.push({
-          id,
-          title: requireNonEmptyString(kind, "title", registration.title),
-          ...registration.icon !== void 0 ? { icon: requireNonEmptyString(kind, "icon", registration.icon) } : {},
-          component: requireComponent(kind, registration.component),
-          ...registration.layout !== void 0 ? { layout: registration.layout } : {},
-          ...registration.run !== void 0 ? { run: registration.run } : {}
-        });
-      },
-      experimental_newThreadPanelAction(registration) {
-        const kind = "slots.experimental_newThreadPanelAction";
-        const id = requireSlotId(kind, registration?.id);
-        requireUniqueId(kind, seenIds.newThreadPanelAction, id);
-        if (registration.run !== void 0 && typeof registration.run !== "function") {
-          throw new Error(`${kind}: "run" must be a function when set`);
-        }
-        if (registration.layout !== void 0 && registration.layout !== "padded" && registration.layout !== "flush") {
-          throw new Error(`${kind}: "layout" must be "padded" or "flush"`);
-        }
-        captured.newThreadPanelActions.push({
-          id,
-          title: requireNonEmptyString(kind, "title", registration.title),
-          ...registration.icon !== void 0 ? { icon: requireNonEmptyString(kind, "icon", registration.icon) } : {},
-          component: requireComponent(kind, registration.component),
-          ...registration.layout !== void 0 ? { layout: registration.layout } : {},
-          ...registration.run !== void 0 ? { run: registration.run } : {}
-        });
-      },
-      pendingInteraction(registration) {
-        const kind = "slots.pendingInteraction";
-        const id = requireSlotId(kind, registration?.id);
-        requireUniqueId(kind, seenIds.pendingInteraction, id);
-        captured.pendingInteractions.push({
-          id,
-          component: requireComponent(kind, registration.component)
-        });
-      },
-      sidebarFooterAction(registration) {
-        const kind = "slots.sidebarFooterAction";
-        const id = requireSlotId(kind, registration?.id);
-        requireUniqueId(kind, seenIds.sidebarFooterAction, id);
-        if (typeof registration.run !== "function") {
-          throw new Error(`${kind}: "run" must be a function`);
-        }
-        captured.sidebarFooterActions.push({
-          id,
-          title: requireNonEmptyString(kind, "title", registration.title),
-          icon: requireNonEmptyString(kind, "icon", registration.icon),
-          run: registration.run
-        });
-      },
-      experimental_threadList(registration) {
-        const kind = "slots.experimental_threadList";
-        const id = requireSlotId(kind, registration?.id);
-        requireUniqueId(kind, seenIds.threadList, id);
-        const description = requireOptionalString(
-          kind,
-          "description",
-          registration.description
-        );
-        captured.threadLists.push({
-          id,
-          title: requireNonEmptyString(kind, "title", registration.title),
-          ...description !== void 0 ? { description } : {},
-          component: requireComponent(kind, registration.component)
-        });
-      },
-      experimental_threadHeaderAction(registration) {
-        const kind = "slots.experimental_threadHeaderAction";
-        const id = requireSlotId(kind, registration?.id);
-        requireUniqueId(kind, seenIds.threadHeaderAction, id);
-        captured.threadHeaderActions.push({
-          id,
-          title: requireNonEmptyString(kind, "title", registration.title),
-          component: requireComponent(kind, registration.component)
-        });
-      },
-      fileOpener(registration) {
-        const kind = "slots.fileOpener";
-        const id = requireSlotId(kind, registration?.id);
-        requireUniqueId(kind, seenIds.fileOpener, id);
-        const rawExtensions = registration?.extensions;
-        if (!Array.isArray(rawExtensions) || rawExtensions.length === 0) {
-          throw new Error(
-            `${kind}: "extensions" must be a non-empty array of lowercase extensions without the dot`
-          );
-        }
-        const extensions = rawExtensions.map((extension) => {
-          if (typeof extension !== "string" || !/^[a-z0-9]+$/.test(extension)) {
-            throw new Error(
-              `${kind}: extensions must be lowercase alphanumerics without the dot, got ${JSON.stringify(extension)}`
-            );
-          }
-          return extension;
-        });
-        captured.fileOpeners.push({
-          id,
-          title: requireNonEmptyString(kind, "title", registration.title),
-          extensions,
-          component: requireComponent(kind, registration.component)
-        });
-      },
-      messageDirective(registration) {
-        const kind = "slots.messageDirective";
-        const id = requireMessageDirectiveId(kind, registration?.id);
-        requireUniqueId(kind, seenIds.messageDirective, id);
-        captured.messageDirectives.push({
-          id,
-          component: requireComponent(kind, registration.component)
-        });
-      },
-      messageAction(registration) {
-        const kind = "slots.messageAction";
-        const id = requireSlotId(kind, registration?.id);
-        requireUniqueId(kind, seenIds.messageAction, id);
-        if (typeof registration.run !== "function") {
-          throw new Error(`${kind}: "run" must be a function`);
-        }
-        captured.messageActions.push({
-          id,
-          title: requireNonEmptyString(kind, "title", registration.title),
-          ...registration.icon !== void 0 ? { icon: requireNonEmptyString(kind, "icon", registration.icon) } : {},
-          run: registration.run
-        });
-      }
-    },
-    composer: {
-      customize(registration) {
-        const customization = collectComposerCustomization(
-          registration,
-          seenIds.composerCustomization,
-          (reason) => console.warn(reason)
-        );
-        if (customization !== null) {
-          captured.composerCustomizations.push(customization);
-        }
-      }
-    },
-    contentScripts: {
-      register(registration) {
-        const kind = "contentScripts.register";
-        const id = requireSlotId(kind, registration?.id);
-        requireUniqueId(kind, seenIds.contentScript, id);
-        if (typeof registration.mount !== "function") {
-          throw new Error(`${kind}: "mount" must be a function`);
-        }
-        captured.contentScripts.push({ id, mount: registration.mount });
-      }
-    }
-  });
-  return captured;
-}
 async function loadPluginApp(source) {
   installTestPluginRuntime();
   const resolved = typeof source === "function" ? await source() : source;
@@ -778,7 +842,7 @@ async function loadPluginApp(source) {
       "the bundle's default export is not definePluginApp(...) from @get-bb/plugin-sdk/app"
     );
   }
-  return collectRegistrations(definition);
+  return collectPluginAppRegistrations(definition);
 }
 async function mountPluginContentScripts(app, options) {
   const controller = new AbortController();