@dumbledor/sdk 0.1.0

package/dist/server/index.cjs

@@ -0,0 +1,137 @@
+'use strict';
+
+// 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/server/index.ts
+function applyServerContext(headers, context) {
+  if (context?.userAgent) {
+    headers.set("User-Agent", context.userAgent);
+  }
+  if (context?.ip) {
+    headers.set("X-Forwarded-For", context.ip);
+  }
+  if (context?.referrer) {
+    headers.set("Referer", context.referrer);
+  }
+}
+async function send(config, payload, context) {
+  if (config.disabled) {
+    return;
+  }
+  const fetchImpl = resolveFetch(config.fetch);
+  const endpoint = `${config.ingestUrl}/v1/collect`;
+  const body = withWebsiteId(payload, config.websiteId);
+  const headers = new Headers({ "Content-Type": "application/json" });
+  applyServerContext(headers, context);
+  try {
+    const response = await fetchImpl(endpoint, {
+      method: "POST",
+      headers,
+      body: JSON.stringify(body),
+      keepalive: false
+    });
+    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 createServerClient(config) {
+  const resolved = assertClientConfig(config);
+  return {
+    page(input) {
+      return send(
+        resolved,
+        {
+          type: "pageview",
+          url: input.url,
+          referrer: input.referrer,
+          title: input.title,
+          hostname: input.hostname
+        },
+        {
+          url: input.url,
+          referrer: input.referrer
+        }
+      );
+    },
+    track(name, properties, context) {
+      return send(
+        resolved,
+        {
+          type: "track",
+          name,
+          properties: properties ?? {},
+          url: context?.url
+        },
+        context
+      );
+    },
+    identify(userId, traits, context) {
+      return send(
+        resolved,
+        {
+          type: "identify",
+          userId,
+          traits: traits ?? {}
+        },
+        context
+      );
+    }
+  };
+}
+
+exports.createServerClient = createServerClient;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/server/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/constants.ts","../../src/config.ts","../../src/server/index.ts"],"names":[],"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","import { assertClientConfig, resolveFetch, withWebsiteId } from \"../config\";\nimport type {\n  CollectPayloadInput,\n  CollectResponse,\n  DumbledorServerConfig,\n  ServerContext,\n} from \"../types\";\n\nexport type DumbledorServer = {\n  page: (input: { url: string; referrer?: string; title?: string; hostname?: string }) => Promise<CollectResponse | void>;\n  track: (\n    name: string,\n    properties?: Record<string, unknown>,\n    context?: ServerContext,\n  ) => Promise<CollectResponse | void>;\n  identify: (\n    userId: string,\n    traits?: Record<string, unknown>,\n    context?: ServerContext,\n  ) => Promise<CollectResponse | void>;\n};\n\nfunction applyServerContext(headers: Headers, context?: ServerContext) {\n  if (context?.userAgent) {\n    headers.set(\"User-Agent\", context.userAgent);\n  }\n  if (context?.ip) {\n    headers.set(\"X-Forwarded-For\", context.ip);\n  }\n  if (context?.referrer) {\n    headers.set(\"Referer\", context.referrer);\n  }\n}\n\nasync function send(\n  config: ReturnType<typeof assertClientConfig>,\n  payload: CollectPayloadInput,\n  context?: ServerContext,\n): Promise<CollectResponse | void> {\n  if (config.disabled) {\n    return;\n  }\n\n  const fetchImpl = resolveFetch(config.fetch);\n  const endpoint = `${config.ingestUrl}/v1/collect`;\n  const body = withWebsiteId(payload, config.websiteId);\n  const headers = new Headers({ \"Content-Type\": \"application/json\" });\n  applyServerContext(headers, context);\n\n  try {\n    const response = await fetchImpl(endpoint, {\n      method: \"POST\",\n      headers,\n      body: JSON.stringify(body),\n      keepalive: false,\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\nexport function createServerClient(config: DumbledorServerConfig): DumbledorServer {\n  const resolved = assertClientConfig(config);\n\n  return {\n    page(input) {\n      return send(\n        resolved,\n        {\n          type: \"pageview\",\n          url: input.url,\n          referrer: input.referrer,\n          title: input.title,\n          hostname: input.hostname,\n        },\n        {\n          url: input.url,\n          referrer: input.referrer,\n        },\n      );\n    },\n    track(name, properties, context) {\n      return send(\n        resolved,\n        {\n          type: \"track\",\n          name,\n          properties: properties ?? {},\n          url: context?.url,\n        },\n        context,\n      );\n    },\n    identify(userId, traits, context) {\n      return send(\n        resolved,\n        {\n          type: \"identify\",\n          userId,\n          traits: traits ?? {},\n        },\n        context,\n      );\n    },\n  };\n}\n"]}

package/dist/server/index.d.cts

