@aranova/tracking-next 0.2.2

package/dist/server.js

@@ -0,0 +1,72 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/server.ts
+var server_exports = {};
+__export(server_exports, {
+  getTrackingParamsServer: () => getTrackingParamsServer
+});
+module.exports = __toCommonJS(server_exports);
+var import_server_only = require("server-only");
+var import_headers = require("next/headers");
+
+// ../tracking-core/src/tracking.ts
+var TRACKING_PARAM_KEYS = [
+  "gclid",
+  "fbclid",
+  "utm_source",
+  "utm_medium",
+  "utm_campaign",
+  "utm_term",
+  "utm_content"
+];
+function createEmptyTrackingParams() {
+  return {
+    gclid: null,
+    fbclid: null,
+    utm_source: null,
+    utm_medium: null,
+    utm_campaign: null,
+    utm_term: null,
+    utm_content: null
+  };
+}
+function normalizeTrackingCookieValue(value) {
+  return typeof value === "string" && value.length > 0 ? value : null;
+}
+function getTrackingParamsFromCookieReader(readCookie) {
+  return TRACKING_PARAM_KEYS.reduce((params, key) => {
+    params[key] = normalizeTrackingCookieValue(readCookie(key));
+    return params;
+  }, createEmptyTrackingParams());
+}
+
+// src/server.ts
+function getCookieStore() {
+  return (0, import_headers.cookies)();
+}
+function getTrackingParamsServer() {
+  const cookieStore = getCookieStore();
+  return getTrackingParamsFromCookieReader((key) => cookieStore.get(key)?.value);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getTrackingParamsServer
+});
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server.ts","../../tracking-core/src/tracking.ts"],"sourcesContent":["import 'server-only';\n\nimport { cookies } from 'next/headers';\n\nimport { getTrackingParamsFromCookieReader, type TrackingParams } from '../../tracking-core/src/index';\n\ninterface CookieValue {\n  value: string;\n}\n\ninterface CookieStore {\n  get(name: string): CookieValue | undefined;\n}\n\nfunction getCookieStore(): CookieStore {\n  return cookies() as unknown as CookieStore;\n}\n\nexport function getTrackingParamsServer(): TrackingParams {\n  const cookieStore = getCookieStore();\n  return getTrackingParamsFromCookieReader((key) => cookieStore.get(key)?.value);\n}\n","import type { TrackingParams } from './types';\n\nexport const TRACKING_COOKIE_MAX_AGE_SECONDS = 7_776_000;\n\nexport const TRACKING_PARAM_KEYS = [\n  'gclid',\n  'fbclid',\n  'utm_source',\n  'utm_medium',\n  'utm_campaign',\n  'utm_term',\n  'utm_content',\n] as const;\n\nexport type TrackingParamKey = (typeof TRACKING_PARAM_KEYS)[number];\n\nexport function createEmptyTrackingParams(): TrackingParams {\n  return {\n    gclid: null,\n    fbclid: null,\n    utm_source: null,\n    utm_medium: null,\n    utm_campaign: null,\n    utm_term: null,\n    utm_content: null,\n  };\n}\n\nexport function normalizeTrackingCookieValue(value: unknown): string | null {\n  return typeof value === 'string' && value.length > 0 ? value : null;\n}\n\nexport function getTrackingParamsFromCookieReader(\n  readCookie: (key: TrackingParamKey) => unknown,\n): TrackingParams {\n  return TRACKING_PARAM_KEYS.reduce<TrackingParams>((params, key) => {\n    params[key] = normalizeTrackingCookieValue(readCookie(key));\n    return params;\n  }, createEmptyTrackingParams());\n}\n\nexport function getTrackingQueryValues(\n  searchParams: Pick<URLSearchParams, 'get'>,\n): Partial<Record<TrackingParamKey, string>> {\n  return TRACKING_PARAM_KEYS.reduce<Partial<Record<TrackingParamKey, string>>>((params, key) => {\n    const value = searchParams.get(key);\n\n    if (typeof value === 'string' && value.trim().length > 0) {\n      params[key] = value;\n    }\n\n    return params;\n  }, {});\n}\n\nexport function getCookieValueFromDocument(key: TrackingParamKey): string | null {\n  if (typeof document === 'undefined')\n    return null;\n\n  const cookies = document.cookie ? document.cookie.split('; ') : [];\n  const match = cookies.find((cookie) => cookie.startsWith(`${key}=`));\n\n  if (!match)\n    return null;\n\n  const [, rawValue = ''] = match.split('=');\n  return normalizeTrackingCookieValue(decodeURIComponent(rawValue));\n}\n\nexport function setTrackingCookie(\n  key: TrackingParamKey,\n  value: string,\n  maxAgeSeconds = TRACKING_COOKIE_MAX_AGE_SECONDS,\n): void {\n  if (typeof document === 'undefined')\n    return;\n\n  const encodedValue = encodeURIComponent(value);\n  document.cookie = `${key}=${encodedValue}; Max-Age=${maxAgeSeconds}; Path=/; SameSite=Lax`;\n}\n\nexport function persistTrackingParamsFromSearchParams(\n  searchParams: Pick<URLSearchParams, 'get'>,\n  maxAgeSeconds = TRACKING_COOKIE_MAX_AGE_SECONDS,\n): Partial<Record<TrackingParamKey, string>> {\n  const trackingValues = getTrackingQueryValues(searchParams);\n\n  Object.entries(trackingValues).forEach(([key, value]) => {\n    setTrackingCookie(key as TrackingParamKey, value, maxAgeSeconds);\n  });\n\n  return trackingValues;\n}\n\nexport function captureTrackingParamsFromLocation(\n  url = typeof window === 'undefined' ? '' : window.location.href,\n  maxAgeSeconds = TRACKING_COOKIE_MAX_AGE_SECONDS,\n): TrackingParams {\n  const resolvedUrl = typeof window === 'undefined'\n    ? new URL(url || 'https://example.invalid')\n    : new URL(url, window.location.origin);\n  persistTrackingParamsFromSearchParams(resolvedUrl.searchParams, maxAgeSeconds);\n  return getTrackingParamsFromCookieReader(getCookieValueFromDocument);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yBAAO;AAEP,qBAAwB;;;ACEjB,IAAM,sBAAsB;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAIO,SAAS,4BAA4C;AAC1D,SAAO;AAAA,IACL,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,YAAY;AAAA,IACZ,YAAY;AAAA,IACZ,cAAc;AAAA,IACd,UAAU;AAAA,IACV,aAAa;AAAA,EACf;AACF;AAEO,SAAS,6BAA6B,OAA+B;AAC1E,SAAO,OAAO,UAAU,YAAY,MAAM,SAAS,IAAI,QAAQ;AACjE;AAEO,SAAS,kCACd,YACgB;AAChB,SAAO,oBAAoB,OAAuB,CAAC,QAAQ,QAAQ;AACjE,WAAO,GAAG,IAAI,6BAA6B,WAAW,GAAG,CAAC;AAC1D,WAAO;AAAA,EACT,GAAG,0BAA0B,CAAC;AAChC;;;ADzBA,SAAS,iBAA8B;AACrC,aAAO,wBAAQ;AACjB;AAEO,SAAS,0BAA0C;AACxD,QAAM,cAAc,eAAe;AACnC,SAAO,kCAAkC,CAAC,QAAQ,YAAY,IAAI,GAAG,GAAG,KAAK;AAC/E;","names":[]}

package/dist/server.mjs

@@ -0,0 +1,47 @@
+// src/server.ts
+import "server-only";
+import { cookies } from "next/headers";
+
+// ../tracking-core/src/tracking.ts
+var TRACKING_PARAM_KEYS = [
+  "gclid",
+  "fbclid",
+  "utm_source",
+  "utm_medium",
+  "utm_campaign",
+  "utm_term",
+  "utm_content"
+];
+function createEmptyTrackingParams() {
+  return {
+    gclid: null,
+    fbclid: null,
+    utm_source: null,
+    utm_medium: null,
+    utm_campaign: null,
+    utm_term: null,
+    utm_content: null
+  };
+}
+function normalizeTrackingCookieValue(value) {
+  return typeof value === "string" && value.length > 0 ? value : null;
+}
+function getTrackingParamsFromCookieReader(readCookie) {
+  return TRACKING_PARAM_KEYS.reduce((params, key) => {
+    params[key] = normalizeTrackingCookieValue(readCookie(key));
+    return params;
+  }, createEmptyTrackingParams());
+}
+
+// src/server.ts
+function getCookieStore() {
+  return cookies();
+}
+function getTrackingParamsServer() {
+  const cookieStore = getCookieStore();
+  return getTrackingParamsFromCookieReader((key) => cookieStore.get(key)?.value);
+}
+export {
+  getTrackingParamsServer
+};
+//# sourceMappingURL=server.mjs.map

package/dist/server.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server.ts","../../tracking-core/src/tracking.ts"],"sourcesContent":["import 'server-only';\n\nimport { cookies } from 'next/headers';\n\nimport { getTrackingParamsFromCookieReader, type TrackingParams } from '../../tracking-core/src/index';\n\ninterface CookieValue {\n  value: string;\n}\n\ninterface CookieStore {\n  get(name: string): CookieValue | undefined;\n}\n\nfunction getCookieStore(): CookieStore {\n  return cookies() as unknown as CookieStore;\n}\n\nexport function getTrackingParamsServer(): TrackingParams {\n  const cookieStore = getCookieStore();\n  return getTrackingParamsFromCookieReader((key) => cookieStore.get(key)?.value);\n}\n","import type { TrackingParams } from './types';\n\nexport const TRACKING_COOKIE_MAX_AGE_SECONDS = 7_776_000;\n\nexport const TRACKING_PARAM_KEYS = [\n  'gclid',\n  'fbclid',\n  'utm_source',\n  'utm_medium',\n  'utm_campaign',\n  'utm_term',\n  'utm_content',\n] as const;\n\nexport type TrackingParamKey = (typeof TRACKING_PARAM_KEYS)[number];\n\nexport function createEmptyTrackingParams(): TrackingParams {\n  return {\n    gclid: null,\n    fbclid: null,\n    utm_source: null,\n    utm_medium: null,\n    utm_campaign: null,\n    utm_term: null,\n    utm_content: null,\n  };\n}\n\nexport function normalizeTrackingCookieValue(value: unknown): string | null {\n  return typeof value === 'string' && value.length > 0 ? value : null;\n}\n\nexport function getTrackingParamsFromCookieReader(\n  readCookie: (key: TrackingParamKey) => unknown,\n): TrackingParams {\n  return TRACKING_PARAM_KEYS.reduce<TrackingParams>((params, key) => {\n    params[key] = normalizeTrackingCookieValue(readCookie(key));\n    return params;\n  }, createEmptyTrackingParams());\n}\n\nexport function getTrackingQueryValues(\n  searchParams: Pick<URLSearchParams, 'get'>,\n): Partial<Record<TrackingParamKey, string>> {\n  return TRACKING_PARAM_KEYS.reduce<Partial<Record<TrackingParamKey, string>>>((params, key) => {\n    const value = searchParams.get(key);\n\n    if (typeof value === 'string' && value.trim().length > 0) {\n      params[key] = value;\n    }\n\n    return params;\n  }, {});\n}\n\nexport function getCookieValueFromDocument(key: TrackingParamKey): string | null {\n  if (typeof document === 'undefined')\n    return null;\n\n  const cookies = document.cookie ? document.cookie.split('; ') : [];\n  const match = cookies.find((cookie) => cookie.startsWith(`${key}=`));\n\n  if (!match)\n    return null;\n\n  const [, rawValue = ''] = match.split('=');\n  return normalizeTrackingCookieValue(decodeURIComponent(rawValue));\n}\n\nexport function setTrackingCookie(\n  key: TrackingParamKey,\n  value: string,\n  maxAgeSeconds = TRACKING_COOKIE_MAX_AGE_SECONDS,\n): void {\n  if (typeof document === 'undefined')\n    return;\n\n  const encodedValue = encodeURIComponent(value);\n  document.cookie = `${key}=${encodedValue}; Max-Age=${maxAgeSeconds}; Path=/; SameSite=Lax`;\n}\n\nexport function persistTrackingParamsFromSearchParams(\n  searchParams: Pick<URLSearchParams, 'get'>,\n  maxAgeSeconds = TRACKING_COOKIE_MAX_AGE_SECONDS,\n): Partial<Record<TrackingParamKey, string>> {\n  const trackingValues = getTrackingQueryValues(searchParams);\n\n  Object.entries(trackingValues).forEach(([key, value]) => {\n    setTrackingCookie(key as TrackingParamKey, value, maxAgeSeconds);\n  });\n\n  return trackingValues;\n}\n\nexport function captureTrackingParamsFromLocation(\n  url = typeof window === 'undefined' ? '' : window.location.href,\n  maxAgeSeconds = TRACKING_COOKIE_MAX_AGE_SECONDS,\n): TrackingParams {\n  const resolvedUrl = typeof window === 'undefined'\n    ? new URL(url || 'https://example.invalid')\n    : new URL(url, window.location.origin);\n  persistTrackingParamsFromSearchParams(resolvedUrl.searchParams, maxAgeSeconds);\n  return getTrackingParamsFromCookieReader(getCookieValueFromDocument);\n}\n"],"mappings":";AAAA,OAAO;AAEP,SAAS,eAAe;;;ACEjB,IAAM,sBAAsB;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAIO,SAAS,4BAA4C;AAC1D,SAAO;AAAA,IACL,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,YAAY;AAAA,IACZ,YAAY;AAAA,IACZ,cAAc;AAAA,IACd,UAAU;AAAA,IACV,aAAa;AAAA,EACf;AACF;AAEO,SAAS,6BAA6B,OAA+B;AAC1E,SAAO,OAAO,UAAU,YAAY,MAAM,SAAS,IAAI,QAAQ;AACjE;AAEO,SAAS,kCACd,YACgB;AAChB,SAAO,oBAAoB,OAAuB,CAAC,QAAQ,QAAQ;AACjE,WAAO,GAAG,IAAI,6BAA6B,WAAW,GAAG,CAAC;AAC1D,WAAO;AAAA,EACT,GAAG,0BAA0B,CAAC;AAChC;;;ADzBA,SAAS,iBAA8B;AACrC,SAAO,QAAQ;AACjB;AAEO,SAAS,0BAA0C;AACxD,QAAM,cAAc,eAAe;AACnC,SAAO,kCAAkC,CAAC,QAAQ,YAAY,IAAI,GAAG,GAAG,KAAK;AAC/E;","names":[]}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@aranova/tracking-next",
+  "version": "0.2.2",
+  "private": false,
+  "description": "Next.js tracking utilities for Aranova client sites",
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AranovaIO/aranova_internal.git",
+    "directory": "packages/tracking-next"
+  },
+  "homepage": "https://github.com/AranovaIO/aranova_internal/tree/master/packages/tracking-next",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.mjs",
+      "require": "./dist/server.js"
+    },
+    "./middleware": {
+      "types": "./dist/middleware.d.ts",
+      "import": "./dist/middleware.mjs",
+      "require": "./dist/middleware.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "next": ">=14.0.0",
+    "react": ">=18.0.0"
+  },
+  "dependencies": {
+    "server-only": "^0.0.1"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.2",
+    "jsdom": "^29.0.1",
+    "react": "^19.2.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.7.3",
+    "vitest": "^4.1.4"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  }
+}