@nexussdk/sdk 0.0.1 → 0.0.4

package/dist/vue.cjs

@@ -0,0 +1,2 @@
+'use strict';var vue=require('vue'),flags=require('@nexussdk/flags'),tracker=require('@nexussdk/tracker');var p=class e{static instance=null;static vitalsCleanup=null;flags;tracker;constructor(t={}){let{apiKey:n,baseUrl:r,user:o,environment:a,tags:s,autoCapture:i,sampling:f,transport:x,vitals:l,devServer:c,flags:g,tracker:C}=t;this.flags=new flags.NexusFlagsClient({apiKey:n,baseUrl:r,user:o,...g});let m=r,I=x;if(c?.enabled){let d=c.port??4567;m=`http://${c.host??"localhost"}:${d}`;}if(this.tracker=new tracker.NexusTrackerClient({apiKey:n,baseUrl:m,environment:a,tags:s,autoCapture:i,sampling:f,transport:I,...C}),l){let d=typeof l=="object"?l:{};e.vitalsCleanup=tracker.attachWebVitals(this.tracker,d);}}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,n=false){return e.getInstance().flags.isEnabled(t,n)}static getVariant(t,n,r){return e.getInstance().flags.getVariant(t,n,r)}static captureError(t,n){e.getInstance().tracker.captureError(t,n);}static captureMessage(t,n="info",r){e.getInstance().tracker.captureMessage(t,n,r);}static addBreadcrumb(t){e.getInstance().tracker.addBreadcrumb(t);}static setExtra(t,n){e.getInstance().tracker.setExtra(t,n);}static attachWebVitals(t){return tracker.attachWebVitals(e.getInstance().tracker,t)}static async identify(t){let n=e.getInstance();n.tracker.setUser(t),await n.flags.identify(t);}static reset(){let t=e.getInstance();t.tracker.setUser(null),t.flags.reset();}static async destroy(){e.vitalsCleanup&&(e.vitalsCleanup(),e.vitalsCleanup=null),e.instance&&(await e.instance.tracker.flush(),e.instance.tracker.destroy(),e.instance.flags.destroy(),e.instance=null);}};var y=Symbol("NexusSDK"),H={install(e,t={}){let n=p.init(t),r={flags:n.flags,tracker:n.tracker,nexus:n};e.provide(y,r);let o=e.config.errorHandler;e.config.errorHandler=(a,s,i)=>{n.tracker.captureError(a,{componentStack:i,tags:{framework:"vue3",component:s?.$options?.name||"AnonymousComponent"}}),o&&o(a,s,i);},e.component("NexusGuard",R);}};function N(){let e=vue.inject(y);if(e)return e;let t=p.getInstance();return {flags:t.flags,tracker:t.tracker,nexus:t}}function A(e,t=false){let{flags:n}=N(),r=vue.ref(n.isEnabled(e,t)),o=vue.shallowRef(null),a=n.onFlagChange(e,s=>{r.value=s.enabled,o.value=s;});return vue.onUnmounted(()=>{a();}),{enabled:r,getVariant:(s,i)=>n.getVariant(e,s,i),result:o}}var R=vue.defineComponent({name:"NexusGuard",props:{onError:{type:Function,default:void 0},tags:{type:Object,default:()=>({})}},setup(e,{slots:t}){let n=vue.ref(false),r=vue.shallowRef(null),o=()=>{n.value=false,r.value=null;};return vue.onErrorCaptured((a,s,i)=>{let f=tracker.parseStackTrace(a.stack),l=`NX-${tracker.computeFingerprint(a.name,a.message,f[0]).replace(/^fp_/,"").slice(0,8).toUpperCase()}`,c={error:a,errorId:l,componentStack:i,reset:o};n.value=true,r.value=c;try{let{tracker:g}=N();g.captureError(a,{componentStack:i,tags:{...e.tags,guardErrorId:l,framework:"vue3",component:s?.$options?.name||"AnonymousComponent"}});}catch{}if(e.onError)try{e.onError(a,c);}catch{}return  false}),()=>n.value&&r.value?t.fallback?t.fallback(r.value):vue.h("div",{role:"alert",style:{padding:"16px 20px",margin:"12px 0",borderRadius:"8px",backgroundColor:"#1f1315",border:"1px solid #7f1d1d",color:"#fca5a5",fontFamily:"-apple-system, BlinkMacSystemFont, Segoe UI, Roboto, sans-serif",fontSize:"14px"}},[vue.h("div",{style:{display:"flex",justifyContent:"space-between",marginBottom:"8px"}},[vue.h("strong",{style:{color:"#ef4444"}},"Vue Component Crash Protected"),vue.h("span",{style:{fontFamily:"monospace",fontSize:"12px",background:"#450a0a",padding:"2px 8px",borderRadius:"4px"}},r.value.errorId)]),vue.h("p",{style:{margin:"0 0 12px 0",color:"#fecaca"}},r.value.error.message),vue.h("button",{type:"button",onClick:o,style:{background:"#b91c1c",border:"none",color:"#fff",padding:"6px 14px",borderRadius:"6px",fontSize:"13px",cursor:"pointer",fontWeight:"500"}},"Retry Component")]):t.default?t.default():null}});
+exports.NEXUS_KEY=y;exports.NexusGuardVue=R;exports.NexusPlugin=H;exports.useFlag=A;exports.useNexus=N;

