@dumbledor/sdk 0.1.0

package/dist/react/index.cjs

@@ -0,0 +1,247 @@
+"use client";
+'use strict';
+
+var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+
+// src/constants.ts
+var DEFAULT_INGEST_URL = "https://ingest.dumbledor.com";
+var UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+
+// src/config.ts
+var DumbledorConfigError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "DumbledorConfigError";
+  }
+};
+function normalizeIngestUrl(value) {
+  const raw = value?.trim() || DEFAULT_INGEST_URL;
+  return raw.replace(/\/$/, "");
+}
+function assertClientConfig(config) {
+  const websiteId = config.websiteId?.trim();
+  if (!websiteId) {
+    throw new DumbledorConfigError("websiteId is required.");
+  }
+  if (!UUID_PATTERN.test(websiteId)) {
+    throw new DumbledorConfigError("websiteId must be a valid UUID.");
+  }
+  return {
+    websiteId,
+    ingestUrl: normalizeIngestUrl(config.ingestUrl),
+    honorDoNotTrack: config.honorDoNotTrack ?? false,
+    disabled: config.disabled ?? false,
+    fetch: config.fetch
+  };
+}
+function withWebsiteId(payload, websiteId) {
+  return {
+    ...payload,
+    websiteId
+  };
+}
+function resolveFetch(fetchImpl) {
+  const resolved = fetchImpl ?? globalThis.fetch;
+  if (!resolved) {
+    throw new DumbledorConfigError("fetch is not available in this runtime.");
+  }
+  return resolved;
+}
+
+// src/dnt.ts
+function hasDoNotTrack() {
+  if (typeof window === "undefined") {
+    return false;
+  }
+  const win = window;
+  const dnt = win.doNotTrack ?? win.navigator.doNotTrack ?? win.navigator.msDoNotTrack;
+  return dnt === 1 || dnt === "1" || dnt === "yes";
+}
+function isTrackingDisabled(honorDoNotTrack) {
+  return honorDoNotTrack && hasDoNotTrack();
+}
+
+// src/client.ts
+function defaultPageviewInput() {
+  if (typeof window === "undefined" || typeof document === "undefined") {
+    return {};
+  }
+  return {
+    url: window.location.href,
+    referrer: document.referrer || void 0,
+    title: document.title,
+    hostname: window.location.hostname,
+    language: navigator.language,
+    screen: typeof screen !== "undefined" ? `${screen.width}x${screen.height}` : void 0
+  };
+}
+function createTransport(config) {
+  const endpoint = `${config.ingestUrl}/v1/collect`;
+  const fetchImpl = resolveFetch(config.fetch);
+  return async function send(payload) {
+    if (config.disabled || isTrackingDisabled(config.honorDoNotTrack)) {
+      return;
+    }
+    const body = withWebsiteId(payload, config.websiteId);
+    try {
+      const response = await fetchImpl(endpoint, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body),
+        keepalive: true,
+        credentials: "omit",
+        mode: "cors"
+      });
+      if (!response.ok) {
+        return {
+          ok: false,
+          error: `Ingest request failed with status ${response.status}`
+        };
+      }
+      return await response.json();
+    } catch {
+      return {
+        ok: false,
+        error: "Ingest request failed"
+      };
+    }
+  };
+}
+function createClient(config) {
+  const resolved = assertClientConfig(config);
+  const send = createTransport(resolved);
+  return {
+    config: resolved,
+    page(input = {}) {
+      const defaults = defaultPageviewInput();
+      const url = input.url ?? defaults.url;
+      if (!url) {
+        return;
+      }
+      void send({
+        type: "pageview",
+        url,
+        referrer: input.referrer ?? defaults.referrer,
+        title: input.title ?? defaults.title,
+        hostname: input.hostname ?? defaults.hostname,
+        language: input.language ?? defaults.language,
+        screen: input.screen ?? defaults.screen
+      });
+    },
+    track(name, properties) {
+      const defaults = defaultPageviewInput();
+      void send({
+        type: "track",
+        name,
+        properties: properties ?? {},
+        url: defaults.url,
+        hostname: defaults.hostname
+      });
+    },
+    identify(userId, traits) {
+      void send({
+        type: "identify",
+        userId,
+        traits: traits ?? {}
+      });
+    }
+  };
+}
+var defaultClient = null;
+function init(config) {
+  defaultClient = createClient(config);
+  return defaultClient;
+}
+function getClient() {
+  if (!defaultClient) {
+    throw new Error(
+      "Dumbledor is not initialized. Call init(), wrap with DumbledorProvider, or createClient() first."
+    );
+  }
+  return defaultClient;
+}
+
+// src/react/context.tsx
+var DumbledorContext = react.createContext(null);
+function useDumbledor() {
+  const client = react.useContext(DumbledorContext);
+  if (client) {
+    return client;
+  }
+  return getClient();
+}
+function PageView({ pathname, trackInitialView = true }) {
+  const client = useDumbledor();
+  const lastPathRef = react.useRef(null);
+  react.useEffect(() => {
+    const nextPath = pathname ?? (typeof window !== "undefined" ? `${window.location.pathname}${window.location.search}` : null);
+    if (!nextPath || lastPathRef.current === nextPath) {
+      return;
+    }
+    const isFirstView = lastPathRef.current === null;
+    lastPathRef.current = nextPath;
+    if (isFirstView && !trackInitialView) {
+      return;
+    }
+    client.page();
+  }, [client, pathname, trackInitialView]);
+  return null;
+}
+function useTrack() {
+  const client = useDumbledor();
+  return react.useCallback(
+    (name, properties) => {
+      client.track(name, properties);
+    },
+    [client]
+  );
+}
+function useIdentify() {
+  const client = useDumbledor();
+  return react.useCallback(
+    (userId, traits) => {
+      client.identify(userId, traits);
+    },
+    [client]
+  );
+}
+function usePage() {
+  const client = useDumbledor();
+  return react.useCallback(
+    (input) => {
+      client.page(input);
+    },
+    [client]
+  );
+}
+function DumbledorProvider({
+  children,
+  websiteId,
+  ingestUrl,
+  honorDoNotTrack,
+  disabled,
+  fetch
+}) {
+  const client = react.useMemo(
+    () => init({
+      websiteId,
+      ingestUrl,
+      honorDoNotTrack,
+      disabled,
+      fetch
+    }),
+    [websiteId, ingestUrl, honorDoNotTrack, disabled, fetch]
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(DumbledorContext.Provider, { value: client, children });
+}
+
+exports.DumbledorContext = DumbledorContext;
+exports.DumbledorProvider = DumbledorProvider;
+exports.PageView = PageView;
+exports.useDumbledor = useDumbledor;
+exports.useIdentify = useIdentify;
+exports.usePage = usePage;
+exports.useTrack = useTrack;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/react/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/constants.ts","../../src/config.ts","../../src/dnt.ts","../../src/client.ts","../../src/react/context.tsx","../../src/react/page-view.tsx","../../src/react/hooks.ts","../../src/react/provider.tsx"],"names":["createContext","useContext","useRef","useEffect","useCallback","useMemo"],"mappings":"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","file":"index.cjs","sourcesContent":["export const DEFAULT_INGEST_URL = \"https://ingest.dumbledor.com\";\n\nexport const UUID_PATTERN =\n  /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;\n","import { DEFAULT_INGEST_URL, UUID_PATTERN } from \"./constants\";\nimport type {\n  CollectPayload,\n  CollectPayloadInput,\n  DumbledorClientConfig,\n  ResolvedDumbledorConfig,\n} from \"./types\";\n\nexport class DumbledorConfigError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"DumbledorConfigError\";\n  }\n}\n\nexport function normalizeIngestUrl(value?: string): string {\n  const raw = value?.trim() || DEFAULT_INGEST_URL;\n  return raw.replace(/\\/$/, \"\");\n}\n\nexport function assertClientConfig(config: DumbledorClientConfig): ResolvedDumbledorConfig {\n  const websiteId = config.websiteId?.trim();\n\n  if (!websiteId) {\n    throw new DumbledorConfigError(\"websiteId is required.\");\n  }\n\n  if (!UUID_PATTERN.test(websiteId)) {\n    throw new DumbledorConfigError(\"websiteId must be a valid UUID.\");\n  }\n\n  return {\n    websiteId,\n    ingestUrl: normalizeIngestUrl(config.ingestUrl),\n    honorDoNotTrack: config.honorDoNotTrack ?? false,\n    disabled: config.disabled ?? false,\n    fetch: config.fetch,\n  };\n}\n\nexport function withWebsiteId(\n  payload: CollectPayloadInput,\n  websiteId: string,\n): CollectPayload {\n  return {\n    ...payload,\n    websiteId,\n  };\n}\n\nexport function resolveFetch(fetchImpl?: typeof fetch): typeof fetch {\n  const resolved = fetchImpl ?? globalThis.fetch;\n  if (!resolved) {\n    throw new DumbledorConfigError(\"fetch is not available in this runtime.\");\n  }\n\n  return resolved;\n}\n","type NavigatorWithMsDnt = Navigator & {\n  msDoNotTrack?: string | number | null;\n};\n\ntype WindowWithDnt = Window & {\n  doNotTrack?: string | number | null;\n};\n\nexport function hasDoNotTrack(): boolean {\n  if (typeof window === \"undefined\") {\n    return false;\n  }\n\n  const win = window as WindowWithDnt;\n  const dnt =\n    win.doNotTrack ??\n    win.navigator.doNotTrack ??\n    (win.navigator as NavigatorWithMsDnt).msDoNotTrack;\n\n  return dnt === 1 || dnt === \"1\" || dnt === \"yes\";\n}\n\nexport function isTrackingDisabled(honorDoNotTrack: boolean): boolean {\n  return honorDoNotTrack && hasDoNotTrack();\n}\n","import { assertClientConfig, resolveFetch, withWebsiteId } from \"./config\";\nimport { isTrackingDisabled } from \"./dnt\";\nimport type {\n  CollectPayloadInput,\n  CollectResponse,\n  DumbledorClient,\n  DumbledorClientConfig,\n  PageviewInput,\n  ResolvedDumbledorConfig,\n} from \"./types\";\n\nfunction defaultPageviewInput(): PageviewInput {\n  if (typeof window === \"undefined\" || typeof document === \"undefined\") {\n    return {};\n  }\n\n  return {\n    url: window.location.href,\n    referrer: document.referrer || undefined,\n    title: document.title,\n    hostname: window.location.hostname,\n    language: navigator.language,\n    screen: typeof screen !== \"undefined\" ? `${screen.width}x${screen.height}` : undefined,\n  };\n}\n\nexport function createTransport(config: ResolvedDumbledorConfig) {\n  const endpoint = `${config.ingestUrl}/v1/collect`;\n  const fetchImpl = resolveFetch(config.fetch);\n\n  return async function send(payload: CollectPayloadInput): Promise<CollectResponse | void> {\n    if (config.disabled || isTrackingDisabled(config.honorDoNotTrack)) {\n      return;\n    }\n\n    const body = withWebsiteId(payload, config.websiteId);\n\n    try {\n      const response = await fetchImpl(endpoint, {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify(body),\n        keepalive: true,\n        credentials: \"omit\",\n        mode: \"cors\",\n      });\n\n      if (!response.ok) {\n        return {\n          ok: false,\n          error: `Ingest request failed with status ${response.status}`,\n        };\n      }\n\n      return (await response.json()) as CollectResponse;\n    } catch {\n      return {\n        ok: false,\n        error: \"Ingest request failed\",\n      };\n    }\n  };\n}\n\nexport function createClient(config: DumbledorClientConfig): DumbledorClient {\n  const resolved = assertClientConfig(config);\n  const send = createTransport(resolved);\n\n  return {\n    config: resolved,\n    page(input = {}) {\n      const defaults = defaultPageviewInput();\n      const url = input.url ?? defaults.url;\n      if (!url) {\n        return;\n      }\n\n      void send({\n        type: \"pageview\",\n        url,\n        referrer: input.referrer ?? defaults.referrer,\n        title: input.title ?? defaults.title,\n        hostname: input.hostname ?? defaults.hostname,\n        language: input.language ?? defaults.language,\n        screen: input.screen ?? defaults.screen,\n      });\n    },\n    track(name, properties) {\n      const defaults = defaultPageviewInput();\n      void send({\n        type: \"track\",\n        name,\n        properties: properties ?? {},\n        url: defaults.url,\n        hostname: defaults.hostname,\n      });\n    },\n    identify(userId, traits) {\n      void send({\n        type: \"identify\",\n        userId,\n        traits: traits ?? {},\n      });\n    },\n  };\n}\n\nlet defaultClient: DumbledorClient | null = null;\n\nexport function init(config: DumbledorClientConfig): DumbledorClient {\n  defaultClient = createClient(config);\n  return defaultClient;\n}\n\nexport function getClient(): DumbledorClient {\n  if (!defaultClient) {\n    throw new Error(\n      \"Dumbledor is not initialized. Call init(), wrap with DumbledorProvider, or createClient() first.\",\n    );\n  }\n\n  return defaultClient;\n}\n\nexport function page(input?: PageviewInput): void {\n  getClient().page(input);\n}\n\nexport function track(name: string, properties?: Record<string, unknown>): void {\n  getClient().track(name, properties);\n}\n\nexport function identify(userId: string, traits?: Record<string, unknown>): void {\n  getClient().identify(userId, traits);\n}\n","\"use client\";\n\nimport { createContext, useContext } from \"react\";\nimport { getClient } from \"../client\";\nimport type { DumbledorClient } from \"../types\";\n\nexport const DumbledorContext = createContext<DumbledorClient | null>(null);\n\nexport function useDumbledor(): DumbledorClient {\n  const client = useContext(DumbledorContext);\n  if (client) {\n    return client;\n  }\n\n  return getClient();\n}\n","\"use client\";\n\nimport { useEffect, useRef } from \"react\";\nimport { useDumbledor } from \"./context\";\n\nexport type PageViewProps = {\n  /** Route pathname. When omitted, falls back to `window.location.pathname`. */\n  pathname?: string;\n  /** Track the first render. Default: `true`. */\n  trackInitialView?: boolean;\n};\n\nexport function PageView({ pathname, trackInitialView = true }: PageViewProps) {\n  const client = useDumbledor();\n  const lastPathRef = useRef<string | null>(null);\n\n  useEffect(() => {\n    const nextPath =\n      pathname ??\n      (typeof window !== \"undefined\"\n        ? `${window.location.pathname}${window.location.search}`\n        : null);\n\n    if (!nextPath || lastPathRef.current === nextPath) {\n      return;\n    }\n\n    const isFirstView = lastPathRef.current === null;\n    lastPathRef.current = nextPath;\n\n    if (isFirstView && !trackInitialView) {\n      return;\n    }\n\n    client.page();\n  }, [client, pathname, trackInitialView]);\n\n  return null;\n}\n","\"use client\";\n\nimport { useCallback } from \"react\";\nimport { useDumbledor } from \"./context\";\n\nexport function useTrack() {\n  const client = useDumbledor();\n  return useCallback(\n    (name: string, properties?: Record<string, unknown>) => {\n      client.track(name, properties);\n    },\n    [client],\n  );\n}\n\nexport function useIdentify() {\n  const client = useDumbledor();\n  return useCallback(\n    (userId: string, traits?: Record<string, unknown>) => {\n      client.identify(userId, traits);\n    },\n    [client],\n  );\n}\n\nexport function usePage() {\n  const client = useDumbledor();\n  return useCallback(\n    (input?: Parameters<typeof client.page>[0]) => {\n      client.page(input);\n    },\n    [client],\n  );\n}\n","\"use client\";\n\nimport { useMemo } from \"react\";\nimport { init } from \"../client\";\nimport type { DumbledorClientConfig } from \"../types\";\nimport { DumbledorContext } from \"./context\";\n\nexport type DumbledorProviderProps = DumbledorClientConfig & {\n  children: React.ReactNode;\n};\n\nexport function DumbledorProvider({\n  children,\n  websiteId,\n  ingestUrl,\n  honorDoNotTrack,\n  disabled,\n  fetch,\n}: DumbledorProviderProps) {\n  const client = useMemo(\n    () =>\n      init({\n        websiteId,\n        ingestUrl,\n        honorDoNotTrack,\n        disabled,\n        fetch,\n      }),\n    [websiteId, ingestUrl, honorDoNotTrack, disabled, fetch],\n  );\n\n  return <DumbledorContext.Provider value={client}>{children}</DumbledorContext.Provider>;\n}\n"]}

