@fluidframework/core-interfaces 2.0.0-internal.6.1.0 → 2.0.0-internal.6.2.0

package/src/events.ts

@@ -0,0 +1,430 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+
+/**
+ * Base interface for event emitters.
+ */
+export interface IEvent {
+	/**
+	 * Base event emitter signature.
+	 *
+	 * @remarks The event emitter polyfill and the node event emitter have different event types:
+	 * `string | symbol` vs. `string | number`.
+	 *
+	 * So for our typing we'll contrain to string, that way we work with both.
+	 *
+	 * @eventProperty
+	 */
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any
+	(event: string, listener: (...args: any[]) => void);
+}
+
+/**
+ * Base interface for error event emitters.
+ */
+export interface IErrorEvent extends IEvent {
+	/**
+	 * Base error event emitter signature.
+	 *
+	 * @eventProperty
+	 */
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any
+	(event: "error", listener: (message: any) => void);
+}
+
+/**
+ * Base interface for event providers.
+ */
+export interface IEventProvider<TEvent extends IEvent> {
+	/**
+	 * Registers a callback to be invoked when the corresponding event is triggered.
+	 */
+	readonly on: IEventTransformer<this, TEvent>;
+
+	/**
+	 * Registers a callback to be invoked the first time (after registration) the corresponding event is triggered.
+	 */
+	readonly once: IEventTransformer<this, TEvent>;
+
+	/**
+	 * Removes the corresponding event if it has been registered.
+	 */
+	readonly off: IEventTransformer<this, TEvent>;
+}
+
+/**
+ * Allows an interface to extend interfaces that already extend an {@link IEventProvider}.
+ *
+ * @example
+ * ``` typescript
+ * interface AEvents extends IEvent{
+ *  (event: "a-event",listener: (a: number)=>void);
+ * }
+ * interface A extends IEventProvider<AEvents>{
+ *  a: object;
+ * }
+ *
+ * interface BEvents extends IEvent{
+ *  (event: "b-event",listener: (b: string)=>void);
+ * }
+ * interface B extends ExtendEventProvider<AEvents, A, BEvents>{
+ *  b: boolean;
+ * };
+ * ```
+ * interface B will now extend interface A and its events
+ *
+ */
+export type ExtendEventProvider<
+	TBaseEvent extends IEvent,
+	TBase extends IEventProvider<TBaseEvent>,
+	TEvent extends TBaseEvent,
+> = Omit<Omit<Omit<TBase, "on">, "once">, "off"> &
+	IEventProvider<TBaseEvent> &
+	IEventProvider<TEvent>;
+
+// These types handle replacing IEventThisPlaceHolder with `this`, so we can
+// support polymorphic `this`. For instance if an event wanted to be:
+// (event: "some-event", listener:(target: this)=>void)
+//
+// it should be written as
+// (event: "some-event", listener:(target: IEventThisPlaceHolder)=>void)
+//
+// and IEventThisPlaceHolder will be replaced with this.
+// This is all consumers of these types need to know.
+
+/**
+ * The placeholder type that should be used instead of `this` in events.
+ */
+// eslint-disable-next-line @typescript-eslint/consistent-type-definitions
+export type IEventThisPlaceHolder = { thisPlaceHolder: "thisPlaceHolder" };
+
+/**
+ * Does the type replacement by changing types of {@link IEventThisPlaceHolder} to `TThis`
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export type ReplaceIEventThisPlaceHolder<L extends any[], TThis> = L extends any[]
+	? { [K in keyof L]: L[K] extends IEventThisPlaceHolder ? TThis : L[K] }
+	: L;
+
+/**
+ * Transforms the event overload by replacing {@link IEventThisPlaceHolder} with `TThis` in the event listener
+ * arguments and having the overload return `TTHis` as well
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export type TransformedEvent<TThis, E, A extends any[]> = (
+	event: E,
+	listener: (...args: ReplaceIEventThisPlaceHolder<A, TThis>) => void,
+) => TThis;
+
+/**
+ * This type is a conditional type for transforming all the overloads provided in `TEvent`.
+ *
+ * @remarks
+ * Due to limitations of the TypeScript typing system, we need to handle each number of overload individually.
+ * It currently supports the max of 15 event overloads which is more than we use anywhere.
+ * At more than 15 overloads we start to hit {@link https://github.com/microsoft/TypeScript/issues/37209 | TS2589}.
+ * If we need to move beyond 15 we should evaluate using a mapped type pattern like `{"event":(listenerArgs)=>void}`
+ */
+export type IEventTransformer<TThis, TEvent extends IEvent> = TEvent extends {
+	(event: infer E0, listener: (...args: infer A0) => void);
+	(event: infer E1, listener: (...args: infer A1) => void);
+	(event: infer E2, listener: (...args: infer A2) => void);
+	(event: infer E3, listener: (...args: infer A3) => void);
+	(event: infer E4, listener: (...args: infer A4) => void);
+	(event: infer E5, listener: (...args: infer A5) => void);
+	(event: infer E6, listener: (...args: infer A6) => void);
+	(event: infer E7, listener: (...args: infer A7) => void);
+	(event: infer E8, listener: (...args: infer A8) => void);
+	(event: infer E9, listener: (...args: infer A9) => void);
+	(event: infer E10, listener: (...args: infer A10) => void);
+	(event: infer E11, listener: (...args: infer A11) => void);
+	(event: infer E12, listener: (...args: infer A12) => void);
+	(event: infer E13, listener: (...args: infer A13) => void);
+	(event: infer E14, listener: (...args: infer A14) => void);
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any
+	(event: string, listener: (...args: any[]) => void);
+}
+	? TransformedEvent<TThis, E0, A0> &
+			TransformedEvent<TThis, E1, A1> &
+			TransformedEvent<TThis, E2, A2> &
+			TransformedEvent<TThis, E3, A3> &
+			TransformedEvent<TThis, E4, A4> &
+			TransformedEvent<TThis, E5, A5> &
+			TransformedEvent<TThis, E6, A6> &
+			TransformedEvent<TThis, E7, A7> &
+			TransformedEvent<TThis, E8, A8> &
+			TransformedEvent<TThis, E9, A9> &
+			TransformedEvent<TThis, E10, A10> &
+			TransformedEvent<TThis, E11, A11> &
+			TransformedEvent<TThis, E12, A12> &
+			TransformedEvent<TThis, E13, A13> &
+			TransformedEvent<TThis, E14, A14>
+	: TEvent extends {
+			(event: infer E0, listener: (...args: infer A0) => void);
+			(event: infer E1, listener: (...args: infer A1) => void);
+			(event: infer E2, listener: (...args: infer A2) => void);
+			(event: infer E3, listener: (...args: infer A3) => void);
+			(event: infer E4, listener: (...args: infer A4) => void);
+			(event: infer E5, listener: (...args: infer A5) => void);
+			(event: infer E6, listener: (...args: infer A6) => void);
+			(event: infer E7, listener: (...args: infer A7) => void);
+			(event: infer E8, listener: (...args: infer A8) => void);
+			(event: infer E9, listener: (...args: infer A9) => void);
+			(event: infer E10, listener: (...args: infer A10) => void);
+			(event: infer E11, listener: (...args: infer A11) => void);
+			(event: infer E12, listener: (...args: infer A12) => void);
+			(event: infer E13, listener: (...args: infer A13) => void);
+			// eslint-disable-next-line @typescript-eslint/no-explicit-any
+			(event: string, listener: (...args: any[]) => void);
+	  }
+	? TransformedEvent<TThis, E0, A0> &
+			TransformedEvent<TThis, E1, A1> &
+			TransformedEvent<TThis, E2, A2> &
+			TransformedEvent<TThis, E3, A3> &
+			TransformedEvent<TThis, E4, A4> &
+			TransformedEvent<TThis, E5, A5> &
+			TransformedEvent<TThis, E6, A6> &
+			TransformedEvent<TThis, E7, A7> &
+			TransformedEvent<TThis, E8, A8> &
+			TransformedEvent<TThis, E9, A9> &
+			TransformedEvent<TThis, E10, A10> &
+			TransformedEvent<TThis, E11, A11> &
+			TransformedEvent<TThis, E12, A12> &
+			TransformedEvent<TThis, E13, A13>
+	: TEvent extends {
+			(event: infer E0, listener: (...args: infer A0) => void);
+			(event: infer E1, listener: (...args: infer A1) => void);
+			(event: infer E2, listener: (...args: infer A2) => void);
+			(event: infer E3, listener: (...args: infer A3) => void);
+			(event: infer E4, listener: (...args: infer A4) => void);
+			(event: infer E5, listener: (...args: infer A5) => void);
+			(event: infer E6, listener: (...args: infer A6) => void);
+			(event: infer E7, listener: (...args: infer A7) => void);
+			(event: infer E8, listener: (...args: infer A8) => void);
+			(event: infer E9, listener: (...args: infer A9) => void);
+			(event: infer E10, listener: (...args: infer A10) => void);
+			(event: infer E11, listener: (...args: infer A11) => void);
+			(event: infer E12, listener: (...args: infer A12) => void);
+			// eslint-disable-next-line @typescript-eslint/no-explicit-any
+			(event: string, listener: (...args: any[]) => void);
+	  }
+	? TransformedEvent<TThis, E0, A0> &
+			TransformedEvent<TThis, E1, A1> &
+			TransformedEvent<TThis, E2, A2> &
+			TransformedEvent<TThis, E3, A3> &
+			TransformedEvent<TThis, E4, A4> &
+			TransformedEvent<TThis, E5, A5> &
+			TransformedEvent<TThis, E6, A6> &
+			TransformedEvent<TThis, E7, A7> &
+			TransformedEvent<TThis, E8, A8> &
+			TransformedEvent<TThis, E9, A9> &
+			TransformedEvent<TThis, E10, A10> &
+			TransformedEvent<TThis, E11, A11> &
+			TransformedEvent<TThis, E12, A12>
+	: TEvent extends {
+			(event: infer E0, listener: (...args: infer A0) => void);
+			(event: infer E1, listener: (...args: infer A1) => void);
+			(event: infer E2, listener: (...args: infer A2) => void);
+			(event: infer E3, listener: (...args: infer A3) => void);
+			(event: infer E4, listener: (...args: infer A4) => void);
+			(event: infer E5, listener: (...args: infer A5) => void);
+			(event: infer E6, listener: (...args: infer A6) => void);
+			(event: infer E7, listener: (...args: infer A7) => void);
+			(event: infer E8, listener: (...args: infer A8) => void);
+			(event: infer E9, listener: (...args: infer A9) => void);
+			(event: infer E10, listener: (...args: infer A10) => void);
+			(event: infer E11, listener: (...args: infer A11) => void);
+			// eslint-disable-next-line @typescript-eslint/no-explicit-any
+			(event: string, listener: (...args: any[]) => void);
+	  }
+	? TransformedEvent<TThis, E0, A0> &
+			TransformedEvent<TThis, E1, A1> &
+			TransformedEvent<TThis, E2, A2> &
+			TransformedEvent<TThis, E3, A3> &
+			TransformedEvent<TThis, E4, A4> &
+			TransformedEvent<TThis, E5, A5> &
+			TransformedEvent<TThis, E6, A6> &
+			TransformedEvent<TThis, E7, A7> &
+			TransformedEvent<TThis, E8, A8> &
+			TransformedEvent<TThis, E9, A9> &
+			TransformedEvent<TThis, E10, A10> &
+			TransformedEvent<TThis, E11, A11>
+	: TEvent extends {
+			(event: infer E0, listener: (...args: infer A0) => void);
+			(event: infer E1, listener: (...args: infer A1) => void);
+			(event: infer E2, listener: (...args: infer A2) => void);
+			(event: infer E3, listener: (...args: infer A3) => void);
+			(event: infer E4, listener: (...args: infer A4) => void);
+			(event: infer E5, listener: (...args: infer A5) => void);
+			(event: infer E6, listener: (...args: infer A6) => void);
+			(event: infer E7, listener: (...args: infer A7) => void);
+			(event: infer E8, listener: (...args: infer A8) => void);
+			(event: infer E9, listener: (...args: infer A9) => void);
+			(event: infer E10, listener: (...args: infer A10) => void);
+			// eslint-disable-next-line @typescript-eslint/no-explicit-any
+			(event: string, listener: (...args: any[]) => void);
+	  }
+	? TransformedEvent<TThis, E0, A0> &
+			TransformedEvent<TThis, E1, A1> &
+			TransformedEvent<TThis, E2, A2> &
+			TransformedEvent<TThis, E3, A3> &
+			TransformedEvent<TThis, E4, A4> &
+			TransformedEvent<TThis, E5, A5> &
+			TransformedEvent<TThis, E6, A6> &
+			TransformedEvent<TThis, E7, A7> &
+			TransformedEvent<TThis, E8, A8> &
+			TransformedEvent<TThis, E9, A9> &
+			TransformedEvent<TThis, E10, A10>
+	: TEvent extends {
+			(event: infer E0, listener: (...args: infer A0) => void);
+			(event: infer E1, listener: (...args: infer A1) => void);
+			(event: infer E2, listener: (...args: infer A2) => void);
+			(event: infer E3, listener: (...args: infer A3) => void);
+			(event: infer E4, listener: (...args: infer A4) => void);
+			(event: infer E5, listener: (...args: infer A5) => void);
+			(event: infer E6, listener: (...args: infer A6) => void);
+			(event: infer E7, listener: (...args: infer A7) => void);
+			(event: infer E8, listener: (...args: infer A8) => void);
+			(event: infer E9, listener: (...args: infer A9) => void);
+			// eslint-disable-next-line @typescript-eslint/no-explicit-any
+			(event: string, listener: (...args: any[]) => void);
+	  }
+	? TransformedEvent<TThis, E0, A0> &
+			TransformedEvent<TThis, E1, A1> &
+			TransformedEvent<TThis, E2, A2> &
+			TransformedEvent<TThis, E3, A3> &
+			TransformedEvent<TThis, E4, A4> &
+			TransformedEvent<TThis, E5, A5> &
+			TransformedEvent<TThis, E6, A6> &
+			TransformedEvent<TThis, E7, A7> &
+			TransformedEvent<TThis, E8, A8> &
+			TransformedEvent<TThis, E9, A9>
+	: TEvent extends {
+			(event: infer E0, listener: (...args: infer A0) => void);
+			(event: infer E1, listener: (...args: infer A1) => void);
+			(event: infer E2, listener: (...args: infer A2) => void);
+			(event: infer E3, listener: (...args: infer A3) => void);
+			(event: infer E4, listener: (...args: infer A4) => void);
+			(event: infer E5, listener: (...args: infer A5) => void);
+			(event: infer E6, listener: (...args: infer A6) => void);
+			(event: infer E7, listener: (...args: infer A7) => void);
+			(event: infer E8, listener: (...args: infer A8) => void);
+			// eslint-disable-next-line @typescript-eslint/no-explicit-any
+			(event: string, listener: (...args: any[]) => void);
+	  }
+	? TransformedEvent<TThis, E0, A0> &
+			TransformedEvent<TThis, E1, A1> &
+			TransformedEvent<TThis, E2, A2> &
+			TransformedEvent<TThis, E3, A3> &
+			TransformedEvent<TThis, E4, A4> &
+			TransformedEvent<TThis, E5, A5> &
+			TransformedEvent<TThis, E6, A6> &
+			TransformedEvent<TThis, E7, A7> &
+			TransformedEvent<TThis, E8, A8>
+	: TEvent extends {
+			(event: infer E0, listener: (...args: infer A0) => void);
+			(event: infer E1, listener: (...args: infer A1) => void);
+			(event: infer E2, listener: (...args: infer A2) => void);
+			(event: infer E3, listener: (...args: infer A3) => void);
+			(event: infer E4, listener: (...args: infer A4) => void);
+			(event: infer E5, listener: (...args: infer A5) => void);
+			(event: infer E6, listener: (...args: infer A6) => void);
+			(event: infer E7, listener: (...args: infer A7) => void);
+			// eslint-disable-next-line @typescript-eslint/no-explicit-any
+			(event: string, listener: (...args: any[]) => void);
+	  }
+	? TransformedEvent<TThis, E0, A0> &
+			TransformedEvent<TThis, E1, A1> &
+			TransformedEvent<TThis, E2, A2> &
+			TransformedEvent<TThis, E3, A3> &
+			TransformedEvent<TThis, E4, A4> &
+			TransformedEvent<TThis, E5, A5> &
+			TransformedEvent<TThis, E6, A6> &
+			TransformedEvent<TThis, E7, A7>
+	: TEvent extends {
+			(event: infer E0, listener: (...args: infer A0) => void);
+			(event: infer E1, listener: (...args: infer A1) => void);
+			(event: infer E2, listener: (...args: infer A2) => void);
+			(event: infer E3, listener: (...args: infer A3) => void);
+			(event: infer E4, listener: (...args: infer A4) => void);
+			(event: infer E5, listener: (...args: infer A5) => void);
+			(event: infer E6, listener: (...args: infer A6) => void);
+			// eslint-disable-next-line @typescript-eslint/no-explicit-any
+			(event: string, listener: (...args: any[]) => void);
+	  }
+	? TransformedEvent<TThis, E0, A0> &
+			TransformedEvent<TThis, E1, A1> &
+			TransformedEvent<TThis, E2, A2> &
+			TransformedEvent<TThis, E3, A3> &
+			TransformedEvent<TThis, E4, A4> &
+			TransformedEvent<TThis, E5, A5> &
+			TransformedEvent<TThis, E6, A6>
+	: TEvent extends {
+			(event: infer E0, listener: (...args: infer A0) => void);
+			(event: infer E1, listener: (...args: infer A1) => void);
+			(event: infer E2, listener: (...args: infer A2) => void);
+			(event: infer E3, listener: (...args: infer A3) => void);
+			(event: infer E4, listener: (...args: infer A4) => void);
+			(event: infer E5, listener: (...args: infer A5) => void);
+			// eslint-disable-next-line @typescript-eslint/no-explicit-any
+			(event: string, listener: (...args: any[]) => void);
+	  }
+	? TransformedEvent<TThis, E0, A0> &
+			TransformedEvent<TThis, E1, A1> &
+			TransformedEvent<TThis, E2, A2> &
+			TransformedEvent<TThis, E3, A3> &
+			TransformedEvent<TThis, E4, A4> &
+			TransformedEvent<TThis, E5, A5>
+	: TEvent extends {
+			(event: infer E0, listener: (...args: infer A0) => void);
+			(event: infer E1, listener: (...args: infer A1) => void);
+			(event: infer E2, listener: (...args: infer A2) => void);
+			(event: infer E3, listener: (...args: infer A3) => void);
+			(event: infer E4, listener: (...args: infer A4) => void);
+			// eslint-disable-next-line @typescript-eslint/no-explicit-any
+			(event: string, listener: (...args: any[]) => void);
+	  }
+	? TransformedEvent<TThis, E0, A0> &
+			TransformedEvent<TThis, E1, A1> &
+			TransformedEvent<TThis, E2, A2> &
+			TransformedEvent<TThis, E3, A3> &
+			TransformedEvent<TThis, E4, A4>
+	: TEvent extends {
+			(event: infer E0, listener: (...args: infer A0) => void);
+			(event: infer E1, listener: (...args: infer A1) => void);
+			(event: infer E2, listener: (...args: infer A2) => void);
+			(event: infer E3, listener: (...args: infer A3) => void);
+			// eslint-disable-next-line @typescript-eslint/no-explicit-any
+			(event: string, listener: (...args: any[]) => void);
+	  }
+	? TransformedEvent<TThis, E0, A0> &
+			TransformedEvent<TThis, E1, A1> &
+			TransformedEvent<TThis, E2, A2> &
+			TransformedEvent<TThis, E3, A3>
+	: TEvent extends {
+			(event: infer E0, listener: (...args: infer A0) => void);
+			(event: infer E1, listener: (...args: infer A1) => void);
+			(event: infer E2, listener: (...args: infer A2) => void);
+			// eslint-disable-next-line @typescript-eslint/no-explicit-any
+			(event: string, listener: (...args: any[]) => void);
+	  }
+	? TransformedEvent<TThis, E0, A0> &
+			TransformedEvent<TThis, E1, A1> &
+			TransformedEvent<TThis, E2, A2>
+	: TEvent extends {
+			(event: infer E0, listener: (...args: infer A0) => void);
+			(event: infer E1, listener: (...args: infer A1) => void);
+			// eslint-disable-next-line @typescript-eslint/no-explicit-any
+			(event: string, listener: (...args: any[]) => void);
+	  }
+	? TransformedEvent<TThis, E0, A0> & TransformedEvent<TThis, E1, A1>
+	: TEvent extends {
+			(event: infer E0, listener: (...args: infer A0) => void);
+			// eslint-disable-next-line @typescript-eslint/no-explicit-any
+			(event: string, listener: (...args: any[]) => void);
+	  }
+	? TransformedEvent<TThis, E0, A0>
+	: // eslint-disable-next-line @typescript-eslint/no-explicit-any
+	  TransformedEvent<TThis, string, any[]>;

