feat(plugin-sentry): add plugin for sentry

[ysh4296]

plugin-sentry (Issue from #520)

Stackflow has a unique screen handling with "Activity."
Currently, Sentry doesn't support tracing for this mechanism,
So we had to create own plugin.

This pr contains a basic functional plugin that works for:

• Tracing page load events
• Tracing activity changes (push, pop, replace)

How I Tested It:

• Test with demo project working on localhost, personal sentry account
• Load built package from local file path

// demo/.../Stack.tsx

import * as Sentry from "@sentry/browser";
import { sentryPlugin } from "../../../extensions/plugin-sentry/dist";

export const { Stack, actions } = stackflow({
  config,
  components: {
    Main,
    Article,
  },
  plugins: [
    sentryPlugin({
      dsn: "https://example-dsn-key",
      integrations: [Sentry.replayIntegration()],
      // Tracing
      tracesSampleRate: 1.0, //  Capture 100% of the transactions
      // Set 'tracePropagationTargets' to control for which URLs distributed tracing should be enabled
      tracePropagationTargets: ["localhost"],
      // Session Replay
      replaysSessionSampleRate: 0.1, // This sets the sample rate at 10%. You may want to change it to 100% while in development and then sample at a lower rate in production.
      replaysOnErrorSampleRate: 1.0, // If you're not already sampling the entire session, change the sample rate to 100% when sampling sessions where errors occur.
    }),
  ],
});

Screen shots & additional explanation

Performance

• Recorded transactions can be viewed under the Performance tab.
• Both Page Load and Activity Changes (navigation events) are successfully recorded.

Error Tracing

• This plugin integrates seamlessly with other tools (e.g., Replay Integration).
• It traces user actions within transactions, providing more context for debugging.

Note

I'm not sure if this is the 'desired' behavior, so I would appreciate any feedback.

[changeset-bot]

⚠️ No Changeset found

Latest commit: 436ed73

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Updated (UTC)
stackflow-docs	✅ Ready (Inspect)	Visit Preview	Jan 18, 2025 5:44am

[tonyfromundefined]

Hello @ysh4296! It's the end of the year and we're currently busy with other work, so the review is delayed. I think it will be possible early next year, so please keep that in mind.