[feat] Integrate PostHog plugin

.deploy/ssh/with-cloudflare/demo/docker-compose.api.demo.template.yml

@@ -33,6 +33,10 @@ services:
       SENTRY_HTTP_TRACING_ENABLED: '${SENTRY_HTTP_TRACING_ENABLED:-}'
       SENTRY_POSTGRES_TRACKING_ENABLED: '${SENTRY_POSTGRES_TRACKING_ENABLED:-}'
       SENTRY_PROFILING_ENABLED: '${SENTRY_PROFILING_ENABLED:-}'
+      POSTHOG_KEY: '${POSTHOG_KEY:-}'
+      POSTHOG_HOST: '${POSTHOG_HOST:-}'
+      POSTHOG_ENABLED: '${POSTHOG_ENABLED:-}'
+      POSTHOG_FLUSH_INTERVAL: '${POSTHOG_FLUSH_INTERVAL:-}'
       AWS_ACCESS_KEY_ID: '${AWS_ACCESS_KEY_ID:-}'
       AWS_SECRET_ACCESS_KEY: '${AWS_SECRET_ACCESS_KEY:-}'
       AWS_REGION: '${AWS_REGION:-}'

.deploy/ssh/with-cloudflare/prod/docker-compose.api.prod.template.yml

@@ -33,6 +33,10 @@ services:
       SENTRY_HTTP_TRACING_ENABLED: '${SENTRY_HTTP_TRACING_ENABLED}'
       SENTRY_POSTGRES_TRACKING_ENABLED: '${SENTRY_POSTGRES_TRACKING_ENABLED}'
       SENTRY_PROFILING_ENABLED: '${SENTRY_PROFILING_ENABLED}'
+      POSTHOG_KEY: '${POSTHOG_KEY}'
+      POSTHOG_HOST: '${POSTHOG_HOST}'
+      POSTHOG_ENABLED: '${POSTHOG_ENABLED}'
+      POSTHOG_FLUSH_INTERVAL: '${POSTHOG_FLUSH_INTERVAL}'
       AWS_ACCESS_KEY_ID: '${AWS_ACCESS_KEY_ID}'
       AWS_SECRET_ACCESS_KEY: '${AWS_SECRET_ACCESS_KEY}'
       AWS_REGION: '${AWS_REGION}'

.deploy/ssh/with-cloudflare/stage/docker-compose.api.stage.template.yml

@@ -33,6 +33,10 @@ services:
       SENTRY_HTTP_TRACING_ENABLED: '${SENTRY_HTTP_TRACING_ENABLED}'
       SENTRY_POSTGRES_TRACKING_ENABLED: '${SENTRY_POSTGRES_TRACKING_ENABLED}'
       SENTRY_PROFILING_ENABLED: '${SENTRY_PROFILING_ENABLED}'
+      POSTHOG_KEY: '${POSTHOG_KEY}'
+      POSTHOG_HOST: '${POSTHOG_HOST}'
+      POSTHOG_ENABLED: '${POSTHOG_ENABLED}'
+      POSTHOG_FLUSH_INTERVAL: '${POSTHOG_FLUSH_INTERVAL}'
       AWS_ACCESS_KEY_ID: '${AWS_ACCESS_KEY_ID}'
       AWS_SECRET_ACCESS_KEY: '${AWS_SECRET_ACCESS_KEY}'
       AWS_REGION: '${AWS_REGION}'

.deploy/ssh/with-letsencrypt/demo/docker-compose.api.demo.template.yml

@@ -33,6 +33,10 @@ services:
       SENTRY_HTTP_TRACING_ENABLED: '${SENTRY_HTTP_TRACING_ENABLED:-}'
       SENTRY_POSTGRES_TRACKING_ENABLED: '${SENTRY_POSTGRES_TRACKING_ENABLED:-}'
       SENTRY_PROFILING_ENABLED: '${SENTRY_PROFILING_ENABLED:-}'
