Ir al contenido
Documentación

Plugin Marketplace

Navegue, instale, y gestione plugins de la comunidad. Cada bundle `.nbplugin` es SHA-256 verificado en el momento de la instalación; plugins corren en un sandbox de renderer con permisos declarados en manifest.

Qué es

Un tab de workspace listando plugins aprobados del marketplace moderado (https://nosqlstudio.com/marketplace/plugins) más su conjunto instalado localmente. Plugins extienden NoSqlStudio con tabs de workspace, clasificadores de datamask, variantes de tema, query inspectors, y acciones de menú. Ejemplos: Geo Heatmap (plotea cualquier field GeoJSON en un mapa), BSONSize Profiler (análisis de storage per-collection), KPI Card Builder (cards de dashboard customizados).

Cuándo usar

Instale plugins cuando el feature set built-in no atiende una necesidad específica — usualmente una visualización domain-specific o una integración one-off. El marketplace le deja descubrir plugins; este workspace gestiona el conjunto instalado.

Cómo abrirlo

  1. En el app desktop del NoSqlStudio, abra el menú Tools → Plugin Marketplace, o presione Ctrl+Alt+Shift+G.
  2. El workspace abre con dos columnas: plugins instalados a la izquierda, un pane Browse buscando el catálogo del marketplace a la derecha.
  3. Haga clic en un plugin en el pane Browse para ver su manifest, permisos, screenshots, y fingerprint SHA-256. Haga clic en Install para descargar.

Instalando un plugin

  1. Browse — busque por nombre o tag. Cada card muestra el autor, permisos declarados, y conteo de install.
  2. Verify — el marketplace publica el SHA-256 del bundle + manifest. El installer local se rehúsa a escribir el bundle al disco si el hash real difiere.
  3. Permissions — revise lo que el plugin pide: workspace mount, fetch (cuáles hosts), DataService read/write, telemetry. Rechace si cualquier permiso parece excesivo para la función declarada.
  4. Install — el engine extrae el bundle a userData/Plugins/<plugin-id>/, registra la entry, y recarga las surfaces afectadas.
  5. Uninstall / disable — cada plugin instalado tiene un toggle y un botón remove. Disabling no elimina; removal limpia la carpeta userData.

Enviando su propio plugin

Construya con el @mongodb-js/compass-plugin-sdk, empaque en un zip `.nbplugin` (manifest.json + JS bundle), luego envíe en https://nosqlstudio.com/marketplace/submit. Moderadores verifican el manifest + SHA-256 en hasta 5 días hábiles.

Limitaciones (v1)

  • Plugins corren en el proceso renderer, no aislados. Un plugin malicioso con permisos amplios puede leer secrets de conexión. Audite el manifest antes de instalar.
  • Hot-reload después de install requiere que el workspace afectado sea cerrado y reabierto. La primera instalación de un plugin que registra un workspace tab necesita un reload completo del app (Cmd/Ctrl+R).
  • Fallback del marketplace — si el catálogo central está unreachable, el workspace muestra un cache stale (o los sample plugins built-in en el first run).