/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* vim: set ts=8 sts=2 et sw=2 tw=80: */
/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

#ifndef mozilla_TimelineConsumers_h_
#define mozilla_TimelineConsumers_h_

#include "nsIObserver.h"
#include "mozilla/StaticPtr.h"
#include "mozilla/UniquePtr.h"
#include "mozilla/LinkedList.h"
#include "mozilla/StaticMutex.h"
#include "nsTArray.h"
#include "TimelineMarkerEnums.h"  // for MarkerTracingType

class nsDocShell;
class nsIDocShell;
struct JSContext;

namespace mozilla {
class TimeStamp;
class MarkersStorage;
class AbstractTimelineMarker;

namespace dom {
struct ProfileTimelineMarker;
}

class TimelineConsumers {
 public:
  // Methods for registering interested consumers (i.e. "devtools toolboxes").
  // Each consumer should be directly focused on a particular docshell, but
  // timeline markers don't necessarily have to be tied to that docshell.
  // See the public `AddMarker*` methods below.
  // Main thread only.
  static void AddConsumer(nsDocShell* aDocShell);
  static void RemoveConsumer(nsDocShell* aDocShell);

  static bool HasConsumer(nsIDocShell* aDocShell);

  // Checks if there's any existing interested consumer.
  // May be called from any thread.
  static bool IsEmpty();

  // Methods for adding markers relevant for particular docshells, or generic
  // (meaning that they either can't be tied to a particular docshell, or one
  // wasn't accessible in the part of the codebase where they're instantiated).
  // These will only add markers if at least one docshell is currently being
  // observed by a timeline. Markers tied to a particular docshell won't be
  // created unless that docshell is specifically being currently observed.
  // See nsIDocShell::recordProfileTimelineMarkers

  // These methods create a basic TimelineMarker from a name and some metadata,
  // relevant for a specific docshell.
  // Main thread only.
  static void AddMarkerForDocShell(
      nsDocShell* aDocShell, const char* aName, MarkerTracingType aTracingType,
      MarkerStackRequest aStackRequest = MarkerStackRequest::STACK);
  static void AddMarkerForDocShell(
      nsIDocShell* aDocShell, const char* aName, MarkerTracingType aTracingType,
      MarkerStackRequest aStackRequest = MarkerStackRequest::STACK);

  static void AddMarkerForDocShell(
      nsDocShell* aDocShell, const char* aName, const TimeStamp& aTime,
      MarkerTracingType aTracingType,
      MarkerStackRequest aStackRequest = MarkerStackRequest::STACK);
  static void AddMarkerForDocShell(
      nsIDocShell* aDocShell, const char* aName, const TimeStamp& aTime,
      MarkerTracingType aTracingType,
      MarkerStackRequest aStackRequest = MarkerStackRequest::STACK);

  // These methods register and receive ownership of an already created marker,
  // relevant for a specific docshell.
  // Main thread only.
  static void AddMarkerForDocShell(nsDocShell* aDocShell,
                                   UniquePtr<AbstractTimelineMarker>&& aMarker);
  static void AddMarkerForDocShell(nsIDocShell* aDocShell,
                                   UniquePtr<AbstractTimelineMarker>&& aMarker);

  // These methods create a basic marker from a name and some metadata,
  // which doesn't have to be relevant to a specific docshell.
  // May be called from any thread.
  static void AddMarkerForAllObservedDocShells(
      const char* aName, MarkerTracingType aTracingType,
      MarkerStackRequest aStackRequest = MarkerStackRequest::STACK);
  static void AddMarkerForAllObservedDocShells(
      const char* aName, const TimeStamp& aTime, MarkerTracingType aTracingType,
      MarkerStackRequest aStackRequest = MarkerStackRequest::STACK);

  // This method clones and registers an already instantiated marker,
  // which doesn't have to be relevant to a specific docshell.
  // May be called from any thread.
  static void AddMarkerForAllObservedDocShells(
      UniquePtr<AbstractTimelineMarker>& aMarker);

  static void PopMarkers(nsDocShell* aDocShell, JSContext* aCx,
                         nsTArray<dom::ProfileTimelineMarker>& aStore);

 private:
  static StaticMutex sMutex;

  static LinkedList<MarkersStorage>& MarkersStores() MOZ_REQUIRES(sMutex);

  static uint32_t sActiveConsumers MOZ_GUARDED_BY(sMutex);
  static StaticAutoPtr<LinkedList<MarkersStorage>> sMarkersStores
      MOZ_GUARDED_BY(sMutex);
};

}  // namespace mozilla

#endif /* mozilla_TimelineConsumers_h_ */