+      POSTHOG_KEY: '${POSTHOG_KEY:-}'
+      POSTHOG_HOST: '${POSTHOG_HOST:-}'
+      POSTHOG_ENABLED: '${POSTHOG_ENABLED:-}'
+      POSTHOG_FLUSH_INTERVAL: '${POSTHOG_FLUSH_INTERVAL:-}'
       AWS_ACCESS_KEY_ID: '${AWS_ACCESS_KEY_ID:-}'
       AWS_SECRET_ACCESS_KEY: '${AWS_SECRET_ACCESS_KEY:-}'
       AWS_REGION: '${AWS_REGION:-}'

.deploy/ssh/with-letsencrypt/prod/docker-compose.api.prod.template.yml

@@ -33,6 +33,10 @@ services:
       SENTRY_HTTP_TRACING_ENABLED: '${SENTRY_HTTP_TRACING_ENABLED}'
       SENTRY_POSTGRES_TRACKING_ENABLED: '${SENTRY_POSTGRES_TRACKING_ENABLED}'
       SENTRY_PROFILING_ENABLED: '${SENTRY_PROFILING_ENABLED}'
+      POSTHOG_KEY: '${POSTHOG_KEY}'
+      POSTHOG_HOST: '${POSTHOG_HOST}'
+      POSTHOG_ENABLED: '${POSTHOG_ENABLED}'
+      POSTHOG_FLUSH_INTERVAL: '${POSTHOG_FLUSH_INTERVAL}'
       AWS_ACCESS_KEY_ID: '${AWS_ACCESS_KEY_ID}'
       AWS_SECRET_ACCESS_KEY: '${AWS_SECRET_ACCESS_KEY}'
       AWS_REGION: '${AWS_REGION}'

.deploy/ssh/with-letsencrypt/stage/docker-compose.api.stage.template.yml

@@ -33,6 +33,10 @@ services:
       SENTRY_HTTP_TRACING_ENABLED: '${SENTRY_HTTP_TRACING_ENABLED}'
       SENTRY_POSTGRES_TRACKING_ENABLED: '${SENTRY_POSTGRES_TRACKING_ENABLED}'
       SENTRY_PROFILING_ENABLED: '${SENTRY_PROFILING_ENABLED}'
+      POSTHOG_KEY: '${POSTHOG_KEY}'
+      POSTHOG_HOST: '${POSTHOG_HOST}'
+      POSTHOG_ENABLED: '${POSTHOG_ENABLED}'
+      POSTHOG_FLUSH_INTERVAL: '${POSTHOG_FLUSH_INTERVAL}'
       AWS_ACCESS_KEY_ID: '${AWS_ACCESS_KEY_ID}'
       AWS_SECRET_ACCESS_KEY: '${AWS_SECRET_ACCESS_KEY}'
       AWS_REGION: '${AWS_REGION}'

.env.compose

@@ -250,6 +250,12 @@
 SENTRY_PROFILING_ENABLED=false
 SENTRY_TRACES_SAMPLE_RATE=0.1
 
+# PostHog Configuration
+POSTHOG_KEY=
+POSTHOG_HOST=https://app.posthog.com
+POSTHOG_ENABLED=true
+POSTHOG_FLUSH_INTERVAL=10000
+
 # Default Currency
 DEFAULT_CURRENCY=USD
 

.env.demo.compose

@@ -257,6 +257,14 @@
 SENTRY_PROFILING_ENABLED=false
 SENTRY_TRACES_SAMPLE_RATE=0.1
 
+
+# PostHog Configuration
+POSTHOG_KEY=
+POSTHOG_HOST=https://app.posthog.com
+POSTHOG_ENABLED=true
+POSTHOG_FLUSH_INTERVAL=10000
+
+
 # Default Currency
 DEFAULT_CURRENCY=USD
 

.env.docker

@@ -237,6 +237,12 @@
 SENTRY_PROFILING_ENABLED=false
 SENTRY_TRACES_SAMPLE_RATE=0.1
 
