@codaco/analytics 8.0.0 → 9.0.1

package/dist/index.d.ts

@@ -1,88 +1,119 @@
-import { NextRequest } from 'next/server';
-import z from 'zod';
+import { A as AnalyticsConfig, a as Analytics } from './types-DK5BiTnW.js';
+export { E as ErrorProperties, b as EventProperties, c as EventType, e as eventTypes, l as legacyEventTypeMap } from './types-DK5BiTnW.js';
+import * as react from 'react';
+import { ReactNode } from 'react';
+import 'zod';
 
-declare const eventTypes: readonly ["AppSetup", "ProtocolInstalled", "InterviewStarted", "InterviewCompleted", "DataExported"];
 /**
- * Raw events are the payload that is sent to trackEvent, which can be either
- * general events or errors. We discriminate on the `type` property to determine
- * which schema to use, and then merge the shared properties.
+ * Check if analytics is disabled via environment variables
  */
-declare const RawEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    type: z.ZodEnum<{
-        AppSetup: "AppSetup";
-        ProtocolInstalled: "ProtocolInstalled";
-        InterviewStarted: "InterviewStarted";
-        InterviewCompleted: "InterviewCompleted";
-        DataExported: "DataExported";
-    }>;
-}, z.core.$strip>, z.ZodObject<{
-    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    type: z.ZodLiteral<"Error">;
-    message: z.ZodString;
-    name: z.ZodString;
-    stack: z.ZodOptional<z.ZodString>;
-    cause: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>], "type">;
-type RawEvent = z.infer<typeof RawEventSchema>;
-declare const TrackableEventSchema: z.ZodIntersection<z.ZodDiscriminatedUnion<[z.ZodObject<{
-    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    type: z.ZodEnum<{
-        AppSetup: "AppSetup";
-        ProtocolInstalled: "ProtocolInstalled";
-        InterviewStarted: "InterviewStarted";
-        InterviewCompleted: "InterviewCompleted";
-        DataExported: "DataExported";
-    }>;
-}, z.core.$strip>, z.ZodObject<{
-    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    type: z.ZodLiteral<"Error">;
-    message: z.ZodString;
-    name: z.ZodString;
-    stack: z.ZodOptional<z.ZodString>;
-    cause: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>], "type">, z.ZodObject<{
-    timestamp: z.ZodString;
-}, z.core.$strip>>;
-type TrackableEvent = z.infer<typeof TrackableEventSchema>;
+declare function isDisabledByEnv(): boolean;
 /**
- * The final schema for an analytics event. This is the schema that is used to
- * validate the event before it is inserted into the database. It is the
- * intersection of the trackable event and the dispatchable properties.
+ * Default configuration for analytics
+ * API host and key are hardcoded, but disabled flag can be set via environment variables
  */
-declare const AnalyticsEventSchema: z.ZodIntersection<z.ZodIntersection<z.ZodDiscriminatedUnion<[z.ZodObject<{
-    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    type: z.ZodEnum<{
-        AppSetup: "AppSetup";
-        ProtocolInstalled: "ProtocolInstalled";
-        InterviewStarted: "InterviewStarted";
-        InterviewCompleted: "InterviewCompleted";
-        DataExported: "DataExported";
-    }>;
-}, z.core.$strip>, z.ZodObject<{
-    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    type: z.ZodLiteral<"Error">;
-    message: z.ZodString;
-    name: z.ZodString;
-    stack: z.ZodOptional<z.ZodString>;
-    cause: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>], "type">, z.ZodObject<{
-    timestamp: z.ZodString;
-}, z.core.$strip>>, z.ZodObject<{
-    installationId: z.ZodString;
-    countryISOCode: z.ZodString;
-}, z.core.$strip>>;
-type analyticsEvent = z.infer<typeof AnalyticsEventSchema>;
-declare const createRouteHandler: ({ platformUrl, installationId, disableAnalytics, }: {
-    platformUrl?: string;
-    installationId: string;
-    disableAnalytics?: boolean;
-}) => (request: NextRequest) => Promise<Response>;
-declare const makeEventTracker: (options?: {
-    endpoint?: string;
-}) => (event: RawEvent) => Promise<{
-    error: string | null;
-    success: boolean;
-}>;
+declare const defaultConfig: Partial<AnalyticsConfig>;
+/**
+ * Merge user config with defaults
+ *
+ * Note: This package is designed to work exclusively with the Cloudflare Worker
+ * reverse proxy (ph-relay.networkcanvas.com). Authentication is handled by the
+ * worker, so the API key is optional and defaults to a placeholder value.
+ *
+ * The only environment variable checked is DISABLE_ANALYTICS / NEXT_PUBLIC_DISABLE_ANALYTICS
+ * for disabling tracking. All other configuration is hardcoded or passed explicitly.
+ */
+declare function mergeConfig(userConfig: AnalyticsConfig): Required<AnalyticsConfig>;
+
+/**
+ * Hook to access analytics functionality in React components
+ *
+ * @example
+ * ```tsx
+ * import { useAnalytics } from '@codaco/analytics';
+ *
+ * function MyComponent() {
+ *   const { trackEvent, trackError } = useAnalytics();
+ *
+ *   const handleAction = () => {
+ *     trackEvent('protocol_installed', {
+ *       metadata: { protocolName: 'My Protocol' }
+ *     });
+ *   };
+ *
+ *   return <button onClick={handleAction}>Install Protocol</button>;
+ * }
+ * ```
+ */
+declare function useAnalytics(): Analytics;
+/**
+ * Hook to access feature flags
+ *
+ * @example
+ * ```tsx
+ * import { useFeatureFlag } from '@codaco/analytics';
+ *
+ * function MyComponent() {
+ *   const isNewFeatureEnabled = useFeatureFlag('new-feature');
+ *
+ *   if (isNewFeatureEnabled) {
+ *     return <NewFeature />;
+ *   }
+ *
+ *   return <OldFeature />;
+ * }
+ * ```
+ */
+declare function useFeatureFlag(flagKey: string): boolean;
+/**
+ * Hook to access feature flag values (for multivariate flags)
+ *
+ * @example
+ * ```tsx
+ * import { useFeatureFlagValue } from '@codaco/analytics';
+ *
+ * function MyComponent() {
+ *   const theme = useFeatureFlagValue('theme-variant');
+ *
+ *   return <div className={theme === 'dark' ? 'dark-theme' : 'light-theme'}>
+ *     Content
+ *   </div>;
+ * }
+ * ```
+ */
+declare function useFeatureFlagValue(flagKey: string): string | boolean | undefined;
+
+/**
+ * Props for the AnalyticsProvider
+ */
+type AnalyticsProviderProps = {
+    children: ReactNode;
+    config: AnalyticsConfig;
+};
+/**
+ * Provider component that initializes PostHog and provides analytics context
+ *
+ * @example
+ * ```tsx
+ * import { AnalyticsProvider } from '@codaco/analytics';
+ *
+ * function App({ children }) {
+ *   return (
+ *     <AnalyticsProvider
+ *       config={{
+ *         installationId: 'your-installation-id',
+ *         apiKey: 'phc_your_api_key', // optional if set via env
+ *         apiHost: 'https://ph-relay.networkcanvas.com', // optional
+ *       }}
+ *     >
+ *       {children}
+ *     </AnalyticsProvider>
+ *   );
+ * }
+ * ```
+ */
+declare function AnalyticsProvider({ children, config }: AnalyticsProviderProps): react.JSX.Element | null;
+
+declare function ensureError(value: unknown): Error;
 
-export { AnalyticsEventSchema, type RawEvent, RawEventSchema, type TrackableEvent, TrackableEventSchema, type analyticsEvent, createRouteHandler, eventTypes, makeEventTracker };
+export { Analytics, AnalyticsConfig, AnalyticsProvider, type AnalyticsProviderProps, defaultConfig, ensureError, isDisabledByEnv, mergeConfig, useAnalytics, useFeatureFlag, useFeatureFlagValue };

package/dist/index.js

@@ -1,182 +1,210 @@
-// src/index.ts
-import { NextResponse } from "next/server";
-import z from "zod";
+import {
+  defaultConfig,
+  ensureError,
+  isDisabledByEnv,
+  mergeConfig
+} from "./chunk-3NEQVIC4.js";
 
-// src/utils.ts
-function ensureError(value) {
-  if (!value) return new Error("No value was thrown");
-  if (value instanceof Error) return value;
-  if (Object.prototype.isPrototypeOf.call(value, Error)) return value;
-  let stringified = "[Unable to stringify the thrown value]";
-  try {
-    stringified = JSON.stringify(value);
-  } catch (e) {
-    console.error(e);
-  }
-  const error = new Error(`This value was thrown as is, not through an Error: ${stringified}`);
-  return error;
-}
+// src/hooks.ts
+import { useContext } from "react";
 
-// src/index.ts
-var eventTypes = [
-  "AppSetup",
-  "ProtocolInstalled",
-  "InterviewStarted",
-  "InterviewCompleted",
-  "DataExported"
-];
-var EventSchema = z.object({
-  type: z.enum(eventTypes)
-});
-var ErrorSchema = z.object({
-  type: z.literal("Error"),
-  message: z.string(),
-  name: z.string(),
-  stack: z.string().optional(),
-  cause: z.string().optional()
-});
-var SharedEventAndErrorSchema = z.object({
-  metadata: z.record(z.string(), z.unknown()).optional()
-});
-var RawEventSchema = z.discriminatedUnion("type", [
-  SharedEventAndErrorSchema.merge(EventSchema),
-  SharedEventAndErrorSchema.merge(ErrorSchema)
-]);
-var TrackablePropertiesSchema = z.object({
-  timestamp: z.string()
-});
-var TrackableEventSchema = z.intersection(RawEventSchema, TrackablePropertiesSchema);
-var DispatchablePropertiesSchema = z.object({
-  installationId: z.string(),
-  countryISOCode: z.string()
-});
-var AnalyticsEventSchema = z.intersection(TrackableEventSchema, DispatchablePropertiesSchema);
-var createRouteHandler = ({
-  platformUrl = "https://analytics.networkcanvas.com",
-  installationId,
-  disableAnalytics
-}) => {
-  return async (request) => {
-    try {
-      const incomingEvent = await request.json();
-      if (disableAnalytics) {
-        console.info("\u{1F6D1} Analytics disabled. Payload not sent.");
-        try {
-          console.info("Payload:", "\n", JSON.stringify(incomingEvent, null, 2));
-        } catch (e) {
-          console.error("Error stringifying payload:", e);
+// src/provider.tsx
+import { createContext, useEffect, useRef } from "react";
+
+// src/client.ts
+import posthog from "posthog-js";
+function createAnalytics(config) {
+  const { apiHost, apiKey, installationId, disabled, debug, posthogOptions } = config;
+  if (disabled) {
+    return createNoOpAnalytics(installationId);
+  }
+  posthog.init(apiKey, {
+    api_host: apiHost,
+    loaded: (posthogInstance) => {
+      posthogInstance.register({
+        installation_id: installationId
+      });
+      if (debug) {
+        posthogInstance.debug();
+      }
+    },
+    ...posthogOptions
+  });
+  return {
+    trackEvent: (eventType, properties) => {
+      if (disabled) return;
+      try {
+        posthog.capture(eventType, {
+          ...properties,
+          // Flatten metadata into properties for better PostHog integration
+          ...properties?.metadata ?? {}
+        });
+      } catch (_e) {
+        if (debug) {
         }
-        return NextResponse.json({ message: "Analytics disabled" }, { status: 200 });
       }
-      const trackableEvent = TrackableEventSchema.safeParse(incomingEvent);
-      if (!trackableEvent.success) {
-        console.error("Invalid event:", trackableEvent.error);
-        return NextResponse.json({ error: "Invalid event" }, { status: 400 });
+    },
+    trackError: (error, additionalProperties) => {
+      if (disabled) return;
+      try {
+        const errorObj = ensureError(error);
+        const errorProperties = {
+          message: errorObj.message,
+          name: errorObj.name,
+          stack: errorObj.stack,
+          cause: errorObj.cause ? String(errorObj.cause) : void 0,
+          ...additionalProperties
+        };
+        posthog.capture("error", {
+          ...errorProperties,
+          // Flatten metadata
+          ...additionalProperties?.metadata ?? {}
+        });
+      } catch (_e) {
+        if (debug) {
+        }
       }
-      let countryISOCode = "Unknown";
+    },
+    isFeatureEnabled: (flagKey) => {
+      if (disabled) return false;
       try {
-        const ip = await fetch("https://api64.ipify.org").then((res) => res.text());
-        if (!ip) {
-          throw new Error("Could not fetch IP address");
+        return posthog.isFeatureEnabled(flagKey);
+      } catch (_e) {
+        if (debug) {
         }
-        const geoData = await fetch(`http://ip-api.com/json/${ip}`).then((res) => res.json());
-        if (geoData.status === "success") {
-          countryISOCode = geoData.countryCode;
-        } else {
-          throw new Error(geoData.message);
+        return void 0;
+      }
+    },
+    getFeatureFlag: (flagKey) => {
+      if (disabled) return void 0;
+      try {
+        return posthog.getFeatureFlag(flagKey);
+      } catch (_e) {
+        if (debug) {
         }
-      } catch (e) {
-        console.error("Geolocation failed:", e);
+        return void 0;
       }
-      const analyticsEvent = {
-        ...trackableEvent.data,
-        installationId,
-        countryISOCode
-      };
-      const response = await fetch(`${platformUrl}/api/event`, {
-        keepalive: true,
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json"
-        },
-        body: JSON.stringify(analyticsEvent)
-      });
-      if (!response.ok) {
-        let error = `Analytics platform returned an unexpected error: ${response.statusText}`;
-        if (response.status === 400) {
-          error = "Analytics platform rejected the event as invalid. Please check the event schema";
+    },
+    reloadFeatureFlags: () => {
+      if (disabled) return;
+      try {
+        posthog.reloadFeatureFlags();
+      } catch (_e) {
+        if (debug) {
         }
-        if (response.status === 404) {
-          error = "Analytics platform could not be reached. Please specify a valid platform URL, or check that the platform is online.";
+      }
+    },
+    identify: (distinctId, properties) => {
+      if (disabled) return;
+      try {
+        posthog.identify(distinctId, properties);
+      } catch (_e) {
+        if (debug) {
         }
-        if (response.status === 500) {
-          error = "Analytics platform returned an internal server error. Please check the platform logs.";
+      }
+    },
+    reset: () => {
+      if (disabled) return;
+      try {
+        posthog.reset();
+      } catch (_e) {
+        if (debug) {
         }
-        console.info(`\u26A0\uFE0F Analytics platform rejected event: ${error}`);
-        return Response.json(
-          {
-            error
-          },
-          { status: 500 }
-        );
       }
-      console.info("\u{1F680} Analytics event sent to platform!");
-      return Response.json({ message: "Event forwarded successfully" });
-    } catch (e) {
-      const error = ensureError(e);
-      console.info("\u{1F6AB} Internal error with sending analytics event.");
-      return Response.json({ error: `Error in analytics route handler: ${error.message}` }, { status: 500 });
-    }
+    },
+    isEnabled: () => !disabled,
+    getInstallationId: () => installationId
   };
-};
-var makeEventTracker = (options) => async (event) => {
-  const endpoint = options?.endpoint ?? "/api/analytics";
-  const eventWithTimeStamp = {
-    ...event,
-    timestamp: (/* @__PURE__ */ new Date()).toJSON()
+}
+function createNoOpAnalytics(installationId) {
+  return {
+    trackEvent: () => {
+    },
+    trackError: () => {
+    },
+    isFeatureEnabled: () => false,
+    getFeatureFlag: () => void 0,
+    reloadFeatureFlags: () => {
+    },
+    identify: () => {
+    },
+    reset: () => {
+    },
+    isEnabled: () => false,
+    getInstallationId: () => installationId
   };
-  try {
-    const response = await fetch(endpoint, {
-      method: "POST",
-      keepalive: true,
-      body: JSON.stringify(eventWithTimeStamp),
-      headers: {
-        "Content-Type": "application/json"
-      }
-    });
-    if (!response.ok) {
-      if (response.status === 404) {
-        return {
-          error: "Analytics endpoint not found, did you forget to add the route?",
-          success: false
-        };
-      }
-      if (response.status === 400) {
-        return {
-          error: `Invalid event sent to analytics endpoint: ${response.statusText}`,
-          success: false
-        };
-      }
-      return {
-        error: `Internal server error when sending analytics event: ${response.statusText}. Check the route handler implementation.`,
-        success: false
-      };
+}
+
+// src/provider.tsx
+var AnalyticsContext = createContext(null);
+function AnalyticsProvider({ children, config }) {
+  const analyticsRef = useRef(null);
+  useEffect(() => {
+    if (!analyticsRef.current) {
+      const mergedConfig = mergeConfig(config);
+      analyticsRef.current = createAnalytics(mergedConfig);
     }
-    return { error: null, success: true };
-  } catch (e) {
-    const error = ensureError(e);
-    return {
-      error: `Internal error when sending analytics event: ${error.message}`,
-      success: false
-    };
+  }, []);
+  if (!analyticsRef.current) {
+    return null;
+  }
+  return /* @__PURE__ */ React.createElement(AnalyticsContext.Provider, { value: analyticsRef.current }, children);
+}
+
+// src/hooks.ts
+function useAnalytics() {
+  const analytics = useContext(AnalyticsContext);
+  if (!analytics) {
+    throw new Error("useAnalytics must be used within an AnalyticsProvider");
   }
+  return analytics;
+}
+function useFeatureFlag(flagKey) {
+  const analytics = useAnalytics();
+  return analytics.isFeatureEnabled(flagKey) ?? false;
+}
+function useFeatureFlagValue(flagKey) {
+  const analytics = useAnalytics();
+  return analytics.getFeatureFlag(flagKey);
+}
+
+// src/types.ts
+import { z } from "zod";
+var eventTypes = [
+  "app_setup",
+  "protocol_installed",
+  "interview_started",
+  "interview_completed",
+  "data_exported",
+  "error"
+];
+var legacyEventTypeMap = {
+  AppSetup: "app_setup",
+  ProtocolInstalled: "protocol_installed",
+  InterviewStarted: "interview_started",
+  InterviewCompleted: "interview_completed",
+  DataExported: "data_exported",
+  Error: "error"
 };
+var EventPropertiesSchema = z.object({
+  metadata: z.record(z.string(), z.unknown()).optional()
+});
+var ErrorPropertiesSchema = EventPropertiesSchema.extend({
+  message: z.string(),
+  name: z.string(),
+  stack: z.string().optional(),
+  cause: z.string().optional()
+});
 export {
-  AnalyticsEventSchema,
-  RawEventSchema,
-  TrackableEventSchema,
-  createRouteHandler,
+  AnalyticsProvider,
+  defaultConfig,
+  ensureError,
   eventTypes,
-  makeEventTracker
+  isDisabledByEnv,
+  legacyEventTypeMap,
+  mergeConfig,
+  useAnalytics,
+  useFeatureFlag,
+  useFeatureFlagValue
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/utils.ts"],"sourcesContent":["import { type NextRequest, NextResponse } from \"next/server\";\nimport z from \"zod\";\nimport { ensureError } from \"./utils\";\n\n// Todo: it would be great to work out a way to support arbitrary types here.\nexport const eventTypes = [\n\t\"AppSetup\",\n\t\"ProtocolInstalled\",\n\t\"InterviewStarted\",\n\t\"InterviewCompleted\",\n\t\"DataExported\",\n] as const;\n\nconst EventSchema = z.object({\n\ttype: z.enum(eventTypes),\n});\n\nconst ErrorSchema = z.object({\n\ttype: z.literal(\"Error\"),\n\tmessage: z.string(),\n\tname: z.string(),\n\tstack: z.string().optional(),\n\tcause: z.string().optional(),\n});\n\nconst SharedEventAndErrorSchema = z.object({\n\tmetadata: z.record(z.string(), z.unknown()).optional(),\n});\n\n/**\n * Raw events are the payload that is sent to trackEvent, which can be either\n * general events or errors. We discriminate on the `type` property to determine\n * which schema to use, and then merge the shared properties.\n */\nexport const RawEventSchema = z.discriminatedUnion(\"type\", [\n\tSharedEventAndErrorSchema.merge(EventSchema),\n\tSharedEventAndErrorSchema.merge(ErrorSchema),\n]);\nexport type RawEvent = z.infer<typeof RawEventSchema>;\n\n/**\n * Trackable events are the events that are sent to the route handler by\n * `trackEvent`. The function adds the timestamp to ensure it is not inaccurate\n * due to network latency or processing time.\n */\nconst TrackablePropertiesSchema = z.object({\n\ttimestamp: z.string(),\n});\n\nexport const TrackableEventSchema = z.intersection(RawEventSchema, TrackablePropertiesSchema);\nexport type TrackableEvent = z.infer<typeof TrackableEventSchema>;\n\n/**\n * Dispatchable events are the events that are sent to the platform. The route\n * handler injects the installationId and countryISOCode properties.\n */\nconst DispatchablePropertiesSchema = z.object({\n\tinstallationId: z.string(),\n\tcountryISOCode: z.string(),\n});\n\n/**\n * The final schema for an analytics event. This is the schema that is used to\n * validate the event before it is inserted into the database. It is the\n * intersection of the trackable event and the dispatchable properties.\n */\nexport const AnalyticsEventSchema = z.intersection(TrackableEventSchema, DispatchablePropertiesSchema);\nexport type analyticsEvent = z.infer<typeof AnalyticsEventSchema>;\n\ntype GeoData = {\n\tstatus: \"success\" | \"fail\";\n\tcountryCode: string;\n\tmessage: string;\n};\n\nexport const createRouteHandler = ({\n\tplatformUrl = \"https://analytics.networkcanvas.com\",\n\tinstallationId,\n\tdisableAnalytics,\n}: {\n\tplatformUrl?: string;\n\tinstallationId: string;\n\tdisableAnalytics?: boolean;\n}) => {\n\treturn async (request: NextRequest) => {\n\t\ttry {\n\t\t\tconst incomingEvent = (await request.json()) as unknown;\n\n\t\t\t// Check if analytics is disabled\n\t\t\tif (disableAnalytics) {\n\t\t\t\tconsole.info(\"🛑 Analytics disabled. Payload not sent.\");\n\t\t\t\ttry {\n\t\t\t\t\tconsole.info(\"Payload:\", \"\\n\", JSON.stringify(incomingEvent, null, 2));\n\t\t\t\t} catch (e) {\n\t\t\t\t\tconsole.error(\"Error stringifying payload:\", e);\n\t\t\t\t}\n\n\t\t\t\treturn NextResponse.json({ message: \"Analytics disabled\" }, { status: 200 });\n\t\t\t}\n\n\t\t\t// Validate the event\n\t\t\tconst trackableEvent = TrackableEventSchema.safeParse(incomingEvent);\n\n\t\t\tif (!trackableEvent.success) {\n\t\t\t\tconsole.error(\"Invalid event:\", trackableEvent.error);\n\t\t\t\treturn NextResponse.json({ error: \"Invalid event\" }, { status: 400 });\n\t\t\t}\n\n\t\t\t// We don't want failures in third party services to prevent us from\n\t\t\t// tracking analytics events, so we'll catch any errors and log them\n\t\t\t// and continue with an 'Unknown' country code.\n\t\t\tlet countryISOCode = \"Unknown\";\n\t\t\ttry {\n\t\t\t\tconst ip = await fetch(\"https://api64.ipify.org\").then((res) => res.text());\n\n\t\t\t\tif (!ip) {\n\t\t\t\t\tthrow new Error(\"Could not fetch IP address\");\n\t\t\t\t}\n\n\t\t\t\tconst geoData = (await fetch(`http://ip-api.com/json/${ip}`).then((res) => res.json())) as GeoData;\n\n\t\t\t\tif (geoData.status === \"success\") {\n\t\t\t\t\tcountryISOCode = geoData.countryCode;\n\t\t\t\t} else {\n\t\t\t\t\tthrow new Error(geoData.message);\n\t\t\t\t}\n\t\t\t} catch (e) {\n\t\t\t\tconsole.error(\"Geolocation failed:\", e);\n\t\t\t}\n\n\t\t\tconst analyticsEvent: analyticsEvent = {\n\t\t\t\t...trackableEvent.data,\n\t\t\t\tinstallationId,\n\t\t\t\tcountryISOCode,\n\t\t\t};\n\n\t\t\t// Forward to backend\n\t\t\tconst response = await fetch(`${platformUrl}/api/event`, {\n\t\t\t\tkeepalive: true,\n\t\t\t\tmethod: \"POST\",\n\t\t\t\theaders: {\n\t\t\t\t\t\"Content-Type\": \"application/json\",\n\t\t\t\t},\n\t\t\t\tbody: JSON.stringify(analyticsEvent),\n\t\t\t});\n\n\t\t\tif (!response.ok) {\n\t\t\t\tlet error = `Analytics platform returned an unexpected error: ${response.statusText}`;\n\n\t\t\t\tif (response.status === 400) {\n\t\t\t\t\terror = \"Analytics platform rejected the event as invalid. Please check the event schema\";\n\t\t\t\t}\n\n\t\t\t\tif (response.status === 404) {\n\t\t\t\t\terror =\n\t\t\t\t\t\t\"Analytics platform could not be reached. Please specify a valid platform URL, or check that the platform is online.\";\n\t\t\t\t}\n\n\t\t\t\tif (response.status === 500) {\n\t\t\t\t\terror = \"Analytics platform returned an internal server error. Please check the platform logs.\";\n\t\t\t\t}\n\n\t\t\t\tconsole.info(`⚠️ Analytics platform rejected event: ${error}`);\n\t\t\t\treturn Response.json(\n\t\t\t\t\t{\n\t\t\t\t\t\terror,\n\t\t\t\t\t},\n\t\t\t\t\t{ status: 500 },\n\t\t\t\t);\n\t\t\t}\n\t\t\tconsole.info(\"🚀 Analytics event sent to platform!\");\n\t\t\treturn Response.json({ message: \"Event forwarded successfully\" });\n\t\t} catch (e) {\n\t\t\tconst error = ensureError(e);\n\t\t\tconsole.info(\"🚫 Internal error with sending analytics event.\");\n\n\t\t\treturn Response.json({ error: `Error in analytics route handler: ${error.message}` }, { status: 500 });\n\t\t}\n\t};\n};\n\nexport const makeEventTracker =\n\t(options?: { endpoint?: string }) =>\n\tasync (\n\t\tevent: RawEvent,\n\t): Promise<{\n\t\terror: string | null;\n\t\tsuccess: boolean;\n\t}> => {\n\t\t// We use a relative path by default, which should automatically use the\n\t\t// same origin as the page that is sending the event.\n\t\tconst endpoint = options?.endpoint ?? \"/api/analytics\";\n\n\t\tconst eventWithTimeStamp: TrackableEvent = {\n\t\t\t...event,\n\t\t\ttimestamp: new Date().toJSON(),\n\t\t};\n\n\t\ttry {\n\t\t\tconst response = await fetch(endpoint, {\n\t\t\t\tmethod: \"POST\",\n\t\t\t\tkeepalive: true,\n\t\t\t\tbody: JSON.stringify(eventWithTimeStamp),\n\t\t\t\theaders: {\n\t\t\t\t\t\"Content-Type\": \"application/json\",\n\t\t\t\t},\n\t\t\t});\n\n\t\t\tif (!response.ok) {\n\t\t\t\tif (response.status === 404) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\terror: \"Analytics endpoint not found, did you forget to add the route?\",\n\t\t\t\t\t\tsuccess: false,\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\t// createRouteHandler will return a 400 if the event failed schema validation.\n\t\t\t\tif (response.status === 400) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\terror: `Invalid event sent to analytics endpoint: ${response.statusText}`,\n\t\t\t\t\t\tsuccess: false,\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\t// createRouteHandler will return a 500 for all error states\n\t\t\t\treturn {\n\t\t\t\t\terror: `Internal server error when sending analytics event: ${response.statusText}. Check the route handler implementation.`,\n\t\t\t\t\tsuccess: false,\n\t\t\t\t};\n\t\t\t}\n\n\t\t\treturn { error: null, success: true };\n\t\t} catch (e) {\n\t\t\tconst error = ensureError(e);\n\t\t\treturn {\n\t\t\t\terror: `Internal error when sending analytics event: ${error.message}`,\n\t\t\t\tsuccess: false,\n\t\t\t};\n\t\t}\n\t};\n","// Helper function that ensures that a value is an Error\nexport function ensureError(value: unknown): Error {\n\tif (!value) return new Error(\"No value was thrown\");\n\n\tif (value instanceof Error) return value;\n\n\t// Test if value inherits from Error\n\tif (Object.prototype.isPrototypeOf.call(value, Error)) return value as Error & typeof value;\n\n\tlet stringified = \"[Unable to stringify the thrown value]\";\n\ttry {\n\t\tstringified = JSON.stringify(value);\n\t} catch (e) {\n\t\tconsole.error(e);\n\t}\n\n\tconst error = new Error(`This value was thrown as is, not through an Error: ${stringified}`);\n\treturn error;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/hooks.ts","../src/provider.tsx","../src/client.ts","../src/types.ts"],"sourcesContent":["\"use client\";\n\nimport { useContext } from \"react\";\nimport { AnalyticsContext } from \"./provider\";\nimport type { Analytics } from \"./types\";\n\n/**\n * Hook to access analytics functionality in React components\n *\n * @example\n * ```tsx\n * import { useAnalytics } from '@codaco/analytics';\n *\n * function MyComponent() {\n *   const { trackEvent, trackError } = useAnalytics();\n *\n *   const handleAction = () => {\n *     trackEvent('protocol_installed', {\n *       metadata: { protocolName: 'My Protocol' }\n *     });\n *   };\n *\n *   return <button onClick={handleAction}>Install Protocol</button>;\n * }\n * ```\n */\nexport function useAnalytics(): Analytics {\n\tconst analytics = useContext(AnalyticsContext);\n\n\tif (!analytics) {\n\t\tthrow new Error(\"useAnalytics must be used within an AnalyticsProvider\");\n\t}\n\n\treturn analytics;\n}\n\n/**\n * Hook to access feature flags\n *\n * @example\n * ```tsx\n * import { useFeatureFlag } from '@codaco/analytics';\n *\n * function MyComponent() {\n *   const isNewFeatureEnabled = useFeatureFlag('new-feature');\n *\n *   if (isNewFeatureEnabled) {\n *     return <NewFeature />;\n *   }\n *\n *   return <OldFeature />;\n * }\n * ```\n */\nexport function useFeatureFlag(flagKey: string): boolean {\n\tconst analytics = useAnalytics();\n\treturn analytics.isFeatureEnabled(flagKey) ?? false;\n}\n\n/**\n * Hook to access feature flag values (for multivariate flags)\n *\n * @example\n * ```tsx\n * import { useFeatureFlagValue } from '@codaco/analytics';\n *\n * function MyComponent() {\n *   const theme = useFeatureFlagValue('theme-variant');\n *\n *   return <div className={theme === 'dark' ? 'dark-theme' : 'light-theme'}>\n *     Content\n *   </div>;\n * }\n * ```\n */\nexport function useFeatureFlagValue(flagKey: string): string | boolean | undefined {\n\tconst analytics = useAnalytics();\n\treturn analytics.getFeatureFlag(flagKey);\n}\n","\"use client\";\n\nimport { createContext, type ReactNode, useEffect, useRef } from \"react\";\nimport { createAnalytics } from \"./client\";\nimport { mergeConfig } from \"./config\";\nimport type { Analytics, AnalyticsConfig } from \"./types\";\n\n/**\n * React Context for analytics\n */\nexport const AnalyticsContext = createContext<Analytics | null>(null);\n\n/**\n * Props for the AnalyticsProvider\n */\nexport type AnalyticsProviderProps = {\n\tchildren: ReactNode;\n\tconfig: AnalyticsConfig;\n};\n\n/**\n * Provider component that initializes PostHog and provides analytics context\n *\n * @example\n * ```tsx\n * import { AnalyticsProvider } from '@codaco/analytics';\n *\n * function App({ children }) {\n *   return (\n *     <AnalyticsProvider\n *       config={{\n *         installationId: 'your-installation-id',\n *         apiKey: 'phc_your_api_key', // optional if set via env\n *         apiHost: 'https://ph-relay.networkcanvas.com', // optional\n *       }}\n *     >\n *       {children}\n *     </AnalyticsProvider>\n *   );\n * }\n * ```\n */\nexport function AnalyticsProvider({ children, config }: AnalyticsProviderProps) {\n\tconst analyticsRef = useRef<Analytics | null>(null);\n\n\t// Initialize analytics only once\n\tuseEffect(() => {\n\t\tif (!analyticsRef.current) {\n\t\t\tconst mergedConfig = mergeConfig(config);\n\t\t\tanalyticsRef.current = createAnalytics(mergedConfig);\n\t\t}\n\t}, []); // Empty deps - only initialize once\n\n\t// Don't render children until analytics is initialized\n\tif (!analyticsRef.current) {\n\t\treturn null;\n\t}\n\n\treturn <AnalyticsContext.Provider value={analyticsRef.current}>{children}</AnalyticsContext.Provider>;\n}\n","import posthog from \"posthog-js\";\nimport type { Analytics, AnalyticsConfig, ErrorProperties, EventProperties, EventType } from \"./types\";\nimport { ensureError } from \"./utils\";\n\n/**\n * Create a client-side analytics instance\n * This wraps PostHog with Network Canvas-specific functionality\n */\nexport function createAnalytics(config: Required<AnalyticsConfig>): Analytics {\n\tconst { apiHost, apiKey, installationId, disabled, debug, posthogOptions } = config;\n\n\t// If analytics is disabled, return a no-op implementation\n\tif (disabled) {\n\t\treturn createNoOpAnalytics(installationId);\n\t}\n\n\t// Initialize PostHog\n\tposthog.init(apiKey, {\n\t\tapi_host: apiHost,\n\t\tloaded: (posthogInstance) => {\n\t\t\t// Set installation ID as a super property (included with every event)\n\t\t\tposthogInstance.register({\n\t\t\t\tinstallation_id: installationId,\n\t\t\t});\n\n\t\t\tif (debug) {\n\t\t\t\tposthogInstance.debug();\n\t\t\t}\n\t\t},\n\t\t...posthogOptions,\n\t});\n\n\treturn {\n\t\ttrackEvent: (eventType: EventType | string, properties?: EventProperties) => {\n\t\t\tif (disabled) return;\n\n\t\t\ttry {\n\t\t\t\tposthog.capture(eventType, {\n\t\t\t\t\t...properties,\n\t\t\t\t\t// Flatten metadata into properties for better PostHog integration\n\t\t\t\t\t...(properties?.metadata ?? {}),\n\t\t\t\t});\n\t\t\t} catch (_e) {\n\t\t\t\tif (debug) {\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\n\t\ttrackError: (error: Error, additionalProperties?: EventProperties) => {\n\t\t\tif (disabled) return;\n\n\t\t\ttry {\n\t\t\t\tconst errorObj = ensureError(error);\n\t\t\t\tconst errorProperties: ErrorProperties = {\n\t\t\t\t\tmessage: errorObj.message,\n\t\t\t\t\tname: errorObj.name,\n\t\t\t\t\tstack: errorObj.stack,\n\t\t\t\t\tcause: errorObj.cause ? String(errorObj.cause) : undefined,\n\t\t\t\t\t...additionalProperties,\n\t\t\t\t};\n\n\t\t\t\tposthog.capture(\"error\", {\n\t\t\t\t\t...errorProperties,\n\t\t\t\t\t// Flatten metadata\n\t\t\t\t\t...(additionalProperties?.metadata ?? {}),\n\t\t\t\t});\n\t\t\t} catch (_e) {\n\t\t\t\tif (debug) {\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\n\t\tisFeatureEnabled: (flagKey: string) => {\n\t\t\tif (disabled) return false;\n\n\t\t\ttry {\n\t\t\t\treturn posthog.isFeatureEnabled(flagKey);\n\t\t\t} catch (_e) {\n\t\t\t\tif (debug) {\n\t\t\t\t}\n\t\t\t\treturn undefined;\n\t\t\t}\n\t\t},\n\n\t\tgetFeatureFlag: (flagKey: string) => {\n\t\t\tif (disabled) return undefined;\n\n\t\t\ttry {\n\t\t\t\treturn posthog.getFeatureFlag(flagKey);\n\t\t\t} catch (_e) {\n\t\t\t\tif (debug) {\n\t\t\t\t}\n\t\t\t\treturn undefined;\n\t\t\t}\n\t\t},\n\n\t\treloadFeatureFlags: () => {\n\t\t\tif (disabled) return;\n\n\t\t\ttry {\n\t\t\t\tposthog.reloadFeatureFlags();\n\t\t\t} catch (_e) {\n\t\t\t\tif (debug) {\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\n\t\tidentify: (distinctId: string, properties?: Record<string, unknown>) => {\n\t\t\tif (disabled) return;\n\n\t\t\ttry {\n\t\t\t\tposthog.identify(distinctId, properties);\n\t\t\t} catch (_e) {\n\t\t\t\tif (debug) {\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\n\t\treset: () => {\n\t\t\tif (disabled) return;\n\n\t\t\ttry {\n\t\t\t\tposthog.reset();\n\t\t\t} catch (_e) {\n\t\t\t\tif (debug) {\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\n\t\tisEnabled: () => !disabled,\n\n\t\tgetInstallationId: () => installationId,\n\t};\n}\n\n/**\n * Create a no-op analytics instance when analytics is disabled\n */\nfunction createNoOpAnalytics(installationId: string): Analytics {\n\treturn {\n\t\ttrackEvent: () => {},\n\t\ttrackError: () => {},\n\t\tisFeatureEnabled: () => false,\n\t\tgetFeatureFlag: () => undefined,\n\t\treloadFeatureFlags: () => {},\n\t\tidentify: () => {},\n\t\treset: () => {},\n\t\tisEnabled: () => false,\n\t\tgetInstallationId: () => installationId,\n\t};\n}\n","import { z } from \"zod\";\n\n/**\n * Event types supported by the analytics system.\n * These are converted to snake_case for PostHog.\n */\nexport const eventTypes = [\n\t\"app_setup\",\n\t\"protocol_installed\",\n\t\"interview_started\",\n\t\"interview_completed\",\n\t\"data_exported\",\n\t\"error\",\n] as const;\n\nexport type EventType = (typeof eventTypes)[number];\n\n/**\n * Legacy event type mapping for backward compatibility\n */\nexport const legacyEventTypeMap: Record<string, EventType> = {\n\tAppSetup: \"app_setup\",\n\tProtocolInstalled: \"protocol_installed\",\n\tInterviewStarted: \"interview_started\",\n\tInterviewCompleted: \"interview_completed\",\n\tDataExported: \"data_exported\",\n\tError: \"error\",\n};\n\n/**\n * Standard event properties that can be sent with any event\n */\nexport const EventPropertiesSchema = z.object({\n\tmetadata: z.record(z.string(), z.unknown()).optional(),\n});\n\nexport type EventProperties = z.infer<typeof EventPropertiesSchema>;\n\n/**\n * Error-specific properties for error tracking\n */\nexport const ErrorPropertiesSchema = EventPropertiesSchema.extend({\n\tmessage: z.string(),\n\tname: z.string(),\n\tstack: z.string().optional(),\n\tcause: z.string().optional(),\n});\n\nexport type ErrorProperties = z.infer<typeof ErrorPropertiesSchema>;\n\n/**\n * Analytics configuration options\n *\n * This package is designed to work exclusively with the Cloudflare Worker\n * reverse proxy at ph-relay.networkcanvas.com. All authentication is handled\n * by the worker, so the API key is optional.\n */\nexport type AnalyticsConfig = {\n\t/**\n\t * PostHog API host - should point to the Cloudflare Worker reverse proxy\n\t * Defaults to \"https://ph-relay.networkcanvas.com\"\n\t */\n\tapiHost?: string;\n\n\t/**\n\t * PostHog project API key (optional)\n\t *\n\t * When using the reverse proxy (default), authentication is handled by the\n\t * Cloudflare Worker. A placeholder key will be used for client-side PostHog\n\t * initialization if not provided.\n\t *\n\t * Only set this if you need to override the default behavior.\n\t */\n\tapiKey?: string;\n\n\t/**\n\t * Unique identifier for this installation/deployment\n\t * This is included with every event as a super property\n\t */\n\tinstallationId: string;\n\n\t/**\n\t * Disable all analytics tracking\n\t * Can be set via DISABLE_ANALYTICS or NEXT_PUBLIC_DISABLE_ANALYTICS env var\n\t */\n\tdisabled?: boolean;\n\n\t/**\n\t * Enable debug mode for PostHog\n\t */\n\tdebug?: boolean;\n\n\t/**\n\t * Additional options to pass to PostHog initialization\n\t */\n\tposthogOptions?: {\n\t\t/**\n\t\t * Disable session recording\n\t\t */\n\t\tdisable_session_recording?: boolean;\n\n\t\t/**\n\t\t * Autocapture settings\n\t\t */\n\t\tautocapture?: boolean;\n\n\t\t/**\n\t\t * Capture pageviews automatically\n\t\t */\n\t\tcapture_pageview?: boolean;\n\n\t\t/**\n\t\t * Capture pageleave events\n\t\t */\n\t\tcapture_pageleave?: boolean;\n\n\t\t/**\n\t\t * Cross-subdomain cookie\n\t\t */\n\t\tcross_subdomain_cookie?: boolean;\n\n\t\t/**\n\t\t * Advanced feature flags support\n\t\t */\n\t\tadvanced_disable_feature_flags?: boolean;\n\n\t\t/**\n\t\t * Other PostHog options\n\t\t */\n\t\t[key: string]: unknown;\n\t};\n};\n\n/**\n * Analytics instance interface\n */\nexport type Analytics = {\n\t/**\n\t * Track a custom event\n\t */\n\ttrackEvent: (eventType: EventType | string, properties?: EventProperties) => void;\n\n\t/**\n\t * Track an error with full stack trace\n\t */\n\ttrackError: (error: Error, additionalProperties?: EventProperties) => void;\n\n\t/**\n\t * Check if a feature flag is enabled\n\t */\n\tisFeatureEnabled: (flagKey: string) => boolean | undefined;\n\n\t/**\n\t * Get the value of a feature flag\n\t */\n\tgetFeatureFlag: (flagKey: string) => string | boolean | undefined;\n\n\t/**\n\t * Reload feature flags from PostHog\n\t */\n\treloadFeatureFlags: () => void;\n\n\t/**\n\t * Identify a user (optional - for advanced use cases)\n\t * Note: By default we only track installations, not users\n\t */\n\tidentify: (distinctId: string, properties?: Record<string, unknown>) => void;\n\n\t/**\n\t * Reset the user identity\n\t */\n\treset: () => void;\n\n\t/**\n\t * Check if analytics is enabled\n\t */\n\tisEnabled: () => boolean;\n\n\t/**\n\t * Get the installation ID\n\t */\n\tgetInstallationId: () => string;\n};\n"],"mappings":"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","names":[]}