package/src/index.ts

@@ -3,6 +3,27 @@
  * Licensed under the MIT License.
  */
 
+export type { IDisposable } from "./disposable";
+
+export {
+	FluidErrorTypes,
+	IErrorBase,
+	IGenericError,
+	IUsageError,
+	IThrottlingWarning,
+} from "./error";
+
+export type {
+	ExtendEventProvider,
+	IErrorEvent,
+	IEvent,
+	IEventProvider,
+	IEventThisPlaceHolder,
+	IEventTransformer,
+	ReplaceIEventThisPlaceHolder,
+	TransformedEvent,
+} from "./events";
+
 export {
 	IFluidLoadable,
 	IProvideFluidLoadable,
@@ -10,6 +31,17 @@ export {
 	IProvideFluidRunnable,
 } from "./fluidLoadable";
 
+export {
+	IFluidPackageEnvironment,
+	IFluidPackage,
+	isFluidPackage,
+	IFluidCodeDetailsConfig,
+	IFluidCodeDetails,
+	isFluidCodeDetails,
+	IFluidCodeDetailsComparer,
+	IProvideFluidCodeDetailsComparer,
+} from "./fluidPackage";
+
 // Typescript forgets the index signature when customers augment IRequestHeader if we export *.
 // So we export the explicit members as a workaround:
 // https://github.com/microsoft/TypeScript/issues/18877#issuecomment-476921038
@@ -28,19 +60,6 @@ export {
 	IProvideFluidHandle,
 } from "./handles";
 
-export {
-	IFluidPackageEnvironment,
-	IFluidPackage,
-	isFluidPackage,
-	IFluidCodeDetailsConfig,
-	IFluidCodeDetails,
-	isFluidCodeDetails,
-	IFluidCodeDetailsComparer,
-	IProvideFluidCodeDetailsComparer,
-} from "./fluidPackage";
-
-export { FluidObjectProviderKeys, FluidObject, FluidObjectKeys } from "./provider";
-export type { IDisposable } from "./disposable";
 export type {
 	ILoggingError,
 	ITaggedTelemetryPropertyType,
@@ -54,3 +73,5 @@ export type {
 	TelemetryEventCategory,
 	TelemetryEventPropertyType,
 } from "./logger";
+export { LogLevel } from "./logger";
+export { FluidObjectProviderKeys, FluidObject, FluidObjectKeys } from "./provider";

package/src/logger.ts

@@ -45,12 +45,23 @@ export interface ITelemetryBaseEvent extends ITelemetryProperties {
 	eventName: string;
 }
 
+/**
+ * Enum to specify a level to the log to filter out logs based on the level.
+ */
+export const enum LogLevel {
+	verbose = 0, // To log any verbose event for example when you are debugging something.
+	default = 10, // Default log level
+	error = 20, // To log errors.
+}
+
 /**
  * Interface to output telemetry events.
  * Implemented by hosting app / loader
  */
 export interface ITelemetryBaseLogger {
-	send(event: ITelemetryBaseEvent): void;
+	send(event: ITelemetryBaseEvent, logLevel?: LogLevel): void;
+
+	minLogLevel?: LogLevel;
 }
 
 /**
@@ -98,20 +109,27 @@ export interface ITelemetryLogger extends ITelemetryBaseLogger {
 	 * Actual implementation that sends telemetry event
 	 * Implemented by derived classes
 	 * @param event - Telemetry event to send over
+	 * @param logLevel - optional level of the log.
 	 */
-	send(event: ITelemetryBaseEvent): void;
+	send(event: ITelemetryBaseEvent, logLevel?: LogLevel): void;
 
 	/**
 	 * Send information telemetry event
 	 * @param event - Event to send
 	 * @param error - optional error object to log
+	 * @param logLevel - optional level of the log.
 	 */
 	// eslint-disable-next-line @typescript-eslint/no-explicit-any
-	sendTelemetryEvent(event: ITelemetryGenericEvent, error?: any): void;
+	sendTelemetryEvent(
+		event: ITelemetryGenericEvent,
+		error?: any,
+		logLevel?: LogLevel.verbose | LogLevel.default,
+	): void;
 
 	/**
 	 * Send error telemetry event
 	 * @param event - Event to send
+	 * @param error - optional error object to log
 	 */
 	// eslint-disable-next-line @typescript-eslint/no-explicit-any
 	sendErrorEvent(event: ITelemetryErrorEvent, error?: any): void;
@@ -119,7 +137,13 @@ export interface ITelemetryLogger extends ITelemetryBaseLogger {
 	/**
 	 * Send performance telemetry event
 	 * @param event - Event to send
+	 * @param error - optional error object to log
+	 * @param logLevel - optional level of the log.
 	 */
 	// eslint-disable-next-line @typescript-eslint/no-explicit-any
-	sendPerformanceEvent(event: ITelemetryPerformanceEvent, error?: any): void;
+	sendPerformanceEvent(
+		event: ITelemetryPerformanceEvent,
+		error?: any,
+		logLevel?: LogLevel.verbose | LogLevel.default,
+	): void;
 }