@nexussdk/sdk 0.0.1

package/.turbo/turbo-build.log

@@ -0,0 +1,45 @@
+
+> @nexussdk/sdk@0.0.1 build /home/runner/work/NexusSDK/NexusSDK/packages/sdk
+> tsup
+
+CLI Building entry: {"react":"src/react.tsx"}
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.5.1
+CLI Using tsup config: /home/runner/work/NexusSDK/NexusSDK/packages/sdk/tsup.config.ts
+CLI Building entry: src/index.ts
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.5.1
+CLI Using tsup config: /home/runner/work/NexusSDK/NexusSDK/packages/sdk/tsup.config.ts
+CLI Target: es2022
+ESM Build start
+CJS Build start
+CLI Target: es2022
+CLI Cleaning output folder
+ESM Build start
+CJS Build start
+IIFE Build start
+dist/react.cjs (1:0): Module level directives cause errors when bundled, "use client" in "dist/react.cjs" was ignored.
+dist/react.mjs (1:0): Module level directives cause errors when bundled, "use client" in "dist/react.mjs" was ignored.
+CJS dist/index.cjs     1.45 KB
+CJS dist/index.cjs.map 8.39 KB
+CJS ⚡️ Build success in 473ms
+CJS dist/react.cjs     2.26 KB
+CJS dist/react.cjs.map 16.56 KB
+CJS ⚡️ Build success in 483ms
+ESM dist/react.mjs     2.17 KB
+ESM dist/react.mjs.map 16.56 KB
+ESM ⚡️ Build success in 484ms
+IIFE dist/index.global.js     19.65 KB
+IIFE dist/index.global.js.map 116.63 KB
+IIFE ⚡️ Build success in 475ms
+ESM dist/index.mjs     1.31 KB
+ESM dist/index.mjs.map 8.39 KB
+ESM ⚡️ Build success in 475ms
+DTS Build start
+DTS Build start
+DTS ⚡️ Build success in 1445ms
+DTS dist/index.d.mts 5.12 KB
+DTS dist/index.d.ts  5.12 KB
+DTS ⚡️ Build success in 1567ms
+DTS dist/react.d.mts 8.12 KB
+DTS dist/react.d.ts  8.12 KB

package/dist/index.cjs

