@power-seo/tracking 1.0.0

package/dist/react.js

@@ -0,0 +1,129 @@
+import { createElement, useState, useEffect, useCallback } from 'react';
+
+// src/react.ts
+function AnalyticsScript({ scripts, consent }) {
+  const loadable = scripts.filter((s) => s.shouldLoad(consent));
+  if (loadable.length === 0) return null;
+  return createElement(
+    "div",
+    { "data-testid": "analytics-scripts" },
+    ...loadable.map(
+      (script) => script.src ? createElement("script", {
+        key: script.id,
+        src: script.src,
+        async: script.async ?? false,
+        defer: script.defer ?? false,
+        ...Object.fromEntries(
+          Object.entries(script.attributes ?? {}).map(([k, v]) => [k, v])
+        )
+      }) : createElement("script", {
+        key: script.id,
+        dangerouslySetInnerHTML: { __html: script.innerHTML ?? "" }
+      })
+    )
+  );
+}
+function ConsentBanner({ manager, privacyPolicyUrl }) {
+  const [state, setState] = useState(manager.getState());
+  const [visible, setVisible] = useState(!state.analytics);
+  useEffect(() => {
+    return manager.onChange((newState) => {
+      setState(newState);
+    });
+  }, [manager]);
+  const handleAcceptAll = useCallback(() => {
+    manager.grantAll();
+    setVisible(false);
+  }, [manager]);
+  const handleRejectAll = useCallback(() => {
+    manager.revokeAll();
+    setVisible(false);
+  }, [manager]);
+  if (!visible) return null;
+  return createElement(
+    "div",
+    {
+      "data-testid": "consent-banner",
+      role: "dialog",
+      "aria-label": "Cookie consent",
+      style: {
+        position: "fixed",
+        bottom: 0,
+        left: 0,
+        right: 0,
+        padding: "16px 24px",
+        backgroundColor: "#fff",
+        borderTop: "1px solid #e0e0e0",
+        boxShadow: "0 -2px 10px rgba(0,0,0,0.1)",
+        display: "flex",
+        justifyContent: "space-between",
+        alignItems: "center",
+        gap: "16px",
+        fontFamily: "system-ui, -apple-system, sans-serif",
+        fontSize: "14px",
+        zIndex: 9999
+      }
+    },
+    createElement(
+      "div",
+      { style: { flex: 1 } },
+      createElement(
+        "p",
+        { style: { margin: 0, color: "#333" } },
+        "We use cookies to improve your experience and analyze site traffic.",
+        privacyPolicyUrl ? createElement(
+          "a",
+          {
+            href: privacyPolicyUrl,
+            style: { marginLeft: "4px", color: "#1a73e8", textDecoration: "underline" },
+            target: "_blank",
+            rel: "noopener noreferrer"
+          },
+          "Privacy Policy"
+        ) : null
+      )
+    ),
+    createElement(
+      "div",
+      { style: { display: "flex", gap: "8px", flexShrink: 0 } },
+      createElement(
+        "button",
+        {
+          "data-testid": "consent-reject",
+          onClick: handleRejectAll,
+          style: {
+            padding: "8px 16px",
+            border: "1px solid #dadce0",
+            borderRadius: "4px",
+            backgroundColor: "#fff",
+            cursor: "pointer",
+            fontSize: "13px",
+            color: "#333"
+          }
+        },
+        "Reject All"
+      ),
+      createElement(
+        "button",
+        {
+          "data-testid": "consent-accept",
+          onClick: handleAcceptAll,
+          style: {
+            padding: "8px 16px",
+            border: "none",
+            borderRadius: "4px",
+            backgroundColor: "#1a73e8",
+            color: "#fff",
+            cursor: "pointer",
+            fontSize: "13px"
+          }
+        },
+        "Accept All"
+      )
+    )
+  );
+}
+
+export { AnalyticsScript, ConsentBanner };
+//# sourceMappingURL=react.js.map
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react.ts"],"names":[],"mappings":"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","file":"react.js","sourcesContent":["// ============================================================================\r\n// @power-seo/tracking — React Components\r\n// ============================================================================\r\n\r\nimport { createElement, useEffect, useState, useCallback } from 'react';\r\nimport type { ScriptConfig, ConsentManager, ConsentState } from './types.js';\r\n\r\n// --- AnalyticsScript ---\r\n\r\nexport interface AnalyticsScriptProps {\r\n  scripts: ScriptConfig[];\r\n  consent: ConsentState;\r\n}\r\n\r\nexport function AnalyticsScript({ scripts, consent }: AnalyticsScriptProps) {\r\n  const loadable = scripts.filter((s) => s.shouldLoad(consent));\r\n\r\n  if (loadable.length === 0) return null;\r\n\r\n  return createElement(\r\n    'div',\r\n    { 'data-testid': 'analytics-scripts' },\r\n    ...loadable.map((script) =>\r\n      script.src\r\n        ? createElement('script', {\r\n            key: script.id,\r\n            src: script.src,\r\n            async: script.async ?? false,\r\n            defer: script.defer ?? false,\r\n            ...Object.fromEntries(\r\n              Object.entries(script.attributes ?? {}).map(([k, v]) => [k, v]),\r\n            ),\r\n          })\r\n        : createElement('script', {\r\n            key: script.id,\r\n            dangerouslySetInnerHTML: { __html: script.innerHTML ?? '' },\r\n          }),\r\n    ),\r\n  );\r\n}\r\n\r\n// --- ConsentBanner ---\r\n\r\nexport interface ConsentBannerProps {\r\n  manager: ConsentManager;\r\n  privacyPolicyUrl?: string;\r\n}\r\n\r\nexport function ConsentBanner({ manager, privacyPolicyUrl }: ConsentBannerProps) {\r\n  const [state, setState] = useState<ConsentState>(manager.getState());\r\n  const [visible, setVisible] = useState(!state.analytics);\r\n\r\n  useEffect(() => {\r\n    return manager.onChange((newState) => {\r\n      setState(newState);\r\n    });\r\n  }, [manager]);\r\n\r\n  const handleAcceptAll = useCallback(() => {\r\n    manager.grantAll();\r\n    setVisible(false);\r\n  }, [manager]);\r\n\r\n  const handleRejectAll = useCallback(() => {\r\n    manager.revokeAll();\r\n    setVisible(false);\r\n  }, [manager]);\r\n\r\n  if (!visible) return null;\r\n\r\n  return createElement(\r\n    'div',\r\n    {\r\n      'data-testid': 'consent-banner',\r\n      role: 'dialog',\r\n      'aria-label': 'Cookie consent',\r\n      style: {\r\n        position: 'fixed',\r\n        bottom: 0,\r\n        left: 0,\r\n        right: 0,\r\n        padding: '16px 24px',\r\n        backgroundColor: '#fff',\r\n        borderTop: '1px solid #e0e0e0',\r\n        boxShadow: '0 -2px 10px rgba(0,0,0,0.1)',\r\n        display: 'flex',\r\n        justifyContent: 'space-between',\r\n        alignItems: 'center',\r\n        gap: '16px',\r\n        fontFamily: 'system-ui, -apple-system, sans-serif',\r\n        fontSize: '14px',\r\n        zIndex: 9999,\r\n      },\r\n    },\r\n    createElement(\r\n      'div',\r\n      { style: { flex: 1 } },\r\n      createElement(\r\n        'p',\r\n        { style: { margin: 0, color: '#333' } },\r\n        'We use cookies to improve your experience and analyze site traffic.',\r\n        privacyPolicyUrl\r\n          ? createElement(\r\n              'a',\r\n              {\r\n                href: privacyPolicyUrl,\r\n                style: { marginLeft: '4px', color: '#1a73e8', textDecoration: 'underline' },\r\n                target: '_blank',\r\n                rel: 'noopener noreferrer',\r\n              },\r\n              'Privacy Policy',\r\n            )\r\n          : null,\r\n      ),\r\n    ),\r\n    createElement(\r\n      'div',\r\n      { style: { display: 'flex', gap: '8px', flexShrink: 0 } },\r\n      createElement(\r\n        'button',\r\n        {\r\n          'data-testid': 'consent-reject',\r\n          onClick: handleRejectAll,\r\n          style: {\r\n            padding: '8px 16px',\r\n            border: '1px solid #dadce0',\r\n            borderRadius: '4px',\r\n            backgroundColor: '#fff',\r\n            cursor: 'pointer',\r\n            fontSize: '13px',\r\n            color: '#333',\r\n          },\r\n        },\r\n        'Reject All',\r\n      ),\r\n      createElement(\r\n        'button',\r\n        {\r\n          'data-testid': 'consent-accept',\r\n          onClick: handleAcceptAll,\r\n          style: {\r\n            padding: '8px 16px',\r\n            border: 'none',\r\n            borderRadius: '4px',\r\n            backgroundColor: '#1a73e8',\r\n            color: '#fff',\r\n            cursor: 'pointer',\r\n            fontSize: '13px',\r\n          },\r\n        },\r\n        'Accept All',\r\n      ),\r\n    ),\r\n  );\r\n}\r\n"]}