package/dist/vue.d.mts

@@ -0,0 +1,234 @@
+import * as vue from 'vue';
+import { InjectionKey, Plugin, Ref } from 'vue';
+import { NexusFlagsClient, NexusFlagsOptions } from '@nexussdk/flags';
+import { NexusTrackerClient, NexusTrackerOptions } from '@nexussdk/tracker';
+import { UserContext, SamplingConfig, TransportPlugin, PerformanceVitalsOptions, SeverityLevel, Breadcrumb, NexusErrorInfo, FlagEvaluationResult } from '@nexussdk/contracts';
+
+/**
+ * @fileoverview Unified Nexus singleton facade wrapping Flags and Tracker clients.
+ * @module @nexus/sdk/nexus
+ */
+
+/**
+ * Dev server routing configuration.
+ */
+interface NexusDevServerOptions {
+    /** Enable local dev server ingestion mode. Auto-enabled in development if true. */
+    enabled?: boolean;
+    /** Port the dev server is listening on. Defaults to 4567. */
+    port?: number;
+    /** Host the dev server is bound to. Defaults to 'localhost'. */
+    host?: string;
+}
+/**
+ * Unified initialization options for the Nexus SDK umbrella.
+ *
+ * @example
+ * Nexus.init({
+ *   apiKey: 'pk_live_...',
+ *   user: { id: 'usr_12345', country: 'VN' },
+ *   environment: 'production',
+ *   autoCapture: true,
+ *   devServer: { enabled: process.env.NODE_ENV === 'development' },
+ * });
+ */
+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;
+    /** Client-side rate limiting and deduplication sampling options. */
+    sampling?: SamplingConfig;
+    /** Pluggable transport adapter ('fetch', 'console', 'localStorage', custom fn). */
+    transport?: TransportPlugin;
+    /** Web Vitals performance observer options, or true for default observation. */
+    vitals?: boolean | PerformanceVitalsOptions;
+    /** Local dev server auto-routing configuration. */
+    devServer?: NexusDevServerOptions;
+    /** 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;
+    private static vitalsCleanup;
+    /** 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.
+     */
+    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.
+     */
+    static getInstance(): Nexus;
+    /**
+     * Convenience method: Check if a feature flag is enabled.
+     */
+    static isEnabled(key: string, defaultValue?: boolean): boolean;
+    /**
+     * Convenience method: Get a flag variant value.
+     */
+    static getVariant<T = unknown>(key: string, variantKey: string, defaultValue?: T): T;
+    /**
+     * Convenience method: Capture an error manually.
+     */
+    static captureError(error: unknown, extra?: Record<string, unknown>): void;
+    /**
+     * Convenience method: Capture an informational or warning message event.
+     */
+    static captureMessage(message: string, level?: SeverityLevel, extra?: Record<string, unknown>): void;
+    /**
+     * Convenience method: Add a breadcrumb manually.
+     */
+    static addBreadcrumb(breadcrumb: Breadcrumb): void;
+    /**
+     * Convenience method: Set extra contextual metadata.
+     */
+    static setExtra(key: string, value: unknown): void;
+    /**
+     * Convenience method: Attach Web Vitals observer to tracker.
+     */
+    static attachWebVitals(options?: PerformanceVitalsOptions): () => void;
+    /**
+     * Convenience method: Update user context for both flags and tracker.
+     */
+    static identify(user: UserContext): Promise<void>;
+    /**
+     * Resets user context to anonymous state (e.g. on logout).
+     */
+    static reset(): void;
+    /**
+     * Gracefully tears down both clients, closing SSE connections and flushing pending events.
+     */
+    static destroy(): Promise<void>;
+}
+
+interface NexusVueContext {
+    flags: NexusFlagsClient;
+    tracker: NexusTrackerClient;
+    nexus: Nexus;
+}
+declare const NEXUS_KEY: InjectionKey<NexusVueContext>;
+/**
+ * Vue 3 Plugin for initializing Nexus SDK and setting up global error handling.
+ *
+ * @example
+ * // main.ts
+ * import { createApp } from 'vue';
+ * import { NexusPlugin } from '@nexussdk/sdk/vue';
+ * import App from './App.vue';
+ *
+ * const app = createApp(App);
+ * app.use(NexusPlugin, {
+ *   apiKey: 'pk_live_...',
+ *   environment: 'production',
+ * });
+ * app.mount('#app');
+ */
+declare const NexusPlugin: Plugin;
+/**
+ * Returns the Nexus context in a Vue component setup function.
+ *
+ * @example
+ * const { flags, tracker } = useNexus();
+ * tracker.captureMessage('Button clicked', 'info');
+ */
+declare function useNexus(): NexusVueContext;
+interface UseFlagVueResult {
+    enabled: Ref<boolean>;
+    getVariant: <T = unknown>(variantKey: string, defaultValue?: T) => T;
+    result: Ref<FlagEvaluationResult | null>;
+}
+/**
+ * Vue 3 composable for subscribing to real-time feature flag changes.
+ *
+ * @example
+ * const { enabled, getVariant } = useFlag('promo_banner_v2');
+ */
+declare function useFlag(key: string, defaultEnabled?: boolean): UseFlagVueResult;
+/**
+ * Vue 3 Error Boundary component using `onErrorCaptured`.
+ * Traps unhandled errors from child components, prevents crash propagation,
+ * and renders a customizable fallback via scoped slots or props.
+ *
+ * @example
+ * <!-- App.vue -->
+ * <NexusGuard>
+ *   <template #fallback="{ error, errorId, reset }">
+ *     <div class="custom-error">
+ *       <h3>Error: {{ error.message }}</h3>
+ *       <p>Ref: {{ errorId }}</p>
+ *       <button @click="reset">Retry</button>
+ *     </div>
+ *   </template>
+ *   <MyWidget />
+ * </NexusGuard>
+ */
+declare const NexusGuardVue: vue.DefineComponent<vue.ExtractPropTypes<{
+    onError: {
+        type: () => (error: Error, info: NexusErrorInfo) => void;
+        default: undefined;
+    };
+    tags: {
+        type: () => Record<string, string>;
+        default: () => {};
+    };
+}>, () => vue.VNode<vue.RendererNode, vue.RendererElement, {
+    [key: string]: any;
+}> | vue.VNode<vue.RendererNode, vue.RendererElement, {
+    [key: string]: any;
+}>[] | null, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {}, string, vue.PublicProps, Readonly<vue.ExtractPropTypes<{
+    onError: {
+        type: () => (error: Error, info: NexusErrorInfo) => void;
+        default: undefined;
+    };
+    tags: {
+        type: () => Record<string, string>;
+        default: () => {};
+    };
+}>> & Readonly<{}>, {
+    onError: (error: Error, info: NexusErrorInfo) => void;
+    tags: Record<string, string>;
+}, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
+
+export { NEXUS_KEY, NexusGuardVue, NexusPlugin, type NexusVueContext, type UseFlagVueResult, useFlag, useNexus };