@@ -0,0 +1,2 @@
+'use strict';var flags=require('@nexussdk/flags'),tracker=require('@nexussdk/tracker');var n=class t{static instance=null;flags;tracker;constructor(e={}){let{apiKey:s,baseUrl:r,user:a,environment:i,tags:o,autoCapture:c,flags:l,tracker:u}=e;this.flags=new flags.NexusFlagsClient({apiKey:s,baseUrl:r,user:a,...l}),this.tracker=new tracker.NexusTrackerClient({apiKey:s,baseUrl:r,environment:i,tags:o,autoCapture:c,...u});}static init(e={}){return t.instance||(t.instance=new t(e)),t.instance}static getInstance(){if(!t.instance)throw new Error('[Nexus SDK] Not initialized. Call Nexus.init({ apiKey: "..." }) first.');return t.instance}static isEnabled(e,s=false){return t.getInstance().flags.isEnabled(e,s)}static getVariant(e,s,r){return t.getInstance().flags.getVariant(e,s,r)}static captureError(e,s){t.getInstance().tracker.captureError(e,s);}static async identify(e){let s=t.getInstance();s.tracker.setUser(e),await s.flags.identify(e);}static reset(){let e=t.getInstance();e.tracker.setUser(null),e.flags.reset();}static async destroy(){t.instance&&(await t.instance.tracker.flush(),t.instance.tracker.destroy(),t.instance.flags.destroy(),t.instance=null);}};Object.defineProperty(exports,"NexusFlagsClient",{enumerable:true,get:function(){return flags.NexusFlagsClient}});Object.defineProperty(exports,"NexusTrackerClient",{enumerable:true,get:function(){return tracker.NexusTrackerClient}});exports.Nexus=n;//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/nexus.ts"],"names":["Nexus","_Nexus","options","apiKey","baseUrl","user","environment","tags","autoCapture","flagsOpts","trackerOpts","NexusFlagsClient","NexusTrackerClient","key","defaultValue","variantKey","error","extra","instance"],"mappings":"uFA6DO,IAAMA,CAAAA,CAAN,MAAMC,CAAM,CACjB,OAAe,QAAA,CAAyB,IAAA,CAGxB,KAAA,CAEA,OAAA,CAER,WAAA,CAAYC,CAAAA,CAA4B,EAAC,CAAG,CAClD,GAAM,CAAE,MAAA,CAAAC,CAAAA,CAAQ,OAAA,CAAAC,EAAS,IAAA,CAAAC,CAAAA,CAAM,WAAA,CAAAC,CAAAA,CAAa,IAAA,CAAAC,CAAAA,CAAM,YAAAC,CAAAA,CAAa,KAAA,CAAOC,CAAAA,CAAW,OAAA,CAASC,CAAY,CAAA,CAAIR,EAE1G,IAAA,CAAK,KAAA,CAAQ,IAAIS,sBAAAA,CAAiB,CAChC,MAAA,CAAAR,CAAAA,CACA,OAAA,CAAAC,CAAAA,CACA,IAAA,CAAAC,CAAAA,CACA,GAAGI,CACL,CAAC,EAED,IAAA,CAAK,OAAA,CAAU,IAAIG,0BAAAA,CAAmB,CACpC,MAAA,CAAAT,EACA,OAAA,CAAAC,CAAAA,CACA,WAAA,CAAAE,CAAAA,CACA,IAAA,CAAAC,CAAAA,CACA,YAAAC,CAAAA,CACA,GAAGE,CACL,CAAC,EACH,CAaA,OAAc,IAAA,CAAKR,CAAAA,CAA4B,EAAC,CAAU,CACxD,OAAKD,CAAAA,CAAM,WACTA,CAAAA,CAAM,QAAA,CAAW,IAAIA,CAAAA,CAAMC,CAAO,CAAA,CAAA,CAE7BD,EAAM,QACf,CAYA,OAAc,WAAA,EAAqB,CACjC,GAAI,CAACA,CAAAA,CAAM,QAAA,CACT,MAAM,IAAI,KAAA,CAAM,wEAAwE,CAAA,CAE1F,OAAOA,CAAAA,CAAM,QACf,CAYA,OAAc,SAAA,CAAUY,CAAAA,CAAaC,EAAe,KAAA,CAAgB,CAClE,OAAOb,CAAAA,CAAM,WAAA,EAAY,CAAE,MAAM,SAAA,CAAUY,CAAAA,CAAKC,CAAY,CAC9D,CAaA,OAAc,WAAwBD,CAAAA,CAAaE,CAAAA,CAAoBD,CAAAA,CAAqB,CAC1F,OAAOb,CAAAA,CAAM,WAAA,EAAY,CAAE,KAAA,CAAM,UAAA,CAAcY,CAAAA,CAAKE,CAAAA,CAAYD,CAAY,CAC9E,CAWA,OAAc,YAAA,CAAaE,CAAAA,CAAgBC,CAAAA,CAAuC,CAChFhB,CAAAA,CAAM,aAAY,CAAE,OAAA,CAAQ,YAAA,CAAae,CAAAA,CAAOC,CAAK,EACvD,CAWA,aAAoB,QAAA,CAASZ,CAAAA,CAAkC,CAC7D,IAAMa,CAAAA,CAAWjB,CAAAA,CAAM,WAAA,EAAY,CACnCiB,CAAAA,CAAS,OAAA,CAAQ,OAAA,CAAQb,CAAI,CAAA,CAC7B,MAAMa,CAAAA,CAAS,KAAA,CAAM,QAAA,CAASb,CAAI,EACpC,CAQA,OAAc,KAAA,EAAc,CAC1B,IAAMa,CAAAA,CAAWjB,CAAAA,CAAM,WAAA,GACvBiB,CAAAA,CAAS,OAAA,CAAQ,OAAA,CAAQ,IAAI,CAAA,CAC7BA,CAAAA,CAAS,KAAA,CAAM,KAAA,GACjB,CAQA,aAAoB,OAAA,EAAyB,CACvCjB,CAAAA,CAAM,WACR,MAAMA,CAAAA,CAAM,QAAA,CAAS,OAAA,CAAQ,KAAA,EAAM,CACnCA,CAAAA,CAAM,QAAA,CAAS,OAAA,CAAQ,OAAA,EAAQ,CAC/BA,CAAAA,CAAM,QAAA,CAAS,KAAA,CAAM,SAAQ,CAC7BA,CAAAA,CAAM,QAAA,CAAW,IAAA,EAErB,CACF","file":"index.cjs","sourcesContent":["/**\n * @fileoverview Unified Nexus singleton facade wrapping Flags and Tracker clients.\n * @module @nexus/sdk/nexus\n */\n\nimport { NexusFlagsClient } from '@nexussdk/flags';\nimport type { NexusFlagsOptions } from '@nexussdk/flags';\nimport { NexusTrackerClient } from '@nexussdk/tracker';\nimport type { NexusTrackerOptions } from '@nexussdk/tracker';\nimport type { UserContext } from '@nexussdk/contracts';\n\n/**\n * Unified initialization options for the Nexus SDK umbrella.\n *\n * @example\n * Nexus.init({\n *   apiKey: 'pk_live_...',\n *   baseUrl: 'http://localhost:8080',\n *   user: { id: 'usr_12345', country: 'VN' },\n *   environment: 'production',\n *   autoCapture: true,\n * });\n */\nexport interface NexusInitOptions {\n  /** Public API key. Resolved from env if omitted. */\n  apiKey?: string;\n  /** Base URL for all API calls. */\n  baseUrl?: string;\n  /** Initial user context for flag targeting and error attribution. */\n  user?: UserContext;\n  /** Target environment for telemetry routing. Defaults to 'production'. */\n  environment?: string;\n  /** Global tags attached to all telemetry events. */\n  tags?: Record<string, string>;\n  /** Toggle automated global error capture. Defaults to true. */\n  autoCapture?: boolean;\n  /** Additional flags-specific options. */\n  flags?: Partial<NexusFlagsOptions>;\n  /** Additional tracker-specific options. */\n  tracker?: Partial<NexusTrackerOptions>;\n}\n\n/**\n * The Nexus singleton class — the primary unified entry point for the SDK.\n *\n * Provides access to both the feature flags client and the error tracker client.\n * Initialize once, then use throughout your application.\n *\n * @example\n * // Initialize (call once at app startup)\n * Nexus.init({ apiKey: 'pk_live_...' });\n *\n * // Feature flags\n * const showBanner = Nexus.isEnabled('promo_banner_v2', false);\n *\n * // Error tracking\n * Nexus.captureError(new Error('Something went wrong'));\n *\n * // Update user context\n * await Nexus.identify({ id: 'usr_12345', country: 'VN' });\n */\nexport class Nexus {\n  private static instance: Nexus | null = null;\n\n  /** The underlying feature flags client instance. */\n  public readonly flags: NexusFlagsClient;\n  /** The underlying error tracker client instance. */\n  public readonly tracker: NexusTrackerClient;\n\n  private constructor(options: NexusInitOptions = {}) {\n    const { apiKey, baseUrl, user, environment, tags, autoCapture, flags: flagsOpts, tracker: trackerOpts } = options;\n\n    this.flags = new NexusFlagsClient({\n      apiKey,\n      baseUrl,\n      user,\n      ...flagsOpts,\n    });\n\n    this.tracker = new NexusTrackerClient({\n      apiKey,\n      baseUrl,\n      environment,\n      tags,\n      autoCapture,\n      ...trackerOpts,\n    });\n  }\n\n  /**\n   * Initializes the Nexus SDK singleton.\n   * Must be called before any other SDK methods.\n   * Safe to call multiple times — returns existing instance after first init.\n   *\n   * @param options - SDK configuration options.\n   * @returns The initialized Nexus singleton instance.\n   *\n   * @example\n   * const nexus = Nexus.init({ apiKey: 'pk_live_...' });\n   */\n  public static init(options: NexusInitOptions = {}): Nexus {\n    if (!Nexus.instance) {\n      Nexus.instance = new Nexus(options);\n    }\n    return Nexus.instance;\n  }\n\n  /**\n   * Returns the current Nexus singleton instance.\n   *\n   * @returns The active Nexus instance.\n   * @throws {Error} If `Nexus.init()` has not been called yet.\n   *\n   * @example\n   * const nexus = Nexus.getInstance();\n   * nexus.flags.isEnabled('checkout_v2');\n   */\n  public static getInstance(): Nexus {\n    if (!Nexus.instance) {\n      throw new Error('[Nexus SDK] Not initialized. Call Nexus.init({ apiKey: \"...\" }) first.');\n    }\n    return Nexus.instance;\n  }\n\n  /**\n   * Convenience method: Check if a feature flag is enabled.\n   *\n   * @param key - Flag identifier.\n   * @param defaultValue - Fallback if flag is missing.\n   * @returns Boolean enabled state.\n   *\n   * @example\n   * if (Nexus.isEnabled('checkout_redesign')) { ... }\n   */\n  public static isEnabled(key: string, defaultValue = false): boolean {\n    return Nexus.getInstance().flags.isEnabled(key, defaultValue);\n  }\n\n  /**\n   * Convenience method: Get a flag variant value.\n   *\n   * @param key - Flag identifier.\n   * @param variantKey - Variant property name.\n   * @param defaultValue - Fallback value.\n   * @returns Variant value cast to type T.\n   *\n   * @example\n   * const rate = Nexus.getVariant<number>('promo_banner_v2', 'discount_rate', 10);\n   */\n  public static getVariant<T = unknown>(key: string, variantKey: string, defaultValue?: T): T {\n    return Nexus.getInstance().flags.getVariant<T>(key, variantKey, defaultValue);\n  }\n\n  /**\n   * Convenience method: Capture an error manually.\n   *\n   * @param error - Error instance, string, or unknown value.\n   * @param extra - Optional metadata tags.\n   *\n   * @example\n   * Nexus.captureError(new TypeError('Cannot read properties of null'));\n   */\n  public static captureError(error: unknown, extra?: Record<string, unknown>): void {\n    Nexus.getInstance().tracker.captureError(error, extra);\n  }\n\n  /**\n   * Convenience method: Update user context for both flags and tracker.\n   *\n   * @param user - New user context (merged with existing).\n   * @returns Promise resolving after flags refresh.\n   *\n   * @example\n   * await Nexus.identify({ id: 'usr_12345', country: 'VN' });\n   */\n  public static async identify(user: UserContext): Promise<void> {\n    const instance = Nexus.getInstance();\n    instance.tracker.setUser(user);\n    await instance.flags.identify(user);\n  }\n\n  /**\n   * Resets user context to anonymous state (e.g. on logout).\n   *\n   * @example\n   * Nexus.reset(); // called on user logout\n   */\n  public static reset(): void {\n    const instance = Nexus.getInstance();\n    instance.tracker.setUser(null);\n    instance.flags.reset();\n  }\n\n  /**\n   * Gracefully tears down both clients, closing SSE connections and flushing pending events.\n   *\n   * @example\n   * await Nexus.destroy();\n   */\n  public static async destroy(): Promise<void> {\n    if (Nexus.instance) {\n      await Nexus.instance.tracker.flush();\n      Nexus.instance.tracker.destroy();\n      Nexus.instance.flags.destroy();\n      Nexus.instance = null;\n    }\n  }\n}\n"]}