+# PostHog Configuration
+POSTHOG_KEY=
+POSTHOG_HOST=https://app.posthog.com
+POSTHOG_ENABLED=true
+POSTHOG_FLUSH_INTERVAL=10000
+
 # Default Currency
 DEFAULT_CURRENCY=USD
 

.env.local

@@ -242,6 +242,12 @@ SENTRY_PROFILING_ENABLED=false
 SENTRY_TRACES_SAMPLE_RATE=0.01
 SENTRY_PROFILE_SAMPLE_RATE=0.01
 
+# PostHog Configuration
+POSTHOG_KEY=phc_w5PscE14j8Gthj1LqEoYXdr7srlwvfRRUZF2aLxbazC
+POSTHOG_HOST=https://us.i.posthog.com
+POSTHOG_ENABLED=false
+POSTHOG_FLUSH_INTERVAL=10000
+
 # Default Currency
 DEFAULT_CURRENCY=USD
 

.env.sample

@@ -241,6 +241,12 @@ SENTRY_PROFILING_ENABLED=
 SENTRY_TRACES_SAMPLE_RATE=
 SENTRY_PROFILE_SAMPLE_RATE=
 
+# PostHog Configuration
+POSTHOG_KEY=
+POSTHOG_HOST=
+POSTHOG_ENABLED=
+POSTHOG_FLUSH_INTERVAL=
+
 # Default Currency
 DEFAULT_CURRENCY=USD
 

apps/api/package.json

@@ -55,6 +55,7 @@
 		"@gauzy/plugin-knowledge-base": "^0.1.0",
 		"@gauzy/plugin-product-reviews": "^0.1.0",
 		"@gauzy/plugin-sentry": "^0.1.0",
+		"@gauzy/plugin-posthog": "^0.1.0",
 		"@gauzy/plugin-videos": "^0.1.0",
 		"@gauzy/plugin-registry": "^0.1.0",
 		"dotenv": "^16.0.3",

apps/api/src/plugin-config.ts

@@ -9,11 +9,13 @@ import {
 	dbKnexConnectionConfig
 } from '@gauzy/config';
 import { SentryService } from '@gauzy/plugin-sentry';
+import { PosthogService } from '@gauzy/plugin-posthog';
+import { PosthogAnalytics as PosthogPlugin } from './posthog';
 import { SentryTracing as SentryPlugin } from './sentry';
 import { version } from './../version';
 import { plugins } from './plugins';
 
-const { sentry } = environment;
+const { sentry, posthog } = environment;
 
 console.log(chalk.magenta(`API Version %s`), version);
 console.log('Plugin Config -> __dirname: ' + __dirname);
@@ -90,6 +92,30 @@ export const pluginConfig: ApplicationPluginConfig = {
 		assetPath: assetPath,
 		assetPublicPath: assetPublicPath
 	},
-	...(sentry?.dsn ? { logger: new SentryService(SentryPlugin.options) } : {}),
+	logger: (() => {
+		const loggers = [];
+
+		if (sentry?.dsn) {
+			loggers.push(new SentryService(SentryPlugin.options));
+		}
+		if (posthog?.posthogEnabled && posthog?.posthogKey) {
+			loggers.push(new PosthogService(PosthogPlugin.options));
+		}
+
+		// Combine both, or return undefined if no logger is configured
+		if (loggers.length === 0) {
+			return undefined;
+		} else if (loggers.length === 1) {
+			return loggers[0];
+		} else {
+			return {
+				log: (...args) => loggers.forEach((logger) => logger.log?.(...args)),
+				error: (...args) => loggers.forEach((logger) => logger.error?.(...args)),
+				warn: (...args) => loggers.forEach((logger) => logger.warn?.(...args)),
+				debug: (...args) => loggers.forEach((logger) => logger.debug?.(...args)),
+				verbose: (...args) => loggers.forEach((logger) => logger.verbose?.(...args))
+			};
+		}
+	})(),
 	plugins
 };

apps/api/src/plugins.ts