package/dist/vue.d.ts

@@ -0,0 +1,234 @@
+import * as vue from 'vue';
+import { InjectionKey, Plugin, Ref } from 'vue';
+import { NexusFlagsClient, NexusFlagsOptions } from '@nexussdk/flags';
+import { NexusTrackerClient, NexusTrackerOptions } from '@nexussdk/tracker';
+import { UserContext, SamplingConfig, TransportPlugin, PerformanceVitalsOptions, SeverityLevel, Breadcrumb, NexusErrorInfo, FlagEvaluationResult } from '@nexussdk/contracts';
+
+/**
+ * @fileoverview Unified Nexus singleton facade wrapping Flags and Tracker clients.
+ * @module @nexus/sdk/nexus
+ */
+
+/**
+ * Dev server routing configuration.
+ */
+interface NexusDevServerOptions {
+    /** Enable local dev server ingestion mode. Auto-enabled in development if true. */
+    enabled?: boolean;
+    /** Port the dev server is listening on. Defaults to 4567. */
+    port?: number;
+    /** Host the dev server is bound to. Defaults to 'localhost'. */
+    host?: string;
+}
+/**
+ * Unified initialization options for the Nexus SDK umbrella.
+ *
+ * @example
+ * Nexus.init({
+ *   apiKey: 'pk_live_...',
+ *   user: { id: 'usr_12345', country: 'VN' },
+ *   environment: 'production',
+ *   autoCapture: true,
+ *   devServer: { enabled: process.env.NODE_ENV === 'development' },
+ * });
+ */
+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;
+    /** Client-side rate limiting and deduplication sampling options. */
+    sampling?: SamplingConfig;
+    /** Pluggable transport adapter ('fetch', 'console', 'localStorage', custom fn). */
+    transport?: TransportPlugin;
+    /** Web Vitals performance observer options, or true for default observation. */
+    vitals?: boolean | PerformanceVitalsOptions;
+    /** Local dev server auto-routing configuration. */
+    devServer?: NexusDevServerOptions;
+    /** 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;
+    private static vitalsCleanup;
+    /** 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.
+     */
+    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.
+     */
+    static getInstance(): Nexus;
+    /**
+     * Convenience method: Check if a feature flag is enabled.
+     */
+    static isEnabled(key: string, defaultValue?: boolean): boolean;
+    /**
+     * Convenience method: Get a flag variant value.
+     */
+    static getVariant<T = unknown>(key: string, variantKey: string, defaultValue?: T): T;
+    /**
+     * Convenience method: Capture an error manually.
+     */
+    static captureError(error: unknown, extra?: Record<string, unknown>): void;
+    /**
+     * Convenience method: Capture an informational or warning message event.
+     */
+    static captureMessage(message: string, level?: SeverityLevel, extra?: Record<string, unknown>): void;
+    /**
+     * Convenience method: Add a breadcrumb manually.
+     */
+    static addBreadcrumb(breadcrumb: Breadcrumb): void;
+    /**
+     * Convenience method: Set extra contextual metadata.
+     */
+    static setExtra(key: string, value: unknown): void;
+    /**
+     * Convenience method: Attach Web Vitals observer to tracker.
+     */
+    static attachWebVitals(options?: PerformanceVitalsOptions): () => void;
+    /**
+     * Convenience method: Update user context for both flags and tracker.
+     */
+    static identify(user: UserContext): Promise<void>;
+    /**
+     * Resets user context to anonymous state (e.g. on logout).
+     */
+    static reset(): void;
+    /**
+     * Gracefully tears down both clients, closing SSE connections and flushing pending events.
+     */
+    static destroy(): Promise<void>;
+}
+
+interface NexusVueContext {
+    flags: NexusFlagsClient;
+    tracker: NexusTrackerClient;
+    nexus: Nexus;
+}
+declare const NEXUS_KEY: InjectionKey<NexusVueContext>;
+/**
+ * Vue 3 Plugin for initializing Nexus SDK and setting up global error handling.
+ *
+ * @example
+ * // main.ts
+ * import { createApp } from 'vue';
+ * import { NexusPlugin } from '@nexussdk/sdk/vue';
+ * import App from './App.vue';
+ *
+ * const app = createApp(App);
+ * app.use(NexusPlugin, {
+ *   apiKey: 'pk_live_...',
+ *   environment: 'production',
+ * });
+ * app.mount('#app');
+ */
+declare const NexusPlugin: Plugin;
+/**
+ * Returns the Nexus context in a Vue component setup function.
+ *
+ * @example
+ * const { flags, tracker } = useNexus();
+ * tracker.captureMessage('Button clicked', 'info');
+ */
+declare function useNexus(): NexusVueContext;
+interface UseFlagVueResult {
+    enabled: Ref<boolean>;
+    getVariant: <T = unknown>(variantKey: string, defaultValue?: T) => T;
+    result: Ref<FlagEvaluationResult | null>;
+}
+/**
+ * Vue 3 composable for subscribing to real-time feature flag changes.
+ *
+ * @example
+ * const { enabled, getVariant } = useFlag('promo_banner_v2');
+ */
+declare function useFlag(key: string, defaultEnabled?: boolean): UseFlagVueResult;
+/**
+ * Vue 3 Error Boundary component using `onErrorCaptured`.
+ * Traps unhandled errors from child components, prevents crash propagation,
+ * and renders a customizable fallback via scoped slots or props.
+ *
+ * @example
+ * <!-- App.vue -->
+ * <NexusGuard>
+ *   <template #fallback="{ error, errorId, reset }">
+ *     <div class="custom-error">
+ *       <h3>Error: {{ error.message }}</h3>
+ *       <p>Ref: {{ errorId }}</p>
+ *       <button @click="reset">Retry</button>
+ *     </div>
+ *   </template>
+ *   <MyWidget />
+ * </NexusGuard>
+ */
+declare const NexusGuardVue: vue.DefineComponent<vue.ExtractPropTypes<{
+    onError: {
+        type: () => (error: Error, info: NexusErrorInfo) => void;
+        default: undefined;
+    };
+    tags: {
+        type: () => Record<string, string>;
+        default: () => {};
+    };
+}>, () => vue.VNode<vue.RendererNode, vue.RendererElement, {
+    [key: string]: any;
+}> | vue.VNode<vue.RendererNode, vue.RendererElement, {
+    [key: string]: any;
+}>[] | null, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {}, string, vue.PublicProps, Readonly<vue.ExtractPropTypes<{
+    onError: {
+        type: () => (error: Error, info: NexusErrorInfo) => void;
+        default: undefined;
+    };
+    tags: {
+        type: () => Record<string, string>;
+        default: () => {};
+    };
+}>> & Readonly<{}>, {
+    onError: (error: Error, info: NexusErrorInfo) => void;
+    tags: Record<string, string>;
+}, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
+
+export { NEXUS_KEY, NexusGuardVue, NexusPlugin, type NexusVueContext, type UseFlagVueResult, useFlag, useNexus };