package/dist/types-DFyKCGgf.d.cts

@@ -0,0 +1,180 @@
+type ConsentCategory = 'necessary' | 'analytics' | 'marketing' | 'preferences';
+interface ScriptConfig {
+    id: string;
+    src?: string;
+    innerHTML?: string;
+    async?: boolean;
+    defer?: boolean;
+    consentCategory: ConsentCategory;
+    attributes?: Record<string, string>;
+    shouldLoad: (consent: ConsentState) => boolean;
+}
+interface ConsentState {
+    necessary: boolean;
+    analytics: boolean;
+    marketing: boolean;
+    preferences: boolean;
+}
+interface ConsentManager {
+    getState: () => ConsentState;
+    grant: (category: ConsentCategory) => void;
+    revoke: (category: ConsentCategory) => void;
+    grantAll: () => void;
+    revokeAll: () => void;
+    isGranted: (category: ConsentCategory) => boolean;
+    onChange: (callback: ConsentChangeCallback) => () => void;
+}
+type ConsentChangeCallback = (state: ConsentState) => void;
+interface GA4Config {
+    measurementId: string;
+    consentModeV2?: boolean;
+    anonymizeIp?: boolean;
+    sendPageView?: boolean;
+}
+interface GA4ReportRequest {
+    startDate: string;
+    endDate: string;
+    metrics: string[];
+    dimensions?: string[];
+    limit?: number;
+}
+interface GA4ReportRow {
+    dimensions: string[];
+    metrics: number[];
+}
+interface GA4ReportResponse {
+    rows: GA4ReportRow[];
+    rowCount: number;
+    metadata?: {
+        metricHeaders: Array<{
+            name: string;
+            type: string;
+        }>;
+    };
+}
+interface GA4Client {
+    queryReport: (propertyId: string, request: GA4ReportRequest) => Promise<GA4ReportResponse>;
+    getRealtimeReport: (propertyId: string, metrics: string[]) => Promise<GA4ReportResponse>;
+    getMetadata: (propertyId: string) => Promise<GA4Metadata>;
+}
+interface GA4Metadata {
+    dimensions: Array<{
+        apiName: string;
+        uiName: string;
+        description: string;
+    }>;
+    metrics: Array<{
+        apiName: string;
+        uiName: string;
+        description: string;
+        type: string;
+    }>;
+}
+interface ClarityConfig {
+    projectId: string;
+}
+interface ClarityProject {
+    id: string;
+    name: string;
+    url: string;
+}
+interface ClarityInsight {
+    type: string;
+    value: number;
+    label: string;
+    trend: 'up' | 'down' | 'stable';
+}
+interface ClarityHeatmapData {
+    url: string;
+    clicks: Array<{
+        x: number;
+        y: number;
+        count: number;
+    }>;
+    scrollDepth: number[];
+}
+interface ClarityClient {
+    getProjects: () => Promise<ClarityProject[]>;
+    getInsights: (projectId: string) => Promise<ClarityInsight[]>;
+    getHeatmapData: (projectId: string, url: string) => Promise<ClarityHeatmapData>;
+}
+interface PostHogConfig {
+    apiKey: string;
+    host?: string;
+}
+interface PostHogEvent {
+    event: string;
+    timestamp: string;
+    properties: Record<string, unknown>;
+}
+interface PostHogTrendResult {
+    label: string;
+    data: number[];
+    days: string[];
+}
+interface PostHogFunnelStep {
+    name: string;
+    count: number;
+    conversionRate: number;
+}
+interface PostHogClient {
+    queryEvents: (projectId: string, event: string, limit?: number) => Promise<PostHogEvent[]>;
+    getTrends: (projectId: string, events: string[], days?: number) => Promise<PostHogTrendResult[]>;
+    getFunnels: (projectId: string, steps: string[]) => Promise<PostHogFunnelStep[]>;
+}
+interface PlausibleConfig {
+    domain: string;
+    selfHostedUrl?: string;
+}
+interface PlausibleTimeseriesPoint {
+    date: string;
+    visitors: number;
+    pageviews: number;
+    bounceRate: number;
+    visitDuration: number;
+}
+interface PlausibleBreakdownEntry {
+    property: string;
+    visitors: number;
+    pageviews: number;
+    bounceRate: number;
+}
+interface PlausibleAggregateResult {
+    visitors: number;
+    pageviews: number;
+    bounceRate: number;
+    visitDuration: number;
+    events: number;
+}
+interface PlausibleClient {
+    getTimeseries: (siteId: string, period?: string) => Promise<PlausibleTimeseriesPoint[]>;
+    getBreakdown: (siteId: string, property: string, period?: string) => Promise<PlausibleBreakdownEntry[]>;
+    getAggregate: (siteId: string, period?: string) => Promise<PlausibleAggregateResult>;
+}
+interface FathomConfig {
+    siteId: string;
+}
+interface FathomSite {
+    id: string;
+    name: string;
+    sharing: string;
+}
+interface FathomPageview {
+    pathname: string;
+    pageviews: number;
+    visitors: number;
+    avgDuration: number;
+    bounceRate: number;
+}
+interface FathomReferrer {
+    source: string;
+    visitors: number;
+    pageviews: number;
+}
+interface FathomClient {
+    getSites: () => Promise<FathomSite[]>;
+    getPageviews: (siteId: string, period?: string) => Promise<FathomPageview[]>;
+    getReferrers: (siteId: string, period?: string) => Promise<FathomReferrer[]>;
+}
+
+export type { ConsentState as C, FathomConfig as F, GA4Config as G, PostHogConfig as P, ScriptConfig as S, ConsentManager as a, ClarityConfig as b, PlausibleConfig as c, GA4Client as d, ClarityClient as e, PostHogClient as f, PlausibleClient as g, FathomClient as h, ClarityHeatmapData as i, ClarityInsight as j, ClarityProject as k, ConsentCategory as l, ConsentChangeCallback as m, FathomPageview as n, FathomReferrer as o, FathomSite as p, GA4Metadata as q, GA4ReportRequest as r, GA4ReportResponse as s, GA4ReportRow as t, PlausibleAggregateResult as u, PlausibleBreakdownEntry as v, PlausibleTimeseriesPoint as w, PostHogEvent as x, PostHogFunnelStep as y, PostHogTrendResult as z };

