@atsignal/browser-plugin-enrich-context 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NETHRU Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,25 @@
+# `@atsignal/browser-plugin-enrich-context`
+
+Browser plugin that enriches Signal events with browser environment and attribution context.
+
+## Install
+
+```bash
+pnpm add @atsignal/browser @atsignal/browser-plugin-enrich-context
+```
+
+## Usage
+
+```ts
+import signal from "@atsignal/browser";
+import "@atsignal/browser-plugin-enrich-context";
+
+await signal.init("your-api-key", {
+  persistQueue: false,
+  plugins: [signal.plugins.enrichContext()],
+});
+```
+
+Load the browser global base bundle first, then the plugin global bundle if you are using script tags.
+
+More SDK details live in the monorepo root README.

package/dist/index.cjs

@@ -0,0 +1,301 @@
+"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/index.ts
+var src_exports = {};
+__export(src_exports, {
+  enrichContext: () => enrichContext
+});
+module.exports = __toCommonJS(src_exports);
+var import_browser = require("@atsignal/browser");
+
+// src/factory.ts
+var ENV_NAMESPACE = "@env";
+var ATTR_NAMESPACE = "@attr";
+var EventContext = class {
+  document() {
+    var _a;
+    if (this._document !== void 0) {
+      return (_a = this._document) != null ? _a : void 0;
+    }
+    const documentValue = typeof document === "undefined" ? null : document;
+    this._document = documentValue;
+    return documentValue != null ? documentValue : void 0;
+  }
+  location() {
+    var _a;
+    if (this._location !== void 0) {
+      return (_a = this._location) != null ? _a : void 0;
+    }
+    const locationValue = typeof location === "undefined" ? null : location;
+    this._location = locationValue;
+    return locationValue != null ? locationValue : void 0;
+  }
+  searchParams() {
+    var _a;
+    if (this._searchParams !== void 0) {
+      return this._searchParams;
+    }
+    const search = normalizeOptionalString((_a = this.location()) == null ? void 0 : _a.search);
+    this._searchParams = search ? new URLSearchParams(search) : null;
+    return this._searchParams;
+  }
+};
+var ENV_STATIC_COLLECTORS = Object.freeze({
+  language: getLanguage,
+  platform: getPlatform
+});
+var ENV_DYNAMIC_COLLECTORS = Object.freeze({
+  current_url: (context) => {
+    var _a;
+    return normalizeOptionalString((_a = context.location()) == null ? void 0 : _a.href);
+  },
+  current_path: (context) => {
+    var _a;
+    return normalizeOptionalString((_a = context.location()) == null ? void 0 : _a.pathname);
+  },
+  current_title: (context) => {
+    var _a;
+    return normalizeOptionalString((_a = context.document()) == null ? void 0 : _a.title);
+  },
+  current_hostname: (context) => {
+    var _a;
+    return normalizeOptionalString((_a = context.location()) == null ? void 0 : _a.hostname);
+  }
+});
+var ATTR_QUERY_PARAMETER_KEYS = Object.freeze([
+  "utm_source",
+  "utm_medium",
+  "utm_campaign",
+  "utm_term",
+  "utm_content",
+  "utm_id",
+  "utm_source_platform",
+  "utm_campaign_id",
+  "utm_creative_format",
+  "utm_marketing_tactic",
+  "gclid",
+  "dclid",
+  "fbclid",
+  "ko_click_id",
+  "li_fat_id",
+  "msclkid",
+  "ttclid",
+  "twclid",
+  "wbraid",
+  "gbraid",
+  "rdt_cid",
+  "sccid"
+]);
+function createAttrDynamicCollectors() {
+  const collectors = /* @__PURE__ */ Object.create(null);
+  for (const key of ATTR_QUERY_PARAMETER_KEYS) {
+    collectors[key] = (context) => {
+      var _a;
+      return normalizeOptionalString((_a = context.searchParams()) == null ? void 0 : _a.get(key));
+    };
+  }
+  return Object.freeze(collectors);
+}
+var ATTR_DYNAMIC_COLLECTORS = createAttrDynamicCollectors();
+function normalizeOptionalString(value) {
+  if (typeof value !== "string" || value.length === 0) {
+    return void 0;
+  }
+  return value;
+}
+function getNavigator() {
+  return typeof navigator === "undefined" ? void 0 : navigator;
+}
+function getLanguage() {
+  var _a;
+  return normalizeOptionalString((_a = getNavigator()) == null ? void 0 : _a.language);
+}
+function getPlatform() {
+  var _a, _b;
+  const currentNavigator = getNavigator();
+  return (_b = normalizeOptionalString((_a = currentNavigator == null ? void 0 : currentNavigator.userAgentData) == null ? void 0 : _a.platform)) != null ? _b : normalizeOptionalString(currentNavigator == null ? void 0 : currentNavigator.platform);
+}
+function getReferrer() {
+  return normalizeOptionalString(
+    typeof document === "undefined" ? void 0 : document.referrer
+  );
+}
+function getReferringHostFromReferrer(referrer) {
+  if (!referrer) {
+    return void 0;
+  }
+  try {
+    return normalizeOptionalString(new URL(referrer).hostname);
+  } catch (e) {
+    return void 0;
+  }
+}
+function buildAttrStaticEntries(blockedKeys) {
+  if (blockedKeys.has("referrer") && blockedKeys.has("referring_host")) {
+    return [];
+  }
+  const values = [];
+  const referrer = getReferrer();
+  if (!blockedKeys.has("referrer") && referrer !== void 0) {
+    values.push(["referrer", referrer]);
+  }
+  if (!blockedKeys.has("referring_host")) {
+    const referringHost = getReferringHostFromReferrer(referrer);
+    if (referringHost !== void 0) {
+      values.push(["referring_host", referringHost]);
+    }
+  }
+  return values;
+}
+function parseBlockedNamespace(blockedProperties, namespace) {
+  const blockedKeys = /* @__PURE__ */ new Set();
+  const prefix = `${namespace}/`;
+  let namespaceBlocked = false;
+  for (const blockedProperty of blockedProperties) {
+    if (blockedProperty === namespace) {
+      namespaceBlocked = true;
+      continue;
+    }
+    if (!blockedProperty.startsWith(prefix)) {
+      continue;
+    }
+    const blockedKey = blockedProperty.slice(prefix.length);
+    if (blockedKey.length > 0) {
+      blockedKeys.add(blockedKey);
+    }
+  }
+  return {
+    namespaceBlocked,
+    blockedKeys
+  };
+}
+function buildStaticEntries(collectors, blockedKeys) {
+  const values = [];
+  for (const [key, collect] of Object.entries(collectors)) {
+    if (blockedKeys.has(key)) {
+      continue;
+    }
+    const value = collect();
+    if (value === void 0) {
+      continue;
+    }
+    values.push([key, value]);
+  }
+  return values;
+}
+function buildDynamicEntries(collectors, blockedKeys) {
+  const values = [];
+  for (const [key, collect] of Object.entries(collectors)) {
+    if (blockedKeys.has(key)) {
+      continue;
+    }
+    values.push([key, collect]);
+  }
+  return values;
+}
+function buildNamespaceConfig(namespace, blockedProperties, staticCollectors, dynamicCollectors) {
+  const blockedNamespace = parseBlockedNamespace(blockedProperties, namespace);
+  if (blockedNamespace.namespaceBlocked) {
+    return null;
+  }
+  const staticValues = namespace === ATTR_NAMESPACE ? buildAttrStaticEntries(blockedNamespace.blockedKeys) : buildStaticEntries(staticCollectors, blockedNamespace.blockedKeys);
+  const dynamicValues = buildDynamicEntries(dynamicCollectors, blockedNamespace.blockedKeys);
+  if (staticValues.length === 0 && dynamicValues.length === 0) {
+    return null;
+  }
+  return {
+    namespace,
+    staticValues,
+    dynamicValues
+  };
+}
+function isPlainObject(value) {
+  if (!value || typeof value !== "object") {
+    return false;
+  }
+  const prototype = Object.getPrototypeOf(value);
+  return prototype === Object.prototype || prototype === null;
+}
+function mergeNamespaceEntries(event, config, context) {
+  if (!config) {
+    return;
+  }
+  const existingValue = event[config.namespace];
+  if (existingValue !== void 0 && !isPlainObject(existingValue)) {
+    return;
+  }
+  const target = existingValue != null ? existingValue : {};
+  if (!isPlainObject(target)) {
+    return;
+  }
+  let changed = false;
+  for (const [key, value] of config.staticValues) {
+    if (key in target) {
+      continue;
+    }
+    target[key] = value;
+    changed = true;
+  }
+  for (const [key, collect] of config.dynamicValues) {
+    if (key in target) {
+      continue;
+    }
+    const value = collect(context);
+    if (value === void 0) {
+      continue;
+    }
+    target[key] = value;
+    changed = true;
+  }
+  if (existingValue === void 0 && changed) {
+    event[config.namespace] = target;
+  }
+}
+function enrichContext() {
+  return {
+    name: "enrichContext",
+    setup: ({ hooks, config }) => {
+      const envConfig = buildNamespaceConfig(
+        ENV_NAMESPACE,
+        config.blockedProperties,
+        ENV_STATIC_COLLECTORS,
+        ENV_DYNAMIC_COLLECTORS
+      );
+      const attrConfig = buildNamespaceConfig(
+        ATTR_NAMESPACE,
+        config.blockedProperties,
+        {},
+        ATTR_DYNAMIC_COLLECTORS
+      );
+      hooks.onEventCreated(({ event }) => {
+        const context = new EventContext();
+        mergeNamespaceEntries(event, envConfig, context);
+        mergeNamespaceEntries(event, attrConfig, context);
+      });
+    }
+  };
+}
+
+// src/index.ts
+(0, import_browser.registerBrowserPlugin)("enrichContext", enrichContext);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  enrichContext
+});