package/dist/vue.mjs

@@ -0,0 +1,2 @@
+import {defineComponent,ref,shallowRef,onErrorCaptured,h,inject,onUnmounted}from'vue';import {NexusFlagsClient}from'@nexussdk/flags';import {parseStackTrace,computeFingerprint,NexusTrackerClient,attachWebVitals}from'@nexussdk/tracker';var p=class e{static instance=null;static vitalsCleanup=null;flags;tracker;constructor(t={}){let{apiKey:n,baseUrl:r,user:o,environment:a,tags:s,autoCapture:i,sampling:f,transport:x,vitals:l,devServer:c,flags:g,tracker:C}=t;this.flags=new NexusFlagsClient({apiKey:n,baseUrl:r,user:o,...g});let m=r,I=x;if(c?.enabled){let d=c.port??4567;m=`http://${c.host??"localhost"}:${d}`;}if(this.tracker=new NexusTrackerClient({apiKey:n,baseUrl:m,environment:a,tags:s,autoCapture:i,sampling:f,transport:I,...C}),l){let d=typeof l=="object"?l:{};e.vitalsCleanup=attachWebVitals(this.tracker,d);}}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,n=false){return e.getInstance().flags.isEnabled(t,n)}static getVariant(t,n,r){return e.getInstance().flags.getVariant(t,n,r)}static captureError(t,n){e.getInstance().tracker.captureError(t,n);}static captureMessage(t,n="info",r){e.getInstance().tracker.captureMessage(t,n,r);}static addBreadcrumb(t){e.getInstance().tracker.addBreadcrumb(t);}static setExtra(t,n){e.getInstance().tracker.setExtra(t,n);}static attachWebVitals(t){return attachWebVitals(e.getInstance().tracker,t)}static async identify(t){let n=e.getInstance();n.tracker.setUser(t),await n.flags.identify(t);}static reset(){let t=e.getInstance();t.tracker.setUser(null),t.flags.reset();}static async destroy(){e.vitalsCleanup&&(e.vitalsCleanup(),e.vitalsCleanup=null),e.instance&&(await e.instance.tracker.flush(),e.instance.tracker.destroy(),e.instance.flags.destroy(),e.instance=null);}};var y=Symbol("NexusSDK"),H={install(e,t={}){let n=p.init(t),r={flags:n.flags,tracker:n.tracker,nexus:n};e.provide(y,r);let o=e.config.errorHandler;e.config.errorHandler=(a,s,i)=>{n.tracker.captureError(a,{componentStack:i,tags:{framework:"vue3",component:s?.$options?.name||"AnonymousComponent"}}),o&&o(a,s,i);},e.component("NexusGuard",R);}};function N(){let e=inject(y);if(e)return e;let t=p.getInstance();return {flags:t.flags,tracker:t.tracker,nexus:t}}function A(e,t=false){let{flags:n}=N(),r=ref(n.isEnabled(e,t)),o=shallowRef(null),a=n.onFlagChange(e,s=>{r.value=s.enabled,o.value=s;});return onUnmounted(()=>{a();}),{enabled:r,getVariant:(s,i)=>n.getVariant(e,s,i),result:o}}var R=defineComponent({name:"NexusGuard",props:{onError:{type:Function,default:void 0},tags:{type:Object,default:()=>({})}},setup(e,{slots:t}){let n=ref(false),r=shallowRef(null),o=()=>{n.value=false,r.value=null;};return onErrorCaptured((a,s,i)=>{let f=parseStackTrace(a.stack),l=`NX-${computeFingerprint(a.name,a.message,f[0]).replace(/^fp_/,"").slice(0,8).toUpperCase()}`,c={error:a,errorId:l,componentStack:i,reset:o};n.value=true,r.value=c;try{let{tracker:g}=N();g.captureError(a,{componentStack:i,tags:{...e.tags,guardErrorId:l,framework:"vue3",component:s?.$options?.name||"AnonymousComponent"}});}catch{}if(e.onError)try{e.onError(a,c);}catch{}return  false}),()=>n.value&&r.value?t.fallback?t.fallback(r.value):h("div",{role:"alert",style:{padding:"16px 20px",margin:"12px 0",borderRadius:"8px",backgroundColor:"#1f1315",border:"1px solid #7f1d1d",color:"#fca5a5",fontFamily:"-apple-system, BlinkMacSystemFont, Segoe UI, Roboto, sans-serif",fontSize:"14px"}},[h("div",{style:{display:"flex",justifyContent:"space-between",marginBottom:"8px"}},[h("strong",{style:{color:"#ef4444"}},"Vue Component Crash Protected"),h("span",{style:{fontFamily:"monospace",fontSize:"12px",background:"#450a0a",padding:"2px 8px",borderRadius:"4px"}},r.value.errorId)]),h("p",{style:{margin:"0 0 12px 0",color:"#fecaca"}},r.value.error.message),h("button",{type:"button",onClick:o,style:{background:"#b91c1c",border:"none",color:"#fff",padding:"6px 14px",borderRadius:"6px",fontSize:"13px",cursor:"pointer",fontWeight:"500"}},"Retry Component")]):t.default?t.default():null}});
+export{y as NEXUS_KEY,R as NexusGuardVue,H as NexusPlugin,A as useFlag,N as useNexus};

