@pingaura/telemetry 0.1.0

package/dist/node.cjs

@@ -0,0 +1,51 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_core = require("./core-KgLaVgR4.cjs");
+const require_matchers = require("./matchers-CMwG37qc.cjs");
+//#region src/node.ts
+function header(headers, name) {
+	const v = headers[name] ?? headers[name.toLowerCase()];
+	return Array.isArray(v) ? v[0] : v;
+}
+/** Framework-agnostic page_view capture from a request-like object. */
+async function capturePageView(client, input) {
+	const ip = (header(input.headers, "x-forwarded-for") ?? "").split(",")[0]?.trim() || void 0;
+	let url = input.url;
+	let path;
+	try {
+		path = new URL(input.url).pathname;
+	} catch {
+		path = input.url.split("?")[0] ?? "/";
+		const host = header(input.headers, "host");
+		if (host) url = `${header(input.headers, "x-forwarded-proto") ?? "https"}://${host}${input.url}`;
+	}
+	await client.pageView({
+		url,
+		path,
+		referrer: header(input.headers, "referer"),
+		userAgent: header(input.headers, "user-agent"),
+		ip
+	});
+}
+/** Express/connect middleware. Fire-and-forget; always calls next(). */
+function analyticsMiddleware(config) {
+	const client = require_core.createClient(config);
+	const matcher = config.shouldTrack ?? require_matchers.shouldTrackPath;
+	return (req, _res, next) => {
+		try {
+			if (matcher(req.originalUrl.split("?")[0] ?? "/")) {
+				const host = req.get("host") ?? "localhost";
+				const url = `${req.protocol}://${host}${req.originalUrl}`;
+				capturePageView(client, {
+					headers: req.headers,
+					url
+				}).catch(() => {});
+			}
+		} catch {}
+		next();
+	};
+}
+//#endregion
+exports.analyticsMiddleware = analyticsMiddleware;
+exports.capturePageView = capturePageView;
+
+//# sourceMappingURL=node.cjs.map

