@wrelik/analytics 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# @wrelik/analytics
+
+## 0.1.0
+
+### Minor Changes
+
+- ad849e3: Initial release of all wrelik-kit packages.
+
+### Patch Changes
+
+- Updated dependencies [ad849e3]
+  - @wrelik/errors@0.1.0

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@wrelik/analytics",
+  "version": "0.1.0",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "dependencies": {
+    "posthog-node": "^3.6.3",
+    "@wrelik/errors": "0.1.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.1",
+    "vitest": "^1.2.2",
+    "@wrelik/eslint-config": "0.1.0",
+    "@wrelik/tsconfig": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "lint": "eslint src/",
+    "test": "vitest run --passWithNoTests"
+  }
+}

package/src/index.ts

@@ -0,0 +1,51 @@
+import { PostHog } from 'posthog-node';
+import { ValidationError } from '@wrelik/errors';
+
+let client: PostHog | null = null;
+
+export function initAnalytics(apiKey: string, host = 'https://app.posthog.com') {
+  client = new PostHog(apiKey, { host });
+}
+
+function getClient(safe = false) {
+  if (!client && !safe) {
+    throw new Error('Analytics not initialized. Call initAnalytics first.');
+  }
+  return client;
+}
+
+export function identify(userId: string, traits: Record<string, any>) {
+  getClient(true)?.identify({
+    distinctId: userId,
+    properties: traits,
+  });
+}
+
+export function capture(
+  event: string,
+  properties: Record<string, any> = {},
+  options?: { userId?: string },
+) {
+  // Validate naming convention: app.action.object
+  const parts = event.split('.');
+  if (parts.length < 3) {
+    throw new ValidationError(`Event name "${event}" must follow "app.action.object" format`);
+  }
+
+  // If no user is provided, we can't capture server-side easily without anonymous ID
+  // But usually servers have a userId context.
+  if (!options?.userId) {
+    console.warn('Analytics capture called without userId');
+    return;
+  }
+
+  getClient(true)?.capture({
+    distinctId: options.userId,
+    event,
+    properties,
+  });
+}
+
+export async function shutdown() {
+  await getClient(true)?.shutdown();
+}

package/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "extends": "@wrelik/tsconfig/node.json",
+  "compilerOptions": {
+    "outDir": "dist"
+  },
+  "include": ["src"]
+}