@@ -0,0 +1,15 @@
+import { b as CollectResponse, S as ServerContext, e as DumbledorServerConfig } from '../types-DWa2kNUy.cjs';
+
+type DumbledorServer = {
+    page: (input: {
+        url: string;
+        referrer?: string;
+        title?: string;
+        hostname?: string;
+    }) => Promise<CollectResponse | void>;
+    track: (name: string, properties?: Record<string, unknown>, context?: ServerContext) => Promise<CollectResponse | void>;
+    identify: (userId: string, traits?: Record<string, unknown>, context?: ServerContext) => Promise<CollectResponse | void>;
+};
+declare function createServerClient(config: DumbledorServerConfig): DumbledorServer;
+
+export { type DumbledorServer, createServerClient };

package/dist/server/index.d.ts

@@ -0,0 +1,15 @@
+import { b as CollectResponse, S as ServerContext, e as DumbledorServerConfig } from '../types-DWa2kNUy.js';
+
+type DumbledorServer = {
+    page: (input: {
+        url: string;
+        referrer?: string;
+        title?: string;
+        hostname?: string;
+    }) => Promise<CollectResponse | void>;
+    track: (name: string, properties?: Record<string, unknown>, context?: ServerContext) => Promise<CollectResponse | void>;
+    identify: (userId: string, traits?: Record<string, unknown>, context?: ServerContext) => Promise<CollectResponse | void>;
+};
+declare function createServerClient(config: DumbledorServerConfig): DumbledorServer;
+
+export { type DumbledorServer, createServerClient };

package/dist/server/index.js

@@ -0,0 +1,135 @@
+// 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/server/index.ts
+function applyServerContext(headers, context) {
+  if (context?.userAgent) {
+    headers.set("User-Agent", context.userAgent);
+  }
+  if (context?.ip) {
+    headers.set("X-Forwarded-For", context.ip);
+  }
+  if (context?.referrer) {
+    headers.set("Referer", context.referrer);
+  }
+}
+async function send(config, payload, context) {
+  if (config.disabled) {
+    return;
+  }
+  const fetchImpl = resolveFetch(config.fetch);
+  const endpoint = `${config.ingestUrl}/v1/collect`;
+  const body = withWebsiteId(payload, config.websiteId);
+  const headers = new Headers({ "Content-Type": "application/json" });
+  applyServerContext(headers, context);
+  try {
+    const response = await fetchImpl(endpoint, {
+      method: "POST",
+      headers,
+      body: JSON.stringify(body),
+      keepalive: false
+    });
+    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 createServerClient(config) {
+  const resolved = assertClientConfig(config);
+  return {
+    page(input) {
+      return send(
+        resolved,
+        {
+          type: "pageview",
+          url: input.url,
+          referrer: input.referrer,
+          title: input.title,
+          hostname: input.hostname
+        },
+        {
+          url: input.url,
+          referrer: input.referrer
+        }
+      );
+    },
+    track(name, properties, context) {
+      return send(
+        resolved,
+        {
+          type: "track",
+          name,
+          properties: properties ?? {},
+          url: context?.url
+        },
+        context
+      );
+    },
+    identify(userId, traits, context) {
+      return send(
+        resolved,
+        {
+          type: "identify",
+          userId,
+          traits: traits ?? {}
+        },
+        context
+      );
+    }
+  };
+}
+
+export { createServerClient };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/constants.ts","../../src/config.ts","../../src/server/index.ts"],"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","import { assertClientConfig, resolveFetch, withWebsiteId } from \"../config\";\nimport type {\n  CollectPayloadInput,\n  CollectResponse,\n  DumbledorServerConfig,\n  ServerContext,\n} from \"../types\";\n\nexport type DumbledorServer = {\n  page: (input: { url: string; referrer?: string; title?: string; hostname?: string }) => Promise<CollectResponse | void>;\n  track: (\n    name: string,\n    properties?: Record<string, unknown>,\n    context?: ServerContext,\n  ) => Promise<CollectResponse | void>;\n  identify: (\n    userId: string,\n    traits?: Record<string, unknown>,\n    context?: ServerContext,\n  ) => Promise<CollectResponse | void>;\n};\n\nfunction applyServerContext(headers: Headers, context?: ServerContext) {\n  if (context?.userAgent) {\n    headers.set(\"User-Agent\", context.userAgent);\n  }\n  if (context?.ip) {\n    headers.set(\"X-Forwarded-For\", context.ip);\n  }\n  if (context?.referrer) {\n    headers.set(\"Referer\", context.referrer);\n  }\n}\n\nasync function send(\n  config: ReturnType<typeof assertClientConfig>,\n  payload: CollectPayloadInput,\n  context?: ServerContext,\n): Promise<CollectResponse | void> {\n  if (config.disabled) {\n    return;\n  }\n\n  const fetchImpl = resolveFetch(config.fetch);\n  const endpoint = `${config.ingestUrl}/v1/collect`;\n  const body = withWebsiteId(payload, config.websiteId);\n  const headers = new Headers({ \"Content-Type\": \"application/json\" });\n  applyServerContext(headers, context);\n\n  try {\n    const response = await fetchImpl(endpoint, {\n      method: \"POST\",\n      headers,\n      body: JSON.stringify(body),\n      keepalive: false,\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\nexport function createServerClient(config: DumbledorServerConfig): DumbledorServer {\n  const resolved = assertClientConfig(config);\n\n  return {\n    page(input) {\n      return send(\n        resolved,\n        {\n          type: \"pageview\",\n          url: input.url,\n          referrer: input.referrer,\n          title: input.title,\n          hostname: input.hostname,\n        },\n        {\n          url: input.url,\n          referrer: input.referrer,\n        },\n      );\n    },\n    track(name, properties, context) {\n      return send(\n        resolved,\n        {\n          type: \"track\",\n          name,\n          properties: properties ?? {},\n          url: context?.url,\n        },\n        context,\n      );\n    },\n    identify(userId, traits, context) {\n      return send(\n        resolved,\n        {\n          type: \"identify\",\n          userId,\n          traits: traits ?? {},\n        },\n        context,\n      );\n    },\n  };\n}\n"]}