package/dist/index.d.mts

@@ -0,0 +1,151 @@
+import { NexusFlagsClient, NexusFlagsOptions } from '@nexussdk/flags';
+export { INexusFlagsClient, NexusFlagsClient, NexusFlagsOptions } from '@nexussdk/flags';
+import { NexusTrackerClient, NexusTrackerOptions } from '@nexussdk/tracker';
+export { INexusTrackerClient, NexusTrackerClient, NexusTrackerOptions } from '@nexussdk/tracker';
+import { UserContext } from '@nexussdk/contracts';
+export { ErrorEventPayload, FeatureFlag, FlagEvaluationResult, ProblemDetails, UserContext } from '@nexussdk/contracts';
+
+/**
+ * @fileoverview Unified Nexus singleton facade wrapping Flags and Tracker clients.
+ * @module @nexus/sdk/nexus
+ */
+
+/**
+ * Unified initialization options for the Nexus SDK umbrella.
+ *
+ * @example
+ * Nexus.init({
+ *   apiKey: 'pk_live_...',
+ *   baseUrl: 'http://localhost:8080',
+ *   user: { id: 'usr_12345', country: 'VN' },
+ *   environment: 'production',
+ *   autoCapture: true,
+ * });
+ */
+interface NexusInitOptions {
+    /** Public API key. Resolved from env if omitted. */
+    apiKey?: string;
+    /** Base URL for all API calls. */
+    baseUrl?: string;
+    /** Initial user context for flag targeting and error attribution. */
+    user?: UserContext;
+    /** Target environment for telemetry routing. Defaults to 'production'. */
+    environment?: string;
+    /** Global tags attached to all telemetry events. */
+    tags?: Record<string, string>;
+    /** Toggle automated global error capture. Defaults to true. */
+    autoCapture?: boolean;
+    /** Additional flags-specific options. */
+    flags?: Partial<NexusFlagsOptions>;
+    /** Additional tracker-specific options. */
+    tracker?: Partial<NexusTrackerOptions>;
+}
+/**
+ * The Nexus singleton class — the primary unified entry point for the SDK.
+ *
+ * Provides access to both the feature flags client and the error tracker client.
+ * Initialize once, then use throughout your application.
+ *
+ * @example
+ * // Initialize (call once at app startup)
+ * Nexus.init({ apiKey: 'pk_live_...' });
+ *
+ * // Feature flags
+ * const showBanner = Nexus.isEnabled('promo_banner_v2', false);
+ *
+ * // Error tracking
+ * Nexus.captureError(new Error('Something went wrong'));
+ *
+ * // Update user context
+ * await Nexus.identify({ id: 'usr_12345', country: 'VN' });
+ */
+declare class Nexus {
+    private static instance;
+    /** The underlying feature flags client instance. */
+    readonly flags: NexusFlagsClient;
+    /** The underlying error tracker client instance. */
+    readonly tracker: NexusTrackerClient;
+    private constructor();
+    /**
+     * Initializes the Nexus SDK singleton.
+     * Must be called before any other SDK methods.
+     * Safe to call multiple times — returns existing instance after first init.
+     *
+     * @param options - SDK configuration options.
+     * @returns The initialized Nexus singleton instance.
+     *
+     * @example
+     * const nexus = Nexus.init({ apiKey: 'pk_live_...' });
+     */
+    static init(options?: NexusInitOptions): Nexus;
+    /**
+     * Returns the current Nexus singleton instance.
+     *
+     * @returns The active Nexus instance.
+     * @throws {Error} If `Nexus.init()` has not been called yet.
+     *
+     * @example
+     * const nexus = Nexus.getInstance();
+     * nexus.flags.isEnabled('checkout_v2');
+     */
+    static getInstance(): Nexus;
+    /**
+     * Convenience method: Check if a feature flag is enabled.
+     *
+     * @param key - Flag identifier.
+     * @param defaultValue - Fallback if flag is missing.
+     * @returns Boolean enabled state.
+     *
+     * @example
+     * if (Nexus.isEnabled('checkout_redesign')) { ... }
+     */
+    static isEnabled(key: string, defaultValue?: boolean): boolean;
+    /**
+     * Convenience method: Get a flag variant value.
+     *
+     * @param key - Flag identifier.
+     * @param variantKey - Variant property name.
+     * @param defaultValue - Fallback value.
+     * @returns Variant value cast to type T.
+     *
+     * @example
+     * const rate = Nexus.getVariant<number>('promo_banner_v2', 'discount_rate', 10);
+     */
+    static getVariant<T = unknown>(key: string, variantKey: string, defaultValue?: T): T;
+    /**
+     * Convenience method: Capture an error manually.
+     *
+     * @param error - Error instance, string, or unknown value.
+     * @param extra - Optional metadata tags.
+     *
+     * @example
+     * Nexus.captureError(new TypeError('Cannot read properties of null'));
+     */
+    static captureError(error: unknown, extra?: Record<string, unknown>): void;
+    /**
+     * Convenience method: Update user context for both flags and tracker.
+     *
+     * @param user - New user context (merged with existing).
+     * @returns Promise resolving after flags refresh.
+     *
+     * @example
+     * await Nexus.identify({ id: 'usr_12345', country: 'VN' });
+     */
+    static identify(user: UserContext): Promise<void>;
+    /**
+     * Resets user context to anonymous state (e.g. on logout).
+     *
+     * @example
+     * Nexus.reset(); // called on user logout
+     */
+    static reset(): void;
+    /**
+     * Gracefully tears down both clients, closing SSE connections and flushing pending events.
+     *
+     * @example
+     * await Nexus.destroy();
+     */
+    static destroy(): Promise<void>;
+}
+
+export { Nexus, type NexusInitOptions };