package/package.json

@@ -1,11 +1,52 @@
 {
   "name": "@nexussdk/sdk",
-  "version": "0.0.1",
+  "version": "0.0.4",
   "private": false,
   "publishConfig": {
     "access": "public"
   },
   "description": "Unified umbrella SDK for Nexus Platform — feature flags + error tracking + React hooks",
+  "license": "MIT",
+  "author": "Nexus",
+  "contributors": [
+    {
+      "name": "Hồ Huỳnh Dũng",
+      "email": "hohuynhdung@gmail.com",
+      "url": "https://github.com/Huynhdung295"
+    }
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Huynhdung295/NexusSDK.git",
+    "directory": "packages/sdk"
+  },
+  "homepage": "https://github.com/Huynhdung295/NexusSDK#readme",
+  "bugs": {
+    "url": "https://github.com/Huynhdung295/NexusSDK/issues"
+  },
+  "keywords": [
+    "nexus",
+    "nexussdk",
+    "feature-flags",
+    "feature-management",
+    "remote-config",
+    "telemetry",
+    "error-tracking",
+    "error-monitoring",
+    "error-boundary",
+    "web-vitals",
+    "pii-sanitizer",
+    "react",
+    "vue",
+    "nextjs",
+    "nuxt",
+    "sdk",
+    "zero-dependencies"
+  ],
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
@@ -19,28 +60,40 @@
       "types": "./dist/react.d.ts",
       "import": "./dist/react.mjs",
       "require": "./dist/react.cjs"
+    },
+    "./vue": {
+      "types": "./dist/vue.d.ts",
+      "import": "./dist/vue.mjs",
+      "require": "./dist/vue.cjs"
     }
   },
   "dependencies": {
-    "@nexussdk/core": "0.0.1",
-    "@nexussdk/flags": "0.0.1",
-    "@nexussdk/tracker": "0.0.1",
-    "@nexussdk/contracts": "0.0.1"
+    "@nexussdk/contracts": "0.0.4",
+    "@nexussdk/core": "0.0.4",
+    "@nexussdk/flags": "0.0.4",
+    "@nexussdk/tracker": "0.0.4"
   },
   "peerDependencies": {
-    "react": ">=18.0.0"
+    "react": ">=18.0.0",
+    "vue": ">=3.0.0"
   },
   "peerDependenciesMeta": {
     "react": {
       "optional": true
+    },
+    "vue": {
+      "optional": true
     }
   },
   "devDependencies": {
-    "@types/react": "^18.3.0",
-    "react": "^18.3.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "rimraf": "^5.0.5",
     "tsup": "^8.0.2",
     "typescript": "^5.4.5",
-    "rimraf": "^5.0.5"
+    "vue": "^3.5.42"
   },
   "scripts": {
     "build": "tsup",

package/.turbo/turbo-build.log

@@ -1,45 +0,0 @@
-
-> @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.map

@@ -1 +0,0 @@
-{"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"]}