@finos/legend-application-studio 28.21.43 → 28.21.45

package/src/__lib__/LegendStudioTelemetryHelper.ts

@@ -27,81 +27,207 @@ import {
 import { LEGEND_STUDIO_APP_EVENT } from './LegendStudioEvent.js';
 import type { LegendSourceInfo } from '@finos/legend-storage';
 
+/**
+ * All Studio telemetry events consistently carry an optional `sourceInfo`
+ * so downstream analytics can slice by workspace edit vs project viewer vs
+ * GAV viewer vs showcase without inferring from URLs. Non-editor events
+ * (virtual assistant, showcase manager) do not attach `sourceInfo` because
+ * they may fire outside any editor context.
+ */
+type WithSourceInfo = {
+  sourceInfo?: LegendSourceInfo | undefined;
+};
+
 type Compilation_TelemetryData = GraphManagerOperationReport & {
   dependenciesCount: number;
-};
+} & WithSourceInfo;
 
 type TestDataGeneration_TelemetryData = GraphManagerOperationReport & {
   dependenciesCount: number;
-};
+} & WithSourceInfo;
 
 type ShowcaseSearchInitiated_TelemetryData = {
   searchText: string;
 };
 
+export type ShowcaseSearchCompleted_TelemetryData = {
+  searchText: string;
+  resultCount: number;
+  showcaseMatchCount: number;
+  textMatchCount: number;
+  durationMs: number;
+  hadResults: boolean;
+};
+
+export enum SHOWCASE_MANAGER_ENTRY_POINT {
+  ACTIVITY_BAR = 'activity-bar',
+  WORKSPACE_SETUP = 'workspace-setup',
+}
+
+export enum SHOWCASE_LAUNCH_ENTRY_POINT {
+  EXPLORER = 'explorer',
+  SEARCH_SHOWCASE_MATCH = 'search-showcase-match',
+  SEARCH_CODE_MATCH = 'search-code-match',
+  DEEP_LINK = 'deep-link',
+}
+
 export type ShowcaseMetadata_TelemetryData = {
   showcasesTotalCount: number;
   showcasesDevelopmentCount: number;
+  entryPoint: SHOWCASE_MANAGER_ENTRY_POINT;
 };
 
 export type ShowcaseProject_TelemetryData = {
   showcasePath: string;
+  title?: string | undefined;
+  isDevelopment?: boolean | undefined;
+  entryPoint?: SHOWCASE_LAUNCH_ENTRY_POINT | undefined;
+  lineNumber?: number | undefined;
 };
 
