@fluidframework/telemetry-utils 2.0.0-dev.1.4.6.106135 → 2.0.0-dev.2.3.0.115467

package/src/events.ts

@@ -23,16 +23,25 @@ export function safeRaiseEvent(
     }
 }
 
+/**
+ * Raises events pertaining to the connection
+ * @param logger - The logger to log telemetry
+ * @param emitter - The event emitter instance
+ * @param connected - A boolean tracking whether the connection was in a connected state or not
+ * @param clientId - The connected/disconnected clientId
+ * @param disconnectedReason - The reason for the connection to be disconnected (Used for telemetry purposes only)
+ */
 export function raiseConnectedEvent(
     logger: ITelemetryLogger,
     emitter: EventEmitter,
     connected: boolean,
-    clientId?: string) {
+    clientId?: string,
+    disconnectedReason?: string) {
     try {
         if (connected) {
             emitter.emit(connectedEventName, clientId);
         } else {
-            emitter.emit(disconnectedEventName);
+            emitter.emit(disconnectedEventName, disconnectedReason);
         }
     } catch (error) {
         logger.sendErrorEvent({ eventName: "RaiseConnectedEventError" }, error);

package/src/index.ts

@@ -2,16 +2,6 @@
  * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
  * Licensed under the MIT License.
  */
-export * from "./debugLogger";
-export * from "./errorLogging";
-export * from "./eventEmitterWithErrorHandling";
-export * from "./events";
-export * from "./fluidErrorBase";
-export * from "./logger";
-export * from "./mockLogger";
-export * from "./thresholdCounter";
-export * from "./utils";
-export * from "./sampledTelemetryHelper";
 export {
     MonitoringContext,
     IConfigProviderBase,
@@ -21,3 +11,41 @@ export {
     ConfigTypes,
     loggerToMonitoringContext,
 } from "./config";
+export { DebugLogger } from "./debugLogger";
+export {
+	extractLogSafeErrorProperties,
+	generateErrorWithStack,
+	generateStack,
+	getCircularReplacer,
+	IFluidErrorAnnotations,
+	isExternalError,
+	isILoggingError,
+	isTaggedTelemetryPropertyValue,
+	LoggingError,
+	NORMALIZED_ERROR_TYPE,
+	normalizeError,
+	wrapError,
+	wrapErrorAndLog,
+} from "./errorLogging";
+export { EventEmitterWithErrorHandling } from "./eventEmitterWithErrorHandling";
+export { connectedEventName, disconnectedEventName, raiseConnectedEvent, safeRaiseEvent } from "./events";
+export { hasErrorInstanceId, IFluidErrorBase, isFluidError, isValidLegacyError } from "./fluidErrorBase";
+export {
+	BaseTelemetryNullLogger,
+	ChildLogger,
+	IPerformanceEventMarkers,
+	ITelemetryLoggerPropertyBag,
+	ITelemetryLoggerPropertyBags,
+	MultiSinkLogger,
+	PerformanceEvent,
+	TaggedLoggerAdapter,
+	TelemetryDataTag,
+	TelemetryEventPropertyTypes,
+	TelemetryLogger,
+	TelemetryNullLogger,
+	TelemetryUTLogger,
+} from "./logger";
+export { MockLogger } from "./mockLogger";
+export { ThresholdCounter } from "./thresholdCounter";
+export { SampledTelemetryHelper } from "./sampledTelemetryHelper";
+export { logIfFalse } from "./utils";

package/src/logger.ts

@@ -15,7 +15,7 @@ import {
     ITaggedTelemetryPropertyType,
     TelemetryEventCategory,
 } from "@fluidframework/common-definitions";
-import { BaseTelemetryNullLogger, performance } from "@fluidframework/common-utils";
+import { performance } from "@fluidframework/common-utils";
 import {
     CachedConfigProvider,
     loggerIsMonitoringContext,
@@ -528,7 +528,7 @@ export class PerformanceEvent {
  * Logger that is useful for UT
  * It can be used in places where logger instance is required, but events should be not send over.
  */
- export class TelemetryUTLogger implements ITelemetryLogger {
+export class TelemetryUTLogger implements ITelemetryLogger {
     public send(event: ITelemetryBaseEvent): void {
     }
     public sendTelemetryEvent(event: ITelemetryGenericEvent, error?: any) {
@@ -561,3 +561,29 @@ export class PerformanceEvent {
         throw error;
     }
 }
+
+/**
+ * Null logger
+ * It can be used in places where logger instance is required, but events should be not send over.
+ */
+export class BaseTelemetryNullLogger implements ITelemetryBaseLogger {
+    /**
+     * Send an event with the logger
+     *
+     * @param event - the event to send
+     */
+    public send(event: ITelemetryBaseEvent): void {
+        return;
+    }
+}
+
+/**
+ * Null logger
+ * It can be used in places where logger instance is required, but events should be not send over.
+ */
+export class TelemetryNullLogger implements ITelemetryLogger {
+    public send(event: ITelemetryBaseEvent): void {}
+    public sendTelemetryEvent(event: ITelemetryGenericEvent, error?: any): void {}
+    public sendErrorEvent(event: ITelemetryErrorEvent, error?: any): void {}
+    public sendPerformanceEvent(event: ITelemetryPerformanceEvent, error?: any): void {}
+}

package/src/packageVersion.ts

@@ -6,4 +6,4 @@
  */
 
 export const pkgName = "@fluidframework/telemetry-utils";
-export const pkgVersion = "2.0.0-dev.1.4.6.106135";
+export const pkgVersion = "2.0.0-dev.2.3.0.115467";