@sjohansson/astro-plausible 0.0.0-stage → 0.1.0

package/dist/options-B-SB8PRR.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options-B-SB8PRR.js","names":[],"sources":["../src/options.ts"],"sourcesContent":["import type { PlausibleConfig } from \"@plausible-analytics/tracker\";\n\n/** Tracker settings that can be written down as JSON. These go straight to the tracker's `init()`. */\nexport interface PlausibleOptions {\n  /** Your site's domain, as entered in Plausible. */\n  domain: string;\n\n  /**\n   * Where events go. `/api/event` is the relay from `astro-plausible init` on your own domain. Set the full\n   * Plausible URL, `https://plausible.io/api/event`, to skip the relay.\n   * @default \"/api/event\"\n   */\n  endpoint?: string;\n\n  /**\n   * Send a pageview on load and on history navigation.\n   * @default true\n   */\n  autoCapturePageviews?: boolean;\n\n  /**\n   * Track `#` paths as separate pages.\n   * @default false\n   */\n  hashBasedRouting?: boolean;\n\n  /**\n   * Track clicks on links to other sites.\n   * @default false\n   */\n  outboundLinks?: boolean;\n\n  /**\n   * Track file downloads, with Plausible's default file types or the ones given.\n   * @default false\n   */\n  fileDownloads?: boolean | { fileExtensions: string[] };\n\n  /**\n   * Track form submissions.\n   * @default false\n   */\n  formSubmissions?: boolean;\n\n  /**\n   * Also track on localhost.\n   * @default false\n   */\n  captureOnLocalhost?: boolean;\n\n  /**\n   * Log ignored events to the console.\n   * @default true\n   */\n  logging?: boolean;\n\n  /** Custom properties added to every event. */\n  customProperties?: Record<string, string | number | boolean>;\n\n  /**\n   * Expose the tracker as `window.plausible`. Plausible's installation check looks for it.\n   * @default true\n   */\n  bindToWindow?: boolean;\n}\n\nexport const DEFAULT_ENDPOINT = \"/api/event\";\n\nconst DOMAIN_PATTERN = /^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*(\\/[\\w.-]+)*$/i;\nconst BOOLEAN_KEYS = [\n  \"autoCapturePageviews\",\n  \"hashBasedRouting\",\n  \"outboundLinks\",\n  \"formSubmissions\",\n  \"captureOnLocalhost\",\n  \"logging\",\n  \"bindToWindow\",\n] as const;\n\nfunction fail(message: string): never {\n  throw new Error(`[@sjohansson/astro-plausible] ${message}`);\n}\n\n/** Validates the options and returns the config for the tracker's `init()`. Only keys that were set are included. */\nexport function plausibleConfig(options: PlausibleOptions): PlausibleConfig {\n  if (typeof options?.domain !== \"string\" || options.domain.length > 253 || !DOMAIN_PATTERN.test(options.domain)) {\n    fail(\"domain must be the site domain as entered in Plausible, like example.com.\");\n  }\n  const endpoint = options.endpoint ?? DEFAULT_ENDPOINT;\n  if (typeof endpoint !== \"string\" || endpoint.length === 0) fail(\"endpoint must be a non-empty string.\");\n\n  const config: PlausibleConfig = { domain: options.domain, endpoint };\n\n  for (const key of BOOLEAN_KEYS) {\n    const value = options[key];\n    if (value === undefined) continue;\n    if (typeof value !== \"boolean\") fail(`${key} must be a boolean.`);\n    config[key] = value;\n  }\n  if (options.fileDownloads !== undefined) {\n    const value = options.fileDownloads;\n    const custom = typeof value === \"object\" && value !== null && Array.isArray(value.fileExtensions);\n    if (typeof value !== \"boolean\" && !custom) fail(\"fileDownloads must be a boolean or { fileExtensions: [...] }.\");\n    config.fileDownloads = value;\n  }\n  if (options.customProperties !== undefined) {\n    const value = options.customProperties;\n    const plain =\n      typeof value === \"object\" &&\n      value !== null &&\n      !Array.isArray(value) &&\n      Object.values(value).every((v) => [\"string\", \"number\", \"boolean\"].includes(typeof v));\n    if (!plain) fail(\"customProperties must be an object of strings, numbers and booleans.\");\n    config.customProperties = value;\n  }\n  return config;\n}\n"],"mappings":";AAkEA,MAAa,mBAAmB;AAEhC,MAAM,iBAAiB;AACvB,MAAM,eAAe;CACnB;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,SAAS,KAAK,SAAwB;CACpC,MAAM,IAAI,MAAM,iCAAiC,SAAS;AAC5D;;AAGA,SAAgB,gBAAgB,SAA4C;CAC1E,IAAI,OAAO,SAAS,WAAW,YAAY,QAAQ,OAAO,SAAS,OAAO,CAAC,eAAe,KAAK,QAAQ,MAAM,GAC3G,KAAK,2EAA2E;CAElF,MAAM,WAAW,QAAQ,YAAA;CACzB,IAAI,OAAO,aAAa,YAAY,SAAS,WAAW,GAAG,KAAK,sCAAsC;CAEtG,MAAM,SAA0B;EAAE,QAAQ,QAAQ;EAAQ;CAAS;CAEnE,KAAK,MAAM,OAAO,cAAc;EAC9B,MAAM,QAAQ,QAAQ;EACtB,IAAI,UAAU,KAAA,GAAW;EACzB,IAAI,OAAO,UAAU,WAAW,KAAK,GAAG,IAAI,oBAAoB;EAChE,OAAO,OAAO;CAChB;CACA,IAAI,QAAQ,kBAAkB,KAAA,GAAW;EACvC,MAAM,QAAQ,QAAQ;EACtB,MAAM,SAAS,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,MAAM,cAAc;EAChG,IAAI,OAAO,UAAU,aAAa,CAAC,QAAQ,KAAK,+DAA+D;EAC/G,OAAO,gBAAgB;CACzB;CACA,IAAI,QAAQ,qBAAqB,KAAA,GAAW;EAC1C,MAAM,QAAQ,QAAQ;EAMtB,IAAI,EAJF,OAAO,UAAU,YACjB,UAAU,QACV,CAAC,MAAM,QAAQ,KAAK,KACpB,OAAO,OAAO,KAAK,CAAC,CAAC,OAAO,MAAM;GAAC;GAAU;GAAU;EAAS,CAAC,CAAC,SAAS,OAAO,CAAC,CAAC,IAC1E,KAAK,sEAAsE;EACvF,OAAO,mBAAmB;CAC5B;CACA,OAAO;AACT"}

