posthog-zero 0.1.0

package/README.md

@@ -0,0 +1,84 @@
+# posthog-zero
+
+Unofficial minimal PostHog **event capture** for edge and embedded runtimes.
+
+Built for:
+
+- **Cloudflare Workers** - `fetch`, use with `ctx.waitUntil()`
+- **Browser / Tauri webview** - `sendBeacon` when available, else `fetch`
+
+## Install
+
+```bash
+npm i posthog-zero
+```
+
+## Usage
+
+```ts
+import { posthogZero } from 'posthog-zero'
+
+const posthog = posthogZero({
+  apiKey: process.env.POSTHOG_KEY!,
+  host: 'https://us.i.posthog.com',
+  defaults: { $lib: 'posthog-zero-example' },
+})
+
+await posthog.capture({
+  event: 'button_clicked',
+  distinctId: anonId,
+  properties: { button: 'signup' },
+})
+```
+
+### Cloudflare Workers
+
+```ts
+import { posthogZero } from 'posthog-zero'
+import { getRequestProperties } from 'posthog-zero/request'
+
+const posthog = posthogZero({
+  apiKey: env.POSTHOG_KEY,
+  host: env.POSTHOG_HOST,
+  bots: 'drop', // or 'flag'
+})
+
+ctx.waitUntil(
+  posthog.capture({
+    event: '$pageview',
+    distinctId: anonId,
+    properties: getRequestProperties(request),
+  })
+)
+```
+
+Custom transport (tests, logging, or your own fetch/beacon):
+
+```ts
+posthogZero({
+  apiKey: process.env.POSTHOG_KEY!,
+  transport: (url, body) =>
+    fetch(url, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(body),
+      keepalive: true,
+    }),
+})
+```
+
+## Options
+
+| Option      | Description                                                                    |
+| ----------- | ------------------------------------------------------------------------------ |
+| `apiKey`    | Project API key (`phc_...`)                                                    |
+| `host`      | Ingest host (default US)                                                       |
+| `defaults`  | Properties merged on every event                                               |
+| `disabled`  | No network, `capture` still resolves                                           |
+| `debug`     | Log payloads                                                                   |
+| `transport` | `'auto'` \| `'beacon'` \| `'fetch'`, or `(url, body) => void \| Promise<void>` |
+| `bots`      | `'drop'` \| `'flag'`                                                           |
+
+`transport` as a function receives the wire `CaptureBody` (POST JSON to `url` yourself). Built-in `'auto'` uses `sendBeacon` when available, else `fetch`.
+
+With `bots: 'flag'`, only bot traffic gets `is_bot: true` and `bot_name` (the matched blocklist substring). Human events are unchanged. Detection uses the same UA list as `@posthog/core` (browser SDK bot blocking).

package/dist/body.d.ts

@@ -0,0 +1,8 @@
+import type { CaptureBody, CaptureInput, EventProperties } from './types.js';
+export declare function normalizeHost(host?: string): string;
+export declare function captureUrl(host: string): string;
+export declare function toTimestamp(value?: string | Date): string;
+export declare function buildCaptureBody(apiKey: string, defaults: EventProperties | undefined, input: CaptureInput): CaptureBody;
+/** For debug logs, omit `api_key` */
+export declare function sanitizeCaptureBody(body: CaptureBody): Omit<CaptureBody, 'api_key'>;
+//# sourceMappingURL=body.d.ts.map

package/dist/body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"body.d.ts","sourceRoot":"","sources":["../src/body.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAI5E,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAIzD;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,eAAe,GAAG,SAAS,EACrC,KAAK,EAAE,YAAY,GAClB,WAAW,CAWb;AAED,qCAAqC;AACrC,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,WAAW,GAChB,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAG9B"}

package/dist/body.js