package/dist/index.d.ts

@@ -0,0 +1,151 @@
+import { NexusFlagsClient, NexusFlagsOptions } from '@nexussdk/flags';
+export { INexusFlagsClient, NexusFlagsClient, NexusFlagsOptions } from '@nexussdk/flags';
+import { NexusTrackerClient, NexusTrackerOptions } from '@nexussdk/tracker';
+export { INexusTrackerClient, NexusTrackerClient, NexusTrackerOptions } from '@nexussdk/tracker';
+import { UserContext } from '@nexussdk/contracts';
+export { ErrorEventPayload, FeatureFlag, FlagEvaluationResult, ProblemDetails, UserContext } from '@nexussdk/contracts';
+
+/**
+ * @fileoverview Unified Nexus singleton facade wrapping Flags and Tracker clients.
+ * @module @nexus/sdk/nexus
+ */
+
+/**
+ * Unified initialization options for the Nexus SDK umbrella.
+ *
+ * @example
+ * Nexus.init({
+ *   apiKey: 'pk_live_...',
+ *   baseUrl: 'http://localhost:8080',
+ *   user: { id: 'usr_12345', country: 'VN' },
+ *   environment: 'production',
+ *   autoCapture: true,
+ * });
+ */
+interface NexusInitOptions {
+    /** Public API key. Resolved from env if omitted. */
+    apiKey?: string;
+    /** Base URL for all API calls. */
+    baseUrl?: string;
+    /** Initial user context for flag targeting and error attribution. */
+    user?: UserContext;
+    /** Target environment for telemetry routing. Defaults to 'production'. */
+    environment?: string;
+    /** Global tags attached to all telemetry events. */
+    tags?: Record<string, string>;
+    /** Toggle automated global error capture. Defaults to true. */
+    autoCapture?: boolean;
+    /** Additional flags-specific options. */
+    flags?: Partial<NexusFlagsOptions>;
+    /** Additional tracker-specific options. */
+    tracker?: Partial<NexusTrackerOptions>;
+}
+/**
+ * The Nexus singleton class — the primary unified entry point for the SDK.
+ *
+ * Provides access to both the feature flags client and the error tracker client.
+ * Initialize once, then use throughout your application.
+ *
+ * @example
+ * // Initialize (call once at app startup)
+ * Nexus.init({ apiKey: 'pk_live_...' });
+ *
+ * // Feature flags
+ * const showBanner = Nexus.isEnabled('promo_banner_v2', false);
+ *
+ * // Error tracking
+ * Nexus.captureError(new Error('Something went wrong'));
+ *
+ * // Update user context
+ * await Nexus.identify({ id: 'usr_12345', country: 'VN' });
+ */
+declare class Nexus {
+    private static instance;
+    /** The underlying feature flags client instance. */
+    readonly flags: NexusFlagsClient;
+    /** The underlying error tracker client instance. */
+    readonly tracker: NexusTrackerClient;
+    private constructor();
+    /**
+     * Initializes the Nexus SDK singleton.
+     * Must be called before any other SDK methods.
+     * Safe to call multiple times — returns existing instance after first init.
+     *
+     * @param options - SDK configuration options.
+     * @returns The initialized Nexus singleton instance.
+     *
+     * @example
+     * const nexus = Nexus.init({ apiKey: 'pk_live_...' });
+     */
+    static init(options?: NexusInitOptions): Nexus;
+    /**
+     * Returns the current Nexus singleton instance.
+     *
+     * @returns The active Nexus instance.
+     * @throws {Error} If `Nexus.init()` has not been called yet.
+     *
+     * @example
+     * const nexus = Nexus.getInstance();
+     * nexus.flags.isEnabled('checkout_v2');
+     */
+    static getInstance(): Nexus;
+    /**
+     * Convenience method: Check if a feature flag is enabled.
+     *
+     * @param key - Flag identifier.
+     * @param defaultValue - Fallback if flag is missing.
+     * @returns Boolean enabled state.
+     *
+     * @example
+     * if (Nexus.isEnabled('checkout_redesign')) { ... }
+     */
+    static isEnabled(key: string, defaultValue?: boolean): boolean;
+    /**
+     * Convenience method: Get a flag variant value.
+     *
+     * @param key - Flag identifier.
+     * @param variantKey - Variant property name.
+     * @param defaultValue - Fallback value.
+     * @returns Variant value cast to type T.
+     *
+     * @example
+     * const rate = Nexus.getVariant<number>('promo_banner_v2', 'discount_rate', 10);
+     */
+    static getVariant<T = unknown>(key: string, variantKey: string, defaultValue?: T): T;
+    /**
+     * Convenience method: Capture an error manually.
+     *
+     * @param error - Error instance, string, or unknown value.
+     * @param extra - Optional metadata tags.
+     *
+     * @example
+     * Nexus.captureError(new TypeError('Cannot read properties of null'));
+     */
+    static captureError(error: unknown, extra?: Record<string, unknown>): void;
+    /**
+     * Convenience method: Update user context for both flags and tracker.
+     *
+     * @param user - New user context (merged with existing).
+     * @returns Promise resolving after flags refresh.
+     *
+     * @example
+     * await Nexus.identify({ id: 'usr_12345', country: 'VN' });
+     */
+    static identify(user: UserContext): Promise<void>;
+    /**
+     * Resets user context to anonymous state (e.g. on logout).
+     *
+     * @example
+     * Nexus.reset(); // called on user logout
+     */
+    static reset(): void;
+    /**
+     * Gracefully tears down both clients, closing SSE connections and flushing pending events.
+     *
+     * @example
+     * await Nexus.destroy();
+     */
+    static destroy(): Promise<void>;
+}
+
+export { Nexus, type NexusInitOptions };