package/dist/index.d.cts

@@ -0,0 +1,5 @@
+import { ClientPlugin } from '@atsignal/browser';
+
+declare function enrichContext(): ClientPlugin;
+
+export { enrichContext };

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import { ClientPlugin } from '@atsignal/browser';
+
+declare function enrichContext(): ClientPlugin;
+
+export { enrichContext };

package/dist/index.js

@@ -0,0 +1,276 @@
+// src/index.ts
+import { registerBrowserPlugin } from "@atsignal/browser";
+
+// src/factory.ts
+var ENV_NAMESPACE = "@env";
+var ATTR_NAMESPACE = "@attr";
+var EventContext = class {
+  document() {
+    var _a;
+    if (this._document !== void 0) {
+      return (_a = this._document) != null ? _a : void 0;
+    }
+    const documentValue = typeof document === "undefined" ? null : document;
+    this._document = documentValue;
+    return documentValue != null ? documentValue : void 0;
+  }
+  location() {
+    var _a;
+    if (this._location !== void 0) {
+      return (_a = this._location) != null ? _a : void 0;
+    }
+    const locationValue = typeof location === "undefined" ? null : location;
+    this._location = locationValue;
+    return locationValue != null ? locationValue : void 0;
+  }
+  searchParams() {
+    var _a;
+    if (this._searchParams !== void 0) {
+      return this._searchParams;
+    }
+    const search = normalizeOptionalString((_a = this.location()) == null ? void 0 : _a.search);
+    this._searchParams = search ? new URLSearchParams(search) : null;
+    return this._searchParams;
+  }
+};
+var ENV_STATIC_COLLECTORS = Object.freeze({
+  language: getLanguage,
+  platform: getPlatform
+});
+var ENV_DYNAMIC_COLLECTORS = Object.freeze({
+  current_url: (context) => {
+    var _a;
+    return normalizeOptionalString((_a = context.location()) == null ? void 0 : _a.href);
+  },
+  current_path: (context) => {
+    var _a;
+    return normalizeOptionalString((_a = context.location()) == null ? void 0 : _a.pathname);
+  },
+  current_title: (context) => {
+    var _a;
+    return normalizeOptionalString((_a = context.document()) == null ? void 0 : _a.title);
+  },
+  current_hostname: (context) => {
+    var _a;
+    return normalizeOptionalString((_a = context.location()) == null ? void 0 : _a.hostname);
+  }
+});
+var ATTR_QUERY_PARAMETER_KEYS = Object.freeze([
+  "utm_source",
+  "utm_medium",
+  "utm_campaign",
+  "utm_term",
+  "utm_content",
+  "utm_id",
+  "utm_source_platform",
+  "utm_campaign_id",
+  "utm_creative_format",
+  "utm_marketing_tactic",
+  "gclid",
+  "dclid",
+  "fbclid",
+  "ko_click_id",
+  "li_fat_id",
+  "msclkid",
+  "ttclid",
+  "twclid",
+  "wbraid",
+  "gbraid",
+  "rdt_cid",
+  "sccid"
+]);
+function createAttrDynamicCollectors() {
+  const collectors = /* @__PURE__ */ Object.create(null);
+  for (const key of ATTR_QUERY_PARAMETER_KEYS) {
+    collectors[key] = (context) => {
+      var _a;
+      return normalizeOptionalString((_a = context.searchParams()) == null ? void 0 : _a.get(key));
+    };
+  }
+  return Object.freeze(collectors);
+}
+var ATTR_DYNAMIC_COLLECTORS = createAttrDynamicCollectors();
+function normalizeOptionalString(value) {
+  if (typeof value !== "string" || value.length === 0) {
+    return void 0;
+  }
+  return value;
+}
+function getNavigator() {
+  return typeof navigator === "undefined" ? void 0 : navigator;
+}
+function getLanguage() {
+  var _a;
+  return normalizeOptionalString((_a = getNavigator()) == null ? void 0 : _a.language);
+}
+function getPlatform() {
+  var _a, _b;
+  const currentNavigator = getNavigator();
+  return (_b = normalizeOptionalString((_a = currentNavigator == null ? void 0 : currentNavigator.userAgentData) == null ? void 0 : _a.platform)) != null ? _b : normalizeOptionalString(currentNavigator == null ? void 0 : currentNavigator.platform);
+}
+function getReferrer() {
+  return normalizeOptionalString(
+    typeof document === "undefined" ? void 0 : document.referrer
+  );
+}
+function getReferringHostFromReferrer(referrer) {
+  if (!referrer) {
+    return void 0;
+  }
+  try {
+    return normalizeOptionalString(new URL(referrer).hostname);
+  } catch (e) {
+    return void 0;
+  }
+}
+function buildAttrStaticEntries(blockedKeys) {
+  if (blockedKeys.has("referrer") && blockedKeys.has("referring_host")) {
+    return [];
+  }
+  const values = [];
+  const referrer = getReferrer();
+  if (!blockedKeys.has("referrer") && referrer !== void 0) {
+    values.push(["referrer", referrer]);
+  }
+  if (!blockedKeys.has("referring_host")) {
+    const referringHost = getReferringHostFromReferrer(referrer);
+    if (referringHost !== void 0) {
+      values.push(["referring_host", referringHost]);
+    }
+  }
+  return values;
+}
+function parseBlockedNamespace(blockedProperties, namespace) {
+  const blockedKeys = /* @__PURE__ */ new Set();
+  const prefix = `${namespace}/`;
+  let namespaceBlocked = false;
+  for (const blockedProperty of blockedProperties) {
+    if (blockedProperty === namespace) {
+      namespaceBlocked = true;
+      continue;
+    }
+    if (!blockedProperty.startsWith(prefix)) {
+      continue;
+    }
+    const blockedKey = blockedProperty.slice(prefix.length);
+    if (blockedKey.length > 0) {
+      blockedKeys.add(blockedKey);
+    }
+  }
+  return {
+    namespaceBlocked,
+    blockedKeys
+  };
+}
+function buildStaticEntries(collectors, blockedKeys) {
+  const values = [];
+  for (const [key, collect] of Object.entries(collectors)) {
+    if (blockedKeys.has(key)) {
+      continue;
+    }
+    const value = collect();
+    if (value === void 0) {
+      continue;
+    }
+    values.push([key, value]);
+  }
+  return values;
+}
+function buildDynamicEntries(collectors, blockedKeys) {
+  const values = [];
+  for (const [key, collect] of Object.entries(collectors)) {
+    if (blockedKeys.has(key)) {
+      continue;
+    }
+    values.push([key, collect]);
+  }
+  return values;
+}
+function buildNamespaceConfig(namespace, blockedProperties, staticCollectors, dynamicCollectors) {
+  const blockedNamespace = parseBlockedNamespace(blockedProperties, namespace);
+  if (blockedNamespace.namespaceBlocked) {
+    return null;
+  }
+  const staticValues = namespace === ATTR_NAMESPACE ? buildAttrStaticEntries(blockedNamespace.blockedKeys) : buildStaticEntries(staticCollectors, blockedNamespace.blockedKeys);
+  const dynamicValues = buildDynamicEntries(dynamicCollectors, blockedNamespace.blockedKeys);
+  if (staticValues.length === 0 && dynamicValues.length === 0) {
+    return null;
+  }
+  return {
+    namespace,
+    staticValues,
+    dynamicValues
+  };
+}
+function isPlainObject(value) {
+  if (!value || typeof value !== "object") {
+    return false;
+  }
+  const prototype = Object.getPrototypeOf(value);
+  return prototype === Object.prototype || prototype === null;
+}
+function mergeNamespaceEntries(event, config, context) {
+  if (!config) {
+    return;
+  }
+  const existingValue = event[config.namespace];
+  if (existingValue !== void 0 && !isPlainObject(existingValue)) {
+    return;
+  }
+  const target = existingValue != null ? existingValue : {};
+  if (!isPlainObject(target)) {
+    return;
+  }
+  let changed = false;
+  for (const [key, value] of config.staticValues) {
+    if (key in target) {
+      continue;
+    }
+    target[key] = value;
+    changed = true;
+  }
+  for (const [key, collect] of config.dynamicValues) {
+    if (key in target) {
+      continue;
+    }
+    const value = collect(context);
+    if (value === void 0) {
+      continue;
+    }
+    target[key] = value;
+    changed = true;
+  }
+  if (existingValue === void 0 && changed) {
+    event[config.namespace] = target;
+  }
+}
+function enrichContext() {
+  return {
+    name: "enrichContext",
+    setup: ({ hooks, config }) => {
+      const envConfig = buildNamespaceConfig(
+        ENV_NAMESPACE,
+        config.blockedProperties,
+        ENV_STATIC_COLLECTORS,
+        ENV_DYNAMIC_COLLECTORS
+      );
+      const attrConfig = buildNamespaceConfig(
+        ATTR_NAMESPACE,
+        config.blockedProperties,
+        {},
+        ATTR_DYNAMIC_COLLECTORS
+      );
+      hooks.onEventCreated(({ event }) => {
+        const context = new EventContext();
+        mergeNamespaceEntries(event, envConfig, context);
+        mergeNamespaceEntries(event, attrConfig, context);
+      });
+    }
+  };
+}
+
+// src/index.ts
+registerBrowserPlugin("enrichContext", enrichContext);
+export {
+  enrichContext
+};

