@facet-smith/analytics

Vendor-neutral exposure and attribution contracts plus development/testing adapters for FacetSmith.

Install

pnpm add @facet-smith/analytics

Example

import {
  createConsoleAnalyticsAdapter,
  type ExperimentAnalyticsAdapter,
} from "@facet-smith/analytics";

const developmentAdapter = createConsoleAnalyticsAdapter();

const productionAdapter: ExperimentAnalyticsAdapter = {
  exposure(event) {
    return analytics.capture("experiment_exposure", event);
  },
};

The package also exports a no-op adapter and InMemoryAnalyticsAdapter for tests. Assignment and exposure are intentionally separate: applications should report exposure only after experimental content becomes visible.

ExperimentAttribution is the immutable experiment identity applications can attach to their existing events. toExperimentAttribution() converts a server-side assignment without carrying its allocation bucket or other runtime details. React applications can read visibility-qualified attribution with useExposedExperiments() from @facet-smith/react.

FacetSmith does not provide statistical inference or an analytics backend. See the analytics guide for event fields and adapter guidance.