package/dist/react/index.d.cts

@@ -0,0 +1,51 @@
+import * as react from 'react';
+
+type DumbledorClientConfig = {
+    /** Project website ID from tracking settings. */
+    websiteId: string;
+    /** Ingest API origin. Defaults to `https://ingest.dumbledor.com`. */
+    ingestUrl?: string;
+    /** Skip all tracking when the browser sends Do Not Track. Default: `false`. */
+    honorDoNotTrack?: boolean;
+    /** Disable tracking entirely. Useful for local development. */
+    disabled?: boolean;
+    /** Custom fetch implementation (testing, edge runtimes). */
+    fetch?: typeof fetch;
+};
+type DumbledorClient = {
+    readonly config: Readonly<ResolvedDumbledorConfig>;
+    page: (input?: PageviewInput) => void;
+    track: (name: string, properties?: Record<string, unknown>) => void;
+    identify: (userId: string, traits?: Record<string, unknown>) => void;
+};
+type ResolvedDumbledorConfig = Required<Pick<DumbledorClientConfig, "websiteId" | "ingestUrl" | "honorDoNotTrack" | "disabled">> & Pick<DumbledorClientConfig, "fetch">;
+type PageviewInput = {
+    url?: string;
+    referrer?: string;
+    title?: string;
+    hostname?: string;
+    language?: string;
+    screen?: string;
+};
+
+type DumbledorProviderProps = DumbledorClientConfig & {
+    children: React.ReactNode;
+};
+declare function DumbledorProvider({ children, websiteId, ingestUrl, honorDoNotTrack, disabled, fetch, }: DumbledorProviderProps): react.JSX.Element;
+
+declare const DumbledorContext: react.Context<DumbledorClient | null>;
+declare function useDumbledor(): DumbledorClient;
+
+type PageViewProps = {
+    /** Route pathname. When omitted, falls back to `window.location.pathname`. */
+    pathname?: string;
+    /** Track the first render. Default: `true`. */
+    trackInitialView?: boolean;
+};
+declare function PageView({ pathname, trackInitialView }: PageViewProps): null;
+
+declare function useTrack(): (name: string, properties?: Record<string, unknown>) => void;
+declare function useIdentify(): (userId: string, traits?: Record<string, unknown>) => void;
+declare function usePage(): (input?: Parameters<(input?: PageviewInput) => void>[0]) => void;
+
+export { DumbledorContext, DumbledorProvider, type DumbledorProviderProps, PageView, type PageViewProps, useDumbledor, useIdentify, usePage, useTrack };

