@nathanclaire/rum-angular

Angular integration for the edge-rum SDK. Provides an Angular module, DI service, and automatic capture of route changes, errors, and Ionic page lifecycle.

Install

npm install @nathanclaire/rum @nathanclaire/rum-angular @nathanclaire/rum-capacitor

Setup

// app.module.ts
import { EdgeRumModule } from '@nathanclaire/rum-angular';

@NgModule({
  imports: [
    EdgeRumModule.forRoot({
      apiKey: 'edge_your_api_key_here',
      endpoint: 'https://your-collector.example.com/collector/telemetry',
      appName: 'MyApp',
      appVersion: '1.0.0',
      appPackage: 'com.yourco.app',
    }),
  ],
})
export class AppModule {}

What it captures automatically

• Angular route changes as screen_view events
• Unhandled errors and promise rejections as app.crash events
• Ionic page enter/leave timing as screen_timing events

Using the service

import { EdgeRumService } from '@nathanclaire/rum-angular';

constructor(private rum: EdgeRumService) {}

onLogin(user: { name?: string; email?: string; phone?: string }) {
  // user.id is owned by the SDK (auto-generated, persisted across sessions).
  // identify() attaches user details — pass null to clear a field.
  this.rum.identify({ name: user.name, email: user.email, phone: user.phone });
}

onCheckout() {
  this.rum.track('checkout_started', { value: 49.99 });
}

Peer dependencies

• @angular/core >= 16
• @angular/router >= 16
• rxjs >= 7

License

MIT