package/dist/options-C15OXXsk.d.ts

@@ -0,0 +1,61 @@
+import { PlausibleConfig } from "@plausible-analytics/tracker";
+/** Tracker settings that can be written down as JSON. These go straight to the tracker's `init()`. */
+interface PlausibleOptions {
+  /** Your site's domain, as entered in Plausible. */
+  domain: string;
+  /**
+   * Where events go. `/api/event` is the relay from `astro-plausible init` on your own domain. Set the full
+   * Plausible URL, `https://plausible.io/api/event`, to skip the relay.
+   * @default "/api/event"
+   */
+  endpoint?: string;
+  /**
+   * Send a pageview on load and on history navigation.
+   * @default true
+   */
+  autoCapturePageviews?: boolean;
+  /**
+   * Track `#` paths as separate pages.
+   * @default false
+   */
+  hashBasedRouting?: boolean;
+  /**
+   * Track clicks on links to other sites.
+   * @default false
+   */
+  outboundLinks?: boolean;
+  /**
+   * Track file downloads, with Plausible's default file types or the ones given.
+   * @default false
+   */
+  fileDownloads?: boolean | {
+    fileExtensions: string[];
+  };
+  /**
+   * Track form submissions.
+   * @default false
+   */
+  formSubmissions?: boolean;
+  /**
+   * Also track on localhost.
+   * @default false
+   */
+  captureOnLocalhost?: boolean;
+  /**
+   * Log ignored events to the console.
+   * @default true
+   */
+  logging?: boolean;
+  /** Custom properties added to every event. */
+  customProperties?: Record<string, string | number | boolean>;
+  /**
+   * Expose the tracker as `window.plausible`. Plausible's installation check looks for it.
+   * @default true
+   */
+  bindToWindow?: boolean;
+}
+declare const DEFAULT_ENDPOINT = "/api/event";
+/** Validates the options and returns the config for the tracker's `init()`. Only keys that were set are included. */
+declare function plausibleConfig(options: PlausibleOptions): PlausibleConfig;
+export { PlausibleOptions as n, plausibleConfig as r, DEFAULT_ENDPOINT as t };
+//# sourceMappingURL=options-C15OXXsk.d.ts.map

package/dist/options-C15OXXsk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options-C15OXXsk.d.ts","names":[],"sources":["../src/options.ts"],"mappings":";;UAGiB;;EAEf;;;;;;EAOA;;;;;EAMA;;;;;EAMA;;;;;EAMA;;;;;EAMA;IAA4B;;;;;;EAM5B;;;;;EAMA;;;;;EAMA;;EAGA,mBAAmB;;;;;EAMnB;;cAGW;;iBAkBG,gBAAgB,SAAS,mBAAmB"}

package/dist/relay.d.ts