package/dist/signal-plugin-enrich-context.global.js

@@ -0,0 +1,280 @@
+"use strict";
+var __signalEnrichContextBundle = (() => {
+  // src/factory.ts
+  var ENV_NAMESPACE = "@env";
+  var ATTR_NAMESPACE = "@attr";
+  var EventContext = class {
+    document() {
+      var _a2;
+      if (this._document !== void 0) {
+        return (_a2 = this._document) != null ? _a2 : void 0;
+      }
+      const documentValue = typeof document === "undefined" ? null : document;
+      this._document = documentValue;
+      return documentValue != null ? documentValue : void 0;
+    }
+    location() {
+      var _a2;
+      if (this._location !== void 0) {
+        return (_a2 = this._location) != null ? _a2 : void 0;
+      }
+      const locationValue = typeof location === "undefined" ? null : location;
+      this._location = locationValue;
+      return locationValue != null ? locationValue : void 0;
+    }
+    searchParams() {
+      var _a2;
+      if (this._searchParams !== void 0) {
+        return this._searchParams;
+      }
+      const search = normalizeOptionalString((_a2 = this.location()) == null ? void 0 : _a2.search);
+      this._searchParams = search ? new URLSearchParams(search) : null;
+      return this._searchParams;
+    }
+  };
+  var ENV_STATIC_COLLECTORS = Object.freeze({
+    language: getLanguage,
+    platform: getPlatform
+  });
+  var ENV_DYNAMIC_COLLECTORS = Object.freeze({
+    current_url: (context) => {
+      var _a2;
+      return normalizeOptionalString((_a2 = context.location()) == null ? void 0 : _a2.href);
+    },
+    current_path: (context) => {
+      var _a2;
+      return normalizeOptionalString((_a2 = context.location()) == null ? void 0 : _a2.pathname);
+    },
+    current_title: (context) => {
+      var _a2;
+      return normalizeOptionalString((_a2 = context.document()) == null ? void 0 : _a2.title);
+    },
+    current_hostname: (context) => {
+      var _a2;
+      return normalizeOptionalString((_a2 = context.location()) == null ? void 0 : _a2.hostname);
+    }
+  });
+  var ATTR_QUERY_PARAMETER_KEYS = Object.freeze([
+    "utm_source",
+    "utm_medium",
+    "utm_campaign",
+    "utm_term",
+    "utm_content",
+    "utm_id",
+    "utm_source_platform",
+    "utm_campaign_id",
+    "utm_creative_format",
+    "utm_marketing_tactic",
+    "gclid",
+    "dclid",
+    "fbclid",
+    "ko_click_id",
+    "li_fat_id",
+    "msclkid",
+    "ttclid",
+    "twclid",
+    "wbraid",
+    "gbraid",
+    "rdt_cid",
+    "sccid"
+  ]);
+  function createAttrDynamicCollectors() {
+    const collectors = /* @__PURE__ */ Object.create(null);
+    for (const key of ATTR_QUERY_PARAMETER_KEYS) {
+      collectors[key] = (context) => {
+        var _a2;
+        return normalizeOptionalString((_a2 = context.searchParams()) == null ? void 0 : _a2.get(key));
+      };
+    }
+    return Object.freeze(collectors);
+  }
+  var ATTR_DYNAMIC_COLLECTORS = createAttrDynamicCollectors();
+  function normalizeOptionalString(value) {
+    if (typeof value !== "string" || value.length === 0) {
+      return void 0;
+    }
+    return value;
+  }
+  function getNavigator() {
+    return typeof navigator === "undefined" ? void 0 : navigator;
+  }
+  function getLanguage() {
+    var _a2;
+    return normalizeOptionalString((_a2 = getNavigator()) == null ? void 0 : _a2.language);
+  }
+  function getPlatform() {
+    var _a2, _b;
+    const currentNavigator = getNavigator();
+    return (_b = normalizeOptionalString((_a2 = currentNavigator == null ? void 0 : currentNavigator.userAgentData) == null ? void 0 : _a2.platform)) != null ? _b : normalizeOptionalString(currentNavigator == null ? void 0 : currentNavigator.platform);
+  }
+  function getReferrer() {
+    return normalizeOptionalString(
+      typeof document === "undefined" ? void 0 : document.referrer
+    );
+  }
+  function getReferringHostFromReferrer(referrer) {
+    if (!referrer) {
+      return void 0;
+    }
+    try {
+      return normalizeOptionalString(new URL(referrer).hostname);
+    } catch (e) {
+      return void 0;
+    }
+  }
+  function buildAttrStaticEntries(blockedKeys) {
+    if (blockedKeys.has("referrer") && blockedKeys.has("referring_host")) {
+      return [];
+    }
+    const values = [];
+    const referrer = getReferrer();
+    if (!blockedKeys.has("referrer") && referrer !== void 0) {
+      values.push(["referrer", referrer]);
+    }
+    if (!blockedKeys.has("referring_host")) {
+      const referringHost = getReferringHostFromReferrer(referrer);
+      if (referringHost !== void 0) {
+        values.push(["referring_host", referringHost]);
+      }
+    }
+    return values;
+  }
+  function parseBlockedNamespace(blockedProperties, namespace) {
+    const blockedKeys = /* @__PURE__ */ new Set();
+    const prefix = `${namespace}/`;
+    let namespaceBlocked = false;
+    for (const blockedProperty of blockedProperties) {
+      if (blockedProperty === namespace) {
+        namespaceBlocked = true;
+        continue;
+      }
+      if (!blockedProperty.startsWith(prefix)) {
+        continue;
+      }
+      const blockedKey = blockedProperty.slice(prefix.length);
+      if (blockedKey.length > 0) {
+        blockedKeys.add(blockedKey);
+      }
+    }
+    return {
+      namespaceBlocked,
+      blockedKeys
+    };
+  }
+  function buildStaticEntries(collectors, blockedKeys) {
+    const values = [];
+    for (const [key, collect] of Object.entries(collectors)) {
+      if (blockedKeys.has(key)) {
+        continue;
+      }
+      const value = collect();
+      if (value === void 0) {
+        continue;
+      }
+      values.push([key, value]);
+    }
+    return values;
+  }
+  function buildDynamicEntries(collectors, blockedKeys) {
+    const values = [];
+    for (const [key, collect] of Object.entries(collectors)) {
+      if (blockedKeys.has(key)) {
+        continue;
+      }
+      values.push([key, collect]);
+    }
+    return values;
+  }
+  function buildNamespaceConfig(namespace, blockedProperties, staticCollectors, dynamicCollectors) {
+    const blockedNamespace = parseBlockedNamespace(blockedProperties, namespace);
+    if (blockedNamespace.namespaceBlocked) {
+      return null;
+    }
+    const staticValues = namespace === ATTR_NAMESPACE ? buildAttrStaticEntries(blockedNamespace.blockedKeys) : buildStaticEntries(staticCollectors, blockedNamespace.blockedKeys);
+    const dynamicValues = buildDynamicEntries(dynamicCollectors, blockedNamespace.blockedKeys);
+    if (staticValues.length === 0 && dynamicValues.length === 0) {
+      return null;
+    }
+    return {
+      namespace,
+      staticValues,
+      dynamicValues
+    };
+  }
+  function isPlainObject(value) {
+    if (!value || typeof value !== "object") {
+      return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+  }
+  function mergeNamespaceEntries(event, config, context) {
+    if (!config) {
+      return;
+    }
+    const existingValue = event[config.namespace];
+    if (existingValue !== void 0 && !isPlainObject(existingValue)) {
+      return;
+    }
+    const target = existingValue != null ? existingValue : {};
+    if (!isPlainObject(target)) {
+      return;
+    }
+    let changed = false;
+    for (const [key, value] of config.staticValues) {
+      if (key in target) {
+        continue;
+      }
+      target[key] = value;
+      changed = true;
+    }
+    for (const [key, collect] of config.dynamicValues) {
+      if (key in target) {
+        continue;
+      }
+      const value = collect(context);
+      if (value === void 0) {
+        continue;
+      }
+      target[key] = value;
+      changed = true;
+    }
+    if (existingValue === void 0 && changed) {
+      event[config.namespace] = target;
+    }
+  }
+  function enrichContext() {
+    return {
+      name: "enrichContext",
+      setup: ({ hooks, config }) => {
+        const envConfig = buildNamespaceConfig(
+          ENV_NAMESPACE,
+          config.blockedProperties,
+          ENV_STATIC_COLLECTORS,
+          ENV_DYNAMIC_COLLECTORS
+        );
+        const attrConfig = buildNamespaceConfig(
+          ATTR_NAMESPACE,
+          config.blockedProperties,
+          {},
+          ATTR_DYNAMIC_COLLECTORS
+        );
+        hooks.onEventCreated(({ event }) => {
+          const context = new EventContext();
+          mergeNamespaceEntries(event, envConfig, context);
+          mergeNamespaceEntries(event, attrConfig, context);
+        });
+      }
+    };
+  }
+
+  // src/global.ts
+  var globalObject = globalThis;
+  var _a;
+  if (!((_a = globalObject.signal) == null ? void 0 : _a.plugins) || typeof globalObject.signal.plugins !== "object") {
+    throw new Error(
+      "Signal browser global bundle must be loaded before the enrichContext plugin bundle"
+    );
+  }
+  globalObject.signal.plugins.enrichContext = enrichContext;
+})();

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@atsignal/browser-plugin-enrich-context",
+  "version": "0.1.0",
+  "description": "Browser enrich-context plugin for Signal.",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/at-signal/signal-js.git"
+  },
+  "homepage": "https://github.com/at-signal/signal-js#readme",
+  "bugs": {
+    "url": "https://github.com/at-signal/signal-js/issues"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "sideEffects": [
+    "./dist/index.js",
+    "./dist/index.cjs"
+  ],
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@atsignal/browser": "0.1.0"
+  },
+  "devDependencies": {
+    "@atsignal/browser": "0.1.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsup --config tsup.config.ts",
+    "dev": "tsup --config tsup.config.ts --watch",
+    "clean": "rimraf dist",
+    "test": "pnpm --filter @atsignal/js-core run build && pnpm --filter @atsignal/browser run build && pnpm run build && node --test test/*.test.mjs"
+  }
+}