feat(plugins)!: Unify plugin APIs

[dcramer]

Adds explicit plugin sets as the single enablement gate for Junior plugins. Installing a package is not enough; package content is discovered only when a package name or trusted factory is listed in defineJuniorPlugins(...). Nitro now injects that enabled set through #junior/config, so the server entry no longer repeats the declaration.

Before

Trusted plugins had to split metadata and hooks, and apps had separate build/runtime declarations:

// nitro.config.ts
juniorNitro({
  plugins: {
    packages: ["@sentry/junior-github"],
  },
});

// server.ts
const app = await createApp({
  plugins: [
    githubPlugin({
      botNameEnv: "GITHUB_APP_BOT_NAME",
      botEmailEnv: "GITHUB_APP_BOT_EMAIL",
    }),
  ],
});

The first unification pass made that safer, but still required wiring the same set twice:

// nitro.config.ts
juniorNitro({ plugins });

// server.ts
const app = await createApp({ plugins });

After

Apps export one runtime-safe plugin set and point Nitro at that module. createApp() reads the same enabled set from Nitro's virtual module:

// plugins.ts
export const plugins = defineJuniorPlugins([
  "@sentry/junior-agent-browser",
  "@sentry/junior-datadog",
  githubPlugin({
    botNameEnv: "GITHUB_APP_BOT_NAME",
    botEmailEnv: "GITHUB_APP_BOT_EMAIL",
  }),
  schedulerPlugin(),
  "@sentry/junior-sentry",
]);

// nitro.config.ts
juniorNitro({ plugins: "./plugins" });

// server.ts
const app = await createApp();

Trusted Plugins

GitHub and Scheduler now provide JavaScript registrations with inline manifests and trusted hooks. Manifest-only packages remain package-name strings. The separate plugins.ts module stays intentional because trusted hooks are live functions; importing nitro.config.ts at runtime would pull build config into the server bundle, and serializing hooks is not viable.

junior check, docs, package READMEs, generated API reference, and specs now point users at the explicit defineJuniorPlugins(...) path instead of the removed pluginPackages / plugins.packages shapes. Validated locally with pnpm typecheck, pnpm --filter @sentry/junior test, pnpm docs:check, pnpm skills:check, pnpm release:check, and pnpm --filter @sentry/junior-example exec nitro build.

Fixes GH-453

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
junior-docs	Ready	Preview, Comment	Jun 2, 2026 9:28am

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 0d84269. Configure here.}