package/dist/react/index.d.ts

@@ -0,0 +1,51 @@
+import * as react from 'react';
+
+type DumbledorClientConfig = {
+    /** Project website ID from tracking settings. */
+    websiteId: string;
+    /** Ingest API origin. Defaults to `https://ingest.dumbledor.com`. */
+    ingestUrl?: string;
+    /** Skip all tracking when the browser sends Do Not Track. Default: `false`. */
+    honorDoNotTrack?: boolean;
+    /** Disable tracking entirely. Useful for local development. */
+    disabled?: boolean;
+    /** Custom fetch implementation (testing, edge runtimes). */
+    fetch?: typeof fetch;
+};
+type DumbledorClient = {
+    readonly config: Readonly<ResolvedDumbledorConfig>;
+    page: (input?: PageviewInput) => void;
+    track: (name: string, properties?: Record<string, unknown>) => void;
+    identify: (userId: string, traits?: Record<string, unknown>) => void;
+};
+type ResolvedDumbledorConfig = Required<Pick<DumbledorClientConfig, "websiteId" | "ingestUrl" | "honorDoNotTrack" | "disabled">> & Pick<DumbledorClientConfig, "fetch">;
+type PageviewInput = {
+    url?: string;
+    referrer?: string;
+    title?: string;
+    hostname?: string;
+    language?: string;
+    screen?: string;
+};
+
+type DumbledorProviderProps = DumbledorClientConfig & {
+    children: React.ReactNode;
+};
+declare function DumbledorProvider({ children, websiteId, ingestUrl, honorDoNotTrack, disabled, fetch, }: DumbledorProviderProps): react.JSX.Element;
+
+declare const DumbledorContext: react.Context<DumbledorClient | null>;
+declare function useDumbledor(): DumbledorClient;
+
+type PageViewProps = {
+    /** Route pathname. When omitted, falls back to `window.location.pathname`. */
+    pathname?: string;
+    /** Track the first render. Default: `true`. */
+    trackInitialView?: boolean;
+};
+declare function PageView({ pathname, trackInitialView }: PageViewProps): null;
+
+declare function useTrack(): (name: string, properties?: Record<string, unknown>) => void;
+declare function useIdentify(): (userId: string, traits?: Record<string, unknown>) => void;
+declare function usePage(): (input?: Parameters<(input?: PageviewInput) => void>[0]) => void;
+
+export { DumbledorContext, DumbledorProvider, type DumbledorProviderProps, PageView, type PageViewProps, useDumbledor, useIdentify, usePage, useTrack };

