@avsbhq/cli 3.8.1 → 3.9.0

package/dist/types/avsb.d.ts

@@ -349,8 +349,8 @@ interface AvsbUtils {
 
 // --- Experiment decisions ---
 
-/** Why an experiment did or did not run for this visit. `variant` / `control` mean the visitor is IN the test. */
-type AvsbDecisionStatus = 'variant' | 'control' | 'trigger-pending' | 'not-targeted' | 'audience-mismatch' | 'excluded' | 'traffic-holdout' | 'capped' | 'scheduled-off' | 'error'
+/** Why an experiment did or did not run for this visit. `variant` / `control` mean the visitor is IN the test. `self-redirect` also means IN the test: the visitor is bucketed to a split-URL variant whose destination is the page they are already on, so the redirect was refused instead of looped. `late` means the page's reveal deadline had passed before the experiment could be applied, so it was skipped whole for this page load and nobody was exposed. `unsupported` means this build of the snippet does not carry a feature the experiment needs, so it was skipped whole and reported. `error` stays the genuine failure bucket. */
+type AvsbDecisionStatus = 'variant' | 'control' | 'trigger-pending' | 'self-redirect' | 'not-targeted' | 'audience-mismatch' | 'excluded' | 'traffic-holdout' | 'capped' | 'scheduled-off' | 'late' | 'unsupported' | 'error'
 
 /** One row of `avsb.getExperimentDecisions()`. The variation fields are present only when a variation was assigned. */
 interface AvsbExperimentDecision {
@@ -374,8 +374,8 @@ interface AvsbApi {
   setVisitorId(visitorId: string): boolean
   /** The variation this visitor is assigned in the experiment, or null. Pass the numeric **Experiment ID** from the experiment details panel (a number or its string form); the value returned is that variation's numeric **Variation ID**. Internal UUIDs are not accepted. */
   getVariation(experimentId: string | number): string | null
-  /** Force a variation, for QA, by the numeric **Experiment ID** and **Variation ID** shown in the experiment details panel. `{ track: false }` applies it without recording an exposure. */
-  forceVariation(experimentId: string | number, variationId: string | number, options?: { track?: boolean }): boolean
+  /** Force a variation, for QA, by the numeric **Experiment ID** and **Variation ID** shown in the experiment details panel. It stays the visitor's variation on later page loads until `exitPreview()`; `{ persist: false }` forces it for this page only. `{ track: false }` applies it without recording an exposure. */
+  forceVariation(experimentId: string | number, variationId: string | number, options?: { track?: boolean; persist?: boolean }): boolean
   waitUntil: AvsbWaitUntilFn
   utils: AvsbUtils
   /** Subscribe to every experiment event. Returns an unsubscribe function. Absent in the preview bypass runtime. */
@@ -396,12 +396,16 @@ interface AvsbApi {
   recs: AvsbRecsClient
   /** Commerce events. Buffered until the commerce chunk loads. */
   commerce: AvsbCommerceApi
-  /** Leave a shared preview link: clears the preview token and reloads. */
+  /** Leave a shared preview link and undo every persisted `forceVariation`: clears both and reloads. */
   exitPreview(): void
+  /** After a split-URL redirect in this tab: the referrer of the page the visitor was redirected FROM, captured before the redirect so your analytics can undo the self-referral. `''` means that visit was direct; `null` means no redirect has happened (or storage is unavailable). Same-origin only, so a destination on a different domain cannot read it. Optional: absent on snippet builds that predate it, so read it as `avsb.getOriginalReferrer?.()`. */
+  getOriginalReferrer?(): string | null
   /** Re-run every experiment against the page as it is now. For app-driven navigation the History API never sees. */
   refresh(): void
   /** The snippet build running on this page, e.g. `1.1.0`. */
   version: string
+  /** Which of the four snippet files this page is running: `full`, `visual`, `shop` or `core`. Optional: absent on snippet builds that predate named files, and until the first install stamp lands. A build that does not name its file always carries everything, so treat an absent value as `full`. */
+  buildVariant?: string
 }
 
 /** `window.avsb`. `q` is the install tag's early-call queue, drained by the runtime. */

package/dist/types/variation-code.d.ts

@@ -38,7 +38,7 @@ interface AvsbCodeOptions {
   /** Experiments running on this page, as the same numeric dashboard ids. */
   getActiveExperiments(): Array<{ experimentId: string; variationId: string }>
   /** Force a variation by the numeric **Experiment ID** and **Variation ID** from the experiment details panel. */
-  forceVariation(experimentId: string | number, variationId: string | number, options?: { track?: boolean }): boolean
+  forceVariation(experimentId: string | number, variationId: string | number, options?: { track?: boolean; persist?: boolean }): boolean
   /** Cancelled automatically on teardown, unlike `avsb.waitUntil`. */
   waitUntil: AvsbWaitUntilFn
   utils: AvsbUtils

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@avsbhq/cli",
-  "version": "3.8.1",
+  "version": "3.9.0",
   "description": "CLI tool for local A/B experiment development with the A vs B platform",
   "type": "module",
   "license": "MIT",
@@ -18,7 +18,8 @@
   },
   "files": [
     "bin",
-    "dist"
+    "dist",
+    "LICENSE"
   ],
   "publishConfig": {
     "access": "public"