@grafana-experiments/sdk 0.0.0 → 0.1.0

package/dist/grafana.d.cts

@@ -0,0 +1,22 @@
+import { E as ExperimentsOptions, a as ExperimentConfig, b as ExperimentDefinition, c as Experiment, P as Properties, R as ReportOptions, J as Journey, d as EventManifest, D as Diagnostic, A as Assignment } from './types-M9Kqiiqw.cjs';
+import '@grafana/faro-web-sdk';
+import '@openfeature/web-sdk';
+
+type GrafanaExperimentsOptions = Omit<ExperimentsOptions, 'client' | 'reportAnalytics' | 'reportExposure'> & {
+    domain: string;
+};
+declare function createGrafanaExperiments(options: GrafanaExperimentsOptions): {
+    dispose(): void;
+    ready: Promise<void>;
+    defineExperiment: <T extends ExperimentConfig = ExperimentConfig>(definition: ExperimentDefinition<T>) => Experiment<T>;
+    reportAnalytics: (name: string, properties?: Properties, options?: ReportOptions) => void;
+    refreshSession: () => void;
+    resetContext: (contextKey: string) => void;
+    beginJourney: () => Journey;
+    getEventManifest: () => EventManifest;
+    getDiagnostics: () => readonly Diagnostic[];
+    subscribeDiagnostics: (listener: (diagnostic: Diagnostic) => void) => () => void;
+    getActiveAssignments: () => readonly Assignment[];
+};
+
+export { type GrafanaExperimentsOptions, createGrafanaExperiments };

package/dist/grafana.d.ts

@@ -0,0 +1,22 @@
+import { E as ExperimentsOptions, a as ExperimentConfig, b as ExperimentDefinition, c as Experiment, P as Properties, R as ReportOptions, J as Journey, d as EventManifest, D as Diagnostic, A as Assignment } from './types-M9Kqiiqw.js';
+import '@grafana/faro-web-sdk';
+import '@openfeature/web-sdk';
+
+type GrafanaExperimentsOptions = Omit<ExperimentsOptions, 'client' | 'reportAnalytics' | 'reportExposure'> & {
+    domain: string;
+};
+declare function createGrafanaExperiments(options: GrafanaExperimentsOptions): {
+    dispose(): void;
+    ready: Promise<void>;
+    defineExperiment: <T extends ExperimentConfig = ExperimentConfig>(definition: ExperimentDefinition<T>) => Experiment<T>;
+    reportAnalytics: (name: string, properties?: Properties, options?: ReportOptions) => void;
+    refreshSession: () => void;
+    resetContext: (contextKey: string) => void;
+    beginJourney: () => Journey;
+    getEventManifest: () => EventManifest;
+    getDiagnostics: () => readonly Diagnostic[];
+    subscribeDiagnostics: (listener: (diagnostic: Diagnostic) => void) => () => void;
+    getActiveAssignments: () => readonly Assignment[];
+};
+
+export { type GrafanaExperimentsOptions, createGrafanaExperiments };

package/dist/grafana.js

@@ -0,0 +1,49 @@
+import {
+  createExperiments
+} from "./chunk-W7444I4G.js";
+
+// src/grafana.ts
+import {
+  createOpenFeatureLocalStorageProvider,
+  createOpenFeatureOFREPWebProvider,
+  reportExperimentView,
+  reportInteraction
+} from "@grafana/runtime";
+import { MultiProvider, OpenFeature, NOOP_PROVIDER } from "@openfeature/web-sdk";
+var releasedDomains = /* @__PURE__ */ new Set();
+function createGrafanaExperiments(options) {
+  const { domain } = options;
+  if (!domain.trim()) {
+    throw new Error("An isolated OpenFeature domain is required");
+  }
+  const existing = OpenFeature.getProvider(domain);
+  if (existing !== OpenFeature.getProvider() && !(existing === NOOP_PROVIDER && releasedDomains.has(domain))) {
+    throw new Error(`OpenFeature domain is already registered: ${domain}`);
+  }
+  const provider = new MultiProvider([
+    { provider: createOpenFeatureLocalStorageProvider() },
+    { provider: createOpenFeatureOFREPWebProvider() }
+  ]);
+  OpenFeature.setProvider(domain, provider);
+  releasedDomains.delete(domain);
+  const sdk = createExperiments({
+    ...options,
+    client: OpenFeature.getClient(domain),
+    reportAnalytics: reportInteraction,
+    reportExposure: (assignment) => reportExperimentView(assignment.experiment_id, assignment.experiment_group, assignment.variant)
+  });
+  const dispose = sdk.dispose;
+  return {
+    ...sdk,
+    dispose() {
+      dispose();
+      if (OpenFeature.getProvider(domain) === provider) {
+        OpenFeature.setProvider(domain, NOOP_PROVIDER);
+        releasedDomains.add(domain);
+      }
+    }
+  };
+}
+export {
+  createGrafanaExperiments
+};