@fabricorg/experiments-web-adapters 0.0.2

package/dist/index.cjs

@@ -0,0 +1,116 @@
+'use strict';
+
+// src/index.ts
+function snowplowAdapter(options = {}) {
+  var _a;
+  const schema = (_a = options.schema) != null ? _a : "iglu:io.fabric.experiments/exposure/jsonschema/1-0-0";
+  return (record) => {
+    var _a2;
+    const tracker = (_a2 = options.tracker) != null ? _a2 : globalThis.snowplow;
+    if (!tracker) return;
+    tracker("trackSelfDescribingEvent", {
+      event: {
+        schema,
+        data: {
+          experimentId: record.experimentId,
+          variantKey: record.variantKey,
+          subjectId: record.subjectId,
+          manifestVersion: record.manifestVersion,
+          at: record.at,
+          failure: record.failure
+        }
+      }
+    });
+  };
+}
+function gaAdapter(options = {}) {
+  var _a;
+  const eventName = (_a = options.eventName) != null ? _a : "experiment_exposure";
+  return (record) => {
+    var _a2;
+    const gtag = (_a2 = options.gtag) != null ? _a2 : globalThis.gtag;
+    if (!gtag) return;
+    gtag("event", eventName, {
+      experiment_id: record.experimentId,
+      variant_key: record.variantKey,
+      manifest_version: record.manifestVersion
+    });
+  };
+}
+function dataLayerAdapter(options = {}) {
+  var _a;
+  const eventName = (_a = options.eventName) != null ? _a : "fx_exposure";
+  return (record) => {
+    var _a2;
+    const w = globalThis;
+    const dl = (_a2 = options.dataLayer) != null ? _a2 : w.dataLayer = w.dataLayer || [];
+    dl.push({
+      event: eventName,
+      fx_experiment_id: record.experimentId,
+      fx_variant_key: record.variantKey,
+      fx_subject_id: record.subjectId,
+      fx_manifest_version: record.manifestVersion
+    });
+  };
+}
+function compose(...adapters) {
+  return (record) => {
+    for (const a of adapters) {
+      try {
+        a(record);
+      } catch (e) {
+      }
+    }
+  };
+}
+function snowplowFailureAdapter(options = {}) {
+  var _a;
+  const schema = (_a = options.schema) != null ? _a : "iglu:io.fabric.experiments/recipe_failure/jsonschema/1-0-0";
+  return (record) => {
+    var _a2;
+    if (!record.failure) return;
+    const tracker = (_a2 = options.tracker) != null ? _a2 : globalThis.snowplow;
+    if (!tracker) return;
+    tracker("trackSelfDescribingEvent", {
+      event: {
+        schema,
+        data: {
+          experimentId: record.experimentId,
+          variantKey: record.variantKey,
+          subjectId: record.subjectId,
+          manifestVersion: record.manifestVersion,
+          at: record.at,
+          message: record.failure.message,
+          stack: record.failure.stack
+        }
+      }
+    });
+  };
+}
+function dataLayerFailureAdapter(options = {}) {
+  var _a;
+  const eventName = (_a = options.eventName) != null ? _a : "fx_recipe_failure";
+  return (record) => {
+    var _a2;
+    if (!record.failure) return;
+    const w = globalThis;
+    const dl = (_a2 = options.dataLayer) != null ? _a2 : w.dataLayer = w.dataLayer || [];
+    dl.push({
+      event: eventName,
+      fx_experiment_id: record.experimentId,
+      fx_variant_key: record.variantKey,
+      fx_subject_id: record.subjectId,
+      fx_manifest_version: record.manifestVersion,
+      fx_failure_message: record.failure.message
+    });
+  };
+}
+
+exports.compose = compose;
+exports.dataLayerAdapter = dataLayerAdapter;
+exports.dataLayerFailureAdapter = dataLayerFailureAdapter;
+exports.gaAdapter = gaAdapter;
+exports.snowplowAdapter = snowplowAdapter;
+exports.snowplowFailureAdapter = snowplowFailureAdapter;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["_a"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { ExposureRecord } from '@fabricorg/experiments-web';\n\nexport type ExposureAdapter = (record: ExposureRecord) => void;\n\n/**\n * Snowplow self-describing exposure event.\n *\n * Schema: iglu:io.fabric.experiments/exposure/jsonschema/1-0-0\n * (host the schema in your Iglu repo to validate downstream).\n */\nexport interface SnowplowAdapterOptions {\n  /** Tracker function: typically `(window as any).snowplow` or the explicit tracker. */\n  tracker?: (...args: unknown[]) => void;\n  /** Schema URI. Override if you publish a custom schema. */\n  schema?: string;\n}\n\nexport function snowplowAdapter(options: SnowplowAdapterOptions = {}): ExposureAdapter {\n  const schema = options.schema ?? 'iglu:io.fabric.experiments/exposure/jsonschema/1-0-0';\n  return (record) => {\n    const tracker =\n      options.tracker ??\n      (globalThis as { snowplow?: (...args: unknown[]) => void }).snowplow;\n    if (!tracker) return;\n    tracker('trackSelfDescribingEvent', {\n      event: {\n        schema,\n        data: {\n          experimentId: record.experimentId,\n          variantKey: record.variantKey,\n          subjectId: record.subjectId,\n          manifestVersion: record.manifestVersion,\n          at: record.at,\n          failure: record.failure,\n        },\n      },\n    });\n  };\n}\n\n/**\n * Google Analytics 4 (gtag) adapter.\n * Sends an `experiment_exposure` event with custom dimensions.\n */\nexport interface GaAdapterOptions {\n  gtag?: (...args: unknown[]) => void;\n  /** Override the event name. Default: `experiment_exposure`. */\n  eventName?: string;\n}\n\nexport function gaAdapter(options: GaAdapterOptions = {}): ExposureAdapter {\n  const eventName = options.eventName ?? 'experiment_exposure';\n  return (record) => {\n    const gtag =\n      options.gtag ?? (globalThis as { gtag?: (...args: unknown[]) => void }).gtag;\n    if (!gtag) return;\n    gtag('event', eventName, {\n      experiment_id: record.experimentId,\n      variant_key: record.variantKey,\n      manifest_version: record.manifestVersion,\n    });\n  };\n}\n\n/**\n * Generic GTM dataLayer adapter — pushes a single event GTM tags can listen for.\n * This is also the default tag-loader behavior.\n */\nexport interface DataLayerAdapterOptions {\n  /** Override the dataLayer reference (tests). */\n  dataLayer?: Array<Record<string, unknown>>;\n  /** Override the event name. Default: `fx_exposure`. */\n  eventName?: string;\n}\n\nexport function dataLayerAdapter(options: DataLayerAdapterOptions = {}): ExposureAdapter {\n  const eventName = options.eventName ?? 'fx_exposure';\n  return (record) => {\n    const w = globalThis as { dataLayer?: Array<Record<string, unknown>> };\n    const dl = options.dataLayer ?? (w.dataLayer = w.dataLayer || []);\n    dl.push({\n      event: eventName,\n      fx_experiment_id: record.experimentId,\n      fx_variant_key: record.variantKey,\n      fx_subject_id: record.subjectId,\n      fx_manifest_version: record.manifestVersion,\n    });\n  };\n}\n\n/**\n * Fan out a single exposure to multiple adapters. Each adapter is wrapped in\n * a try/catch so a third-party tracker error never breaks the chain.\n */\nexport function compose(...adapters: readonly ExposureAdapter[]): ExposureAdapter {\n  return (record) => {\n    for (const a of adapters) {\n      try {\n        a(record);\n      } catch {\n        /* swallow */\n      }\n    }\n  };\n}\n\n// ---- Failure adapters (Mojito onRecipeFailure parity) ----------------------\n\n/**\n * Snowplow self-describing event for variant failures.\n *\n * Schema: iglu:io.fabric.experiments/recipe_failure/jsonschema/1-0-0\n * Fires once per (experimentId, variantKey, message) — useful for alarming\n * on variant-code crashes without cluttering the exposure stream.\n */\nexport interface SnowplowFailureAdapterOptions extends SnowplowAdapterOptions {\n  schema?: string;\n}\n\nexport function snowplowFailureAdapter(\n  options: SnowplowFailureAdapterOptions = {},\n): ExposureAdapter {\n  const schema =\n    options.schema ?? 'iglu:io.fabric.experiments/recipe_failure/jsonschema/1-0-0';\n  return (record) => {\n    if (!record.failure) return;\n    const tracker =\n      options.tracker ??\n      (globalThis as { snowplow?: (...args: unknown[]) => void }).snowplow;\n    if (!tracker) return;\n    tracker('trackSelfDescribingEvent', {\n      event: {\n        schema,\n        data: {\n          experimentId: record.experimentId,\n          variantKey: record.variantKey,\n          subjectId: record.subjectId,\n          manifestVersion: record.manifestVersion,\n          at: record.at,\n          message: record.failure.message,\n          stack: record.failure.stack,\n        },\n      },\n    });\n  };\n}\n\n/** dataLayer push for variant failures — pairs with the default exposure adapter. */\nexport function dataLayerFailureAdapter(\n  options: DataLayerAdapterOptions = {},\n): ExposureAdapter {\n  const eventName = options.eventName ?? 'fx_recipe_failure';\n  return (record) => {\n    if (!record.failure) return;\n    const w = globalThis as { dataLayer?: Array<Record<string, unknown>> };\n    const dl = options.dataLayer ?? (w.dataLayer = w.dataLayer || []);\n    dl.push({\n      event: eventName,\n      fx_experiment_id: record.experimentId,\n      fx_variant_key: record.variantKey,\n      fx_subject_id: record.subjectId,\n      fx_manifest_version: record.manifestVersion,\n      fx_failure_message: record.failure.message,\n    });\n  };\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,57 @@
+import { ExposureRecord } from '@fabricorg/experiments-web';
+
+type ExposureAdapter = (record: ExposureRecord) => void;
+/**
+ * Snowplow self-describing exposure event.
+ *
+ * Schema: iglu:io.fabric.experiments/exposure/jsonschema/1-0-0
+ * (host the schema in your Iglu repo to validate downstream).
+ */
+interface SnowplowAdapterOptions {
+    /** Tracker function: typically `(window as any).snowplow` or the explicit tracker. */
+    tracker?: (...args: unknown[]) => void;
+    /** Schema URI. Override if you publish a custom schema. */
+    schema?: string;
+}
+declare function snowplowAdapter(options?: SnowplowAdapterOptions): ExposureAdapter;
+/**
+ * Google Analytics 4 (gtag) adapter.
+ * Sends an `experiment_exposure` event with custom dimensions.
+ */
+interface GaAdapterOptions {
+    gtag?: (...args: unknown[]) => void;
+    /** Override the event name. Default: `experiment_exposure`. */
+    eventName?: string;
+}
+declare function gaAdapter(options?: GaAdapterOptions): ExposureAdapter;
+/**
+ * Generic GTM dataLayer adapter — pushes a single event GTM tags can listen for.
+ * This is also the default tag-loader behavior.
+ */
+interface DataLayerAdapterOptions {
+    /** Override the dataLayer reference (tests). */
+    dataLayer?: Array<Record<string, unknown>>;
+    /** Override the event name. Default: `fx_exposure`. */
+    eventName?: string;
+}
+declare function dataLayerAdapter(options?: DataLayerAdapterOptions): ExposureAdapter;
+/**
+ * Fan out a single exposure to multiple adapters. Each adapter is wrapped in
+ * a try/catch so a third-party tracker error never breaks the chain.
+ */
+declare function compose(...adapters: readonly ExposureAdapter[]): ExposureAdapter;
+/**
+ * Snowplow self-describing event for variant failures.
+ *
+ * Schema: iglu:io.fabric.experiments/recipe_failure/jsonschema/1-0-0
+ * Fires once per (experimentId, variantKey, message) — useful for alarming
+ * on variant-code crashes without cluttering the exposure stream.
+ */
+interface SnowplowFailureAdapterOptions extends SnowplowAdapterOptions {
+    schema?: string;
+}
+declare function snowplowFailureAdapter(options?: SnowplowFailureAdapterOptions): ExposureAdapter;
+/** dataLayer push for variant failures — pairs with the default exposure adapter. */
+declare function dataLayerFailureAdapter(options?: DataLayerAdapterOptions): ExposureAdapter;
+
+export { type DataLayerAdapterOptions, type ExposureAdapter, type GaAdapterOptions, type SnowplowAdapterOptions, type SnowplowFailureAdapterOptions, compose, dataLayerAdapter, dataLayerFailureAdapter, gaAdapter, snowplowAdapter, snowplowFailureAdapter };

package/dist/index.d.ts

@@ -0,0 +1,57 @@
+import { ExposureRecord } from '@fabricorg/experiments-web';
+
+type ExposureAdapter = (record: ExposureRecord) => void;
+/**
+ * Snowplow self-describing exposure event.
+ *
+ * Schema: iglu:io.fabric.experiments/exposure/jsonschema/1-0-0
+ * (host the schema in your Iglu repo to validate downstream).
+ */
+interface SnowplowAdapterOptions {
+    /** Tracker function: typically `(window as any).snowplow` or the explicit tracker. */
+    tracker?: (...args: unknown[]) => void;
+    /** Schema URI. Override if you publish a custom schema. */
+    schema?: string;
+}
+declare function snowplowAdapter(options?: SnowplowAdapterOptions): ExposureAdapter;
+/**
+ * Google Analytics 4 (gtag) adapter.
+ * Sends an `experiment_exposure` event with custom dimensions.
+ */
+interface GaAdapterOptions {
+    gtag?: (...args: unknown[]) => void;
+    /** Override the event name. Default: `experiment_exposure`. */
+    eventName?: string;
+}
+declare function gaAdapter(options?: GaAdapterOptions): ExposureAdapter;
+/**
+ * Generic GTM dataLayer adapter — pushes a single event GTM tags can listen for.
+ * This is also the default tag-loader behavior.
+ */
+interface DataLayerAdapterOptions {
+    /** Override the dataLayer reference (tests). */
+    dataLayer?: Array<Record<string, unknown>>;
+    /** Override the event name. Default: `fx_exposure`. */
+    eventName?: string;
+}
+declare function dataLayerAdapter(options?: DataLayerAdapterOptions): ExposureAdapter;
+/**
+ * Fan out a single exposure to multiple adapters. Each adapter is wrapped in
+ * a try/catch so a third-party tracker error never breaks the chain.
+ */
+declare function compose(...adapters: readonly ExposureAdapter[]): ExposureAdapter;
+/**
+ * Snowplow self-describing event for variant failures.
+ *
+ * Schema: iglu:io.fabric.experiments/recipe_failure/jsonschema/1-0-0
+ * Fires once per (experimentId, variantKey, message) — useful for alarming
+ * on variant-code crashes without cluttering the exposure stream.
+ */
+interface SnowplowFailureAdapterOptions extends SnowplowAdapterOptions {
+    schema?: string;
+}
+declare function snowplowFailureAdapter(options?: SnowplowFailureAdapterOptions): ExposureAdapter;
+/** dataLayer push for variant failures — pairs with the default exposure adapter. */
+declare function dataLayerFailureAdapter(options?: DataLayerAdapterOptions): ExposureAdapter;
+
+export { type DataLayerAdapterOptions, type ExposureAdapter, type GaAdapterOptions, type SnowplowAdapterOptions, type SnowplowFailureAdapterOptions, compose, dataLayerAdapter, dataLayerFailureAdapter, gaAdapter, snowplowAdapter, snowplowFailureAdapter };

package/dist/index.js

@@ -0,0 +1,109 @@
+// src/index.ts
+function snowplowAdapter(options = {}) {
+  var _a;
+  const schema = (_a = options.schema) != null ? _a : "iglu:io.fabric.experiments/exposure/jsonschema/1-0-0";
+  return (record) => {
+    var _a2;
+    const tracker = (_a2 = options.tracker) != null ? _a2 : globalThis.snowplow;
+    if (!tracker) return;
+    tracker("trackSelfDescribingEvent", {
+      event: {
+        schema,
+        data: {
+          experimentId: record.experimentId,
+          variantKey: record.variantKey,
+          subjectId: record.subjectId,
+          manifestVersion: record.manifestVersion,
+          at: record.at,
+          failure: record.failure
+        }
+      }
+    });
+  };
+}
+function gaAdapter(options = {}) {
+  var _a;
+  const eventName = (_a = options.eventName) != null ? _a : "experiment_exposure";
+  return (record) => {
+    var _a2;
+    const gtag = (_a2 = options.gtag) != null ? _a2 : globalThis.gtag;
+    if (!gtag) return;
+    gtag("event", eventName, {
+      experiment_id: record.experimentId,
+      variant_key: record.variantKey,
+      manifest_version: record.manifestVersion
+    });
+  };
+}
+function dataLayerAdapter(options = {}) {
+  var _a;
+  const eventName = (_a = options.eventName) != null ? _a : "fx_exposure";
+  return (record) => {
+    var _a2;
+    const w = globalThis;
+    const dl = (_a2 = options.dataLayer) != null ? _a2 : w.dataLayer = w.dataLayer || [];
+    dl.push({
+      event: eventName,
+      fx_experiment_id: record.experimentId,
+      fx_variant_key: record.variantKey,
+      fx_subject_id: record.subjectId,
+      fx_manifest_version: record.manifestVersion
+    });
+  };
+}
+function compose(...adapters) {
+  return (record) => {
+    for (const a of adapters) {
+      try {
+        a(record);
+      } catch (e) {
+      }
+    }
+  };
+}
+function snowplowFailureAdapter(options = {}) {
+  var _a;
+  const schema = (_a = options.schema) != null ? _a : "iglu:io.fabric.experiments/recipe_failure/jsonschema/1-0-0";
+  return (record) => {
+    var _a2;
+    if (!record.failure) return;
+    const tracker = (_a2 = options.tracker) != null ? _a2 : globalThis.snowplow;
+    if (!tracker) return;
+    tracker("trackSelfDescribingEvent", {
+      event: {
+        schema,
+        data: {
+          experimentId: record.experimentId,
+          variantKey: record.variantKey,
+          subjectId: record.subjectId,
+          manifestVersion: record.manifestVersion,
+          at: record.at,
+          message: record.failure.message,
+          stack: record.failure.stack
+        }
+      }
+    });
+  };
+}
+function dataLayerFailureAdapter(options = {}) {
+  var _a;
+  const eventName = (_a = options.eventName) != null ? _a : "fx_recipe_failure";
+  return (record) => {
+    var _a2;
+    if (!record.failure) return;
+    const w = globalThis;
+    const dl = (_a2 = options.dataLayer) != null ? _a2 : w.dataLayer = w.dataLayer || [];
+    dl.push({
+      event: eventName,
+      fx_experiment_id: record.experimentId,
+      fx_variant_key: record.variantKey,
+      fx_subject_id: record.subjectId,
+      fx_manifest_version: record.manifestVersion,
+      fx_failure_message: record.failure.message
+    });
+  };
+}
+
+export { compose, dataLayerAdapter, dataLayerFailureAdapter, gaAdapter, snowplowAdapter, snowplowFailureAdapter };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["_a"],"mappings":"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","file":"index.js","sourcesContent":["import type { ExposureRecord } from '@fabricorg/experiments-web';\n\nexport type ExposureAdapter = (record: ExposureRecord) => void;\n\n/**\n * Snowplow self-describing exposure event.\n *\n * Schema: iglu:io.fabric.experiments/exposure/jsonschema/1-0-0\n * (host the schema in your Iglu repo to validate downstream).\n */\nexport interface SnowplowAdapterOptions {\n  /** Tracker function: typically `(window as any).snowplow` or the explicit tracker. */\n  tracker?: (...args: unknown[]) => void;\n  /** Schema URI. Override if you publish a custom schema. */\n  schema?: string;\n}\n\nexport function snowplowAdapter(options: SnowplowAdapterOptions = {}): ExposureAdapter {\n  const schema = options.schema ?? 'iglu:io.fabric.experiments/exposure/jsonschema/1-0-0';\n  return (record) => {\n    const tracker =\n      options.tracker ??\n      (globalThis as { snowplow?: (...args: unknown[]) => void }).snowplow;\n    if (!tracker) return;\n    tracker('trackSelfDescribingEvent', {\n      event: {\n        schema,\n        data: {\n          experimentId: record.experimentId,\n          variantKey: record.variantKey,\n          subjectId: record.subjectId,\n          manifestVersion: record.manifestVersion,\n          at: record.at,\n          failure: record.failure,\n        },\n      },\n    });\n  };\n}\n\n/**\n * Google Analytics 4 (gtag) adapter.\n * Sends an `experiment_exposure` event with custom dimensions.\n */\nexport interface GaAdapterOptions {\n  gtag?: (...args: unknown[]) => void;\n  /** Override the event name. Default: `experiment_exposure`. */\n  eventName?: string;\n}\n\nexport function gaAdapter(options: GaAdapterOptions = {}): ExposureAdapter {\n  const eventName = options.eventName ?? 'experiment_exposure';\n  return (record) => {\n    const gtag =\n      options.gtag ?? (globalThis as { gtag?: (...args: unknown[]) => void }).gtag;\n    if (!gtag) return;\n    gtag('event', eventName, {\n      experiment_id: record.experimentId,\n      variant_key: record.variantKey,\n      manifest_version: record.manifestVersion,\n    });\n  };\n}\n\n/**\n * Generic GTM dataLayer adapter — pushes a single event GTM tags can listen for.\n * This is also the default tag-loader behavior.\n */\nexport interface DataLayerAdapterOptions {\n  /** Override the dataLayer reference (tests). */\n  dataLayer?: Array<Record<string, unknown>>;\n  /** Override the event name. Default: `fx_exposure`. */\n  eventName?: string;\n}\n\nexport function dataLayerAdapter(options: DataLayerAdapterOptions = {}): ExposureAdapter {\n  const eventName = options.eventName ?? 'fx_exposure';\n  return (record) => {\n    const w = globalThis as { dataLayer?: Array<Record<string, unknown>> };\n    const dl = options.dataLayer ?? (w.dataLayer = w.dataLayer || []);\n    dl.push({\n      event: eventName,\n      fx_experiment_id: record.experimentId,\n      fx_variant_key: record.variantKey,\n      fx_subject_id: record.subjectId,\n      fx_manifest_version: record.manifestVersion,\n    });\n  };\n}\n\n/**\n * Fan out a single exposure to multiple adapters. Each adapter is wrapped in\n * a try/catch so a third-party tracker error never breaks the chain.\n */\nexport function compose(...adapters: readonly ExposureAdapter[]): ExposureAdapter {\n  return (record) => {\n    for (const a of adapters) {\n      try {\n        a(record);\n      } catch {\n        /* swallow */\n      }\n    }\n  };\n}\n\n// ---- Failure adapters (Mojito onRecipeFailure parity) ----------------------\n\n/**\n * Snowplow self-describing event for variant failures.\n *\n * Schema: iglu:io.fabric.experiments/recipe_failure/jsonschema/1-0-0\n * Fires once per (experimentId, variantKey, message) — useful for alarming\n * on variant-code crashes without cluttering the exposure stream.\n */\nexport interface SnowplowFailureAdapterOptions extends SnowplowAdapterOptions {\n  schema?: string;\n}\n\nexport function snowplowFailureAdapter(\n  options: SnowplowFailureAdapterOptions = {},\n): ExposureAdapter {\n  const schema =\n    options.schema ?? 'iglu:io.fabric.experiments/recipe_failure/jsonschema/1-0-0';\n  return (record) => {\n    if (!record.failure) return;\n    const tracker =\n      options.tracker ??\n      (globalThis as { snowplow?: (...args: unknown[]) => void }).snowplow;\n    if (!tracker) return;\n    tracker('trackSelfDescribingEvent', {\n      event: {\n        schema,\n        data: {\n          experimentId: record.experimentId,\n          variantKey: record.variantKey,\n          subjectId: record.subjectId,\n          manifestVersion: record.manifestVersion,\n          at: record.at,\n          message: record.failure.message,\n          stack: record.failure.stack,\n        },\n      },\n    });\n  };\n}\n\n/** dataLayer push for variant failures — pairs with the default exposure adapter. */\nexport function dataLayerFailureAdapter(\n  options: DataLayerAdapterOptions = {},\n): ExposureAdapter {\n  const eventName = options.eventName ?? 'fx_recipe_failure';\n  return (record) => {\n    if (!record.failure) return;\n    const w = globalThis as { dataLayer?: Array<Record<string, unknown>> };\n    const dl = options.dataLayer ?? (w.dataLayer = w.dataLayer || []);\n    dl.push({\n      event: eventName,\n      fx_experiment_id: record.experimentId,\n      fx_variant_key: record.variantKey,\n      fx_subject_id: record.subjectId,\n      fx_manifest_version: record.manifestVersion,\n      fx_failure_message: record.failure.message,\n    });\n  };\n}\n"]}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@fabricorg/experiments-web-adapters",
+  "version": "0.0.2",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "description": "Pluggable exposure adapters for @fabricorg/experiments-web — Snowplow, GA, GTM, dataLayer.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "types": "./dist/index.d.ts",
+  "module": "./dist/index.js",
+  "exports": {
+    ".": {
+      "import": { "types": "./dist/index.d.ts", "default": "./dist/index.js" },
+      "require": { "types": "./dist/index.d.cts", "default": "./dist/index.cjs" }
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@fabricorg/experiments-web": "workspace:*"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.8.3",
+    "vitest": "^2.1.8"
+  }
+}