@@ -0,0 +1,32 @@
+const DEFAULT_HOST = 'https://us.i.posthog.com';
+export function normalizeHost(host) {
+    return (host ?? DEFAULT_HOST).replace(/\/$/, '');
+}
+export function captureUrl(host) {
+    return `${normalizeHost(host)}/i/v0/e/`;
+}
+export function toTimestamp(value) {
+    if (value === undefined)
+        return new Date().toISOString();
+    if (value instanceof Date)
+        return value.toISOString();
+    return value;
+}
+export function buildCaptureBody(apiKey, defaults, input) {
+    return {
+        api_key: apiKey,
+        event: input.event,
+        distinct_id: input.distinctId,
+        properties: {
+            ...defaults,
+            ...input.properties,
+        },
+        timestamp: toTimestamp(input.timestamp),
+    };
+}
+/** For debug logs, omit `api_key` */
+export function sanitizeCaptureBody(body) {
+    const { api_key: _key, ...rest } = body;
+    return rest;
+}
+//# sourceMappingURL=body.js.map

package/dist/body.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"body.js","sourceRoot":"","sources":["../src/body.ts"],"names":[],"mappings":"AAEA,MAAM,YAAY,GAAG,0BAA0B,CAAA;AAE/C,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC,OAAO,CAAC,IAAI,IAAI,YAAY,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;AAClD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,UAAU,CAAA;AACzC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAqB;IAC/C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IACxD,IAAI,KAAK,YAAY,IAAI;QAAE,OAAO,KAAK,CAAC,WAAW,EAAE,CAAA;IACrD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,MAAc,EACd,QAAqC,EACrC,KAAmB;IAEnB,OAAO;QACL,OAAO,EAAE,MAAM;QACf,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,WAAW,EAAE,KAAK,CAAC,UAAU;QAC7B,UAAU,EAAE;YACV,GAAG,QAAQ;YACX,GAAG,KAAK,CAAC,UAAU;SACpB;QACD,SAAS,EAAE,WAAW,CAAC,KAAK,CAAC,SAAS,CAAC;KACxC,CAAA;AACH,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,mBAAmB,CACjC,IAAiB;IAEjB,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAA;IACvC,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/bots.d.ts

@@ -0,0 +1,9 @@
+import type { BotsMode, CaptureBody, EventProperties } from './types.js';
+/** Matched blocklist substring, if any. */
+export declare function getBotName(ua: string | undefined): string | undefined;
+export declare function isBotFromProperties(properties: EventProperties | undefined): boolean;
+/** Adds `is_bot` and `bot_name` when UA matches PostHog's blocklist. */
+export declare function enrichBotFlags(properties: EventProperties): EventProperties;
+/** Returns `null` when `bots: 'drop'` and properties indicate a bot. */
+export declare function applyBotsMode(body: CaptureBody, bots: BotsMode | undefined): CaptureBody | null;
+//# sourceMappingURL=bots.d.ts.map

package/dist/bots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bots.d.ts","sourceRoot":"","sources":["../src/bots.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAExE,2CAA2C;AAC3C,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CASrE;AAED,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,eAAe,GAAG,SAAS,GACtC,OAAO,CAMT;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,UAAU,EAAE,eAAe,GAAG,eAAe,CAM3E;AAED,wEAAwE;AACxE,wBAAgB,aAAa,CAC3B,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,QAAQ,GAAG,SAAS,GACzB,WAAW,GAAG,IAAI,CAQpB"}

package/dist/bots.js