package/dist/types-DWa2kNUy.d.cts

@@ -0,0 +1,68 @@
+type CollectEventType = "pageview" | "track" | "identify";
+type PageviewPayload = {
+    type: "pageview";
+    websiteId: string;
+    url: string;
+    referrer?: string;
+    title?: string;
+    hostname?: string;
+    language?: string;
+    screen?: string;
+};
+type TrackPayload = {
+    type: "track";
+    websiteId: string;
+    name: string;
+    properties?: Record<string, unknown>;
+    url?: string;
+    hostname?: string;
+};
+type IdentifyPayload = {
+    type: "identify";
+    websiteId: string;
+    userId: string;
+    traits?: Record<string, unknown>;
+};
+type CollectPayload = PageviewPayload | TrackPayload | IdentifyPayload;
+type CollectPayloadInput = Omit<PageviewPayload, "websiteId"> | Omit<TrackPayload, "websiteId"> | Omit<IdentifyPayload, "websiteId">;
+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 DumbledorServerConfig = DumbledorClientConfig;
+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 ServerContext = {
+    url?: string;
+    referrer?: string;
+    userAgent?: string;
+    ip?: string;
+};
+type CollectResponse = {
+    ok: boolean;
+    skipped?: string;
+    error?: string;
+};
+
+export type { CollectPayloadInput as C, DumbledorClientConfig as D, IdentifyPayload as I, PageviewInput as P, ResolvedDumbledorConfig as R, ServerContext as S, TrackPayload as T, DumbledorClient as a, CollectResponse as b, CollectPayload as c, CollectEventType as d, DumbledorServerConfig as e, PageviewPayload as f };

package/dist/types-DWa2kNUy.d.ts

@@ -0,0 +1,68 @@
+type CollectEventType = "pageview" | "track" | "identify";
+type PageviewPayload = {
+    type: "pageview";
+    websiteId: string;
+    url: string;
+    referrer?: string;
+    title?: string;
+    hostname?: string;
+    language?: string;
+    screen?: string;
+};
+type TrackPayload = {
+    type: "track";
+    websiteId: string;
+    name: string;
+    properties?: Record<string, unknown>;
+    url?: string;
+    hostname?: string;
+};
+type IdentifyPayload = {
+    type: "identify";
+    websiteId: string;
+    userId: string;
+    traits?: Record<string, unknown>;
+};
+type CollectPayload = PageviewPayload | TrackPayload | IdentifyPayload;
+type CollectPayloadInput = Omit<PageviewPayload, "websiteId"> | Omit<TrackPayload, "websiteId"> | Omit<IdentifyPayload, "websiteId">;
+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 DumbledorServerConfig = DumbledorClientConfig;
+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 ServerContext = {
+    url?: string;
+    referrer?: string;
+    userAgent?: string;
+    ip?: string;
+};
+type CollectResponse = {
+    ok: boolean;
+    skipped?: string;
+    error?: string;
+};
+
+export type { CollectPayloadInput as C, DumbledorClientConfig as D, IdentifyPayload as I, PageviewInput as P, ResolvedDumbledorConfig as R, ServerContext as S, TrackPayload as T, DumbledorClient as a, CollectResponse as b, CollectPayload as c, CollectEventType as d, DumbledorServerConfig as e, PageviewPayload as f };

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "@dumbledor/sdk",
+  "version": "0.1.0",
+  "description": "Official Dumbledor analytics SDK for browser, React, Next.js, and server runtimes.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js",
+      "require": "./dist/react/index.cjs"
+    },
+    "./next": {
+      "types": "./dist/next/index.d.ts",
+      "import": "./dist/next/index.js",
+      "require": "./dist/next/index.cjs"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.js",
+      "require": "./dist/server/index.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "peerDependencies": {
+    "next": ">=13.0.0",
+    "react": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "next": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.7",
+    "next": "^16.1.6",
+    "react": "^19.2.3",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.16"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "analytics",
+    "dumbledor",
+    "privacy",
+    "tracking",
+    "nextjs",
+    "react"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dumbledor/dumbledor.com",
+    "directory": "sdk"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup && node scripts/stamp-client.mjs",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  }
+}