@@ -17,15 +17,20 @@ import { VideosPlugin } from '@gauzy/plugin-videos';
 import { RegistryPlugin } from '@gauzy/plugin-registry';
 
 import { SentryTracing as SentryPlugin } from './sentry';
+import { PosthogAnalytics as PosthogPlugin } from './posthog';
 
-const { jitsu, sentry } = environment;
+const { jitsu, sentry, posthog } = environment;
 
 /**
  * An array of plugins to be included or used in the codebase.
  */
 export const plugins = [
 	// Includes the SentryPlugin based on the presence of Sentry configuration.
 	...(sentry && sentry.dsn ? [SentryPlugin] : []),
+
+	// Includes the PostHogPlugin based on the presence of PostHog configuration.
+	...(posthog?.posthogEnabled && posthog?.posthogKey ? [PosthogPlugin] : []),
+
 	// Initializes the Jitsu Analytics Plugin by providing a configuration object.
 	JitsuAnalyticsPlugin.init({
 		config: {

apps/api/src/posthog.ts

@@ -0,0 +1,31 @@
+import { environment } from '@gauzy/config';
+import { PosthogPlugin } from '@gauzy/plugin-posthog';
+
+/**
+ * Initializes and configures the PostHog plugin for analytics and performance tracking.
+ *
+ * This function checks if PostHog tracking is enabled in the environment configuration.
+ * If enabled, it initializes the PostHog plugin with the specified settings.
+ * Otherwise, it logs a message indicating that PostHog was not initialized.
+ *
+ * @returns {typeof PosthogPlugin | null} The configured PostHog instance, or null if not initialized.
+ */
+export function initializePosthog(): typeof PosthogPlugin | null {
+	if (!environment.posthog?.posthogEnabled || !environment.posthog?.posthogKey) {
+		console.log('PostHog not initialized: Tracking is disabled or API key is missing');
+		return null;
+	}
+
+	// Configure PostHog
+	return PosthogPlugin.init({
+		apiKey: environment.posthog.posthogKey,
+		apiHost: environment.posthog.posthogHost || 'https://app.posthog.com',
+		enableErrorTracking: true,
+		flushInterval: environment.posthog.posthogFlushInterval || 10000,
+		flushAt: 20,
+		autocapture: true,
+		mock: false
+	});
+}
+
+export const PosthogAnalytics = initializePosthog();

docker-compose.build.yml

@@ -24,6 +24,10 @@ services:
       SENTRY_HTTP_TRACING_ENABLED: ${SENTRY_HTTP_TRACING_ENABLED:-}
       SENTRY_POSTGRES_TRACKING_ENABLED: ${SENTRY_POSTGRES_TRACKING_ENABLED:-}
       SENTRY_PROFILING_ENABLED: ${SENTRY_PROFILING_ENABLED:-}
+      POSTHOG_KEY: ${POSTHOG_KEY:-}
+      POSTHOG_HOST: ${POSTHOG_HOST:-}
+      POSTHOG_ENABLED: ${POSTHOG_ENABLED:-}
+      POSTHOG_FLUSH_INTERVAL: ${POSTHOG_FLUSH_INTERVAL:-}
       JITSU_SERVER_URL: ${JITSU_SERVER_URL:-}
       OTEL_EXPORTER_OTLP_TRACES_ENDPOINT: ${OTEL_EXPORTER_OTLP_TRACES_ENDPOINT:-}
       OTEL_EXPORTER_OTLP_HEADERS: ${OTEL_EXPORTER_OTLP_HEADERS:-}

docker-compose.demo.yml

@@ -35,6 +35,10 @@ services:
       SENTRY_HTTP_TRACING_ENABLED: ${SENTRY_HTTP_TRACING_ENABLED:-}
       SENTRY_POSTGRES_TRACKING_ENABLED: ${SENTRY_POSTGRES_TRACKING_ENABLED:-}
       SENTRY_PROFILING_ENABLED: ${SENTRY_PROFILING_ENABLED:-}
+      POSTHOG_KEY: ${POSTHOG_KEY:-}
+      POSTHOG_HOST: ${POSTHOG_HOST:-}
+      POSTHOG_ENABLED: ${POSTHOG_ENABLED:-}
+      POSTHOG_FLUSH_INTERVAL: ${POSTHOG_FLUSH_INTERVAL:-}
       JITSU_SERVER_URL: ${JITSU_SERVER_URL:-}
       JITSU_SERVER_WRITE_KEY: ${JITSU_SERVER_WRITE_KEY:-}
       OTEL_EXPORTER_OTLP_TRACES_ENDPOINT: ${OTEL_EXPORTER_OTLP_TRACES_ENDPOINT:-}

docker-compose.yml

@@ -17,6 +17,10 @@ services:
       SENTRY_HTTP_TRACING_ENABLED: ${SENTRY_HTTP_TRACING_ENABLED:-}
       SENTRY_POSTGRES_TRACKING_ENABLED: ${SENTRY_POSTGRES_TRACKING_ENABLED:-}
       SENTRY_PROFILING_ENABLED: ${SENTRY_PROFILING_ENABLED:-}
+      POSTHOG_KEY: ${POSTHOG_KEY:-}
+      POSTHOG_HOST: ${POSTHOG_HOST:-}
+      POSTHOG_ENABLED: ${POSTHOG_ENABLED:-}
+      POSTHOG_FLUSH_INTERVAL: ${POSTHOG_FLUSH_INTERVAL:-}
       JITSU_SERVER_URL: ${JITSU_SERVER_URL:-}
       OTEL_EXPORTER_OTLP_TRACES_ENDPOINT: ${OTEL_EXPORTER_OTLP_TRACES_ENDPOINT:-}
       OTEL_EXPORTER_OTLP_HEADERS: ${OTEL_EXPORTER_OTLP_HEADERS:-}

package.json

@@ -170,9 +170,9 @@
 		"build:package:plugins:pre": "yarn run build:package:ui-core && yarn run build:package:ui-auth && yarn run build:package:plugin:onboarding-ui && yarn run build:package:plugin:legal-ui && yarn run build:package:plugin:job-search-ui && yarn run build:package:plugin:job-matching-ui && yarn run build:package:plugin:job-employee-ui && yarn run build:package:plugin:job-proposal-ui && yarn run build:package:plugin:public-layout-ui && yarn run build:package:plugin:maintenance-ui && yarn run build:package:plugin:videos-ui && yarn run build:integration-ui-plugins",
 		"build:package:plugins:pre:prod": "yarn run build:package:ui-core:prod && yarn run build:package:ui-auth:prod && yarn run build:package:plugin:onboarding-ui:prod && yarn run build:package:plugin:legal-ui:prod && yarn run build:package:plugin:job-search-ui:prod && yarn run build:package:plugin:job-matching-ui:prod && yarn run build:package:plugin:job-employee-ui:prod && yarn run build:package:plugin:job-proposal-ui:prod && yarn run build:package:plugin:public-layout-ui:prod && yarn run build:package:plugin:maintenance-ui:prod && yarn run build:package:plugin:videos-ui:prod && yarn run build:integration-ui-plugins:prod",
 		"build:package:plugins:pre:docker": "yarn run build:package:ui-core:docker && yarn run build:package:ui-auth:docker && yarn run build:package:plugin:onboarding-ui:docker && yarn run build:package:plugin:legal-ui:docker && yarn run build:package:plugin:job-search-ui:docker && yarn run build:package:plugin:job-matching-ui:docker && yarn run build:package:plugin:job-employee-ui:docker && yarn run build:package:plugin:job-proposal-ui:docker && yarn run build:package:plugin:public-layout-ui:docker && yarn run build:package:plugin:maintenance-ui:docker && yarn run build:package:plugin:videos-ui:docker && yarn run build:integration-ui-plugins:docker",
-		"build:package:plugins:post": "yarn run build:package:plugin:integration-jira && yarn run build:package:plugin:integration-ai && yarn run build:package:plugin:sentry && yarn run build:package:plugin:jitsu-analytic && yarn run build:package:plugin:product-reviews && yarn run build:package:plugin:job-search && yarn run build:package:plugin:job-proposal && yarn run build:package:plugin:integration-github && yarn run build:package:plugin:knowledge-base && yarn run build:package:plugin:changelog && yarn run build:package:plugin:integration-hubstaff && yarn run build:package:plugin:integration-upwork && yarn run build:package:plugin:integration-make-com && yarn run build:package:plugin:videos && yarn run build:package:plugin:registry && yarn run build:package:plugin:integration-zapier",
-		"build:package:plugins:post:prod": "yarn run build:package:plugin:integration-jira:prod && yarn run build:package:plugin:integration-ai:prod && yarn run build:package:plugin:sentry:prod && yarn run build:package:plugin:jitsu-analytic:prod && yarn run build:package:plugin:product-reviews:prod && yarn run build:package:plugin:job-search:prod && yarn run build:package:plugin:job-proposal:prod && yarn run build:package:plugin:integration-github:prod && yarn run build:package:plugin:knowledge-base:prod && yarn run build:package:plugin:changelog:prod && yarn run build:package:plugin:integration-hubstaff:prod && yarn run build:package:plugin:integration-upwork:prod && yarn run build:package:plugin:integration-make-com:prod && yarn run build:package:plugin:videos:prod && yarn run build:package:plugin:registry:prod && yarn run build:package:plugin:integration-zapier:prod",
-		"build:package:plugins:post:docker": "yarn run build:package:plugin:integration-jira:docker && yarn run build:package:plugin:integration-ai:docker && yarn run build:package:plugin:sentry:docker && yarn run build:package:plugin:jitsu-analytic:docker && yarn run build:package:plugin:product-reviews:docker && yarn run build:package:plugin:job-search:docker && yarn run build:package:plugin:job-proposal:docker && yarn run build:package:plugin:integration-github:docker && yarn run build:package:plugin:knowledge-base:docker && yarn run build:package:plugin:changelog:docker && yarn run build:package:plugin:integration-hubstaff:docker && yarn run build:package:plugin:integration-upwork:docker && yarn run build:package:plugin:integration-make-com:docker && yarn run build:package:plugin:videos:docker && yarn run build:package:plugin:registry:docker && yarn run build:package:plugin:integration-zapier:docker",
+		"build:package:plugins:post": "yarn run build:package:plugin:integration-jira && yarn run build:package:plugin:integration-ai && yarn run build:package:plugin:sentry && yarn run build:package:plugin:posthog && yarn run build:package:plugin:jitsu-analytic && yarn run build:package:plugin:product-reviews && yarn run build:package:plugin:job-search && yarn run build:package:plugin:job-proposal && yarn run build:package:plugin:integration-github && yarn run build:package:plugin:knowledge-base && yarn run build:package:plugin:changelog && yarn run build:package:plugin:integration-hubstaff && yarn run build:package:plugin:integration-upwork && yarn run build:package:plugin:integration-make-com && yarn run build:package:plugin:videos && yarn run build:package:plugin:registry && yarn run build:package:plugin:integration-zapier",
+		"build:package:plugins:post:prod": "yarn run build:package:plugin:integration-jira:prod && yarn run build:package:plugin:integration-ai:prod && yarn run build:package:plugin:sentry:prod && yarn run build:package:plugin:posthog:prod && yarn run build:package:plugin:jitsu-analytic:prod && yarn run build:package:plugin:product-reviews:prod && yarn run build:package:plugin:job-search:prod && yarn run build:package:plugin:job-proposal:prod && yarn run build:package:plugin:integration-github:prod && yarn run build:package:plugin:knowledge-base:prod && yarn run build:package:plugin:changelog:prod && yarn run build:package:plugin:integration-hubstaff:prod && yarn run build:package:plugin:integration-upwork:prod && yarn run build:package:plugin:integration-make-com:prod && yarn run build:package:plugin:videos:prod && yarn run build:package:plugin:registry:prod && yarn run build:package:plugin:integration-zapier:prod",
+		"build:package:plugins:post:docker": "yarn run build:package:plugin:integration-jira:docker && yarn run build:package:plugin:integration-ai:docker && yarn run build:package:plugin:sentry:docker && yarn run build:package:plugin:posthog:docker && yarn run build:package:plugin:jitsu-analytic:docker && yarn run build:package:plugin:product-reviews:docker && yarn run build:package:plugin:job-search:docker && yarn run build:package:plugin:job-proposal:docker && yarn run build:package:plugin:integration-github:docker && yarn run build:package:plugin:knowledge-base:docker && yarn run build:package:plugin:changelog:docker && yarn run build:package:plugin:integration-hubstaff:docker && yarn run build:package:plugin:integration-upwork:docker && yarn run build:package:plugin:integration-make-com:docker && yarn run build:package:plugin:videos:docker && yarn run build:package:plugin:registry:docker && yarn run build:package:plugin:integration-zapier:docker",
 		"build:package:plugin:integration-ai": "cross-env NODE_ENV=development NODE_OPTIONS=--max-old-space-size=12288 yarn nx build plugin-integration-ai",
 		"build:package:plugin:integration-ai:prod": "cross-env NODE_ENV=production NODE_OPTIONS=--max-old-space-size=12288 yarn nx build plugin-integration-ai",
 		"build:package:plugin:integration-ai:docker": "cross-env NODE_ENV=production NODE_OPTIONS=--max-old-space-size=60000 yarn nx build plugin-integration-ai",
@@ -197,6 +197,9 @@
 		"build:package:plugin:sentry": "cross-env NODE_ENV=development NODE_OPTIONS=--max-old-space-size=12288 yarn nx build plugin-sentry",
 		"build:package:plugin:sentry:prod": "cross-env NODE_ENV=production NODE_OPTIONS=--max-old-space-size=12288 yarn nx build plugin-sentry",
 		"build:package:plugin:sentry:docker": "cross-env NODE_ENV=production NODE_OPTIONS=--max-old-space-size=60000 yarn nx build plugin-sentry",
+		"build:package:plugin:posthog": "cross-env NODE_ENV=development NODE_OPTIONS=--max-old-space-size=12288 yarn nx build plugin-posthog",
+		"build:package:plugin:posthog:prod": "cross-env NODE_ENV=production NODE_OPTIONS=--max-old-space-size=12288 yarn nx build plugin-posthog",
+		"build:package:plugin:posthog:docker": "cross-env NODE_ENV=production NODE_OPTIONS=--max-old-space-size=60000 yarn nx build plugin-posthog",
 		"build:package:plugin:jitsu-analytic": "cross-env NODE_ENV=development NODE_OPTIONS=--max-old-space-size=12288 yarn nx build plugin-jitsu-analytics",
 		"build:package:plugin:jitsu-analytic:prod": "cross-env NODE_ENV=production NODE_OPTIONS=--max-old-space-size=12288 yarn nx build plugin-jitsu-analytics",
 		"build:package:plugin:jitsu-analytic:docker": "cross-env NODE_ENV=production NODE_OPTIONS=--max-old-space-size=60000 yarn nx build plugin-jitsu-analytics",

packages/common/src/lib/interfaces/IPosthogConfig.ts

@@ -0,0 +1,24 @@
+/**
+ * Represents a configuration object for PostHog server settings.
+ */
+export interface IPosthogConfig {
+	/**
+	 * The PostHog API key used to authenticate requests.
+	 */
+	readonly posthogKey: string;
+
+	/**
+	 * The host URL of the PostHog instance (e.g., https://app.posthog.com).
+	 */
+	readonly posthogHost: string;
+
+	/**
+	 * Whether PostHog tracking is enabled.
+	 */
+	readonly posthogEnabled: boolean;
+
+	/**
+	 * How often events are flushed (in milliseconds).
+	 */
+	readonly posthogFlushInterval: number;
+}