@@ -0,0 +1,43 @@
+import { DEFAULT_BLOCKED_UA_STRS, isBlockedUA } from '@posthog/core/utils';
+/** Matched blocklist substring, if any. */
+export function getBotName(ua) {
+    if (!ua)
+        return undefined;
+    const uaLower = ua.toLowerCase();
+    for (const blocked of DEFAULT_BLOCKED_UA_STRS) {
+        if (uaLower.indexOf(blocked.toLowerCase()) !== -1) {
+            return blocked;
+        }
+    }
+    return undefined;
+}
+export function isBotFromProperties(properties) {
+    if (!properties)
+        return false;
+    if (properties.is_bot === true)
+        return true;
+    const ua = properties.$raw_user_agent;
+    if (typeof ua === 'string')
+        return isBlockedUA(ua);
+    return false;
+}
+/** Adds `is_bot` and `bot_name` when UA matches PostHog's blocklist. */
+export function enrichBotFlags(properties) {
+    const ua = properties.$raw_user_agent;
+    if (typeof ua !== 'string')
+        return properties;
+    const botName = getBotName(ua);
+    if (!botName)
+        return properties;
+    return { ...properties, is_bot: true, bot_name: botName };
+}
+/** Returns `null` when `bots: 'drop'` and properties indicate a bot. */
+export function applyBotsMode(body, bots) {
+    if (!bots)
+        return body;
+    if (bots === 'drop') {
+        return isBotFromProperties(body.properties) ? null : body;
+    }
+    return { ...body, properties: enrichBotFlags(body.properties) };
+}
+//# sourceMappingURL=bots.js.map

package/dist/bots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bots.js","sourceRoot":"","sources":["../src/bots.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAI1E,2CAA2C;AAC3C,MAAM,UAAU,UAAU,CAAC,EAAsB;IAC/C,IAAI,CAAC,EAAE;QAAE,OAAO,SAAS,CAAA;IACzB,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,EAAE,CAAA;IAChC,KAAK,MAAM,OAAO,IAAI,uBAAuB,EAAE,CAAC;QAC9C,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YAClD,OAAO,OAAO,CAAA;QAChB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,UAAuC;IAEvC,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAA;IAC7B,IAAI,UAAU,CAAC,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IAC3C,MAAM,EAAE,GAAG,UAAU,CAAC,eAAe,CAAA;IACrC,IAAI,OAAO,EAAE,KAAK,QAAQ;QAAE,OAAO,WAAW,CAAC,EAAE,CAAC,CAAA;IAClD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,cAAc,CAAC,UAA2B;IACxD,MAAM,EAAE,GAAG,UAAU,CAAC,eAAe,CAAA;IACrC,IAAI,OAAO,EAAE,KAAK,QAAQ;QAAE,OAAO,UAAU,CAAA;IAC7C,MAAM,OAAO,GAAG,UAAU,CAAC,EAAE,CAAC,CAAA;IAC9B,IAAI,CAAC,OAAO;QAAE,OAAO,UAAU,CAAA;IAC/B,OAAO,EAAE,GAAG,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAA;AAC3D,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,aAAa,CAC3B,IAAiB,EACjB,IAA0B;IAE1B,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAA;IAEtB,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,OAAO,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;IAC3D,CAAC;IAED,OAAO,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAA;AACjE,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,3 @@
+import type { PosthogZeroClient, PosthogZeroOptions } from './types.js';
+export declare function posthogZero(options: PosthogZeroOptions): PosthogZeroClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,YAAY,CAAA;AAEnB,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,CA+B1E"}

package/dist/client.js