@@ -0,0 +1,92 @@
+/**
+ * The relay forwards tracker events from your domain to Plausible. It is written against the web standard Request
+ * and Response, so it runs anywhere fetch does: an Astro endpoint, Cloudflare, Netlify, Vercel, or through the
+ * `swaHandler` adapter, Azure Static Web Apps managed functions.
+ *
+ * It checks the domain so the endpoint only relays for your sites, passes the visitor's IP in `X-Forwarded-For`
+ * and their user agent (Plausible drops events without a real visitor IP), caps the body size, and can validate
+ * custom events.
+ */
+/** Per property pattern that an event's props must match. Only the listed properties are forwarded. */
+export type RelayRule = Record<string, RegExp | string>;
+export interface RelayOptions {
+  /** Site domain as entered in Plausible, or several when one relay serves several sites. */
+  domain: string | string[];
+  /**
+   * The Plausible host. Events are posted to `<upstream>/api/event`. Self-hosted: `https://plausible.example.com`.
+   * @default "https://plausible.io"
+   */
+  upstream?: string;
+  /**
+   * Largest request body accepted, in bytes.
+   * @default 16384
+   */
+  maxBodyLength?: number;
+  /**
+   * Headers to read the visitor IP from, in order, when `handle` or `forward` is not given one. A client can send
+   * any header, so list only the ones your platform sets: `["cf-connecting-ip"]` on Cloudflare.
+   * @default DEFAULT_IP_HEADERS
+   */
+  ipHeaders?: string[];
+  /**
+   * Validation for custom events, by event name. An event with a rule is forwarded only if every listed property
+   * is a string matching its pattern, and with only those properties. Events without a rule pass through as is.
+   */
+  events?: Record<string, RelayRule>;
+  /** Called when Plausible cannot be reached. */
+  onError?: (error: unknown) => void;
+}
+/** Incoming request headers with lowercased names, as Node and most platforms give them. */
+export type RelayHeaders = Record<string, string | string[] | undefined>;
+export interface RelayForward {
+  url: string;
+  body: string;
+  headers: Record<string, string>;
+}
+export interface RelayResult {
+  status: number;
+  contentType: string;
+  body: string;
+}
+export interface Relay {
+  /** Builds the upstream request, or null when the event is not for this relay or not valid. */
+  forward(rawBody: unknown, headers: RelayHeaders, clientIp?: string): RelayForward | null;
+  /** Sends a forward to Plausible. Throws when Plausible cannot be reached. */
+  send(forward: RelayForward): Promise<RelayResult>;
+  /** Handles a web standard request end to end. Pass the visitor IP when the platform gives it to you. */
+  handle(request: Request, context?: {
+    clientIp?: string;
+  }): Promise<Response>;
+}
+export declare const DEFAULT_UPSTREAM = "https://plausible.io";
+export declare const DEFAULT_MAX_BODY_LENGTH: number;
+/**
+ * Platform headers that carry the visitor IP, most specific first. x-forwarded-for is last because proxies append to
+ * it and some let the client seed it. The first header present wins, so on a platform that sets only one of these a
+ * client can spoof the IP by sending one ranked above it; set `ipHeaders` there.
+ */
+export declare const DEFAULT_IP_HEADERS: readonly string[];
+/** Visitor IP from platform headers, without any port. Undefined when no header carries one. */
+export declare function clientIp(headers: RelayHeaders, names?: readonly string[]): string | undefined;
+export declare function createRelay(options: RelayOptions): Relay;
+/** The subset of the Azure Functions v3 context the adapter uses. */
+export interface SwaContext {
+  log: {
+    warn(message: string): void;
+  };
+  res?: {
+    status: number;
+    headers?: Record<string, string>;
+    body?: string;
+  };
+}
+export interface SwaRequest {
+  rawBody?: unknown;
+  headers?: RelayHeaders;
+}
+/**
+ * Adapter for Azure Static Web Apps managed functions (Node, `function.json` model). `astro-plausible init` writes
+ * a function that uses this.
+ */
+export declare function swaHandler(relay: Relay): (context: SwaContext, req: SwaRequest) => Promise<void>;
+//# sourceMappingURL=relay.d.ts.map

package/dist/relay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay.d.ts","names":[],"sources":["../src/relay.ts"],"mappings":";;;;;;;;;;YAWY,YAAY,eAAe;iBAEtB;;EAEf;;;;;EAMA;;;;;EAMA;;;;;;EAOA;;;;;EAMA,SAAS,eAAe;;EAGxB,WAAW;;;YAID,eAAe;iBAEV;EACf;EACA;EACA,SAAS;;iBAGM;EACf;EACA;EACA;;iBAGe;;EAEf,QAAQ,kBAAkB,SAAS,cAAc,oBAAoB;;EAErE,KAAK,SAAS,eAAe,QAAQ;;EAErC,OAAO,SAAS,SAAS;IAAY;MAAsB,QAAQ;;qBAGxD;qBACA;;;;;;qBAOA;;wBAeG,SAAS,SAAS,cAAc;wBAuEhC,YAAY,SAAS,eAAe;;iBAiFnC;EACf;IAAO,KAAK;;EACZ;IAAQ;IAAgB,UAAU;IAAwB;;;iBAG3C;EACf;EACA,UAAU;;;;;;wBAOI,WAAW,OAAO,SAAS,SAAS,YAAY,KAAK,eAAe"}

package/dist/relay.js