package/dist/react/index.js

@@ -0,0 +1,239 @@
+"use client";
+import { createContext, useContext, useRef, useEffect, useCallback, useMemo } from 'react';
+import { jsx } from 'react/jsx-runtime';
+
+// src/constants.ts
+var DEFAULT_INGEST_URL = "https://ingest.dumbledor.com";
+var UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+
+// src/config.ts
+var DumbledorConfigError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "DumbledorConfigError";
+  }
+};
+function normalizeIngestUrl(value) {
+  const raw = value?.trim() || DEFAULT_INGEST_URL;
+  return raw.replace(/\/$/, "");
+}
+function assertClientConfig(config) {
+  const websiteId = config.websiteId?.trim();
+  if (!websiteId) {
+    throw new DumbledorConfigError("websiteId is required.");
+  }
+  if (!UUID_PATTERN.test(websiteId)) {
+    throw new DumbledorConfigError("websiteId must be a valid UUID.");
+  }
+  return {
+    websiteId,
+    ingestUrl: normalizeIngestUrl(config.ingestUrl),
+    honorDoNotTrack: config.honorDoNotTrack ?? false,
+    disabled: config.disabled ?? false,
+    fetch: config.fetch
+  };
+}
+function withWebsiteId(payload, websiteId) {
+  return {
+    ...payload,
+    websiteId
+  };
+}
+function resolveFetch(fetchImpl) {
+  const resolved = fetchImpl ?? globalThis.fetch;
+  if (!resolved) {
+    throw new DumbledorConfigError("fetch is not available in this runtime.");
+  }
+  return resolved;
+}
+
+// src/dnt.ts
+function hasDoNotTrack() {
+  if (typeof window === "undefined") {
+    return false;
+  }
+  const win = window;
+  const dnt = win.doNotTrack ?? win.navigator.doNotTrack ?? win.navigator.msDoNotTrack;
+  return dnt === 1 || dnt === "1" || dnt === "yes";
+}
+function isTrackingDisabled(honorDoNotTrack) {
+  return honorDoNotTrack && hasDoNotTrack();
+}
+
+// src/client.ts
+function defaultPageviewInput() {
+  if (typeof window === "undefined" || typeof document === "undefined") {
+    return {};
+  }
+  return {
+    url: window.location.href,
+    referrer: document.referrer || void 0,
+    title: document.title,
+    hostname: window.location.hostname,
+    language: navigator.language,
+    screen: typeof screen !== "undefined" ? `${screen.width}x${screen.height}` : void 0
+  };
+}
+function createTransport(config) {
+  const endpoint = `${config.ingestUrl}/v1/collect`;
+  const fetchImpl = resolveFetch(config.fetch);
+  return async function send(payload) {
+    if (config.disabled || isTrackingDisabled(config.honorDoNotTrack)) {
+      return;
+    }
+    const body = withWebsiteId(payload, config.websiteId);
+    try {
+      const response = await fetchImpl(endpoint, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body),
+        keepalive: true,
+        credentials: "omit",
+        mode: "cors"
+      });
+      if (!response.ok) {
+        return {
+          ok: false,
+          error: `Ingest request failed with status ${response.status}`
+        };
+      }
+      return await response.json();
+    } catch {
+      return {
+        ok: false,
+        error: "Ingest request failed"
+      };
+    }
+  };
+}
+function createClient(config) {
+  const resolved = assertClientConfig(config);
+  const send = createTransport(resolved);
+  return {
+    config: resolved,
+    page(input = {}) {
+      const defaults = defaultPageviewInput();
+      const url = input.url ?? defaults.url;
+      if (!url) {
+        return;
+      }
+      void send({
+        type: "pageview",
+        url,
+        referrer: input.referrer ?? defaults.referrer,
+        title: input.title ?? defaults.title,
+        hostname: input.hostname ?? defaults.hostname,
+        language: input.language ?? defaults.language,
+        screen: input.screen ?? defaults.screen
+      });
+    },
+    track(name, properties) {
+      const defaults = defaultPageviewInput();
+      void send({
+        type: "track",
+        name,
+        properties: properties ?? {},
+        url: defaults.url,
+        hostname: defaults.hostname
+      });
+    },
+    identify(userId, traits) {
+      void send({
+        type: "identify",
+        userId,
+        traits: traits ?? {}
+      });
+    }
+  };
+}
+var defaultClient = null;
+function init(config) {
+  defaultClient = createClient(config);
+  return defaultClient;
+}
+function getClient() {
+  if (!defaultClient) {
+    throw new Error(
+      "Dumbledor is not initialized. Call init(), wrap with DumbledorProvider, or createClient() first."
+    );
+  }
+  return defaultClient;
+}
+
+// src/react/context.tsx
+var DumbledorContext = createContext(null);
+function useDumbledor() {
+  const client = useContext(DumbledorContext);
+  if (client) {
+    return client;
+  }
+  return getClient();
+}
+function PageView({ pathname, trackInitialView = true }) {
+  const client = useDumbledor();
+  const lastPathRef = useRef(null);
+  useEffect(() => {
+    const nextPath = pathname ?? (typeof window !== "undefined" ? `${window.location.pathname}${window.location.search}` : null);
+    if (!nextPath || lastPathRef.current === nextPath) {
+      return;
+    }
+    const isFirstView = lastPathRef.current === null;
+    lastPathRef.current = nextPath;
+    if (isFirstView && !trackInitialView) {
+      return;
+    }
+    client.page();
+  }, [client, pathname, trackInitialView]);
+  return null;
+}
+function useTrack() {
+  const client = useDumbledor();
+  return useCallback(
+    (name, properties) => {
+      client.track(name, properties);
+    },
+    [client]
+  );
+}
+function useIdentify() {
+  const client = useDumbledor();
+  return useCallback(
+    (userId, traits) => {
+      client.identify(userId, traits);
+    },
+    [client]
+  );
+}
+function usePage() {
+  const client = useDumbledor();
+  return useCallback(
+    (input) => {
+      client.page(input);
+    },
+    [client]
+  );
+}
+function DumbledorProvider({
+  children,
+  websiteId,
+  ingestUrl,
+  honorDoNotTrack,
+  disabled,
+  fetch
+}) {
+  const client = useMemo(
+    () => init({
+      websiteId,
+      ingestUrl,
+      honorDoNotTrack,
+      disabled,
+      fetch
+    }),
+    [websiteId, ingestUrl, honorDoNotTrack, disabled, fetch]
+  );
+  return /* @__PURE__ */ jsx(DumbledorContext.Provider, { value: client, children });
+}
+
+export { DumbledorContext, DumbledorProvider, PageView, useDumbledor, useIdentify, usePage, useTrack };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/constants.ts","../../src/config.ts","../../src/dnt.ts","../../src/client.ts","../../src/react/context.tsx","../../src/react/page-view.tsx","../../src/react/hooks.ts","../../src/react/provider.tsx"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["export const DEFAULT_INGEST_URL = \"https://ingest.dumbledor.com\";\n\nexport const UUID_PATTERN =\n  /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;\n","import { DEFAULT_INGEST_URL, UUID_PATTERN } from \"./constants\";\nimport type {\n  CollectPayload,\n  CollectPayloadInput,\n  DumbledorClientConfig,\n  ResolvedDumbledorConfig,\n} from \"./types\";\n\nexport class DumbledorConfigError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"DumbledorConfigError\";\n  }\n}\n\nexport function normalizeIngestUrl(value?: string): string {\n  const raw = value?.trim() || DEFAULT_INGEST_URL;\n  return raw.replace(/\\/$/, \"\");\n}\n\nexport function assertClientConfig(config: DumbledorClientConfig): ResolvedDumbledorConfig {\n  const websiteId = config.websiteId?.trim();\n\n  if (!websiteId) {\n    throw new DumbledorConfigError(\"websiteId is required.\");\n  }\n\n  if (!UUID_PATTERN.test(websiteId)) {\n    throw new DumbledorConfigError(\"websiteId must be a valid UUID.\");\n  }\n\n  return {\n    websiteId,\n    ingestUrl: normalizeIngestUrl(config.ingestUrl),\n    honorDoNotTrack: config.honorDoNotTrack ?? false,\n    disabled: config.disabled ?? false,\n    fetch: config.fetch,\n  };\n}\n\nexport function withWebsiteId(\n  payload: CollectPayloadInput,\n  websiteId: string,\n): CollectPayload {\n  return {\n    ...payload,\n    websiteId,\n  };\n}\n\nexport function resolveFetch(fetchImpl?: typeof fetch): typeof fetch {\n  const resolved = fetchImpl ?? globalThis.fetch;\n  if (!resolved) {\n    throw new DumbledorConfigError(\"fetch is not available in this runtime.\");\n  }\n\n  return resolved;\n}\n","type NavigatorWithMsDnt = Navigator & {\n  msDoNotTrack?: string | number | null;\n};\n\ntype WindowWithDnt = Window & {\n  doNotTrack?: string | number | null;\n};\n\nexport function hasDoNotTrack(): boolean {\n  if (typeof window === \"undefined\") {\n    return false;\n  }\n\n  const win = window as WindowWithDnt;\n  const dnt =\n    win.doNotTrack ??\n    win.navigator.doNotTrack ??\n    (win.navigator as NavigatorWithMsDnt).msDoNotTrack;\n\n  return dnt === 1 || dnt === \"1\" || dnt === \"yes\";\n}\n\nexport function isTrackingDisabled(honorDoNotTrack: boolean): boolean {\n  return honorDoNotTrack && hasDoNotTrack();\n}\n","import { assertClientConfig, resolveFetch, withWebsiteId } from \"./config\";\nimport { isTrackingDisabled } from \"./dnt\";\nimport type {\n  CollectPayloadInput,\n  CollectResponse,\n  DumbledorClient,\n  DumbledorClientConfig,\n  PageviewInput,\n  ResolvedDumbledorConfig,\n} from \"./types\";\n\nfunction defaultPageviewInput(): PageviewInput {\n  if (typeof window === \"undefined\" || typeof document === \"undefined\") {\n    return {};\n  }\n\n  return {\n    url: window.location.href,\n    referrer: document.referrer || undefined,\n    title: document.title,\n    hostname: window.location.hostname,\n    language: navigator.language,\n    screen: typeof screen !== \"undefined\" ? `${screen.width}x${screen.height}` : undefined,\n  };\n}\n\nexport function createTransport(config: ResolvedDumbledorConfig) {\n  const endpoint = `${config.ingestUrl}/v1/collect`;\n  const fetchImpl = resolveFetch(config.fetch);\n\n  return async function send(payload: CollectPayloadInput): Promise<CollectResponse | void> {\n    if (config.disabled || isTrackingDisabled(config.honorDoNotTrack)) {\n      return;\n    }\n\n    const body = withWebsiteId(payload, config.websiteId);\n\n    try {\n      const response = await fetchImpl(endpoint, {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify(body),\n        keepalive: true,\n        credentials: \"omit\",\n        mode: \"cors\",\n      });\n\n      if (!response.ok) {\n        return {\n          ok: false,\n          error: `Ingest request failed with status ${response.status}`,\n        };\n      }\n\n      return (await response.json()) as CollectResponse;\n    } catch {\n      return {\n        ok: false,\n        error: \"Ingest request failed\",\n      };\n    }\n  };\n}\n\nexport function createClient(config: DumbledorClientConfig): DumbledorClient {\n  const resolved = assertClientConfig(config);\n  const send = createTransport(resolved);\n\n  return {\n    config: resolved,\n    page(input = {}) {\n      const defaults = defaultPageviewInput();\n      const url = input.url ?? defaults.url;\n      if (!url) {\n        return;\n      }\n\n      void send({\n        type: \"pageview\",\n        url,\n        referrer: input.referrer ?? defaults.referrer,\n        title: input.title ?? defaults.title,\n        hostname: input.hostname ?? defaults.hostname,\n        language: input.language ?? defaults.language,\n        screen: input.screen ?? defaults.screen,\n      });\n    },\n    track(name, properties) {\n      const defaults = defaultPageviewInput();\n      void send({\n        type: \"track\",\n        name,\n        properties: properties ?? {},\n        url: defaults.url,\n        hostname: defaults.hostname,\n      });\n    },\n    identify(userId, traits) {\n      void send({\n        type: \"identify\",\n        userId,\n        traits: traits ?? {},\n      });\n    },\n  };\n}\n\nlet defaultClient: DumbledorClient | null = null;\n\nexport function init(config: DumbledorClientConfig): DumbledorClient {\n  defaultClient = createClient(config);\n  return defaultClient;\n}\n\nexport function getClient(): DumbledorClient {\n  if (!defaultClient) {\n    throw new Error(\n      \"Dumbledor is not initialized. Call init(), wrap with DumbledorProvider, or createClient() first.\",\n    );\n  }\n\n  return defaultClient;\n}\n\nexport function page(input?: PageviewInput): void {\n  getClient().page(input);\n}\n\nexport function track(name: string, properties?: Record<string, unknown>): void {\n  getClient().track(name, properties);\n}\n\nexport function identify(userId: string, traits?: Record<string, unknown>): void {\n  getClient().identify(userId, traits);\n}\n","\"use client\";\n\nimport { createContext, useContext } from \"react\";\nimport { getClient } from \"../client\";\nimport type { DumbledorClient } from \"../types\";\n\nexport const DumbledorContext = createContext<DumbledorClient | null>(null);\n\nexport function useDumbledor(): DumbledorClient {\n  const client = useContext(DumbledorContext);\n  if (client) {\n    return client;\n  }\n\n  return getClient();\n}\n","\"use client\";\n\nimport { useEffect, useRef } from \"react\";\nimport { useDumbledor } from \"./context\";\n\nexport type PageViewProps = {\n  /** Route pathname. When omitted, falls back to `window.location.pathname`. */\n  pathname?: string;\n  /** Track the first render. Default: `true`. */\n  trackInitialView?: boolean;\n};\n\nexport function PageView({ pathname, trackInitialView = true }: PageViewProps) {\n  const client = useDumbledor();\n  const lastPathRef = useRef<string | null>(null);\n\n  useEffect(() => {\n    const nextPath =\n      pathname ??\n      (typeof window !== \"undefined\"\n        ? `${window.location.pathname}${window.location.search}`\n        : null);\n\n    if (!nextPath || lastPathRef.current === nextPath) {\n      return;\n    }\n\n    const isFirstView = lastPathRef.current === null;\n    lastPathRef.current = nextPath;\n\n    if (isFirstView && !trackInitialView) {\n      return;\n    }\n\n    client.page();\n  }, [client, pathname, trackInitialView]);\n\n  return null;\n}\n","\"use client\";\n\nimport { useCallback } from \"react\";\nimport { useDumbledor } from \"./context\";\n\nexport function useTrack() {\n  const client = useDumbledor();\n  return useCallback(\n    (name: string, properties?: Record<string, unknown>) => {\n      client.track(name, properties);\n    },\n    [client],\n  );\n}\n\nexport function useIdentify() {\n  const client = useDumbledor();\n  return useCallback(\n    (userId: string, traits?: Record<string, unknown>) => {\n      client.identify(userId, traits);\n    },\n    [client],\n  );\n}\n\nexport function usePage() {\n  const client = useDumbledor();\n  return useCallback(\n    (input?: Parameters<typeof client.page>[0]) => {\n      client.page(input);\n    },\n    [client],\n  );\n}\n","\"use client\";\n\nimport { useMemo } from \"react\";\nimport { init } from \"../client\";\nimport type { DumbledorClientConfig } from \"../types\";\nimport { DumbledorContext } from \"./context\";\n\nexport type DumbledorProviderProps = DumbledorClientConfig & {\n  children: React.ReactNode;\n};\n\nexport function DumbledorProvider({\n  children,\n  websiteId,\n  ingestUrl,\n  honorDoNotTrack,\n  disabled,\n  fetch,\n}: DumbledorProviderProps) {\n  const client = useMemo(\n    () =>\n      init({\n        websiteId,\n        ingestUrl,\n        honorDoNotTrack,\n        disabled,\n        fetch,\n      }),\n    [websiteId, ingestUrl, honorDoNotTrack, disabled, fetch],\n  );\n\n  return <DumbledorContext.Provider value={client}>{children}</DumbledorContext.Provider>;\n}\n"]}