@@ -0,0 +1,28 @@
+import { buildCaptureBody, captureUrl, sanitizeCaptureBody } from './body.js';
+import { applyBotsMode } from './bots.js';
+import { sendCapture } from './transport.js';
+export function posthogZero(options) {
+    const host = options.host;
+    const url = captureUrl(host ?? 'https://us.i.posthog.com');
+    const defaults = options.defaults;
+    const disabled = options.disabled ?? false;
+    const debug = options.debug ?? false;
+    const transport = options.transport ?? 'auto';
+    const bots = options.bots;
+    return {
+        capture(input) {
+            const body = applyBotsMode(buildCaptureBody(options.apiKey, defaults, input), bots);
+            if (!body) {
+                return Promise.resolve();
+            }
+            if (debug) {
+                console.info('[posthog-zero]', sanitizeCaptureBody(body));
+            }
+            if (disabled) {
+                return Promise.resolve();
+            }
+            return sendCapture(url, body, transport);
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAO5C,MAAM,UAAU,WAAW,CAAC,OAA2B;IACrD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAA;IACzB,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,IAAI,0BAA0B,CAAC,CAAA;IAC1D,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAA;IACjC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,KAAK,CAAA;IAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAA;IACpC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAA;IAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAA;IAEzB,OAAO;QACL,OAAO,CAAC,KAAmB;YACzB,MAAM,IAAI,GAAG,aAAa,CACxB,gBAAgB,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,EACjD,IAAI,CACL,CAAA;YAED,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;YAC1B,CAAC;YAED,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAA;YAC3D,CAAC;YAED,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;YAC1B,CAAC;YAED,OAAO,WAAW,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,CAAA;QAC1C,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { posthogZero } from './client.js';
+export type { BotsMode, CaptureBody, CaptureInput, CaptureTransport, EventProperties, PosthogZeroClient, PosthogZeroOptions, Transport, TransportPreset, } from './types.js';
+export { getBotName, isBotFromProperties } from './bots.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,YAAY,EACV,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACT,eAAe,GAChB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { posthogZero } from './client.js';
+export { getBotName, isBotFromProperties } from './bots.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAYzC,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA"}

package/dist/request.d.ts

@@ -0,0 +1,8 @@
+import type { EventProperties } from './types.js';
+/**
+ * PostHog-style properties from a generic `Request` (Workers, Astro middleware, etc.):
+ * request URL, referrer, user-agent, browser/OS/device (`$raw_user_agent` for `bots` option).
+ * Merge any extra properties in your `capture` call.
+ */
+export declare function getRequestProperties(request: Request): EventProperties;
+//# sourceMappingURL=request.d.ts.map

package/dist/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../src/request.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AA+BjD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,CAoCtE"}

package/dist/request.js

@@ -0,0 +1,74 @@
+import { detectBrowser, detectBrowserVersion, detectDevice, detectDeviceType, detectOS, } from '@posthog/core/utils';
+function getSearchEngine(referrer) {
+    if (!referrer)
+        return undefined;
+    try {
+        const host = new URL(referrer).hostname;
+        if (host === 'google.com' || host.endsWith('.google.com'))
+            return 'google';
+        if (host === 'bing.com' || host.endsWith('.bing.com'))
+            return 'bing';
+        if (host === 'yahoo.com' || host.endsWith('.yahoo.com'))
+            return 'yahoo';
+        if (host === 'duckduckgo.com' || host.endsWith('.duckduckgo.com'))
+            return 'duckduckgo';
+    }
+    catch {
+        // ignore malformed URLs
+    }
+    return undefined;
+}
+function getUrlProperties(request) {
+    try {
+        const parsedUrl = new URL(request.url);
+        return {
+            $current_url: parsedUrl.href,
+            $host: parsedUrl.hostname,
+            $pathname: parsedUrl.pathname,
+            $search: parsedUrl.search || undefined,
+        };
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * PostHog-style properties from a generic `Request` (Workers, Astro middleware, etc.):
+ * request URL, referrer, user-agent, browser/OS/device (`$raw_user_agent` for `bots` option).
+ * Merge any extra properties in your `capture` call.
+ */
+export function getRequestProperties(request) {
+    const referer = request.headers.get('referer') ?? undefined;
+    let referringDomain;
+    try {
+        referringDomain = referer
+            ? new URL(referer).hostname || undefined
+            : undefined;
+    }
+    catch {
+        referringDomain = undefined;
+    }
+    const uaString = request.headers.get('user-agent') ?? undefined;
+    const [osName, osVersion] = uaString ? detectOS(uaString) : ['', ''];
+    const browserName = uaString ? detectBrowser(uaString, '') : '';
+    const browserVersion = uaString ? detectBrowserVersion(uaString, '') : null;
+    const browserLanguage = request.headers.get('accept-language')?.split(',')[0]?.trim() || undefined;
+    return {
+        ...getUrlProperties(request),
+        $referrer: referer,
+        $referring_domain: referringDomain,
+        $raw_user_agent: uaString,
+        $browser_language: browserLanguage,
+        $browser_language_prefix: browserLanguage?.split('-')[0],
+        $search_engine: getSearchEngine(referer),
+        $os: osName || undefined,
+        $os_version: osVersion || undefined,
+        $browser: browserName || undefined,
+        $browser_version: browserVersion ?? undefined,
+        $device: uaString ? detectDevice(uaString) || undefined : undefined,
+        $device_type: uaString
+            ? detectDeviceType(uaString) || undefined
+            : undefined,
+    };
+}
+//# sourceMappingURL=request.js.map

package/dist/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../src/request.ts"],"names":[],"mappings":"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"}

package/dist/transport.d.ts

@@ -0,0 +1,3 @@
+import type { CaptureBody, Transport } from './types.js';
+export declare function sendCapture(url: string, body: CaptureBody, transport: Transport): Promise<void>;
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EAEX,SAAS,EAEV,MAAM,YAAY,CAAA;AA4CnB,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,EACjB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/transport.js

@@ -0,0 +1,43 @@
+function isCaptureTransport(transport) {
+    return typeof transport === 'function';
+}
+function beaconAvailable() {
+    return (typeof navigator !== 'undefined' &&
+        typeof navigator.sendBeacon === 'function' &&
+        typeof Blob !== 'undefined');
+}
+function useBeaconPreset(preset) {
+    return beaconAvailable() && (preset === 'beacon' || preset === 'auto');
+}
+function resolveFetch() {
+    if (typeof globalThis.fetch === 'function')
+        return globalThis.fetch;
+    throw new Error('posthog-zero: fetch is not available in this runtime');
+}
+function sendViaBeacon(url, body) {
+    const json = JSON.stringify(body);
+    const blob = new Blob([json], { type: 'application/json' });
+    navigator.sendBeacon(url, blob);
+    return Promise.resolve();
+}
+function sendViaFetch(url, body) {
+    const json = JSON.stringify(body);
+    return resolveFetch()(url, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: json,
+        keepalive: true,
+    })
+        .then(() => undefined)
+        .catch(() => undefined);
+}
+export function sendCapture(url, body, transport) {
+    if (isCaptureTransport(transport)) {
+        return Promise.resolve(transport(url, body)).catch(() => undefined);
+    }
+    if (useBeaconPreset(transport)) {
+        return sendViaBeacon(url, body);
+    }
+    return sendViaFetch(url, body);
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAOA,SAAS,kBAAkB,CACzB,SAAoB;IAEpB,OAAO,OAAO,SAAS,KAAK,UAAU,CAAA;AACxC,CAAC;AAED,SAAS,eAAe;IACtB,OAAO,CACL,OAAO,SAAS,KAAK,WAAW;QAChC,OAAO,SAAS,CAAC,UAAU,KAAK,UAAU;QAC1C,OAAO,IAAI,KAAK,WAAW,CAC5B,CAAA;AACH,CAAC;AAED,SAAS,eAAe,CAAC,MAAuB;IAC9C,OAAO,eAAe,EAAE,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,MAAM,CAAC,CAAA;AACxE,CAAC;AAED,SAAS,YAAY;IACnB,IAAI,OAAO,UAAU,CAAC,KAAK,KAAK,UAAU;QAAE,OAAO,UAAU,CAAC,KAAK,CAAA;IACnE,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAA;AACzE,CAAC;AAED,SAAS,aAAa,CAAC,GAAW,EAAE,IAAiB;IACnD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;IACjC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAA;IAC3D,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAC/B,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;AAC1B,CAAC;AAED,SAAS,YAAY,CAAC,GAAW,EAAE,IAAiB;IAClD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;IACjC,OAAO,YAAY,EAAE,CAAC,GAAG,EAAE;QACzB,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI;QACV,SAAS,EAAE,IAAI;KAChB,CAAC;SACC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;SACrB,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;AAC3B,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,GAAW,EACX,IAAiB,EACjB,SAAoB;IAEpB,IAAI,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC;QAClC,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;IACrE,CAAC;IAED,IAAI,eAAe,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/B,OAAO,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IACjC,CAAC;IAED,OAAO,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;AAChC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,46 @@
+export type EventProperties = Record<string, string | number | boolean | undefined>;
+export type CaptureInput = {
+    event: string;
+    distinctId: string;
+    properties?: EventProperties;
+    timestamp?: string | Date;
+};
+/** Wire payload for PostHog /i/v0/e/ */
+export type CaptureBody = {
+    api_key: string;
+    event: string;
+    distinct_id: string;
+    properties: EventProperties;
+    timestamp: string;
+};
+export type TransportPreset = 'auto' | 'beacon' | 'fetch';
+/** POST JSON to `url` (e.g. via fetch or sendBeacon). Errors are swallowed by the client. */
+export type CaptureTransport = (url: string, body: CaptureBody) => void | Promise<void>;
+export type Transport = TransportPreset | CaptureTransport;
+/**
+ * Bot handling uses PostHog's UA blocklist (`@posthog/core`).
+ * - `drop`: skip capture when `$raw_user_agent` (or `is_bot: true`) indicates a bot.
+ * - `flag`: add `is_bot` and `bot_name` on bot traffic (from `$raw_user_agent`).
+ */
+export type BotsMode = 'drop' | 'flag';
+export type PosthogZeroOptions = {
+    apiKey: string;
+    /** Ingest host, default `https://us.i.posthog.com` */
+    host?: string;
+    /** Merged into every event's `properties` */
+    defaults?: EventProperties;
+    /** Skip network (capture still resolves) */
+    disabled?: boolean;
+    /** Log sanitized payloads to `console` */
+    debug?: boolean;
+    /**
+     * `auto`: sendBeacon when available, else fetch.
+     * Or a custom sender that receives the wire payload (serialize as needed).
+     */
+    transport?: Transport;
+    bots?: BotsMode;
+};
+export type PosthogZeroClient = {
+    capture: (input: CaptureInput) => Promise<void>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,MAAM,CAClC,MAAM,EACN,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CACtC,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,eAAe,CAAA;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B,CAAA;AAED,wCAAwC;AACxC,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,eAAe,CAAA;IAC3B,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;AAEzD,6FAA6F;AAC7F,MAAM,MAAM,gBAAgB,GAAG,CAC7B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,KACd,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAEzB,MAAM,MAAM,SAAS,GAAG,eAAe,GAAG,gBAAgB,CAAA;AAE1D;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAA;AAEtC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,eAAe,CAAA;IAC1B,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,OAAO,CAAA;IACf;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,IAAI,CAAC,EAAE,QAAQ,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAChD,CAAA"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "posthog-zero",
+  "version": "0.1.0",
+  "description": "Minimal PostHog event capture for Cloudflare Workers, edge, and browser/Tauri.",
+  "type": "module",
+  "license": "MIT",
+  "repository": "EveToolsHQ/posthog-zero",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./request": {
+      "types": "./dist/request.d.ts",
+      "import": "./dist/request.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@posthog/core": "^1.29.9"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.4",
+    "eslint": "^9.39.4",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-import-x": "^4.16.2",
+    "eslint-plugin-prettier": "^5.5.5",
+    "eslint-plugin-unused-imports": "^4.4.1",
+    "prettier": "^3.8.3",
+    "typescript": "~5.8.3",
+    "typescript-eslint": "^8.60.0",
+    "vitest": "^3.2.4"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "check": "pnpm run typecheck && pnpm run lint && pnpm run format:check && pnpm run test",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  }
+}