@@ -0,0 +1,189 @@
+// src/relay.ts
+const DEFAULT_UPSTREAM = "https://plausible.io";
+const DEFAULT_MAX_BODY_LENGTH = 16384;
+/**
+* Platform headers that carry the visitor IP, most specific first. x-forwarded-for is last because proxies append to
+* it and some let the client seed it. The first header present wins, so on a platform that sets only one of these a
+* client can spoof the IP by sending one ranked above it; set `ipHeaders` there.
+*/
+const DEFAULT_IP_HEADERS = [
+	"x-azure-clientip",
+	"x-client-ip",
+	"cf-connecting-ip",
+	"x-nf-client-connection-ip",
+	"x-real-ip",
+	"x-forwarded-for"
+];
+function header(headers, name) {
+	const value = headers[name];
+	return Array.isArray(value) ? value[0] : value;
+}
+/** Visitor IP from platform headers, without any port. Undefined when no header carries one. */
+function clientIp(headers, names = DEFAULT_IP_HEADERS) {
+	for (const name of names) {
+		const raw = header(headers, name)?.split(",")[0]?.trim();
+		if (!raw) continue;
+		const bracketed = raw.match(/^\[(.+)\]:\d+$/);
+		if (bracketed) return bracketed[1];
+		const ipv4WithPort = raw.match(/^(\d{1,3}(?:\.\d{1,3}){3}):\d+$/);
+		return ipv4WithPort ? ipv4WithPort[1] : raw;
+	}
+}
+function compileRules(events = {}) {
+	const compiled = /* @__PURE__ */ new Map();
+	for (const [name, rule] of Object.entries(events)) {
+		const entries = Object.entries(rule).map(([property, pattern]) => [property, pattern instanceof RegExp ? new RegExp(pattern.source, pattern.flags.replace(/[gy]/g, "")) : new RegExp(pattern)]);
+		if (entries.length === 0) throw new Error(`[@sjohansson/astro-plausible] Rule for event "${name}" lists no properties.`);
+		compiled.set(name, entries);
+	}
+	return compiled;
+}
+const PROPS_ALIASES = [
+	"m",
+	"meta",
+	"props"
+];
+/** Applies the rule for an event. Returns the props to forward, or null when the event is not valid. */
+function applyRule(rules, props) {
+	const source = props && typeof props === "object" ? props : {};
+	const kept = {};
+	for (const [property, pattern] of rules) {
+		const value = source[property];
+		if (typeof value !== "string" || !pattern.test(value)) return null;
+		kept[property] = value;
+	}
+	return kept;
+}
+const encoder = new TextEncoder();
+/** Reads a request body as text, or returns null as soon as it grows past `limit` bytes. */
+async function readBody(request, limit) {
+	if (!request.body) return "";
+	const reader = request.body.getReader();
+	const decoder = new TextDecoder();
+	let text = "";
+	let size = 0;
+	for (;;) {
+		const { done, value } = await reader.read();
+		if (done) return text + decoder.decode();
+		size += value.byteLength;
+		if (size > limit) {
+			await reader.cancel();
+			return null;
+		}
+		text += decoder.decode(value, { stream: true });
+	}
+}
+function headersToRecord(headers) {
+	const record = {};
+	headers.forEach((value, name) => {
+		record[name.toLowerCase()] = value;
+	});
+	return record;
+}
+function createRelay(options) {
+	const domains = new Set(Array.isArray(options.domain) ? options.domain : [options.domain]);
+	if (domains.size === 0 || [...domains].some((d) => typeof d !== "string" || d.length === 0)) throw new Error("[@sjohansson/astro-plausible] domain is required.");
+	const upstream = `${(options.upstream ?? "https://plausible.io").replace(/\/$/, "")}/api/event`;
+	const maxBodyLength = options.maxBodyLength ?? 16384;
+	const rules = compileRules(options.events);
+	const ipHeaders = options.ipHeaders?.map((name) => name.toLowerCase()) ?? DEFAULT_IP_HEADERS;
+	const relay = {
+		forward(rawBody, headers, ip) {
+			if (typeof rawBody !== "string" || rawBody.length === 0) return null;
+			if (rawBody.length > maxBodyLength || encoder.encode(rawBody).length > maxBodyLength) return null;
+			let event;
+			try {
+				event = JSON.parse(rawBody);
+			} catch {
+				return null;
+			}
+			if (!event || typeof event !== "object" || Array.isArray(event)) return null;
+			if (typeof event["d"] !== "string" || !domains.has(event["d"])) return null;
+			const name = event["n"];
+			if (typeof name !== "string" || name.length === 0) return null;
+			if (rules.has(name)) {
+				const kept = applyRule(rules.get(name) ?? [], event["p"]);
+				if (!kept) return null;
+				for (const alias of PROPS_ALIASES) delete event[alias];
+				event["p"] = kept;
+			}
+			const forwardHeaders = { "content-type": "application/json" };
+			const userAgent = header(headers, "user-agent");
+			if (userAgent) forwardHeaders["user-agent"] = userAgent;
+			const visitorIp = ip ?? clientIp(headers, ipHeaders);
+			if (visitorIp) forwardHeaders["x-forwarded-for"] = visitorIp;
+			return {
+				url: upstream,
+				body: JSON.stringify(event),
+				headers: forwardHeaders
+			};
+		},
+		async send(forward) {
+			const res = await fetch(forward.url, {
+				method: "POST",
+				headers: forward.headers,
+				body: forward.body
+			});
+			return {
+				status: res.status,
+				contentType: res.headers.get("content-type") ?? "text/plain",
+				body: await res.text()
+			};
+		},
+		async handle(request, context = {}) {
+			if (request.method !== "POST") return new Response(null, {
+				status: 405,
+				headers: { allow: "POST" }
+			});
+			if (Number(request.headers.get("content-length")) > maxBodyLength) return new Response(null, { status: 413 });
+			const body = await readBody(request, maxBodyLength);
+			if (body === null) return new Response(null, { status: 413 });
+			const forward = relay.forward(body, headersToRecord(request.headers), context.clientIp);
+			if (!forward) return new Response(null, { status: 400 });
+			try {
+				const result = await relay.send(forward);
+				return new Response(result.body, {
+					status: result.status,
+					headers: {
+						"content-type": result.contentType,
+						"cache-control": "no-store"
+					}
+				});
+			} catch (error) {
+				options.onError?.(error);
+				return new Response(null, { status: 502 });
+			}
+		}
+	};
+	return relay;
+}
+/**
+* Adapter for Azure Static Web Apps managed functions (Node, `function.json` model). `astro-plausible init` writes
+* a function that uses this.
+*/
+function swaHandler(relay) {
+	return async (context, req) => {
+		const forward = relay.forward(req.rawBody, req.headers ?? {});
+		if (!forward) {
+			context.res = { status: 400 };
+			return;
+		}
+		try {
+			const result = await relay.send(forward);
+			context.res = {
+				status: result.status,
+				headers: {
+					"content-type": result.contentType,
+					"cache-control": "no-store"
+				},
+				body: result.body
+			};
+		} catch (error) {
+			context.log.warn(`Plausible forward failed: ${error}`);
+			context.res = { status: 502 };
+		}
+	};
+}
+export { DEFAULT_IP_HEADERS, DEFAULT_MAX_BODY_LENGTH, DEFAULT_UPSTREAM, clientIp, createRelay, swaHandler };
+
+//# sourceMappingURL=relay.js.map