package/dist/node.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.cjs","names":["createClient","shouldTrackPath"],"sources":["../src/node.ts"],"sourcesContent":["import { type AnalyticsClient, type ClientConfig, createClient } from './core';\nimport { shouldTrackPath } from './matchers';\n\ntype HeaderBag = Record<string, string | string[] | undefined>;\n\nfunction header(headers: HeaderBag, name: string): string | undefined {\n  const v = headers[name] ?? headers[name.toLowerCase()];\n  return Array.isArray(v) ? v[0] : v;\n}\n\nexport interface CaptureInput {\n  headers: HeaderBag;\n  url: string;\n}\n\n/** Framework-agnostic page_view capture from a request-like object. */\nexport async function capturePageView(\n  client: AnalyticsClient,\n  input: CaptureInput,\n): Promise<void> {\n  const xff = header(input.headers, 'x-forwarded-for') ?? '';\n  const ip = xff.split(',')[0]?.trim() || undefined;\n  let url = input.url;\n  let path: string;\n  try {\n    path = new URL(input.url).pathname;\n  } catch {\n    // bare path (e.g. \"/pricing\") — rebuild an absolute URL from Host, else the collector rejects the batch\n    path = input.url.split('?')[0] ?? '/';\n    const host = header(input.headers, 'host');\n    if (host) {\n      const proto = header(input.headers, 'x-forwarded-proto') ?? 'https';\n      url = `${proto}://${host}${input.url}`;\n    }\n  }\n  await client.pageView({\n    url,\n    path,\n    referrer: header(input.headers, 'referer'),\n    userAgent: header(input.headers, 'user-agent'),\n    ip,\n  });\n}\n\ninterface ExpressReqLike {\n  originalUrl: string;\n  protocol: string;\n  headers: HeaderBag;\n  get(name: string): string | undefined;\n}\ntype NextFn = () => void;\n\nexport interface NodeMiddlewareConfig extends ClientConfig {\n  shouldTrack?: (pathname: string) => boolean;\n}\n\n/** Express/connect middleware. Fire-and-forget; always calls next(). */\nexport function analyticsMiddleware(\n  config: NodeMiddlewareConfig,\n): (req: ExpressReqLike, _res: unknown, next: NextFn) => void {\n  const client = createClient(config);\n  const matcher = config.shouldTrack ?? shouldTrackPath;\n\n  return (req, _res, next) => {\n    try {\n      const pathname = req.originalUrl.split('?')[0] ?? '/';\n      if (matcher(pathname)) {\n        const host = req.get('host') ?? 'localhost';\n        const url = `${req.protocol}://${host}${req.originalUrl}`;\n        // catch the build/send rejection so a voided promise never becomes a fatal unhandled rejection\n        void capturePageView(client, { headers: req.headers, url }).catch(\n          () => {\n            // never block the request\n          },\n        );\n      }\n    } catch {\n      // never block the request\n    }\n    next();\n  };\n}\n"],"mappings":";;;;AAKA,SAAS,OAAO,SAAoB,MAAkC;CACpE,MAAM,IAAI,QAAQ,SAAS,QAAQ,KAAK,YAAY;CACpD,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,KAAK;AACnC;;AAQA,eAAsB,gBACpB,QACA,OACe;CAEf,MAAM,MADM,OAAO,MAAM,SAAS,iBAAiB,KAAK,GAAA,CACzC,MAAM,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,KAAK,KAAA;CACxC,IAAI,MAAM,MAAM;CAChB,IAAI;CACJ,IAAI;EACF,OAAO,IAAI,IAAI,MAAM,GAAG,CAAC,CAAC;CAC5B,QAAQ;EAEN,OAAO,MAAM,IAAI,MAAM,GAAG,CAAC,CAAC,MAAM;EAClC,MAAM,OAAO,OAAO,MAAM,SAAS,MAAM;EACzC,IAAI,MAEF,MAAM,GADQ,OAAO,MAAM,SAAS,mBAAmB,KAAK,QAC7C,KAAK,OAAO,MAAM;CAErC;CACA,MAAM,OAAO,SAAS;EACpB;EACA;EACA,UAAU,OAAO,MAAM,SAAS,SAAS;EACzC,WAAW,OAAO,MAAM,SAAS,YAAY;EAC7C;CACF,CAAC;AACH;;AAeA,SAAgB,oBACd,QAC4D;CAC5D,MAAM,SAASA,aAAAA,aAAa,MAAM;CAClC,MAAM,UAAU,OAAO,eAAeC,iBAAAA;CAEtC,QAAQ,KAAK,MAAM,SAAS;EAC1B,IAAI;GAEF,IAAI,QADa,IAAI,YAAY,MAAM,GAAG,CAAC,CAAC,MAAM,GAC9B,GAAG;IACrB,MAAM,OAAO,IAAI,IAAI,MAAM,KAAK;IAChC,MAAM,MAAM,GAAG,IAAI,SAAS,KAAK,OAAO,IAAI;IAE5C,gBAAqB,QAAQ;KAAE,SAAS,IAAI;KAAS;IAAI,CAAC,CAAC,CAAC,YACpD,CAEN,CACF;GACF;EACF,QAAQ,CAER;EACA,KAAK;CACP;AACF"}

package/dist/node.d.cts

@@ -0,0 +1,25 @@
+import { n as ClientConfig, t as AnalyticsClient } from "./core-DVilpn_i.cjs";
+
+//#region src/node.d.ts
+type HeaderBag = Record<string, string | string[] | undefined>;
+interface CaptureInput {
+  headers: HeaderBag;
+  url: string;
+}
+/** Framework-agnostic page_view capture from a request-like object. */
+declare function capturePageView(client: AnalyticsClient, input: CaptureInput): Promise<void>;
+interface ExpressReqLike {
+  originalUrl: string;
+  protocol: string;
+  headers: HeaderBag;
+  get(name: string): string | undefined;
+}
+type NextFn = () => void;
+interface NodeMiddlewareConfig extends ClientConfig {
+  shouldTrack?: (pathname: string) => boolean;
+}
+/** Express/connect middleware. Fire-and-forget; always calls next(). */
+declare function analyticsMiddleware(config: NodeMiddlewareConfig): (req: ExpressReqLike, _res: unknown, next: NextFn) => void;
+//#endregion
+export { CaptureInput, NodeMiddlewareConfig, analyticsMiddleware, capturePageView };
+//# sourceMappingURL=node.d.cts.map

package/dist/node.d.mts

@@ -0,0 +1,25 @@
+import { n as ClientConfig, t as AnalyticsClient } from "./core-DVilpn_i.mjs";
+
+//#region src/node.d.ts
+type HeaderBag = Record<string, string | string[] | undefined>;
+interface CaptureInput {
+  headers: HeaderBag;
+  url: string;
+}
+/** Framework-agnostic page_view capture from a request-like object. */
+declare function capturePageView(client: AnalyticsClient, input: CaptureInput): Promise<void>;
+interface ExpressReqLike {
+  originalUrl: string;
+  protocol: string;
+  headers: HeaderBag;
+  get(name: string): string | undefined;
+}
+type NextFn = () => void;
+interface NodeMiddlewareConfig extends ClientConfig {
+  shouldTrack?: (pathname: string) => boolean;
+}
+/** Express/connect middleware. Fire-and-forget; always calls next(). */
+declare function analyticsMiddleware(config: NodeMiddlewareConfig): (req: ExpressReqLike, _res: unknown, next: NextFn) => void;
+//#endregion
+export { CaptureInput, NodeMiddlewareConfig, analyticsMiddleware, capturePageView };
+//# sourceMappingURL=node.d.mts.map

package/dist/node.mjs

@@ -0,0 +1,49 @@
+import { t as createClient } from "./core-Cvg8zn6Q.mjs";
+import { t as shouldTrackPath } from "./matchers-CUD5NL5K.mjs";
+//#region src/node.ts
+function header(headers, name) {
+	const v = headers[name] ?? headers[name.toLowerCase()];
+	return Array.isArray(v) ? v[0] : v;
+}
+/** Framework-agnostic page_view capture from a request-like object. */
+async function capturePageView(client, input) {
+	const ip = (header(input.headers, "x-forwarded-for") ?? "").split(",")[0]?.trim() || void 0;
+	let url = input.url;
+	let path;
+	try {
+		path = new URL(input.url).pathname;
+	} catch {
+		path = input.url.split("?")[0] ?? "/";
+		const host = header(input.headers, "host");
+		if (host) url = `${header(input.headers, "x-forwarded-proto") ?? "https"}://${host}${input.url}`;
+	}
+	await client.pageView({
+		url,
+		path,
+		referrer: header(input.headers, "referer"),
+		userAgent: header(input.headers, "user-agent"),
+		ip
+	});
+}
+/** Express/connect middleware. Fire-and-forget; always calls next(). */
+function analyticsMiddleware(config) {
+	const client = createClient(config);
+	const matcher = config.shouldTrack ?? shouldTrackPath;
+	return (req, _res, next) => {
+		try {
+			if (matcher(req.originalUrl.split("?")[0] ?? "/")) {
+				const host = req.get("host") ?? "localhost";
+				const url = `${req.protocol}://${host}${req.originalUrl}`;
+				capturePageView(client, {
+					headers: req.headers,
+					url
+				}).catch(() => {});
+			}
+		} catch {}
+		next();
+	};
+}
+//#endregion
+export { analyticsMiddleware, capturePageView };
+
+//# sourceMappingURL=node.mjs.map

package/dist/node.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.mjs","names":[],"sources":["../src/node.ts"],"sourcesContent":["import { type AnalyticsClient, type ClientConfig, createClient } from './core';\nimport { shouldTrackPath } from './matchers';\n\ntype HeaderBag = Record<string, string | string[] | undefined>;\n\nfunction header(headers: HeaderBag, name: string): string | undefined {\n  const v = headers[name] ?? headers[name.toLowerCase()];\n  return Array.isArray(v) ? v[0] : v;\n}\n\nexport interface CaptureInput {\n  headers: HeaderBag;\n  url: string;\n}\n\n/** Framework-agnostic page_view capture from a request-like object. */\nexport async function capturePageView(\n  client: AnalyticsClient,\n  input: CaptureInput,\n): Promise<void> {\n  const xff = header(input.headers, 'x-forwarded-for') ?? '';\n  const ip = xff.split(',')[0]?.trim() || undefined;\n  let url = input.url;\n  let path: string;\n  try {\n    path = new URL(input.url).pathname;\n  } catch {\n    // bare path (e.g. \"/pricing\") — rebuild an absolute URL from Host, else the collector rejects the batch\n    path = input.url.split('?')[0] ?? '/';\n    const host = header(input.headers, 'host');\n    if (host) {\n      const proto = header(input.headers, 'x-forwarded-proto') ?? 'https';\n      url = `${proto}://${host}${input.url}`;\n    }\n  }\n  await client.pageView({\n    url,\n    path,\n    referrer: header(input.headers, 'referer'),\n    userAgent: header(input.headers, 'user-agent'),\n    ip,\n  });\n}\n\ninterface ExpressReqLike {\n  originalUrl: string;\n  protocol: string;\n  headers: HeaderBag;\n  get(name: string): string | undefined;\n}\ntype NextFn = () => void;\n\nexport interface NodeMiddlewareConfig extends ClientConfig {\n  shouldTrack?: (pathname: string) => boolean;\n}\n\n/** Express/connect middleware. Fire-and-forget; always calls next(). */\nexport function analyticsMiddleware(\n  config: NodeMiddlewareConfig,\n): (req: ExpressReqLike, _res: unknown, next: NextFn) => void {\n  const client = createClient(config);\n  const matcher = config.shouldTrack ?? shouldTrackPath;\n\n  return (req, _res, next) => {\n    try {\n      const pathname = req.originalUrl.split('?')[0] ?? '/';\n      if (matcher(pathname)) {\n        const host = req.get('host') ?? 'localhost';\n        const url = `${req.protocol}://${host}${req.originalUrl}`;\n        // catch the build/send rejection so a voided promise never becomes a fatal unhandled rejection\n        void capturePageView(client, { headers: req.headers, url }).catch(\n          () => {\n            // never block the request\n          },\n        );\n      }\n    } catch {\n      // never block the request\n    }\n    next();\n  };\n}\n"],"mappings":";;;AAKA,SAAS,OAAO,SAAoB,MAAkC;CACpE,MAAM,IAAI,QAAQ,SAAS,QAAQ,KAAK,YAAY;CACpD,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,KAAK;AACnC;;AAQA,eAAsB,gBACpB,QACA,OACe;CAEf,MAAM,MADM,OAAO,MAAM,SAAS,iBAAiB,KAAK,GAAA,CACzC,MAAM,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,KAAK,KAAA;CACxC,IAAI,MAAM,MAAM;CAChB,IAAI;CACJ,IAAI;EACF,OAAO,IAAI,IAAI,MAAM,GAAG,CAAC,CAAC;CAC5B,QAAQ;EAEN,OAAO,MAAM,IAAI,MAAM,GAAG,CAAC,CAAC,MAAM;EAClC,MAAM,OAAO,OAAO,MAAM,SAAS,MAAM;EACzC,IAAI,MAEF,MAAM,GADQ,OAAO,MAAM,SAAS,mBAAmB,KAAK,QAC7C,KAAK,OAAO,MAAM;CAErC;CACA,MAAM,OAAO,SAAS;EACpB;EACA;EACA,UAAU,OAAO,MAAM,SAAS,SAAS;EACzC,WAAW,OAAO,MAAM,SAAS,YAAY;EAC7C;CACF,CAAC;AACH;;AAeA,SAAgB,oBACd,QAC4D;CAC5D,MAAM,SAAS,aAAa,MAAM;CAClC,MAAM,UAAU,OAAO,eAAe;CAEtC,QAAQ,KAAK,MAAM,SAAS;EAC1B,IAAI;GAEF,IAAI,QADa,IAAI,YAAY,MAAM,GAAG,CAAC,CAAC,MAAM,GAC9B,GAAG;IACrB,MAAM,OAAO,IAAI,IAAI,MAAM,KAAK;IAChC,MAAM,MAAM,GAAG,IAAI,SAAS,KAAK,OAAO,IAAI;IAE5C,gBAAqB,QAAQ;KAAE,SAAS,IAAI;KAAS;IAAI,CAAC,CAAC,CAAC,YACpD,CAEN,CACF;GACF;EACF,QAAQ,CAER;EACA,KAAK;CACP;AACF"}

package/package.json

@@ -0,0 +1,104 @@
+{
+  "name": "@pingaura/telemetry",
+  "version": "0.1.0",
+  "description": "PingAura first-party analytics — Node / Next.js / Cloudflare Workers server SDK",
+  "license": "Apache-2.0",
+  "author": "PingAura AI",
+  "homepage": "https://www.pingaura.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pingaura-ai/pingaura-telemetry-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/pingaura-ai/pingaura-telemetry-sdk/issues"
+  },
+  "keywords": [
+    "analytics",
+    "telemetry",
+    "first-party-analytics",
+    "pingaura",
+    "nextjs",
+    "cloudflare-workers"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.cts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./next": {
+      "import": {
+        "types": "./dist/next.d.mts",
+        "default": "./dist/next.mjs"
+      },
+      "require": {
+        "types": "./dist/next.d.cts",
+        "default": "./dist/next.cjs"
+      }
+    },
+    "./node": {
+      "import": {
+        "types": "./dist/node.d.mts",
+        "default": "./dist/node.mjs"
+      },
+      "require": {
+        "types": "./dist/node.d.cts",
+        "default": "./dist/node.cjs"
+      }
+    },
+    "./cloudflare": {
+      "import": {
+        "types": "./dist/cloudflare.d.mts",
+        "default": "./dist/cloudflare.mjs"
+      },
+      "require": {
+        "types": "./dist/cloudflare.d.cts",
+        "default": "./dist/cloudflare.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "format": "prettier --write .",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "pnpm run build"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^26.0.1",
+    "eslint": "^10.5.0",
+    "prettier": "^3.8.4",
+    "tsdown": "^0.22.3",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.62.0",
+    "vitest": "^4.1.9"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "esbuild"
+    ]
+  }
+}