@avsbhq/snippet-types 1.4.0 → 1.5.1

package/avsb.d.ts

@@ -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,7 +396,7 @@ 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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@avsbhq/snippet-types",
-  "version": "1.4.0",
+  "version": "1.5.1",
   "description": "TypeScript declarations for window.avsb, the A vs B web-snippet API",
   "keywords": [
     "avsb",
@@ -31,12 +31,12 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/avsbhq/a-vs-b.git",
+    "url": "git+https://github.com/avsbhq/avsb-js.git",
     "directory": "packages/avsb-snippet-types"
   },
-  "homepage": "https://github.com/avsbhq/a-vs-b/tree/main/packages/avsb-snippet-types#readme",
+  "homepage": "https://github.com/avsbhq/avsb-js/tree/main/packages/avsb-snippet-types#readme",
   "bugs": {
-    "url": "https://github.com/avsbhq/a-vs-b/issues"
+    "url": "https://github.com/avsbhq/avsb-js/issues"
   },
   "scripts": {
     "sync:types": "node ../../snippet/scripts/syncSnippetTypes.mjs",

package/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