-export type IngestDefinitionDeployment_TelemetryData = {
-  sourceInfo: LegendSourceInfo | undefined;
-  ingestUrn: string;
-  ingestDefinitionPath: string;
+export type ShowcaseViewerClose_TelemetryData = {
+  showcasePath: string;
+  dwellMs: number;
 };
 
+export enum SHOWCASE_FEEDBACK_VOTE {
+  UP = 'up',
+  DOWN = 'down',
+}
+
+export enum SHOWCASE_FEEDBACK_SURFACE {
+  DEEP_LINK_VIEWER = 'deep-link-viewer',
+  ASSISTANT_PANEL = 'assistant-panel',
+}
+
+export type ShowcaseFeedback_TelemetryData = {
+  showcasePath: string;
+  title?: string | undefined;
+  vote: SHOWCASE_FEEDBACK_VOTE;
+  surface: SHOWCASE_FEEDBACK_SURFACE;
+};
+
+export type ShowcaseFailure_TelemetryData = {
+  errorMessage: string;
+  showcasePath?: string | undefined;
+  searchText?: string | undefined;
+};
+
+export enum TEXT_MODE_ENTER_TRIGGER {
+  MANUAL_TOGGLE = 'manual-toggle',
+  FALLBACK_GRAPH_BUILD_FAILURE = 'fallback-graph-build-failure',
+  FALLBACK_FORM_COMPILATION_FAILURE = 'fallback-form-compilation-failure',
+  INITIAL_LAZY = 'initial-lazy',
+}
+
+export enum TEXT_MODE_LEAVE_OUTCOME {
+  COMPILED_AND_LEFT = 'compiled-and-left',
+  DISCARDED = 'discarded',
+}
+
+export enum TEXT_MODE_COMPILATION_ERROR_KIND {
+  PARSER = 'parser',
+  COMPILER = 'compiler',
+  OTHER = 'other',
+}
+
+export enum TEXT_MODE_TOGGLE_SOURCE {
+  BUTTON = 'button',
+  KEYBOARD_SHORTCUT = 'keyboard-shortcut',
+  CONTEXT_MENU = 'context-menu',
+}
+
+export enum TEXT_MODE_TOGGLE_DIRECTION {
+  TO_TEXT = 'to-text',
+  TO_FORM = 'to-form',
+}
+
+export enum TEXT_MODE_ACTION {
+  GO_TO_DEFINITION = 'go-to-definition',
+}
+
+export enum TEXT_MODE_ACTION_STATUS {
+  LAUNCH = 'launch',
+  SUCCESS = 'success',
+  ERROR = 'error',
+}
+
+export enum GRAPH_EDITOR_MODE_LABEL {
+  FORM = 'form',
+  TEXT = 'text',
+  STRICT_TEXT = 'strict-text',
+}
+
 export class LegendStudioTelemetryHelper {
-  static logEvent_GraphCompilationLaunched(service: TelemetryService): void {
-    service.logEvent(LEGEND_STUDIO_APP_EVENT.COMPILE_GRAPH__LAUNCH, {});
+  static logEvent_GraphCompilationLaunched(
+    service: TelemetryService,
+    sourceInfo?: LegendSourceInfo | undefined,
+  ): void {
+    service.logEvent(LEGEND_STUDIO_APP_EVENT.COMPILE_GRAPH__LAUNCH, {
+      sourceInfo,
+    });
   }
 
-  static logEvent_TextCompilationLaunched(service: TelemetryService): void {
-    service.logEvent(LEGEND_STUDIO_APP_EVENT.COMPILE_TEXT__LAUNCH, {});
+  static logEvent_TextCompilationLaunched(
+    service: TelemetryService,
+    sourceInfo?: LegendSourceInfo | undefined,
+  ): void {
+    service.logEvent(LEGEND_STUDIO_APP_EVENT.COMPILE_TEXT__LAUNCH, {
+      sourceInfo,
+    });
   }
 
-  static logEvent_TestDataGenerationLaunched(service: TelemetryService): void {
-    service.logEvent(LEGEND_STUDIO_APP_EVENT.TEST_DATA_GENERATION__LAUNCH, {});
+  static logEvent_TestDataGenerationLaunched(
+    service: TelemetryService,
+    sourceInfo?: LegendSourceInfo | undefined,
+  ): void {
+    service.logEvent(LEGEND_STUDIO_APP_EVENT.TEST_DATA_GENERATION__LAUNCH, {
+      sourceInfo,
+    });
   }
 
   static logEvent_GraphCompilationSucceeded(
     service: TelemetryService,
     data: Compilation_TelemetryData,
+    sourceInfo?: LegendSourceInfo | undefined,
   ): void {
-    service.logEvent(
-      LEGEND_STUDIO_APP_EVENT.FORM_MODE_COMPILATION__SUCCESS,
-      data,
-    );
+    service.logEvent(LEGEND_STUDIO_APP_EVENT.FORM_MODE_COMPILATION__SUCCESS, {
+      ...data,
+      sourceInfo,
+    });
   }
 
   static logEvent_TextCompilationSucceeded(
     service: TelemetryService,
     data: Compilation_TelemetryData,
+    sourceInfo?: LegendSourceInfo | undefined,
   ): void {
-    service.logEvent(
-      LEGEND_STUDIO_APP_EVENT.TEXT_MODE_COMPILATION__SUCCESS,
-      data,
-    );
+    service.logEvent(LEGEND_STUDIO_APP_EVENT.TEXT_MODE_COMPILATION__SUCCESS, {
+      ...data,
+      sourceInfo,
+    });
   }
 
   static logEvent_TestDataGenerationSucceeded(
     service: TelemetryService,
     data: TestDataGeneration_TelemetryData,
+    sourceInfo?: LegendSourceInfo | undefined,
   ): void {
-    service.logEvent(
-      LEGEND_STUDIO_APP_EVENT.TEST_DATA_GENERATION__SUCCESS,
-      data,
-    );
+    service.logEvent(LEGEND_STUDIO_APP_EVENT.TEST_DATA_GENERATION__SUCCESS, {
+      ...data,
+      sourceInfo,
+    });
   }
 
   static logEvent_GraphInitializationSucceeded(
     service: TelemetryService,
     data: GraphInitializationReport,
+    sourceInfo?: LegendSourceInfo | undefined,
   ): void {
-    service.logEvent(GRAPH_MANAGER_EVENT.INITIALIZE_GRAPH__SUCCESS, data);
+    service.logEvent(GRAPH_MANAGER_EVENT.INITIALIZE_GRAPH__SUCCESS, {
+      ...data,
+      sourceInfo,
+    });
   }
 
   // showcase manager
@@ -137,6 +263,63 @@ export class LegendStudioTelemetryHelper {
     );
   }
 
+  static logEvent_ShowcaseSearchCompleted(
+    service: TelemetryService,
+    data: ShowcaseSearchCompleted_TelemetryData,
+  ): void {
+    service.logEvent(
+      LEGEND_STUDIO_APP_EVENT.SHOWCASE_MANAGER_SEARCH__COMPLETED,
+      data,
+    );
+  }
+
+  static logEvent_ShowcaseViewerClose(
+    service: TelemetryService,
+    data: ShowcaseViewerClose_TelemetryData,
+  ): void {
+    service.logEvent(LEGEND_STUDIO_APP_EVENT.SHOWCASE_VIEWER_CLOSE, data);
+  }
+
+  static logEvent_ShowcaseFeedbackSubmit(
+    service: TelemetryService,
+    data: ShowcaseFeedback_TelemetryData,
+  ): void {
+    service.logEvent(
+      LEGEND_STUDIO_APP_EVENT.SHOWCASE_VIEWER_FEEDBACK__SUBMIT,
+      data,
+    );
+  }
+
+  static logEvent_ShowcaseManagerInitFailure(
+    service: TelemetryService,
+    data: ShowcaseFailure_TelemetryData,
+  ): void {
+    service.logEvent(
+      LEGEND_STUDIO_APP_EVENT.SHOWCASE_MANAGER_INIT__FAILURE,
+      data,
+    );
+  }
+
+  static logEvent_ShowcaseManagerOpenFailure(
+    service: TelemetryService,
+    data: ShowcaseFailure_TelemetryData,
+  ): void {
+    service.logEvent(
+      LEGEND_STUDIO_APP_EVENT.SHOWCASE_MANAGER_OPEN__FAILURE,
+      data,
+    );
+  }
+
+  static logEvent_ShowcaseManagerSearchFailure(
+    service: TelemetryService,
+    data: ShowcaseFailure_TelemetryData,
+  ): void {
+    service.logEvent(
+      LEGEND_STUDIO_APP_EVENT.SHOWCASE_MANAGER_SEARCH__FAILURE,
+      data,
+    );
+  }
+
   // virtual assistant
   static logEvent_VirtualAssistantPanelOpened(service: TelemetryService): void {
     service.logEvent(APPLICATION_EVENT.VIRTUAL_ASSISTANT_PANEL__OPEN, {});
@@ -187,30 +370,33 @@ export class LegendStudioTelemetryHelper {
   static logEvent_ServiceLegendAISuggestLaunched(
     telemetryService: TelemetryService,
     servicePath: string,
+    sourceInfo?: LegendSourceInfo | undefined,
   ): void {
     telemetryService.logEvent(
       LEGEND_STUDIO_APP_EVENT.SERVICE_LEGENDAI_SUGGEST__LAUNCH,
-      { servicePath },
+      { servicePath, sourceInfo },
     );
   }
 
   static logEvent_ServiceLegendAISuggestApplied(
     telemetryService: TelemetryService,
     servicePath: string,
+    sourceInfo?: LegendSourceInfo | undefined,
   ): void {
     telemetryService.logEvent(
       LEGEND_STUDIO_APP_EVENT.SERVICE_LEGENDAI_SUGGEST__APPLY,
-      { servicePath },
+      { servicePath, sourceInfo },
     );
   }
 
   static logEvent_ServiceLegendAISuggestDiscarded(
     telemetryService: TelemetryService,
     servicePath: string,
+    sourceInfo?: LegendSourceInfo | undefined,
   ): void {
     telemetryService.logEvent(
       LEGEND_STUDIO_APP_EVENT.SERVICE_LEGENDAI_SUGGEST__DISCARD,
-      { servicePath },
+      { servicePath, sourceInfo },
     );
   }
 
@@ -218,10 +404,11 @@ export class LegendStudioTelemetryHelper {
     telemetryService: TelemetryService,
     servicePath: string,
     errorMessage: string,
+    sourceInfo?: LegendSourceInfo | undefined,
   ): void {
     telemetryService.logEvent(
       LEGEND_STUDIO_APP_EVENT.SERVICE_LEGENDAI_SUGGEST__FAILURE,
-      { servicePath, errorMessage },
+      { servicePath, errorMessage, sourceInfo },
     );
   }
 
@@ -229,30 +416,33 @@ export class LegendStudioTelemetryHelper {
   static logEvent_DataSpaceLegendAISuggestLaunched(
     telemetryService: TelemetryService,
     dataSpacePath: string,
+    sourceInfo?: LegendSourceInfo | undefined,
   ): void {
     telemetryService.logEvent(
       LEGEND_STUDIO_APP_EVENT.DATASPACE_LEGENDAI_SUGGEST__LAUNCH,
-      { dataSpacePath },
+      { dataSpacePath, sourceInfo },
     );
   }
 
   static logEvent_DataSpaceLegendAISuggestApplied(
     telemetryService: TelemetryService,
     dataSpacePath: string,
+    sourceInfo?: LegendSourceInfo | undefined,
   ): void {
     telemetryService.logEvent(
       LEGEND_STUDIO_APP_EVENT.DATASPACE_LEGENDAI_SUGGEST__APPLY,
-      { dataSpacePath },
+      { dataSpacePath, sourceInfo },
     );
   }
 
   static logEvent_DataSpaceLegendAISuggestDiscarded(
     telemetryService: TelemetryService,
     dataSpacePath: string,
+    sourceInfo?: LegendSourceInfo | undefined,
   ): void {
     telemetryService.logEvent(
       LEGEND_STUDIO_APP_EVENT.DATASPACE_LEGENDAI_SUGGEST__DISCARD,
-      { dataSpacePath },
+      { dataSpacePath, sourceInfo },
     );
   }
 
@@ -260,40 +450,44 @@ export class LegendStudioTelemetryHelper {
     telemetryService: TelemetryService,
     dataSpacePath: string,
     errorMessage: string,
+    sourceInfo?: LegendSourceInfo | undefined,
   ): void {
     telemetryService.logEvent(
       LEGEND_STUDIO_APP_EVENT.DATASPACE_LEGENDAI_SUGGEST__FAILURE,
-      { dataSpacePath, errorMessage },
+      { dataSpacePath, errorMessage, sourceInfo },
     );
   }
 
   static logEvent_DataProductLegendAISuggestLaunched(
     telemetryService: TelemetryService,
     dataProductPath: string,
+    sourceInfo?: LegendSourceInfo | undefined,
   ): void {
     telemetryService.logEvent(
       LEGEND_STUDIO_APP_EVENT.DATA_PRODUCT_LEGENDAI_SUGGEST__LAUNCH,
-      { dataProductPath },
+      { dataProductPath, sourceInfo },
     );
   }
 
   static logEvent_DataProductLegendAISuggestApplied(
     telemetryService: TelemetryService,
     dataProductPath: string,
+    sourceInfo?: LegendSourceInfo | undefined,
   ): void {
     telemetryService.logEvent(
       LEGEND_STUDIO_APP_EVENT.DATA_PRODUCT_LEGENDAI_SUGGEST__APPLY,
-      { dataProductPath },
+      { dataProductPath, sourceInfo },
     );
   }
 
   static logEvent_DataProductLegendAISuggestDiscarded(
     telemetryService: TelemetryService,
     dataProductPath: string,
+    sourceInfo?: LegendSourceInfo | undefined,
   ): void {
     telemetryService.logEvent(
       LEGEND_STUDIO_APP_EVENT.DATA_PRODUCT_LEGENDAI_SUGGEST__DISCARD,
-      { dataProductPath },
+      { dataProductPath, sourceInfo },
     );
   }
 
@@ -301,77 +495,11 @@ export class LegendStudioTelemetryHelper {
     telemetryService: TelemetryService,
     dataProductPath: string,
     errorMessage: string,
+    sourceInfo?: LegendSourceInfo | undefined,
   ): void {
     telemetryService.logEvent(
       LEGEND_STUDIO_APP_EVENT.DATA_PRODUCT_LEGENDAI_SUGGEST__FAILURE,
-      { dataProductPath, errorMessage },
-    );
-  }
-
-  // Lakehouse
-  static logEvent_LakehouseDeployIngest(
-    service: TelemetryService,
-    sourceInfo: LegendSourceInfo | undefined,
-    ingestUrn: string,
-    ingestDefinitionPath: string,
-  ): void {
-    const eventData: IngestDefinitionDeployment_TelemetryData = {
-      sourceInfo,
-      ingestUrn,
-      ingestDefinitionPath,
-    };
-    service.logEvent(
-      LEGEND_STUDIO_APP_EVENT.INGESTION_DEPLOY_SUCCESS_URN,
-      eventData,
-    );
-  }
-
-  static logEvent_LakehouseDeployIngestFailure(
-    service: TelemetryService,
-    sourceInfo: LegendSourceInfo | undefined,
-    ingestDefinitionPath: string,
-    errorMessage: string,
-  ): void {
-    const eventData = {
-      sourceInfo,
-      ingestDefinitionPath,
-      errorMessage,
-    };
-    service.logEvent(
-      LEGEND_STUDIO_APP_EVENT.INGESTION_DEPLOY_FAILURE,
-      eventData,
-    );
-  }
-
-  static logEvent_LakehouseDeployDataProduct(
-    service: TelemetryService,
-    sourceInfo: LegendSourceInfo | undefined,
-    dataProductPath: string,
-  ): void {
-    const eventData = {
-      sourceInfo,
-      dataProductPath,
-    };
-    service.logEvent(
-      LEGEND_STUDIO_APP_EVENT.DATA_PRODUCT_DEPLOY_SUCCESS,
-      eventData,
-    );
-  }
-
-  static logEvent_LakehouseDeployDataProductFailure(
-    service: TelemetryService,
-    sourceInfo: LegendSourceInfo | undefined,
-    dataProductPath: string,
-    errorMessage: string,
-  ): void {
-    const eventData = {
-      sourceInfo,
-      dataProductPath,
-      errorMessage,
-    };
-    service.logEvent(
-      LEGEND_STUDIO_APP_EVENT.DATA_PRODUCT_DEPLOY_FAILURE,
-      eventData,
+      { dataProductPath, errorMessage, sourceInfo },
     );
   }
 
@@ -382,6 +510,10 @@ export class LegendStudioTelemetryHelper {
     groupId: string,
     artifactId: string,
     versionId: string | undefined,
+    lakehouseElementCounts: {
+      ingestCount: number;
+      dataProductCount: number;
+    },
   ): void {
     service.logEvent(
       LEGEND_STUDIO_APP_EVENT.METADATA_PUSH_TO_METADATA__LAUNCH,
@@ -390,6 +522,7 @@ export class LegendStudioTelemetryHelper {
         groupId,
         artifactId,
         versionId,
+        ...lakehouseElementCounts,
       },
     );
   }
@@ -401,6 +534,10 @@ export class LegendStudioTelemetryHelper {
     artifactId: string,
     versionId: string | undefined,
     status: string,
+    lakehouseElementCounts: {
+      ingestCount: number;
+      dataProductCount: number;
+    },
   ): void {
     service.logEvent(
       LEGEND_STUDIO_APP_EVENT.METADATA_PUSH_TO_METADATA__SUCCESS,
@@ -410,6 +547,7 @@ export class LegendStudioTelemetryHelper {
         artifactId,
         versionId,
         status,
+        ...lakehouseElementCounts,
       },
     );
   }
@@ -427,4 +565,187 @@ export class LegendStudioTelemetryHelper {
       },
     );
   }
+
+  // Text mode session
+  static logEvent_TextModeEntered(
+    service: TelemetryService,
+    sourceInfo: LegendSourceInfo | undefined,
+    data: {
+      trigger: TEXT_MODE_ENTER_TRIGGER;
+      strict: boolean;
+      elementPath?: string | undefined;
+    },
+  ): void {
+    service.logEvent(LEGEND_STUDIO_APP_EVENT.TEXT_MODE__ENTER, {
+      sourceInfo,
+      ...data,
+    });
+  }
+
+  static logEvent_TextModeLeft(
+    service: TelemetryService,
+    sourceInfo: LegendSourceInfo | undefined,
+    data: {
+      outcome: TEXT_MODE_LEAVE_OUTCOME;
+      durationMs: number;
+      editCount: number;
+      compilationCount: number;
+    },
+  ): void {
+    service.logEvent(LEGEND_STUDIO_APP_EVENT.TEXT_MODE__LEAVE, {
+      sourceInfo,
+      ...data,
+    });
+  }
+
+  static logEvent_TextModeFirstEdit(
+    service: TelemetryService,
+    sourceInfo: LegendSourceInfo | undefined,
+    timeToFirstEditMs: number,
+  ): void {
+    service.logEvent(LEGEND_STUDIO_APP_EVENT.TEXT_MODE__FIRST_EDIT, {
+      sourceInfo,
+      timeToFirstEditMs,
+    });
+  }
+
+  // Push local changes (workspace save/commit)
+  static logEvent_PushLocalChangesLaunched(
+    service: TelemetryService,
+    sourceInfo: LegendSourceInfo | undefined,
+    data: { mode: GRAPH_EDITOR_MODE_LABEL; changeCount: number },
+  ): void {
+    service.logEvent(LEGEND_STUDIO_APP_EVENT.PUSH_LOCAL_CHANGES__LAUNCH, {
+      sourceInfo,
+      ...data,
+    });
+  }
+
+  static logEvent_PushLocalChangesSucceeded(
+    service: TelemetryService,
+    sourceInfo: LegendSourceInfo | undefined,
+    data: {
+      mode: GRAPH_EDITOR_MODE_LABEL;
+      changeCount: number;
+      durationMs: number;
+      revisionId: string | undefined;
+    },
+  ): void {
+    service.logEvent(LEGEND_STUDIO_APP_EVENT.PUSH_LOCAL_CHANGES__SUCCESS, {
+      sourceInfo,
+      ...data,
+    });
+  }
+
+  static logEvent_PushLocalChangesFailure(
+    service: TelemetryService,
+    sourceInfo: LegendSourceInfo | undefined,
+    data: {
+      mode: GRAPH_EDITOR_MODE_LABEL;
+      changeCount: number;
+      errorMessage: string;
+    },
+  ): void {
+    service.logEvent(LEGEND_STUDIO_APP_EVENT.PUSH_LOCAL_CHANGES__FAILURE, {
+      sourceInfo,
+      ...data,
+    });
+  }
+
+  // Workspace update (pull)
+  static logEvent_WorkspaceUpdateLaunched(
+    service: TelemetryService,
+    sourceInfo: LegendSourceInfo | undefined,
+  ): void {
+    service.logEvent(LEGEND_STUDIO_APP_EVENT.UPDATE_WORKSPACE__LAUNCH, {
+      sourceInfo,
+    });
+  }
+
+  static logEvent_WorkspaceUpdateSucceeded(
+    service: TelemetryService,
+    sourceInfo: LegendSourceInfo | undefined,
+    data: { status: string; durationMs: number },
+  ): void {
+    service.logEvent(LEGEND_STUDIO_APP_EVENT.UPDATE_WORKSPACE__SUCCESS, {
+      sourceInfo,
+      ...data,
+    });
+  }
+
+  static logEvent_WorkspaceUpdateFailure(
+    service: TelemetryService,
+    sourceInfo: LegendSourceInfo | undefined,
+    errorMessage: string,
+  ): void {
+    service.logEvent(LEGEND_STUDIO_APP_EVENT.UPDATE_WORKSPACE__FAILURE, {
+      sourceInfo,
+      errorMessage,
+    });
+  }
+
+  // Text mode - Phase 2
+  static logEvent_TextModeCompilationFailure(
+    service: TelemetryService,
+    sourceInfo: LegendSourceInfo | undefined,
+    data: {
+      errorKind: TEXT_MODE_COMPILATION_ERROR_KIND;
+      errorMessage: string;
+    },
+  ): void {
+    service.logEvent(LEGEND_STUDIO_APP_EVENT.TEXT_MODE_COMPILATION__FAILURE, {
+      sourceInfo,
+      ...data,
+    });
+  }
+
+  static logEvent_TextModeStrictLaunch(
+    service: TelemetryService,
+    sourceInfo: LegendSourceInfo | undefined,
+  ): void {
+    service.logEvent(LEGEND_STUDIO_APP_EVENT.TEXT_MODE__STRICT_LAUNCH, {
+      sourceInfo,
+    });
+  }
+
+  static logEvent_TextModeToggleShortcutInvoked(
+    service: TelemetryService,
+    sourceInfo: LegendSourceInfo | undefined,
+    data: {
+      source: TEXT_MODE_TOGGLE_SOURCE;
+      direction: TEXT_MODE_TOGGLE_DIRECTION;
+    },
+  ): void {
+    service.logEvent(
+      LEGEND_STUDIO_APP_EVENT.TEXT_MODE__TOGGLE_SHORTCUT_INVOKED,
+      { sourceInfo, ...data },
+    );
+  }
+
+  static logEvent_TextModeAction(
+    service: TelemetryService,
+    sourceInfo: LegendSourceInfo | undefined,
+    data: {
+      action: TEXT_MODE_ACTION;
+      status: TEXT_MODE_ACTION_STATUS;
+      errorMessage?: string | undefined;
+    },
+  ): void {
+    service.logEvent(LEGEND_STUDIO_APP_EVENT.TEXT_MODE__ACTION, {
+      sourceInfo,
+      ...data,
+    });
+  }
+
+  // Push local changes - Phase 2
+  static logEvent_PushLocalChangesEmpty(
+    service: TelemetryService,
+    sourceInfo: LegendSourceInfo | undefined,
+    data: { mode: GRAPH_EDITOR_MODE_LABEL },
+  ): void {
+    service.logEvent(LEGEND_STUDIO_APP_EVENT.PUSH_LOCAL_CHANGES__EMPTY, {
+      sourceInfo,
+      ...data,
+    });
+  }
 }