package/dist/relay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay.js","names":[],"sources":["../src/relay.ts"],"sourcesContent":["/**\n * The relay forwards tracker events from your domain to Plausible. It is written against the web standard Request\n * and Response, so it runs anywhere fetch does: an Astro endpoint, Cloudflare, Netlify, Vercel, or through the\n * `swaHandler` adapter, Azure Static Web Apps managed functions.\n *\n * It checks the domain so the endpoint only relays for your sites, passes the visitor's IP in `X-Forwarded-For`\n * and their user agent (Plausible drops events without a real visitor IP), caps the body size, and can validate\n * custom events.\n */\n\n/** Per property pattern that an event's props must match. Only the listed properties are forwarded. */\nexport type RelayRule = Record<string, RegExp | string>;\n\nexport interface RelayOptions {\n  /** Site domain as entered in Plausible, or several when one relay serves several sites. */\n  domain: string | string[];\n\n  /**\n   * The Plausible host. Events are posted to `<upstream>/api/event`. Self-hosted: `https://plausible.example.com`.\n   * @default \"https://plausible.io\"\n   */\n  upstream?: string;\n\n  /**\n   * Largest request body accepted, in bytes.\n   * @default 16384\n   */\n  maxBodyLength?: number;\n\n  /**\n   * Headers to read the visitor IP from, in order, when `handle` or `forward` is not given one. A client can send\n   * any header, so list only the ones your platform sets: `[\"cf-connecting-ip\"]` on Cloudflare.\n   * @default DEFAULT_IP_HEADERS\n   */\n  ipHeaders?: string[];\n\n  /**\n   * Validation for custom events, by event name. An event with a rule is forwarded only if every listed property\n   * is a string matching its pattern, and with only those properties. Events without a rule pass through as is.\n   */\n  events?: Record<string, RelayRule>;\n\n  /** Called when Plausible cannot be reached. */\n  onError?: (error: unknown) => void;\n}\n\n/** Incoming request headers with lowercased names, as Node and most platforms give them. */\nexport type RelayHeaders = Record<string, string | string[] | undefined>;\n\nexport interface RelayForward {\n  url: string;\n  body: string;\n  headers: Record<string, string>;\n}\n\nexport interface RelayResult {\n  status: number;\n  contentType: string;\n  body: string;\n}\n\nexport interface Relay {\n  /** Builds the upstream request, or null when the event is not for this relay or not valid. */\n  forward(rawBody: unknown, headers: RelayHeaders, clientIp?: string): RelayForward | null;\n  /** Sends a forward to Plausible. Throws when Plausible cannot be reached. */\n  send(forward: RelayForward): Promise<RelayResult>;\n  /** Handles a web standard request end to end. Pass the visitor IP when the platform gives it to you. */\n  handle(request: Request, context?: { clientIp?: string }): Promise<Response>;\n}\n\nexport const DEFAULT_UPSTREAM = \"https://plausible.io\";\nexport const DEFAULT_MAX_BODY_LENGTH = 16 * 1024;\n\n/**\n * Platform headers that carry the visitor IP, most specific first. x-forwarded-for is last because proxies append to\n * it and some let the client seed it. The first header present wins, so on a platform that sets only one of these a\n * client can spoof the IP by sending one ranked above it; set `ipHeaders` there.\n */\nexport const DEFAULT_IP_HEADERS: readonly string[] = [\n  \"x-azure-clientip\",\n  \"x-client-ip\",\n  \"cf-connecting-ip\",\n  \"x-nf-client-connection-ip\",\n  \"x-real-ip\",\n  \"x-forwarded-for\",\n];\n\nfunction header(headers: RelayHeaders, name: string): string | undefined {\n  const value = headers[name];\n  return Array.isArray(value) ? value[0] : value;\n}\n\n/** Visitor IP from platform headers, without any port. Undefined when no header carries one. */\nexport function clientIp(headers: RelayHeaders, names: readonly string[] = DEFAULT_IP_HEADERS): string | undefined {\n  for (const name of names) {\n    const raw = header(headers, name)?.split(\",\")[0]?.trim();\n    if (!raw) continue;\n    const bracketed = raw.match(/^\\[(.+)\\]:\\d+$/);\n    if (bracketed) return bracketed[1];\n    const ipv4WithPort = raw.match(/^(\\d{1,3}(?:\\.\\d{1,3}){3}):\\d+$/);\n    return ipv4WithPort ? ipv4WithPort[1] : raw;\n  }\n  return undefined;\n}\n\nfunction compileRules(events: Record<string, RelayRule> = {}): Map<string, [string, RegExp][]> {\n  const compiled = new Map<string, [string, RegExp][]>();\n  for (const [name, rule] of Object.entries(events)) {\n    const entries = Object.entries(rule).map(([property, pattern]): [string, RegExp] => [\n      property,\n      // Drop g and y: they make test() stateful, and the rules are shared across requests.\n      pattern instanceof RegExp ? new RegExp(pattern.source, pattern.flags.replace(/[gy]/g, \"\")) : new RegExp(pattern),\n    ]);\n    if (entries.length === 0) {\n      throw new Error(`[@sjohansson/astro-plausible] Rule for event \"${name}\" lists no properties.`);\n    }\n    compiled.set(name, entries);\n  }\n  return compiled;\n}\n\nconst PROPS_ALIASES = [\"m\", \"meta\", \"props\"];\n\n/** Applies the rule for an event. Returns the props to forward, or null when the event is not valid. */\nfunction applyRule(rules: [string, RegExp][], props: unknown): Record<string, string> | null {\n  const source = props && typeof props === \"object\" ? (props as Record<string, unknown>) : {};\n  const kept: Record<string, string> = {};\n  for (const [property, pattern] of rules) {\n    const value = source[property];\n    if (typeof value !== \"string\" || !pattern.test(value)) return null;\n    kept[property] = value;\n  }\n  return kept;\n}\n\nconst encoder = new TextEncoder();\n\n/** Reads a request body as text, or returns null as soon as it grows past `limit` bytes. */\nasync function readBody(request: Request, limit: number): Promise<string | null> {\n  if (!request.body) return \"\";\n  const reader = request.body.getReader();\n  const decoder = new TextDecoder();\n  let text = \"\";\n  let size = 0;\n  for (;;) {\n    const { done, value } = await reader.read();\n    if (done) return text + decoder.decode();\n    size += value.byteLength;\n    if (size > limit) {\n      await reader.cancel();\n      return null;\n    }\n    text += decoder.decode(value, { stream: true });\n  }\n}\n\nfunction headersToRecord(headers: Headers): RelayHeaders {\n  const record: RelayHeaders = {};\n  headers.forEach((value, name) => {\n    record[name.toLowerCase()] = value;\n  });\n  return record;\n}\n\nexport function createRelay(options: RelayOptions): Relay {\n  const domains = new Set(Array.isArray(options.domain) ? options.domain : [options.domain]);\n  if (domains.size === 0 || [...domains].some((d) => typeof d !== \"string\" || d.length === 0)) {\n    throw new Error(\"[@sjohansson/astro-plausible] domain is required.\");\n  }\n  const upstream = `${(options.upstream ?? DEFAULT_UPSTREAM).replace(/\\/$/, \"\")}/api/event`;\n  const maxBodyLength = options.maxBodyLength ?? DEFAULT_MAX_BODY_LENGTH;\n  const rules = compileRules(options.events);\n  const ipHeaders = options.ipHeaders?.map((name) => name.toLowerCase()) ?? DEFAULT_IP_HEADERS;\n\n  const relay: Relay = {\n    forward(rawBody, headers, ip) {\n      if (typeof rawBody !== \"string\" || rawBody.length === 0) return null;\n      // A UTF-16 code unit is at least one UTF-8 byte, so the length check spares encoding a body that is far too big.\n      if (rawBody.length > maxBodyLength || encoder.encode(rawBody).length > maxBodyLength) return null;\n\n      let event: Record<string, unknown>;\n      try {\n        event = JSON.parse(rawBody);\n      } catch {\n        return null;\n      }\n      if (!event || typeof event !== \"object\" || Array.isArray(event)) return null;\n      if (typeof event[\"d\"] !== \"string\" || !domains.has(event[\"d\"])) return null;\n      const name = event[\"n\"];\n      if (typeof name !== \"string\" || name.length === 0) return null;\n\n      if (rules.has(name)) {\n        const kept = applyRule(rules.get(name) ?? [], event[\"p\"]);\n        if (!kept) return null;\n        // Plausible also takes props as m, meta or props, and reads m and meta before p.\n        for (const alias of PROPS_ALIASES) delete event[alias];\n        event[\"p\"] = kept;\n      }\n\n      const forwardHeaders: Record<string, string> = { \"content-type\": \"application/json\" };\n      const userAgent = header(headers, \"user-agent\");\n      if (userAgent) forwardHeaders[\"user-agent\"] = userAgent;\n      const visitorIp = ip ?? clientIp(headers, ipHeaders);\n      if (visitorIp) forwardHeaders[\"x-forwarded-for\"] = visitorIp;\n\n      return { url: upstream, body: JSON.stringify(event), headers: forwardHeaders };\n    },\n\n    async send(forward) {\n      const res = await fetch(forward.url, { method: \"POST\", headers: forward.headers, body: forward.body });\n      return {\n        status: res.status,\n        contentType: res.headers.get(\"content-type\") ?? \"text/plain\",\n        body: await res.text(),\n      };\n    },\n\n    async handle(request, context = {}) {\n      if (request.method !== \"POST\") return new Response(null, { status: 405, headers: { allow: \"POST\" } });\n      const length = Number(request.headers.get(\"content-length\"));\n      if (length > maxBodyLength) return new Response(null, { status: 413 });\n\n      // Content-Length can be missing (chunked) or wrong, so the limit also applies while reading.\n      const body = await readBody(request, maxBodyLength);\n      if (body === null) return new Response(null, { status: 413 });\n\n      const forward = relay.forward(body, headersToRecord(request.headers), context.clientIp);\n      if (!forward) return new Response(null, { status: 400 });\n\n      try {\n        const result = await relay.send(forward);\n        return new Response(result.body, {\n          status: result.status,\n          headers: { \"content-type\": result.contentType, \"cache-control\": \"no-store\" },\n        });\n      } catch (error) {\n        options.onError?.(error);\n        return new Response(null, { status: 502 });\n      }\n    },\n  };\n  return relay;\n}\n\n/** The subset of the Azure Functions v3 context the adapter uses. */\nexport interface SwaContext {\n  log: { warn(message: string): void };\n  res?: { status: number; headers?: Record<string, string>; body?: string };\n}\n\nexport interface SwaRequest {\n  rawBody?: unknown;\n  headers?: RelayHeaders;\n}\n\n/**\n * Adapter for Azure Static Web Apps managed functions (Node, `function.json` model). `astro-plausible init` writes\n * a function that uses this.\n */\nexport function swaHandler(relay: Relay): (context: SwaContext, req: SwaRequest) => Promise<void> {\n  return async (context, req) => {\n    const forward = relay.forward(req.rawBody, req.headers ?? {});\n    if (!forward) {\n      context.res = { status: 400 };\n      return;\n    }\n    try {\n      const result = await relay.send(forward);\n      context.res = {\n        status: result.status,\n        headers: { \"content-type\": result.contentType, \"cache-control\": \"no-store\" },\n        body: result.body,\n      };\n    } catch (error) {\n      context.log.warn(`Plausible forward failed: ${error}`);\n      context.res = { status: 502 };\n    }\n  };\n}\n"],"mappings":"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"}

