@fullstory/browser 2.0.7 → 2.1.0-beta.0

package/dist/index.d.ts

@@ -11,17 +11,22 @@ import { FSApi } from '@fullstory/snippet';
  * - recordCrossDomainIFrames: FullStory can record cross-domain iFrames. Defaults to `false`. Certain limitations apply and can be found [here](https://help.fullstory.com/hc/en-us/articles/360020622514-Can-FullStory-capture-content-that-is-presented-in-iframes-#h_01F1G333PYKPGZ4B42WDBV3YKV).
  * - recordOnlyThisIFrame: FullStory can record the iFrame as its own unique session. Defaults to `false`. Additional conditions apply and can be found [here](https://help.fullstory.com/hc/en-us/articles/360020622514-Can-FullStory-capture-content-that-is-presented-in-iframes-#h_01F1G33B40Q2TPQA8MA7SF8Y5P).
  * - devMode: In dev mode FullStory won't record sessions. Any calls to SDK methods will `console.warn` that FullStory is in `devMode`. Defaults to `false`.
+ * - sessionUid (beta): Sets the session UID passed to the `FS('init', ...)` v2 operation.
  */
 export interface SnippetOptions {
     orgId: string;
-    namespace?: string;
+    appHost?: string;
+    assetMapId?: string;
+    cookieDomain?: string;
     debug?: boolean;
+    devMode?: boolean;
     host?: string;
-    script?: string;
-    cookieDomain?: string;
+    namespace?: string;
     recordCrossDomainIFrames?: boolean;
     recordOnlyThisIFrame?: boolean;
-    devMode?: boolean;
+    sessionUid?: string;
+    script?: string;
+    startCaptureManually?: boolean;
 }
 /**
  * A callback that will be invoked when FullStory has begun a session.
@@ -33,21 +38,7 @@ type ReadyCallback = (data: {
     sessionUrl: string;
     settings: Readonly<object>;
 }) => void;
-declare global {
-    interface Window {
-        _fs_cookie_domain?: string;
-        _fs_debug?: boolean;
-        _fs_dev_mode?: boolean;
-        _fs_host?: string;
-        _fs_initialized?: boolean;
-        _fs_is_outer_script?: boolean;
-        _fs_namespace?: string;
-        _fs_org?: string;
-        _fs_run_in_iframe?: boolean;
-        _fs_script?: string;
-    }
-}
-export declare const init: (inputOptions: SnippetOptions, readyCallback?: ReadyCallback) => void;
-export declare const isInitialized: () => boolean;
+declare const init: (inputOptions: SnippetOptions, readyCallback?: ReadyCallback) => void;
+declare const isInitialized: () => boolean;
 declare const FullStory: FSApi;
-export default FullStory;
+export { FullStory, init, isInitialized };

package/dist/index.esm.js

@@ -14,6 +14,8 @@ LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
 OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
 PERFORMANCE OF THIS SOFTWARE.
 ***************************************************************************** */
+/* global Reflect, Promise, SuppressedError, Symbol, Iterator */
+
 
 var __assign = function() {
     __assign = Object.assign || function __assign(t) {
@@ -24,17 +26,21 @@ var __assign = function() {
         return t;
     };
     return __assign.apply(this, arguments);
+};
+
+typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
 };
 
-var getFullStory = function () {
-    if (window._fs_namespace) {
-        return window[window._fs_namespace];
-    }
-    return undefined;
-};
+// Module-level state set during `_init` (replaces former window `_fs_*` globals).
+var _namespace;
+var _initialized = false;
+var _isDevMode = false;
+var getFullStory = function (ns) { return (window[ns]); };
 var ensureSnippetLoaded = function () {
-    var fs = getFullStory();
-    if (!fs) {
+    var fs = _namespace ? getFullStory(_namespace) : undefined;
+    if (!_namespace || !fs) {
         throw Error('FullStory is not loaded, please ensure the init function is invoked before calling FullStory API functions');
     }
     return fs;
@@ -42,21 +48,36 @@ var ensureSnippetLoaded = function () {
 var _init = function (inputOptions, readyCallback) {
     // Make a copy so we can modify `options` if desired.
     var options = __assign({}, inputOptions);
-    if (getFullStory()) {
+    var ns = options.namespace || 'FS';
+    _namespace = ns;
+    if (getFullStory(ns)) {
         console.warn('The FullStory snippet has already been defined elsewhere (likely in the <head> element)');
         return;
     }
+    var fsInitEnv = {};
     // see README for details on the recordCrossDomainIFrames option
     if (options.recordCrossDomainIFrames) {
-        window._fs_run_in_iframe = true;
+        fsInitEnv.runInIframe = true;
+    }
+    if (options.appHost) {
+        fsInitEnv.appHost = options.appHost;
+    }
+    if (options.assetMapId) {
+        fsInitEnv.assetMapId = options.assetMapId;
+    }
+    if (options.startCaptureManually) {
+        fsInitEnv.captureOnStartup = false;
     }
     // record the contents of this iFrame when embedded in a parent site
     if (options.recordOnlyThisIFrame) {
-        window._fs_is_outer_script = true;
+        fsInitEnv.isOuterScript = true;
     }
     // Set cookie domain if it was specified.
     if (options.cookieDomain) {
-        window._fs_cookie_domain = options.cookieDomain;
+        fsInitEnv.cookieDomain = options.cookieDomain;
+    }
+    if (options.sessionUid) {
+        fsInitEnv.sessionUid = options.sessionUid;
     }
     if (options.debug === true) {
         if (!options.script) {
@@ -67,11 +88,12 @@ var _init = function (inputOptions, readyCallback) {
         }
     }
     initFS(options);
-    var fs = getFullStory();
+    var fs = getFullStory(_namespace);
     if (!fs) {
-        console.warn('Trouble with fs');
+        console.warn('Failed to initialize FS snippet');
         return;
     }
+    fs('init', { env: fsInitEnv });
     if (readyCallback) {
         fs('observe', { type: 'start', callback: readyCallback });
     }
@@ -80,26 +102,25 @@ var _init = function (inputOptions, readyCallback) {
         fs('trackEvent', {
             name: 'FullStory Dev Mode',
             properties: {
-                message_str: message,
+                message: message,
             }
         });
         fs('shutdown');
-        window._fs_dev_mode = true;
+        _isDevMode = true;
         console.warn(message);
     }
 };
 var initOnce = function (message) { return function (inputOptions, readyCallback) {
-    if (window._fs_initialized) {
+    if (_initialized) {
         if (message)
             console.warn(message);
         return;
     }
     _init(inputOptions, readyCallback);
-    window._fs_initialized = true;
+    _initialized = true;
 }; };
 var init = initOnce('FullStory init has already been called once, additional invocations are ignored');
-// normalize undefined into boolean
-var isInitialized = function () { return !!window._fs_initialized; };
+var isInitialized = function () { return _initialized; };
 var hasFullStoryWithFunction = function () {
     var testNames = [];
     for (var _i = 0; _i < arguments.length; _i++) {
@@ -113,39 +134,42 @@ var guard = function (name) { return function () {
     for (var _i = 0; _i < arguments.length; _i++) {
         args[_i] = arguments[_i];
     }
-    if (window._fs_dev_mode) {
-        var message = "FullStory is in dev mode and is not recording: ".concat(name, " method not executed");
+    if (_isDevMode) {
+        var message = "FullStory is in dev mode and is not capturing: ".concat(name, " method not executed");
         console.warn(message);
         return message;
     }
-    var fs = getFullStory();
+    var fs = _namespace ? getFullStory(_namespace) : undefined;
     if (hasFullStoryWithFunction(name) && fs) {
         return fs[name].apply(fs, args);
     }
     console.warn("FS.".concat(name, " not ready"));
     return null;
 }; };
-var FullStory = Object.assign(function (operation, options, source) {
-    var fs = ensureSnippetLoaded();
-    if (window._fs_dev_mode) {
-        var message = 'FullStory is in dev mode and is not recording: method not executed';
-        console.warn(message);
-        return undefined;
-    }
-    return fs(operation, options, source);
-}, {
-    anonymize: guard('anonymize'),
-    consent: guard('consent'),
-    disableConsole: guard('disableConsole'),
-    enableConsole: guard('enableConsole'),
-    event: guard('event'),
-    getCurrentSessionURL: guard('getCurrentSessionURL'),
-    identify: guard('identify'),
-    log: guard('log'),
-    restart: guard('restart'),
-    setUserVars: guard('setUserVars'),
-    setVars: guard('setVars'),
-    shutdown: guard('shutdown'),
-});
+var buildFullStoryShim = function () {
+    var FS = function (operation, options, source) {
+        var fs = ensureSnippetLoaded();
+        if (_isDevMode) {
+            var message = "FullStory is in dev mode and is not capturing: ".concat(operation, " not executed");
+            console.warn(message);
+            return undefined;
+        }
+        return fs(operation, options, source);
+    };
+    FS.anonymize = guard('anonymize');
+    FS.consent = guard('consent');
+    FS.disableConsole = guard('disableConsole');
+    FS.enableConsole = guard('enableConsole');
+    FS.event = guard('event');
+    FS.getCurrentSessionURL = guard('getCurrentSessionURL');
+    FS.identify = guard('identify');
+    FS.log = guard('log');
+    FS.restart = guard('restart');
+    FS.setUserVars = guard('setUserVars');
+    FS.setVars = guard('setVars');
+    FS.shutdown = guard('shutdown');
+    return FS;
+};
+var FullStory = buildFullStoryShim();
 
-export { FullStory as default, init, isInitialized };
+export { FullStory, init, isInitialized };

package/dist/index.js

@@ -1,7 +1,5 @@
 'use strict';
 
-Object.defineProperty(exports, '__esModule', { value: true });
-
 var snippet = require('@fullstory/snippet');
 
 /******************************************************************************
@@ -18,6 +16,8 @@ LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
 OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
 PERFORMANCE OF THIS SOFTWARE.
 ***************************************************************************** */
+/* global Reflect, Promise, SuppressedError, Symbol, Iterator */
+
 
 var __assign = function() {
     __assign = Object.assign || function __assign(t) {
@@ -28,17 +28,21 @@ var __assign = function() {
         return t;
     };
     return __assign.apply(this, arguments);
+};
+
+typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
 };
 
-var getFullStory = function () {
-    if (window._fs_namespace) {
-        return window[window._fs_namespace];
-    }
-    return undefined;
-};
+// Module-level state set during `_init` (replaces former window `_fs_*` globals).
+var _namespace;
+var _initialized = false;
+var _isDevMode = false;
+var getFullStory = function (ns) { return (window[ns]); };
 var ensureSnippetLoaded = function () {
-    var fs = getFullStory();
-    if (!fs) {
+    var fs = _namespace ? getFullStory(_namespace) : undefined;
+    if (!_namespace || !fs) {
         throw Error('FullStory is not loaded, please ensure the init function is invoked before calling FullStory API functions');
     }
     return fs;
@@ -46,21 +50,36 @@ var ensureSnippetLoaded = function () {
 var _init = function (inputOptions, readyCallback) {
     // Make a copy so we can modify `options` if desired.
     var options = __assign({}, inputOptions);
-    if (getFullStory()) {
+    var ns = options.namespace || 'FS';
+    _namespace = ns;
+    if (getFullStory(ns)) {
         console.warn('The FullStory snippet has already been defined elsewhere (likely in the <head> element)');
         return;
     }
+    var fsInitEnv = {};
     // see README for details on the recordCrossDomainIFrames option
     if (options.recordCrossDomainIFrames) {
-        window._fs_run_in_iframe = true;
+        fsInitEnv.runInIframe = true;
+    }
+    if (options.appHost) {
+        fsInitEnv.appHost = options.appHost;
+    }
+    if (options.assetMapId) {
+        fsInitEnv.assetMapId = options.assetMapId;
+    }
+    if (options.startCaptureManually) {
+        fsInitEnv.captureOnStartup = false;
     }
     // record the contents of this iFrame when embedded in a parent site
     if (options.recordOnlyThisIFrame) {
-        window._fs_is_outer_script = true;
+        fsInitEnv.isOuterScript = true;
     }
     // Set cookie domain if it was specified.
     if (options.cookieDomain) {
-        window._fs_cookie_domain = options.cookieDomain;
+        fsInitEnv.cookieDomain = options.cookieDomain;
+    }
+    if (options.sessionUid) {
+        fsInitEnv.sessionUid = options.sessionUid;
     }
     if (options.debug === true) {
         if (!options.script) {
@@ -71,11 +90,12 @@ var _init = function (inputOptions, readyCallback) {
         }
     }
     snippet.initFS(options);
-    var fs = getFullStory();
+    var fs = getFullStory(_namespace);
     if (!fs) {
-        console.warn('Trouble with fs');
+        console.warn('Failed to initialize FS snippet');
         return;
     }
+    fs('init', { env: fsInitEnv });
     if (readyCallback) {
         fs('observe', { type: 'start', callback: readyCallback });
     }
@@ -84,26 +104,25 @@ var _init = function (inputOptions, readyCallback) {
         fs('trackEvent', {
             name: 'FullStory Dev Mode',
             properties: {
-                message_str: message,
+                message: message,
             }
         });
         fs('shutdown');
-        window._fs_dev_mode = true;
+        _isDevMode = true;
         console.warn(message);
     }
 };
 var initOnce = function (message) { return function (inputOptions, readyCallback) {
-    if (window._fs_initialized) {
+    if (_initialized) {
         if (message)
             console.warn(message);
         return;
     }
     _init(inputOptions, readyCallback);
-    window._fs_initialized = true;
+    _initialized = true;
 }; };
 var init = initOnce('FullStory init has already been called once, additional invocations are ignored');
-// normalize undefined into boolean
-var isInitialized = function () { return !!window._fs_initialized; };
+var isInitialized = function () { return _initialized; };
 var hasFullStoryWithFunction = function () {
     var testNames = [];
     for (var _i = 0; _i < arguments.length; _i++) {
@@ -117,41 +136,44 @@ var guard = function (name) { return function () {
     for (var _i = 0; _i < arguments.length; _i++) {
         args[_i] = arguments[_i];
     }
-    if (window._fs_dev_mode) {
-        var message = "FullStory is in dev mode and is not recording: ".concat(name, " method not executed");
+    if (_isDevMode) {
+        var message = "FullStory is in dev mode and is not capturing: ".concat(name, " method not executed");
         console.warn(message);
         return message;
     }
-    var fs = getFullStory();
+    var fs = _namespace ? getFullStory(_namespace) : undefined;
     if (hasFullStoryWithFunction(name) && fs) {
         return fs[name].apply(fs, args);
     }
     console.warn("FS.".concat(name, " not ready"));
     return null;
 }; };
-var FullStory = Object.assign(function (operation, options, source) {
-    var fs = ensureSnippetLoaded();
-    if (window._fs_dev_mode) {
-        var message = 'FullStory is in dev mode and is not recording: method not executed';
-        console.warn(message);
-        return undefined;
-    }
-    return fs(operation, options, source);
-}, {
-    anonymize: guard('anonymize'),
-    consent: guard('consent'),
-    disableConsole: guard('disableConsole'),
-    enableConsole: guard('enableConsole'),
-    event: guard('event'),
-    getCurrentSessionURL: guard('getCurrentSessionURL'),
-    identify: guard('identify'),
-    log: guard('log'),
-    restart: guard('restart'),
-    setUserVars: guard('setUserVars'),
-    setVars: guard('setVars'),
-    shutdown: guard('shutdown'),
-});
+var buildFullStoryShim = function () {
+    var FS = function (operation, options, source) {
+        var fs = ensureSnippetLoaded();
+        if (_isDevMode) {
+            var message = "FullStory is in dev mode and is not capturing: ".concat(operation, " not executed");
+            console.warn(message);
+            return undefined;
+        }
+        return fs(operation, options, source);
+    };
+    FS.anonymize = guard('anonymize');
+    FS.consent = guard('consent');
+    FS.disableConsole = guard('disableConsole');
+    FS.enableConsole = guard('enableConsole');
+    FS.event = guard('event');
+    FS.getCurrentSessionURL = guard('getCurrentSessionURL');
+    FS.identify = guard('identify');
+    FS.log = guard('log');
+    FS.restart = guard('restart');
+    FS.setUserVars = guard('setUserVars');
+    FS.setVars = guard('setVars');
+    FS.shutdown = guard('shutdown');
+    return FS;
+};
+var FullStory = buildFullStoryShim();
 
-exports.default = FullStory;
+exports.FullStory = FullStory;
 exports.init = init;
 exports.isInitialized = isInitialized;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fullstory/browser",
-  "version": "2.0.7",
+  "version": "2.1.0-beta.0",
   "description": "The official Fullstory browser SDK",
   "repository": "git://github.com/fullstorydev/fullstory-browser-sdk.git",
   "homepage": "https://github.com/fullstorydev/fullstory-browser-sdk",
@@ -25,30 +25,30 @@
     "sdk"
   ],
   "dependencies": {
-    "@fullstory/snippet": "2.0.6"
+    "@fullstory/snippet": "2.1.0-beta.0"
+  },
+  "overrides": {
+    "brace-expansion": "^5.0.8"
   },
   "devDependencies": {
     "@babel/core": "^7.8.7",
-    "@babel/eslint-parser": "^7.16.5",
     "@babel/preset-env": "^7.10.4",
     "@babel/register": "^7.8.6",
+    "@eslint/js": "^10.0.1",
     "@rollup/plugin-typescript": "^11.1.0",
     "@types/jest": "^29.5.0",
     "@types/node": "^18.15.11",
-    "@typescript-eslint/eslint-plugin": "^5.58.0",
-    "@typescript-eslint/parser": "^5.58.0",
-    "eslint": "^8.6.0",
-    "eslint-config-airbnb": "^19.0.4",
-    "eslint-plugin-import": "^2.20.1",
-    "eslint-plugin-jsx-a11y": "^6.5.1",
-    "eslint-plugin-react": "^7.28.0",
-    "jest": "^29.7.0",
+    "eslint": "^10.8.0",
+    "eslint-plugin-import-x": "^4.17.1",
+    "globals": "^17.8.0",
+    "jest": "^30.4.2",
     "jest-environment-jsdom": "^30.3.0",
-    "rimraf": "^2.7.1",
+    "rimraf": "^6.1.3",
     "rollup": "^3.21.0",
-    "ts-jest": "^29.1.0",
+    "ts-jest": "^29.4.12",
     "tslib": "^2.5.0",
     "typescript": "^4.2.4",
+    "typescript-eslint": "^8.65.0",
     "webpack": "^5.76.1"
   }
 }

package/src/index.test.ts

@@ -1,27 +1,52 @@
-import {
-  FullStory as FS,
-  init,
-  isInitialized,
-  SnippetOptions,
-} from '.';
+import type { SnippetOptions } from '.';
 
 const testOrg = '123';
 
+type FsQueue = unknown[][];
+type FsWithQueue = { q?: FsQueue };
+
+const getFsQueue = (ns = 'FS'): FsQueue | undefined => (
+  (window[ns] as unknown as FsWithQueue | undefined)?.q
+);
+
+/** Browser-sdk init call (after snippet's own init); last matching entry wins. */
+const findBrowserInitEnv = (ns = 'FS'): Record<string, unknown> | undefined => {
+  const initCalls = getFsQueue(ns)?.filter((call) => call[0] === 'init') ?? [];
+  // Snippet 2.1 pushes an init with orgId/host/script; browser SDK pushes a follow-up.
+  const browserInit = initCalls.length > 1 ? initCalls[initCalls.length - 1] : initCalls[0];
+  const initOptions = browserInit?.[1] as { env?: Record<string, unknown> } | undefined;
+  return initOptions?.env;
+};
+
 beforeEach(() => {
-  if (window[window._fs_namespace ?? '']) {
-    delete window._fs_initialized;
-    delete window._fs_dev_mode;
-    delete window[window._fs_namespace ?? ''];
-    delete window._fs_namespace;
-  }
+  // Module-level init state lives in the SDK; re-import for a clean slate per test.
+  jest.resetModules();
+  Object.keys(window).forEach((key) => {
+    const value = window[key as keyof Window];
+    if (value && typeof value === 'function' && (value as FsWithQueue).q) {
+      delete window[key as keyof Window];
+    }
+  });
+  delete (window as { FS?: unknown }).FS;
 });
 
+const loadSdk = async () => {
+  const mod = await import('.');
+  return {
+    FS: mod.FullStory,
+    init: mod.init,
+    isInitialized: mod.isInitialized,
+  };
+};
+
 describe('init', () => {
-  it('should throw error if not initialized with an orgId', () => {
+  it('should throw error if not initialized with an orgId', async () => {
+    const { init } = await loadSdk();
     expect(() => { init({} as SnippetOptions); }).toThrow();
   });
 
-  it('should throw error if API called before init', () => {
+  it('should throw error if API called before init', async () => {
+    const { FS, init } = await loadSdk();
     try {
       FS('log', { msg: 'my log' });
       throw new Error('this should have thrown');
@@ -32,58 +57,65 @@ describe('init', () => {
     expect(() => { FS('log', { msg: 'my log' }); }).not.toThrow();
   });
 
-  it('should add _fs_org value to window object', () => {
+  it('should load FS onto the window under the default namespace', async () => {
+    const { init } = await loadSdk();
     init({ orgId: testOrg });
-    expect(window._fs_org).toBe(testOrg);
+    expect((window as unknown as { FS?: unknown }).FS).toBeDefined();
   });
 
-  it('should add _fs_run_in_iframe value to window object', () => {
+  it('should pass runInIframe via FS init env', async () => {
+    const { init } = await loadSdk();
     init({
       orgId: testOrg,
       recordCrossDomainIFrames: true,
     });
-    expect(window._fs_run_in_iframe).toBe(true);
+    expect(findBrowserInitEnv()?.runInIframe).toBe(true);
   });
 
-  it('should add _fs_is_outer_script value to window object', () => {
+  it('should pass isOuterScript via FS init env', async () => {
+    const { init } = await loadSdk();
     init({
       orgId: testOrg,
       recordOnlyThisIFrame: true,
     });
-    expect(window._fs_is_outer_script).toBe(true);
+    expect(findBrowserInitEnv()?.isOuterScript).toBe(true);
   });
 
-  it('should add _fs_dev_mode value to window when initialized with devMode', () => {
+  it('should stop recording when initialized with devMode', async () => {
+    const { init } = await loadSdk();
     init({
       orgId: testOrg,
       devMode: true,
     });
 
-    expect(window._fs_dev_mode).toBe(true);
+    const queue = getFsQueue();
+    expect(queue?.some((call) => call[0] === 'shutdown')).toBe(true);
   });
 
-  it('should return whether initialized', () => {
-    let isInit = isInitialized();
-    expect(isInit).toBe(false);
+  it('should return whether initialized', async () => {
+    const { init, isInitialized } = await loadSdk();
+    expect(isInitialized()).toBe(false);
 
     init({
       orgId: testOrg,
     });
 
-    isInit = isInitialized();
-    expect(isInit).toBe(true);
+    expect(isInitialized()).toBe(true);
   });
 
-  it('should load fs-debug.js when debug is set', () => {
+  it('should load fs-debug.js when debug is set', async () => {
+    const { init } = await loadSdk();
     init({
       orgId: testOrg,
       debug: true,
     });
 
-    expect(window._fs_script).toMatch(/fs-debug.js$/);
+    const script = document.querySelector('script[data-fs-namespace]') as HTMLScriptElement | null;
+    expect(script?.src).toMatch(/fs-debug\.js/);
   });
 
-  it('should pass sessionUid to FS init', () => {
+  it('should pass sessionUid to FS init', async () => {
+    const { init } = await loadSdk();
     const sessionUid = 'session-123';
 
     init({
@@ -91,11 +123,35 @@ describe('init', () => {
       sessionUid,
     });
 
-    const queue = (window[window._fs_namespace ?? 'FS'] as unknown as { q?: unknown[][] }).q;
-    const initCall = queue?.find((call) => call[0] === 'init');
-    const initOptions = initCall?.[1] as { env?: { sessionUid?: string } } | undefined;
+    expect(findBrowserInitEnv()?.sessionUid).toBe(sessionUid);
+  });
+
+  it('should pass cookieDomain, appHost, and assetMapId via FS init env', async () => {
+    const { init } = await loadSdk();
+    init({
+      orgId: testOrg,
+      cookieDomain: 'example.com',
+      appHost: 'app.fullstory.com',
+      assetMapId: 'map-1',
+      startCaptureManually: true,
+    });
+
+    const env = findBrowserInitEnv();
+    expect(env?.cookieDomain).toBe('example.com');
+    expect(env?.appHost).toBe('app.fullstory.com');
+    expect(env?.assetMapId).toBe('map-1');
+    expect(env?.captureOnStartup).toBe(false);
+  });
+
+  it('should use a custom namespace on window', async () => {
+    const { init, FS } = await loadSdk();
+    init({
+      orgId: testOrg,
+      namespace: 'MyFS',
+    });
 
-    expect(initOptions?.env?.sessionUid).toBe(sessionUid);
+    expect((window as unknown as { MyFS?: unknown }).MyFS).toBeDefined();
+    expect(() => { FS('log', { msg: 'ok' }); }).not.toThrow();
   });
 });
 
@@ -111,7 +167,8 @@ describe('devMode', () => {
     consoleWarnedMessage = undefined;
   });
 
-  it('should return a message for functions invoked when in devMode', () => {
+  it('should return a message for functions invoked when in devMode', async () => {
+    const { init, FS } = await loadSdk();
     expect(consoleWarnedMessage).toBeUndefined();
     init({
       orgId: testOrg,
@@ -127,7 +184,8 @@ describe('devMode', () => {
 });
 
 describe('getCurrentSessionURL', () => {
-  it('should return null before fs.js is fully bootstrapped', () => {
+  it('should return null before fs.js is fully bootstrapped', async () => {
+    const { init, FS } = await loadSdk();
     init({ orgId: testOrg });
     // in theory, this is a race condition - assuming that fs.js
     // can't load by the time the following statement is executed
@@ -137,7 +195,8 @@ describe('getCurrentSessionURL', () => {
 });
 
 describe('typescript safety', () => {
-  it('provides type assistance matching the api', () => {
+  it('provides type assistance matching the api', async () => {
+    const { init, FS } = await loadSdk();
     // Just a quick non-exhaustive check that types are working as expected.
     // The "@ts-expect-error" declaration will fail if the types do NOT throw
     // an error.
@@ -190,7 +249,8 @@ describe('typescript safety', () => {
     expect(true).toBe(true);
   });
 
-  it('allows the optional "source" param', () => {
+  it('allows the optional "source" param', async () => {
+    const { init, FS } = await loadSdk();
     init({ orgId: testOrg });
 
     FS('setProperties', {
@@ -223,6 +283,7 @@ describe('typescript safety', () => {
 
   // NOTE: don't run this test, it will hang since fs.js isn't really running. It's only for typescript safety checks.
   it.skip('provides type assistance for the async api', async () => {
+    const { init, FS } = await loadSdk();
     init({ orgId: testOrg });
 
     const disconnector = await FS('observeAsync', { type: 'start', callback: () => console.log('STARTED') });

package/src/index.ts

@@ -38,34 +38,29 @@ export interface SnippetOptions {
  */
 type ReadyCallback = (data: { sessionUrl: string, settings: Readonly<object> }) => void;
 
-declare global {
-  interface Window {
-    _fs_app_host?: string;
-    _fs_asset_map_id?: string;
-    _fs_capture_on_startup?: boolean;
-    _fs_cookie_domain?: string;
-    _fs_debug?: boolean;
-    _fs_dev_mode?: boolean;
-    _fs_host?: string;
-    _fs_initialized?: boolean;
-    _fs_is_outer_script?: boolean;
-    _fs_namespace?: string;
-    _fs_org?: string;
-    _fs_run_in_iframe?: boolean;
-    _fs_script?: string;
-  }
-}
-
-const getFullStory = (): FSApi | undefined => {
-  if (window._fs_namespace) {
-    return window[window._fs_namespace];
-  }
-  return undefined;
+/** Env overrides passed to `FS('init', { env })` after the snippet loads. */
+type FsInitEnv = {
+  appHost?: string;
+  assetMapId?: string;
+  captureOnStartup?: boolean;
+  cookieDomain?: string;
+  isOuterScript?: boolean;
+  runInIframe?: boolean;
+  sessionUid?: string;
 };
 
+// Module-level state set during `_init` (replaces former window `_fs_*` globals).
+let _namespace: string | undefined;
+let _initialized = false;
+let _isDevMode = false;
+
+const getFullStory = (ns: string): FSApi | undefined => (
+  (window as unknown as Record<string, FSApi | undefined>)[ns]
+);
+
 const ensureSnippetLoaded = (): FSApi => {
-  const fs = getFullStory();
-  if (!fs) {
+  const fs = _namespace ? getFullStory(_namespace) : undefined;
+  if (!_namespace || !fs) {
     throw Error(
       'FullStory is not loaded, please ensure the init function is invoked before calling FullStory API functions'
     );
@@ -77,36 +72,45 @@ const ensureSnippetLoaded = (): FSApi => {
 const _init = (inputOptions: SnippetOptions, readyCallback?: ReadyCallback) => {
   // Make a copy so we can modify `options` if desired.
   const options = { ...inputOptions };
-  if (getFullStory()) {
+  const ns = options.namespace || 'FS';
+  _namespace = ns;
+
+  if (getFullStory(ns)) {
     console.warn('The FullStory snippet has already been defined elsewhere (likely in the <head> element)');
     return;
   }
 
+  const fsInitEnv: FsInitEnv = {};
+
   // see README for details on the recordCrossDomainIFrames option
   if (options.recordCrossDomainIFrames) {
-    window._fs_run_in_iframe = true;
+    fsInitEnv.runInIframe = true;
   }
 
   if (options.appHost) {
-    window._fs_app_host = options.appHost;
+    fsInitEnv.appHost = options.appHost;
   }
 
   if (options.assetMapId) {
-    window._fs_asset_map_id = options.assetMapId;
+    fsInitEnv.assetMapId = options.assetMapId;
   }
 
   if (options.startCaptureManually) {
-    window._fs_capture_on_startup = false;
+    fsInitEnv.captureOnStartup = false;
   }
 
   // record the contents of this iFrame when embedded in a parent site
   if (options.recordOnlyThisIFrame) {
-    window._fs_is_outer_script = true;
+    fsInitEnv.isOuterScript = true;
   }
 
   // Set cookie domain if it was specified.
   if (options.cookieDomain) {
-    window._fs_cookie_domain = options.cookieDomain;
+    fsInitEnv.cookieDomain = options.cookieDomain;
+  }
+
+  if (options.sessionUid) {
+    fsInitEnv.sessionUid = options.sessionUid;
   }
 
   if (options.debug === true) {
@@ -119,16 +123,14 @@ const _init = (inputOptions: SnippetOptions, readyCallback?: ReadyCallback) => {
 
   initFS(options);
 
-  const fs = getFullStory();
+  const fs = getFullStory(_namespace);
 
   if (!fs) {
     console.warn('Failed to initialize FS snippet');
     return;
   }
 
-  if (options.sessionUid) {
-    fs('init', { env: { sessionUid: options.sessionUid } });
-  }
+  fs('init', { env: fsInitEnv });
 
   if (readyCallback) {
     fs('observe', { type: 'start', callback: readyCallback });
@@ -143,38 +145,37 @@ const _init = (inputOptions: SnippetOptions, readyCallback?: ReadyCallback) => {
       }
     });
     fs('shutdown');
-    window._fs_dev_mode = true;
+    _isDevMode = true;
     console.warn(message);
   }
 };
 
 const initOnce = (message) => (inputOptions: SnippetOptions, readyCallback?: ReadyCallback) => {
-  if (window._fs_initialized) {
+  if (_initialized) {
     if (message) console.warn(message);
     return;
   }
   _init(inputOptions, readyCallback);
-  window._fs_initialized = true;
+  _initialized = true;
 };
 
-export const init = initOnce('FullStory init has already been called once, additional invocations are ignored');
+const init = initOnce('FullStory init has already been called once, additional invocations are ignored');
 
-// normalize undefined into boolean
-export const isInitialized = () => !!window._fs_initialized;
+const isInitialized = () => _initialized;
 
-const hasFullStoryWithFunction = (...testNames) => {
+const hasFullStoryWithFunction = (...testNames:string[]) => {
   const fs = ensureSnippetLoaded();
   return testNames.every((current) => fs[current]);
 };
 
 const guard = (name) => (...args) => {
-  if (window._fs_dev_mode) {
+  if (_isDevMode) {
     const message = `FullStory is in dev mode and is not capturing: ${name} method not executed`;
     console.warn(message);
     return message;
   }
 
-  const fs = getFullStory();
+  const fs = _namespace ? getFullStory(_namespace) : undefined;
   if (hasFullStoryWithFunction(name) && fs) {
     return fs[name](...args);
   }
@@ -186,7 +187,7 @@ const buildFullStoryShim = (): FSApi => {
   const FS = (operation, options, source) => {
     const fs = ensureSnippetLoaded();
 
-    if (window._fs_dev_mode) {
+    if (_isDevMode) {
       const message = `FullStory is in dev mode and is not capturing: ${operation} not executed`;
       console.warn(message);
       return undefined;
@@ -210,4 +211,6 @@ const buildFullStoryShim = (): FSApi => {
   return FS as FSApi;
 };
 
-export const FullStory: FSApi = buildFullStoryShim();
+const FullStory: FSApi = buildFullStoryShim();
+
+export { FullStory, init, isInitialized };