package/dist/index.global.js

@@ -0,0 +1,9 @@
+var Nexus=(function(exports){'use strict';function f(e,t=1e3,r=3e4){let n=t*Math.pow(2,e),s=Math.min(r,n);return Math.random()*s}function T(e,t){return new Promise((r,n)=>{if(t?.aborted){n(new DOMException("Aborted","AbortError"));return}let s=setTimeout(r,e);t?.addEventListener("abort",()=>{clearTimeout(s),n(new DOMException("Aborted","AbortError"));});})}function O(e){return e>=500||e===429}async function x(e){let{url:t,method:r="GET",headers:n={},body:s,timeoutMs:a=5e3,maxRetries:i=3,retryBaseMs:o=1e3,retryMaxMs:l=3e4,signal:c}=e,d=new Error("Request failed");for(let p=0;p<=i;p++){if(c?.aborted)throw new DOMException("Request aborted by caller.","AbortError");let b=new AbortController,k=setTimeout(()=>b.abort(),a);c?.addEventListener("abort",()=>b.abort());try{let h={method:r,headers:{"Content-Type":"application/json",...n},signal:b.signal};s!==void 0&&(h.body=typeof s=="string"?s:JSON.stringify(s));let u=await fetch(t,h);if(clearTimeout(k),u.ok)return {data:await u.json(),status:u.status,headers:u.headers};if(O(u.status)&&p<i){d=new Error(`HTTP ${u.status}: ${u.statusText}`);let P=f(p,o,l);await T(P,c);continue}let K=await u.text().catch(()=>"");throw new Error(`HTTP ${u.status}: ${K}`)}catch(h){if(clearTimeout(k),h instanceof DOMException&&h.name==="AbortError")throw h;if(d=h instanceof Error?h:new Error(String(h)),p<i){let u=f(p,o,l);await T(u,c);}}}throw d}var C=class{capacity;buffer;head=0;count=0;constructor(e){if(e<1)throw new RangeError(`RingBuffer capacity must be >= 1, got ${e}`);this.capacity=e,this.buffer=new Array(e).fill(void 0);}push(e){this.buffer[this.head]=e,this.head=(this.head+1)%this.capacity,this.count<this.capacity&&this.count++;}toArray(){if(this.count===0)return [];let e=[];if(this.count<this.capacity)for(let t=0;t<this.count;t++)e.push(this.buffer[t]);else for(let t=0;t<this.capacity;t++)e.push(this.buffer[(this.head+t)%this.capacity]);return e}get size(){return this.count}get maxCapacity(){return this.capacity}get isFull(){return this.count===this.capacity}clear(){this.buffer.fill(void 0),this.head=0,this.count=0;}peek(){if(this.count===0)return;let e=(this.head-1+this.capacity)%this.capacity;return this.buffer[e]}};function g(e){try{let t=globalThis.process;if(typeof t<"u"&&t&&t.env)return t.env[e]??void 0}catch{}}function _(e){try{let t=typeof globalThis<"u"&&globalThis.__import_meta__;if(t&&t.env)return t.env[e]??void 0;let r=new Function("try { return import.meta; } catch(e) { return undefined; }")();if(r&&r.env)return r.env[e]??void 0}catch{}}function $(){try{if(typeof window<"u"&&window.__NEXUS_API_KEY__)return window.__NEXUS_API_KEY__}catch{}}function m(e){let t=e||$()||g("NEXUS_API_KEY")||g("NEXT_PUBLIC_NEXUS_API_KEY")||_("VITE_NEXUS_API_KEY")||g("NUXT_PUBLIC_NEXUS_API_KEY");if(!t||t.trim()==="")throw new Error(`[Nexus SDK] No API key found. Please provide one via:
+  1. Nexus.init({ apiKey: "pk_live_..." })
+  2. window.__NEXUS_API_KEY__ = "pk_live_..."
+  3. NEXUS_API_KEY env var
+  4. NEXT_PUBLIC_NEXUS_API_KEY (Next.js)
+  5. VITE_NEXUS_API_KEY (Vite)
+  6. NUXT_PUBLIC_NEXUS_API_KEY (Nuxt)`);return t.trim()}function y(e,t="https://api.nexus.dev"){return (e||g("NEXT_PUBLIC_NEXUS_URL")||_("VITE_NEXUS_URL")||t).replace(/\/$/,"")}function w(e,t,r,n){if(r>n)return "[MaxDepthExceeded]";if(e==null)return e;if(typeof e!="object"&&typeof e!="function")return typeof e=="bigint"||typeof e=="symbol"?e.toString():typeof e=="function"?"[Function]":e;if(e instanceof Error)return {name:e.name,message:e.message,stack:e.stack};if(t.has(e))return "[Circular]";if(t.add(e),Array.isArray(e)){let a=e.map(i=>w(i,t,r+1,n));return t.delete(e),a}let s={};for(let a of Object.keys(e)){let i=e[a];s[a]=w(i,t,r+1,n);}return t.delete(e),s}function E(e,t=8){let r=w(e,new WeakSet,0,t);try{return JSON.stringify(r)}catch{return JSON.stringify({error:"[SerializationFailed]"})}}function D(e,t=0){let r=t>>>0,n=3432918353,s=461845907,a=0,i=Math.floor(e.length/4)*4;for(;a<i;){let c=e.charCodeAt(a)&255|(e.charCodeAt(a+1)&255)<<8|(e.charCodeAt(a+2)&255)<<16|(e.charCodeAt(a+3)&255)<<24;c=Math.imul(c,n),c=c<<15|c>>>17,c=Math.imul(c,s),r^=c,r=r<<13|r>>>19,r=Math.imul(r,5)+3864292196>>>0,a+=4;}let o=0,l=e.length&3;return l>=3&&(o^=(e.charCodeAt(a+2)&255)<<16),l>=2&&(o^=(e.charCodeAt(a+1)&255)<<8),l>=1&&(o^=e.charCodeAt(a)&255,o=Math.imul(o,n),o=o<<15|o>>>17,o=Math.imul(o,s),r^=o),r^=e.length,r^=r>>>16,r=Math.imul(r,2246822507),r^=r>>>13,r=Math.imul(r,3266489909),r^=r>>>16,r>>>0}function B(e,t){let r=`${e}:${t}`;return D(r)%100}function M(e,t){let r=e.replace(/^v/,"").split(".").map(Number),n=t.replace(/^v/,"").split(".").map(Number);for(let s=0;s<3;s++){let a=(r[s]??0)-(n[s]??0);if(a!==0)return a}return 0}function F(e,t){let r=t.split("."),n=e;for(let s of r){if(n==null||typeof n!="object")return;n=n[s];}return n}function H(e,t){let r=F(t,e.attribute),n=e.values;switch(e.operator){case "EQUALS":return r===n[0];case "NOT_EQUALS":return r!==n[0];case "IN":return n.includes(r);case "NOT_IN":return !n.includes(r);case "CONTAINS":return typeof r=="string"&&r.includes(String(n[0]));case "NOT_CONTAINS":return typeof r=="string"&&!r.includes(String(n[0]));case "STARTS_WITH":return typeof r=="string"&&r.startsWith(String(n[0]));case "ENDS_WITH":return typeof r=="string"&&r.endsWith(String(n[0]));case "GREATER_THAN":return typeof r=="number"&&r>Number(n[0]);case "LESS_THAN":return typeof r=="number"&&r<Number(n[0]);case "SEMVER_GTE":return typeof r=="string"&&typeof n[0]=="string"&&M(r,String(n[0]))>=0;case "SEMVER_LTE":return typeof r=="string"&&typeof n[0]=="string"&&M(r,String(n[0]))<=0;default:return  false}}function I(e,t){if(!e.isEnabled)return {key:e.key,enabled:false,variants:{},reason:"KILL_SWITCH",version:e.version};if(e.targetingRules.length>0){if(!e.targetingRules.every(r=>H(r,t)))return {key:e.key,enabled:false,variants:{},reason:"FALLBACK",version:e.version};if(e.rolloutPercentage>=100)return {key:e.key,enabled:true,variants:e.variants,reason:"TARGETING_MATCH",version:e.version}}if(e.rolloutPercentage>0){let r=t.id??"anon";return B(r,e.key)<e.rolloutPercentage?{key:e.key,enabled:true,variants:e.variants,reason:e.targetingRules.length>0?"TARGETING_MATCH":"ROLLOUT_MATCH",version:e.version}:{key:e.key,enabled:false,variants:{},reason:"FALLBACK",version:e.version}}return {key:e.key,enabled:false,variants:{},reason:"KILL_SWITCH",version:e.version}}var j=class{options;eventSource=null;connected=false;destroyed=false;reconnectAttempt=0;reconnectTimer=null;maxReconnects;constructor(e){this.options=e,this.maxReconnects=e.maxReconnects??1/0;}get isConnected(){return this.connected}connect(){this.destroyed||this.connected||this.eventSource||this.openConnection();}disconnect(){this.destroyed=true,this.cleanup();}openConnection(){if(!this.destroyed)try{let e=new URL(this.options.url);e.searchParams.set("apiKey",this.options.apiKey),this.eventSource=new EventSource(e.toString()),this.eventSource.addEventListener("open",()=>{this.connected=!0,this.reconnectAttempt=0,this.options.onStateChange?.(!0);}),this.eventSource.addEventListener("message",t=>{this.handleMessage(t.data);}),this.eventSource.addEventListener("flag_update",t=>{this.handleMessage(t.data);}),this.eventSource.addEventListener("error",()=>{this.connected=!1,this.options.onStateChange?.(!1),this.cleanup(),this.scheduleReconnect();});}catch{this.scheduleReconnect();}}handleMessage(e){try{let t=JSON.parse(e);this.options.onEvent(t);}catch{}}cleanup(){this.eventSource&&(this.eventSource.close(),this.eventSource=null),this.reconnectTimer!==null&&(clearTimeout(this.reconnectTimer),this.reconnectTimer=null);}scheduleReconnect(){if(this.destroyed||this.reconnectAttempt>=this.maxReconnects)return;let e=f(this.reconnectAttempt,1e3,3e4);this.reconnectAttempt++,this.reconnectTimer=setTimeout(()=>{this.reconnectTimer=null,this.destroyed||this.openConnection();},e);}},X="nexus_flags_",R="nexus_anon_id",W=class{memory=new Map;storageKey;localStorageAvailable;broadcastChannel=null;constructor(e){this.storageKey=`${X}${e}`,this.localStorageAvailable=this.testLocalStorage(),this.hydrate(),this.setupBroadcastChannel();}set(e,t){this.memory.set(e,t),this.persist(),this.broadcastUpdate(e,t);}get(e){return this.memory.get(e)}setAll(e){for(let[t,r]of Object.entries(e))this.memory.set(t,r);this.persist();}delete(e){this.memory.delete(e),this.persist();}getAll(){return Object.fromEntries(this.memory.entries())}clear(){if(this.memory.clear(),this.localStorageAvailable)try{window.localStorage.removeItem(this.storageKey);}catch{}this.broadcastChannel?.close();}getOrCreateAnonymousId(){if(typeof window>"u")return "anon-ssr-node";if(this.localStorageAvailable)try{let e=window.localStorage.getItem(R);return e||(e=`anon_${Math.random().toString(36).substring(2,11)}`,window.localStorage.setItem(R,e)),e}catch{}return `anon_${Math.random().toString(36).substring(2,11)}`}testLocalStorage(){try{if(typeof window>"u")return !1;let e="__nexus_test__";return window.localStorage.setItem(e,"1"),window.localStorage.removeItem(e),!0}catch{return  false}}hydrate(){if(this.localStorageAvailable)try{let e=window.localStorage.getItem(this.storageKey);if(e){let t=JSON.parse(e);for(let[r,n]of Object.entries(t))this.memory.set(r,n);}}catch{}}persist(){if(this.localStorageAvailable)try{window.localStorage.setItem(this.storageKey,JSON.stringify(Object.fromEntries(this.memory.entries())));}catch{}}setupBroadcastChannel(){try{typeof BroadcastChannel<"u"&&(this.broadcastChannel=new BroadcastChannel(`nexus_flags_${this.storageKey}`),this.broadcastChannel.onmessage=e=>{e.data?.key&&e.data?.result&&this.memory.set(e.data.key,e.data.result);});}catch{}}broadcastUpdate(e,t){try{this.broadcastChannel?.postMessage({key:e,result:t});}catch{}}},S=class{apiKey;baseUrl;timeoutMs;user;storage;listeners=new Map;sseManager;flagDefinitions=new Map;constructor(e={}){this.apiKey=m(e.apiKey),this.baseUrl=y(e.baseUrl),this.timeoutMs=e.timeoutMs??3e3,this.storage=new W(this.apiKey.substring(0,16)),this.user=e.user??{id:this.storage.getOrCreateAnonymousId()},e.bootstrap&&this.storage.setAll(e.bootstrap),e.realtime!==false&&this.initRealtimeSync(),this.refreshFlags();}isEnabled(e,t=false){let r=this.storage.get(e);return r!==void 0?r.enabled:t}getVariant(e,t,r){let n=this.storage.get(e);if(!n?.enabled||!n.variants)return r;let s=n.variants[t];return s!==void 0?s:r}async identify(e){this.user={...this.user,...e},await this.refreshFlags();}reset(){this.user={id:this.storage.getOrCreateAnonymousId()},this.refreshFlags();}onFlagChange(e,t){return this.listeners.has(e)||this.listeners.set(e,new Set),this.listeners.get(e).add(t),()=>this.listeners.get(e)?.delete(t)}destroy(){this.sseManager?.disconnect(),this.listeners.clear(),this.storage.clear();}initRealtimeSync(){this.sseManager=new j({url:`${this.baseUrl}/api/v1/flags/stream`,apiKey:this.apiKey,onEvent:e=>{if(e.type==="FLAG_UPDATE"&&e.data){let t=this.flagDefinitions.get(e.key),r=t?I(t,this.user):e.data;this.storage.set(e.key,r),this.listeners.get(e.key)?.forEach(n=>n(r));}else e.type==="FLAG_DELETE"&&(this.storage.delete(e.key),this.flagDefinitions.delete(e.key));}}),this.sseManager.connect();}async refreshFlags(){try{let e=await x({url:`${this.baseUrl}/api/v1/flags/eval`,method:"GET",headers:{Authorization:`Bearer ${this.apiKey}`,"X-Nexus-User-Id":this.user.id??"anon","X-Nexus-Country":this.user.country??""},timeoutMs:this.timeoutMs,maxRetries:2});for(let[t,r]of Object.entries(e.data)){this.flagDefinitions.set(t,r);let n=I(r,this.user);this.storage.set(t,n),this.listeners.get(t)?.forEach(s=>s(n));}}catch{}}};var z=/^(password|passwd|token|secret|authorization|bearer|auth|credit_?card|cvv|cvc|ssn|api_?key|access_?token|refresh_?token)$/i,Y=/\b(?:\d[ -]*?){13,16}\b/g,G=/[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}/g,U=/([?&](token|auth|key|secret|password|api_key|access_token|refresh_token)=)[^&]*/gi;function V(e){return e.replace(Y,"[CARD_REDACTED]").replace(G,"[EMAIL_REDACTED]").replace(U,"$1[REDACTED]")}function v(e,t=0){if(t>5)return "[MaxDepthExceeded]";if(e==null)return e;if(typeof e=="string")return V(e);if(typeof e!="object")return e;if(Array.isArray(e))return e.map(n=>v(n,t+1));let r={};for(let[n,s]of Object.entries(e))z.test(n)?r[n]="[REDACTED]":r[n]=v(s,t+1);return r}function L(e){return e.replace(U,"$1[REDACTED]")}function J(e){if(!e)return [];let t=[],r=e.split(`
+`);for(let n of r){let s=n.trim(),a=s.match(/^at\s+(.+?)\s+\((.+?):(\d+):(\d+)\)$/)||s.match(/^at\s+(.+?):(\d+):(\d+)$/)||s.match(/^at\s+\((.+?):(\d+):(\d+)\)$/);if(a){a.length===5?t.push({functionName:a[1]??"<anonymous>",fileName:a[2]??"<unknown>",lineNumber:parseInt(a[3]??"0",10),columnNumber:parseInt(a[4]??"0",10)}):a.length===4&&t.push({functionName:"<anonymous>",fileName:a[1]??"<unknown>",lineNumber:parseInt(a[2]??"0",10),columnNumber:parseInt(a[3]??"0",10)});continue}let i=s.match(/^(.+?)@(.+?):(\d+):(\d+)$/);i&&t.push({functionName:i[1]??"<anonymous>",fileName:i[2]??"<unknown>",lineNumber:parseInt(i[3]??"0",10),columnNumber:parseInt(i[4]??"0",10)});}return t}function Z(e,t,r){let n=r?.fileName??"unknown",s=r?.lineNumber??0,a=`${e}:${t}:${n}:${s}`,i=5381;for(let o=0;o<a.length;o++)i=(i<<5)+i+a.charCodeAt(o)>>>0;return `fp_${i.toString(16).padStart(8,"0")}`}var q=class{buffer;listenersAttached=false;clickHandler;popStateHandler;constructor(e){this.buffer=new C(e),this.clickHandler=this.handleClick.bind(this),this.popStateHandler=this.handleNavigation.bind(this);}push(e){let t=e.data?v(e.data):void 0;this.buffer.push({...e,data:t,timestamp:Date.now()});}getAll(){return this.buffer.toArray()}clear(){this.buffer.clear();}attachListeners(){this.listenersAttached||typeof window>"u"||(this.listenersAttached=true,document.addEventListener("click",this.clickHandler,{capture:true,passive:true}),window.addEventListener("popstate",this.popStateHandler,{passive:true}),this.interceptConsoleError());}detachListeners(){!this.listenersAttached||typeof window>"u"||(document.removeEventListener("click",this.clickHandler,{capture:true}),window.removeEventListener("popstate",this.popStateHandler),this.listenersAttached=false);}handleClick(e){let t=e.target;if(!t||t instanceof HTMLInputElement&&(t.type==="password"||t.hasAttribute("data-nexus-mask")))return;let r=this.describeElement(t);this.push({category:"ui.click",message:`Clicked ${r}`,level:"info",data:{elementTag:t.tagName.toLowerCase(),elementId:t.id||void 0,elementClass:t.className||void 0}});}handleNavigation(){this.push({category:"navigation",message:`Navigated to ${L(window.location.href)}`,level:"info",data:{url:L(window.location.href)}});}describeElement(e){let t=[e.tagName.toLowerCase()];return e.id&&t.push(`#${e.id}`),e.getAttribute("aria-label")&&t.push(`[aria-label="${e.getAttribute("aria-label")}"]`),t.join("")}interceptConsoleError(){let e=console.error.bind(console);console.error=(...t)=>{this.push({category:"console",message:t.map(String).join(" ").substring(0,500),level:"error"}),e(...t);};}},Q=class{options;maxRetries;isPageHiding=false;constructor(e){this.options=e,this.maxRetries=e.maxRetries??2,typeof document<"u"&&document.addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"&&(this.isPageHiding=true);}),typeof window<"u"&&window.addEventListener("pagehide",()=>{this.isPageHiding=true;});}send(e){let t=E(e);if(this.isPageHiding&&typeof navigator<"u"&&typeof navigator.sendBeacon=="function"){let r=new Blob([t],{type:"application/json"});navigator.sendBeacon(this.options.endpoint,r);return}this.sendWithRetry(t,0);}async flush(e){let t=E(e);if(typeof navigator<"u"&&typeof navigator.sendBeacon=="function"){let r=new Blob([t],{type:"application/json"});navigator.sendBeacon(this.options.endpoint,r);return}await this.sendWithRetry(t,0);}async sendWithRetry(e,t){try{let r=await fetch(this.options.endpoint,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${this.options.apiKey}`},body:e,keepalive:!0});if(r.ok)return;if(r.status>=500&&t<this.maxRetries){let n=f(t,1e3,3e4);await new Promise(s=>setTimeout(s,n)),await this.sendWithRetry(e,t+1);}}catch{if(t<this.maxRetries){let r=f(t,1e3,3e4);await new Promise(n=>setTimeout(n,r)),await this.sendWithRetry(e,t+1);}}}};function ee(e){if(typeof window>"u")return ()=>{};let t=n=>{let s=n.error instanceof Error?n.error:new Error(n.message);e.captureError(s);},r=n=>{e.captureError(n.reason);};return window.addEventListener("error",t),window.addEventListener("unhandledrejection",r),()=>{window.removeEventListener("error",t),window.removeEventListener("unhandledrejection",r);}}var A=class{apiKey;environment;tags;beforeSend;breadcrumbManager;transport;userContext;dedupeMap=new Map;cleanupListeners;constructor(e={}){this.apiKey=m(e.apiKey);let t=y(e.baseUrl);this.environment=e.environment??"production",this.tags={...e.tags},this.beforeSend=e.beforeSend,this.breadcrumbManager=new q(Math.min(e.maxBreadcrumbs??20,50)),this.transport=new Q({endpoint:`${t}/api/v1/telemetry/errors`,apiKey:this.apiKey}),e.autoCapture!==false&&typeof window<"u"&&(this.breadcrumbManager.attachListeners(),this.cleanupListeners=ee(this));}captureError(e,t){let r=this.normalizeError(e),n=J(r.stack),s=Z(r.type,r.message,n[0]),a=this.dedupeMap.get(s);if(a){a.count+=1;return}let i={fingerprint:s,errorType:r.type,errorMessage:r.message,stackTrace:n,breadcrumbs:this.breadcrumbManager.getAll(),userContext:this.userContext,deviceContext:this.getDeviceContext(),tags:{environment:this.environment,...this.tags,...t},occurrenceCount:1,clientTimestamp:Date.now()},o=v(i),l=this.beforeSend?this.beforeSend(o):o;if(!l)return;this.transport.send(l);let c=setTimeout(()=>{let d=this.dedupeMap.get(s);if(d&&d.count>1){let p={...d.lastPayload,occurrenceCount:d.count,clientTimestamp:Date.now()};this.transport.send(p);}this.dedupeMap.delete(s);},1e4);this.dedupeMap.set(s,{timer:c,count:1,lastPayload:l});}addBreadcrumb(e){this.breadcrumbManager.push(e);}setUser(e){this.userContext=e??void 0;}setTag(e,t){this.tags[e]=t;}async flush(){for(let[e,t]of this.dedupeMap.entries()){if(clearTimeout(t.timer),t.count>0){let r={...t.lastPayload,occurrenceCount:t.count,clientTimestamp:Date.now()};await this.transport.flush(r);}this.dedupeMap.delete(e);}}destroy(){this.cleanupListeners?.(),this.breadcrumbManager.detachListeners(),this.breadcrumbManager.clear(),this.dedupeMap.forEach(e=>clearTimeout(e.timer)),this.dedupeMap.clear();}normalizeError(e){return e instanceof Error?{type:e.name||"Error",message:e.message,stack:e.stack}:typeof e=="string"?{type:"UnhandledException",message:e}:{type:"NonErrorRejection",message:String(e)}}getDeviceContext(){let e=typeof window<"u"&&typeof navigator<"u";return {userAgent:e?navigator.userAgent:"Node/SSR",currentUrl:e?window.location.href:"",viewport:e?`${window.innerWidth}x${window.innerHeight}`:void 0,timezone:Intl?.DateTimeFormat()?.resolvedOptions()?.timeZone,networkStatus:e&&"connection"in navigator?navigator.connection?.effectiveType??"unknown":void 0}}};var N=class e{static instance=null;flags;tracker;constructor(t={}){let{apiKey:r,baseUrl:n,user:s,environment:a,tags:i,autoCapture:o,flags:l,tracker:c}=t;this.flags=new S({apiKey:r,baseUrl:n,user:s,...l}),this.tracker=new A({apiKey:r,baseUrl:n,environment:a,tags:i,autoCapture:o,...c});}static init(t={}){return e.instance||(e.instance=new e(t)),e.instance}static getInstance(){if(!e.instance)throw new Error('[Nexus SDK] Not initialized. Call Nexus.init({ apiKey: "..." }) first.');return e.instance}static isEnabled(t,r=false){return e.getInstance().flags.isEnabled(t,r)}static getVariant(t,r,n){return e.getInstance().flags.getVariant(t,r,n)}static captureError(t,r){e.getInstance().tracker.captureError(t,r);}static async identify(t){let r=e.getInstance();r.tracker.setUser(t),await r.flags.identify(t);}static reset(){let t=e.getInstance();t.tracker.setUser(null),t.flags.reset();}static async destroy(){e.instance&&(await e.instance.tracker.flush(),e.instance.tracker.destroy(),e.instance.flags.destroy(),e.instance=null);}};exports.Nexus=N;exports.NexusFlagsClient=S;exports.NexusTrackerClient=A;return exports;})({});//# sourceMappingURL=index.global.js.map
+//# sourceMappingURL=index.global.js.map