package/dist/templates/swa.mjs

@@ -0,0 +1,187 @@
+/**
+* Platform headers that carry the visitor IP, most specific first. x-forwarded-for is last because proxies append to
+* it and some let the client seed it. The first header present wins, so on a platform that sets only one of these a
+* client can spoof the IP by sending one ranked above it; set `ipHeaders` there.
+*/
+const DEFAULT_IP_HEADERS = [
+	"x-azure-clientip",
+	"x-client-ip",
+	"cf-connecting-ip",
+	"x-nf-client-connection-ip",
+	"x-real-ip",
+	"x-forwarded-for"
+];
+function header(headers, name) {
+	const value = headers[name];
+	return Array.isArray(value) ? value[0] : value;
+}
+/** Visitor IP from platform headers, without any port. Undefined when no header carries one. */
+function clientIp(headers, names = DEFAULT_IP_HEADERS) {
+	for (const name of names) {
+		const raw = header(headers, name)?.split(",")[0]?.trim();
+		if (!raw) continue;
+		const bracketed = raw.match(/^\[(.+)\]:\d+$/);
+		if (bracketed) return bracketed[1];
+		const ipv4WithPort = raw.match(/^(\d{1,3}(?:\.\d{1,3}){3}):\d+$/);
+		return ipv4WithPort ? ipv4WithPort[1] : raw;
+	}
+}
+function compileRules(events = {}) {
+	const compiled = /* @__PURE__ */ new Map();
+	for (const [name, rule] of Object.entries(events)) {
+		const entries = Object.entries(rule).map(([property, pattern]) => [property, pattern instanceof RegExp ? new RegExp(pattern.source, pattern.flags.replace(/[gy]/g, "")) : new RegExp(pattern)]);
+		if (entries.length === 0) throw new Error(`[@sjohansson/astro-plausible] Rule for event "${name}" lists no properties.`);
+		compiled.set(name, entries);
+	}
+	return compiled;
+}
+const PROPS_ALIASES = [
+	"m",
+	"meta",
+	"props"
+];
+/** Applies the rule for an event. Returns the props to forward, or null when the event is not valid. */
+function applyRule(rules, props) {
+	const source = props && typeof props === "object" ? props : {};
+	const kept = {};
+	for (const [property, pattern] of rules) {
+		const value = source[property];
+		if (typeof value !== "string" || !pattern.test(value)) return null;
+		kept[property] = value;
+	}
+	return kept;
+}
+const encoder = new TextEncoder();
+/** Reads a request body as text, or returns null as soon as it grows past `limit` bytes. */
+async function readBody(request, limit) {
+	if (!request.body) return "";
+	const reader = request.body.getReader();
+	const decoder = new TextDecoder();
+	let text = "";
+	let size = 0;
+	for (;;) {
+		const { done, value } = await reader.read();
+		if (done) return text + decoder.decode();
+		size += value.byteLength;
+		if (size > limit) {
+			await reader.cancel();
+			return null;
+		}
+		text += decoder.decode(value, { stream: true });
+	}
+}
+function headersToRecord(headers) {
+	const record = {};
+	headers.forEach((value, name) => {
+		record[name.toLowerCase()] = value;
+	});
+	return record;
+}
+function createRelay(options) {
+	const domains = new Set(Array.isArray(options.domain) ? options.domain : [options.domain]);
+	if (domains.size === 0 || [...domains].some((d) => typeof d !== "string" || d.length === 0)) throw new Error("[@sjohansson/astro-plausible] domain is required.");
+	const upstream = `${(options.upstream ?? "https://plausible.io").replace(/\/$/, "")}/api/event`;
+	const maxBodyLength = options.maxBodyLength ?? 16384;
+	const rules = compileRules(options.events);
+	const ipHeaders = options.ipHeaders?.map((name) => name.toLowerCase()) ?? DEFAULT_IP_HEADERS;
+	const relay = {
+		forward(rawBody, headers, ip) {
+			if (typeof rawBody !== "string" || rawBody.length === 0) return null;
+			if (rawBody.length > maxBodyLength || encoder.encode(rawBody).length > maxBodyLength) return null;
+			let event;
+			try {
+				event = JSON.parse(rawBody);
+			} catch {
+				return null;
+			}
+			if (!event || typeof event !== "object" || Array.isArray(event)) return null;
+			if (typeof event["d"] !== "string" || !domains.has(event["d"])) return null;
+			const name = event["n"];
+			if (typeof name !== "string" || name.length === 0) return null;
+			if (rules.has(name)) {
+				const kept = applyRule(rules.get(name) ?? [], event["p"]);
+				if (!kept) return null;
+				for (const alias of PROPS_ALIASES) delete event[alias];
+				event["p"] = kept;
+			}
+			const forwardHeaders = { "content-type": "application/json" };
+			const userAgent = header(headers, "user-agent");
+			if (userAgent) forwardHeaders["user-agent"] = userAgent;
+			const visitorIp = ip ?? clientIp(headers, ipHeaders);
+			if (visitorIp) forwardHeaders["x-forwarded-for"] = visitorIp;
+			return {
+				url: upstream,
+				body: JSON.stringify(event),
+				headers: forwardHeaders
+			};
+		},
+		async send(forward) {
+			const res = await fetch(forward.url, {
+				method: "POST",
+				headers: forward.headers,
+				body: forward.body
+			});
+			return {
+				status: res.status,
+				contentType: res.headers.get("content-type") ?? "text/plain",
+				body: await res.text()
+			};
+		},
+		async handle(request, context = {}) {
+			if (request.method !== "POST") return new Response(null, {
+				status: 405,
+				headers: { allow: "POST" }
+			});
+			if (Number(request.headers.get("content-length")) > maxBodyLength) return new Response(null, { status: 413 });
+			const body = await readBody(request, maxBodyLength);
+			if (body === null) return new Response(null, { status: 413 });
+			const forward = relay.forward(body, headersToRecord(request.headers), context.clientIp);
+			if (!forward) return new Response(null, { status: 400 });
+			try {
+				const result = await relay.send(forward);
+				return new Response(result.body, {
+					status: result.status,
+					headers: {
+						"content-type": result.contentType,
+						"cache-control": "no-store"
+					}
+				});
+			} catch (error) {
+				options.onError?.(error);
+				return new Response(null, { status: 502 });
+			}
+		}
+	};
+	return relay;
+}
+/**
+* Adapter for Azure Static Web Apps managed functions (Node, `function.json` model). `astro-plausible init` writes
+* a function that uses this.
+*/
+function swaHandler(relay) {
+	return async (context, req) => {
+		const forward = relay.forward(req.rawBody, req.headers ?? {});
+		if (!forward) {
+			context.res = { status: 400 };
+			return;
+		}
+		try {
+			const result = await relay.send(forward);
+			context.res = {
+				status: result.status,
+				headers: {
+					"content-type": result.contentType,
+					"cache-control": "no-store"
+				},
+				body: result.body
+			};
+		} catch (error) {
+			context.log.warn(`Plausible forward failed: ${error}`);
+			context.res = { status: 502 };
+		}
+	};
+}
+// src/templates/swa.ts
+const relay = createRelay(__ASTRO_PLAUSIBLE_RELAY_CONFIG__);
+var swa_default = swaHandler(relay);
+export { swa_default as default, relay };

package/package.json

@@ -1,6 +1,72 @@
 {
   "name": "@sjohansson/astro-plausible",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "First-party Plausible analytics for Astro sites. The official tracker is bundled into your site's own JavaScript and events go through a relay on your domain, so ad blockers do not drop them.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./integration": {
+      "types": "./dist/integration.d.ts",
+      "import": "./dist/integration.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js"
+    },
+    "./relay": {
+      "types": "./dist/relay.d.ts",
+      "import": "./dist/relay.js"
+    }
+  },
+  "bin": {
+    "astro-plausible": "./dist/bin.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "astro",
+    "astro-integration",
+    "plausible",
+    "analytics",
+    "privacy",
+    "proxy",
+    "static-site"
+  ],
+  "author": "sjohansson",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sjohansson/astro-components.git",
+    "directory": "packages/astro-plausible"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@plausible-analytics/tracker": "^0.4.7"
+  },
+  "peerDependencies": {
+    "astro": "^5.0.0 || ^6.0.0 || ^7.0.0"
+  },
+  "peerDependenciesMeta": {
+    "astro": {
+      "optional": true
+    }
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "clean": "node -e \"fs.rmSync('dist',{recursive:true,force:true})\"",
+    "test": "vitest"
+  }
 }