feat: expose postHog capture function

Refs: SHELL-244 (#505)

api-extractor/carbonio-shell-ui.api.md

@@ -20,6 +20,7 @@ import type { FC } from 'react';
 import type { i18n } from 'i18next';
 import type { LinkProps } from 'react-router-dom';
 import type { ModalProps } from '@zextras/carbonio-design-system';
+import type { PostHog } from 'posthog-js';
 import { default as React_2 } from 'react';
 import type { TFunction } from 'i18next';
 import type { To } from 'history';
@@ -1468,6 +1469,8 @@ export type Tags = Record<string, Tag>;
 
 // @public (undocumented)
 interface Tracker {
+    // (undocumented)
+    capture: InstanceType<typeof PostHog>['capture'];
     // (undocumented)
     enableTracker: (enable: boolean) => void;
     // (undocumented)

src/boot/loader.test.tsx

@@ -128,7 +128,6 @@ describe('Loader', () => {
 		const componentsRes = waitForResponse('get', '/static/iris/components.json');
 		const getInfoRes = waitForResponse('post', '/service/soap/GetInfoRequest');
 		const enableTrackerFn = jest.fn();
-		const resetFn = jest.fn();
 		server.use(
 			http.post(
 				'/service/soap/GetInfoRequest',
@@ -137,7 +136,7 @@ describe('Loader', () => {
 		);
 		jest
 			.spyOn(posthog, 'useTracker')
-			.mockReturnValue({ enableTracker: enableTrackerFn, reset: resetFn });
+			.mockReturnValue({ enableTracker: enableTrackerFn, reset: jest.fn(), capture: jest.fn() });
 		setup(
 			<span data-testid={'loader'}>
 				<Loader />
@@ -195,7 +194,6 @@ describe('Loader', () => {
 			const componentsRes = waitForResponse('get', '/static/iris/components.json');
 			const getInfoRes = waitForResponse('post', '/service/soap/GetInfoRequest');
 			const enableTrackerFn = jest.fn();
-			const resetFn = jest.fn();
 			server.use(
 				http.post(
 					'/service/soap/GetInfoRequest',
@@ -204,7 +202,7 @@ describe('Loader', () => {
 			);
 			jest
 				.spyOn(posthog, 'useTracker')
-				.mockReturnValue({ enableTracker: enableTrackerFn, reset: resetFn });
+				.mockReturnValue({ enableTracker: enableTrackerFn, reset: jest.fn(), capture: jest.fn() });
 			setup(
 				<span data-testid={'loader'}>
 					<Loader />

src/boot/posthog.test.tsx

@@ -8,6 +8,7 @@ import React from 'react';
 
 import { act, waitFor } from '@testing-library/react';
 import { renderHook } from '@testing-library/react-hooks';
+import type { CaptureOptions } from 'posthog-js';
 import * as posthogJsReact from 'posthog-js/react';
 import type * as PostHogReact from 'posthog-js/react';
 
@@ -57,6 +58,16 @@ describe('Posthog', () => {
 		expect(posthog.reset).toHaveBeenCalled();
 	});
 
+	it('should call capture ', () => {
+		const posthog = spyOnPosthog();
+		const { result } = renderHook(() => useTracker());
+		const eventName = 'event name';
+		const properties = { prop1: 'prop1value', prop2: 'prop2value' };
+		const options: CaptureOptions = { send_instantly: true };
+		result.current.capture(eventName, properties, options);
+		expect(posthog.capture).toHaveBeenCalledWith(eventName, properties, options);
+	});
+
 	it('should invoke posthog provider with trackers disabled by default', () => {
 		const mockProvider = jest.spyOn(posthogJsReact, 'PostHogProvider');
 		setup(<TrackerProvider></TrackerProvider>);

src/boot/posthog.tsx

@@ -5,7 +5,7 @@
  */
 import React, { useCallback, useEffect, useMemo, useState } from 'react';
 
-import type { PostHogConfig } from 'posthog-js';
+import type { PostHog, PostHogConfig } from 'posthog-js';
 import { PostHogProvider, usePostHog } from 'posthog-js/react';
 
 import { useAccountStore } from '../store/account';
@@ -36,6 +36,7 @@ export const TrackerProvider = ({
 interface Tracker {
 	enableTracker: (enable: boolean) => void;
 	reset: () => void;
+	capture: InstanceType<typeof PostHog>['capture'];
 }
 
 const hashToSHA256 = async (value: string): Promise<ArrayBuffer> => {
@@ -97,5 +98,12 @@ export const useTracker = (): Tracker => {
 		postHog.reset();
 	}, [postHog]);
 
-	return { enableTracker, reset };
+	const capture = useCallback<InstanceType<typeof PostHog>['capture']>(
+		(eventName, properties, options) => {
+			postHog.capture(eventName, properties, options);
+		},
+		[postHog]
+	);
+
+	return { enableTracker, reset, capture };
 };

src/tests/posthog-utils.ts

@@ -20,7 +20,8 @@ export const spyOnPosthog = (): Partial<ReturnType<(typeof PostHogReact)['usePos
 			disable_surveys: true
 		} as PostHogConfig,
 		reset: jest.fn(),
-		setPersonProperties: jest.fn()
+		setPersonProperties: jest.fn(),
+		capture: jest.fn()
 	} satisfies Partial<ReturnType<(typeof PostHogReact)['usePostHog']>>;
 	jest
 		.spyOn(posthogJsReact, 'usePostHog')