Class TelemetryService

packages/foam-vscode/src/vscode/services/telemetry.ts:32–163

 * `docs/user/tools/telemetry.md` for the full list.
 */
export class TelemetryService implements IDisposable {
  private reporter: TelemetryReporter;
  private sessionWithCommandFired = false;
  private sessionWithNoteFired = false;

  constructor(opts: TelemetryServiceOptions) {
    this.reporter = new TelemetryReporter(
      TELEMETRY_CONNECTION_STRING,
      undefined,
      undefined,
      undefined,
      {
        commonProperties: {
          'foam.component': 'vscode',
          'foam.version': opts.foamVersion,
          'foam.coreVersion': opts.coreVersion,
        },
      }
    );
  }

  trackEvent(name: string, properties?: Record<string, string>): void {
    const fullName = EVENT_PREFIX + name;
    Logger.debug(
      `[telemetry] ${fullName}${properties ? ' ' + JSON.stringify(properties) : ''}`
    );
    this.reporter.sendTelemetryEvent(fullName, properties);
  }

  trackError(
    context: string,
    error: unknown,
    properties?: Record<string, string>
  ): void {
    const errorType =
      error instanceof Error ? error.constructor.name : 'UnknownError';
    const fullName = EVENT_PREFIX + 'error';
    Logger.debug(`[telemetry] ${fullName} in ${context}: ${errorType}`);
    this.reporter.sendTelemetryErrorEvent(fullName, {
      context,
      errorType,
      ...properties,
    });
  }

  /**
   * Fired once per activation, before Foam loads. The canonical "active session" metric.
   */
  trackSession(): void {
    this.trackEvent('session-started');
  }

  /**
   * Fired every time a command is invoked. Also fires `session-with-command` once
   * per session on the first invocation, distinguishing "Foam loaded" from "Foam was used".
   */
  trackCommand(command: string): void {
    if (!this.sessionWithCommandFired) {