package/dist/types-DFyKCGgf.d.ts

@@ -0,0 +1,180 @@
+type ConsentCategory = 'necessary' | 'analytics' | 'marketing' | 'preferences';
+interface ScriptConfig {
+    id: string;
+    src?: string;
+    innerHTML?: string;
+    async?: boolean;
+    defer?: boolean;
+    consentCategory: ConsentCategory;
+    attributes?: Record<string, string>;
+    shouldLoad: (consent: ConsentState) => boolean;
+}
+interface ConsentState {
+    necessary: boolean;
+    analytics: boolean;
+    marketing: boolean;
+    preferences: boolean;
+}
+interface ConsentManager {
+    getState: () => ConsentState;
+    grant: (category: ConsentCategory) => void;
+    revoke: (category: ConsentCategory) => void;
+    grantAll: () => void;
+    revokeAll: () => void;
+    isGranted: (category: ConsentCategory) => boolean;
+    onChange: (callback: ConsentChangeCallback) => () => void;
+}
+type ConsentChangeCallback = (state: ConsentState) => void;
+interface GA4Config {
+    measurementId: string;
+    consentModeV2?: boolean;
+    anonymizeIp?: boolean;
+    sendPageView?: boolean;
+}
+interface GA4ReportRequest {
+    startDate: string;
+    endDate: string;
+    metrics: string[];
+    dimensions?: string[];
+    limit?: number;
+}
+interface GA4ReportRow {
+    dimensions: string[];
+    metrics: number[];
+}
+interface GA4ReportResponse {
+    rows: GA4ReportRow[];
+    rowCount: number;
+    metadata?: {
+        metricHeaders: Array<{
+            name: string;
+            type: string;
+        }>;
+    };
+}
+interface GA4Client {
+    queryReport: (propertyId: string, request: GA4ReportRequest) => Promise<GA4ReportResponse>;
+    getRealtimeReport: (propertyId: string, metrics: string[]) => Promise<GA4ReportResponse>;
+    getMetadata: (propertyId: string) => Promise<GA4Metadata>;
+}
+interface GA4Metadata {
+    dimensions: Array<{
+        apiName: string;
+        uiName: string;
+        description: string;
+    }>;
+    metrics: Array<{
+        apiName: string;
+        uiName: string;
+        description: string;
+        type: string;
+    }>;
+}
+interface ClarityConfig {
+    projectId: string;
+}
+interface ClarityProject {
+    id: string;
+    name: string;
+    url: string;
+}
+interface ClarityInsight {
+    type: string;
+    value: number;
+    label: string;
+    trend: 'up' | 'down' | 'stable';
+}
+interface ClarityHeatmapData {
+    url: string;
+    clicks: Array<{
+        x: number;
+        y: number;
+        count: number;
+    }>;
+    scrollDepth: number[];
+}
+interface ClarityClient {
+    getProjects: () => Promise<ClarityProject[]>;
+    getInsights: (projectId: string) => Promise<ClarityInsight[]>;
+    getHeatmapData: (projectId: string, url: string) => Promise<ClarityHeatmapData>;
+}
+interface PostHogConfig {
+    apiKey: string;
+    host?: string;
+}
+interface PostHogEvent {
+    event: string;
+    timestamp: string;
+    properties: Record<string, unknown>;
+}
+interface PostHogTrendResult {
+    label: string;
+    data: number[];
+    days: string[];
+}
+interface PostHogFunnelStep {
+    name: string;
+    count: number;
+    conversionRate: number;
+}
+interface PostHogClient {
+    queryEvents: (projectId: string, event: string, limit?: number) => Promise<PostHogEvent[]>;
+    getTrends: (projectId: string, events: string[], days?: number) => Promise<PostHogTrendResult[]>;
+    getFunnels: (projectId: string, steps: string[]) => Promise<PostHogFunnelStep[]>;
+}
+interface PlausibleConfig {
+    domain: string;
+    selfHostedUrl?: string;
+}
+interface PlausibleTimeseriesPoint {
+    date: string;
+    visitors: number;
+    pageviews: number;
+    bounceRate: number;
+    visitDuration: number;
+}
+interface PlausibleBreakdownEntry {
+    property: string;
+    visitors: number;
+    pageviews: number;
+    bounceRate: number;
+}
+interface PlausibleAggregateResult {
+    visitors: number;
+    pageviews: number;
+    bounceRate: number;
+    visitDuration: number;
+    events: number;
+}
+interface PlausibleClient {
+    getTimeseries: (siteId: string, period?: string) => Promise<PlausibleTimeseriesPoint[]>;
+    getBreakdown: (siteId: string, property: string, period?: string) => Promise<PlausibleBreakdownEntry[]>;
+    getAggregate: (siteId: string, period?: string) => Promise<PlausibleAggregateResult>;
+}
+interface FathomConfig {
+    siteId: string;
+}
+interface FathomSite {
+    id: string;
+    name: string;
+    sharing: string;
+}
+interface FathomPageview {
+    pathname: string;
+    pageviews: number;
+    visitors: number;
+    avgDuration: number;
+    bounceRate: number;
+}
+interface FathomReferrer {
+    source: string;
+    visitors: number;
+    pageviews: number;
+}
+interface FathomClient {
+    getSites: () => Promise<FathomSite[]>;
+    getPageviews: (siteId: string, period?: string) => Promise<FathomPageview[]>;
+    getReferrers: (siteId: string, period?: string) => Promise<FathomReferrer[]>;
+}
+
+export type { ConsentState as C, FathomConfig as F, GA4Config as G, PostHogConfig as P, ScriptConfig as S, ConsentManager as a, ClarityConfig as b, PlausibleConfig as c, GA4Client as d, ClarityClient as e, PostHogClient as f, PlausibleClient as g, FathomClient as h, ClarityHeatmapData as i, ClarityInsight as j, ClarityProject as k, ConsentCategory as l, ConsentChangeCallback as m, FathomPageview as n, FathomReferrer as o, FathomSite as p, GA4Metadata as q, GA4ReportRequest as r, GA4ReportResponse as s, GA4ReportRow as t, PlausibleAggregateResult as u, PlausibleBreakdownEntry as v, PlausibleTimeseriesPoint as w, PostHogEvent as x, PostHogFunnelStep as y, PostHogTrendResult as z };

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@power-seo/tracking",
+  "version": "1.0.0",
+  "description": "Analytics platform integration with script builders, consent management, and React components",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    },
+    "./react": {
+      "import": "./dist/react.js",
+      "require": "./dist/react.cjs",
+      "types": "./dist/react.d.ts"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "clean": "rimraf dist"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.0.0",
+    "@types/react": "^19.0.0",
+    "jsdom": "^25.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "rimraf": "^6.0.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  },
+  "keywords": [
+    "seo",
+    "analytics",
+    "ga4",
+    "clarity",
+    "posthog",
+    "plausible",
+    "fathom",
+    "tracking",
+    "consent",
+    "react",
+    "typescript"
+  ],
+  "sideEffects": false,
+  "author": "CyberCraft Bangladesh <info@ccbd.dev>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cybercraftbd/power-seo.git",
+    "directory": "packages/tracking"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}