@touchcastllc/napster-companion-api-dev 1.5.0-alpha.1 → 1.6.0-alpha.2

package/lib/services/micGate.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Handle returned by {@link gateOnMicrophone}. Lets the caller tear down an
+ * active recovery card (e.g. on session destroy) independent of whether the
+ * user ever retries.
+ */
+export interface MicGateController {
+    /** Force-hide the recovery card, if one is mounted. Safe to call unconditionally. */
+    dismiss(): void;
+}
+export interface MicGateOptions {
+    /** Element the recovery card mounts into on denial. */
+    root: HTMLElement;
+    /**
+     * The microphone is available. Fires once for an immediate grant, and
+     * again after each successful "Check again" retry. May return a promise —
+     * {@link gateOnMicrophone}'s own promise waits for it, so a caller that
+     * awaits the gate call also waits for whatever `onGranted` kicks off.
+     */
+    onGranted: () => void | Promise<void>;
+    /** Reported once, on the FIRST failure only — never on a refused retry. */
+    onError?: (error: Error) => void;
+    /** Fires immediately before the recovery card mounts. */
+    onBeforeRecovery?: () => void;
+}
+/**
+ * Gate a session on microphone access (CA-622): try once, and on denial keep
+ * the widget mounted with a recovery card ("Check again", CA-774) instead of
+ * tearing it down.
+ */
+export declare function gateOnMicrophone(opts: MicGateOptions): Promise<MicGateController>;

package/lib/services/webrtc.d.ts

@@ -3,9 +3,7 @@ import type { MediaCapture } from "../utils/MediaCapture";
 export interface WebRTCController {
     startWithToken: (token: string) => Promise<void>;
     close: () => void;
-    forceReconnect: () => Promise<void>;
     getConnectionStatus: () => string;
-    getReconnectAttempts: () => number;
     getError: () => Error | null;
     updateAudioDevice: (deviceId: string) => Promise<void>;
 }
@@ -19,9 +17,6 @@ interface WebRTCParams {
         videoStream?: MediaStream | null;
         audioStream?: MediaStream | null;
     }) => void;
-    onDataChannel?: (dc: RTCDataChannel) => void;
-    maxReconnectAttempts?: number;
-    reconnectInterval?: number;
     /**
      * ICE servers for the peer connection. When omitted, servers from the
      * connection token are used, else {@link DEFAULT_ICE_SERVERS}. Provide this to

package/lib/stores/index.d.ts

@@ -2,5 +2,5 @@ export { store } from "./store";
 export type { RootState } from "./store";
 export { setOnFeaturesUpdateCallback } from "./middleware/featuresUpdateMiddleware";
 export * from "./selectors";
-export { setSessionId, setAvatarReady, setDataChannel, setStopInteraction, setMuted, setAutoMicActive, setVolume, setAvatarSpeaking, setScreenSharing, setUserTalking, setConnectionToken, setCloseConnectionHandler, setSessionTerminatedByServer, resetAvatar, } from "./slices/avatarSlice";
-export { setFeatures, resetFeatures, setPosition, setDebugMode, } from "./slices/appSlice";
+export { setSessionId, setDataChannel, setStopInteraction, setMuted, setAutoMicActive, setVolume, setAvatarSpeaking, setScreenSharing, setUserTalking, setConnectionToken, setCloseConnectionHandler, setSessionTerminatedByServer, resetAvatar, } from "./slices/avatarSlice";
+export { setFeatures, resetFeatures, setDebugMode } from "./slices/appSlice";

package/lib/stores/selectors.d.ts

@@ -1,10 +1,9 @@
 import { RootState } from "./index";
-import { FeatureConfig, Position } from "../types";
+import { FeatureConfig } from "../types";
 /**
  * Avatar state selectors
  */
 export declare const selectSessionId: (state: RootState) => string | undefined;
-export declare const selectAvatarReady: (state: RootState) => boolean;
 export declare const selectDataChannel: (state: RootState) => RTCDataChannel | null;
 export declare const selectMuted: (state: RootState) => boolean;
 export declare const selectAutoMicActive: (state: RootState) => boolean;
@@ -18,9 +17,7 @@ export declare const selectSessionTerminatedByServer: (state: RootState) => bool
  * App state selectors
  */
 export declare const selectFeatures: (state: RootState) => FeatureConfig;
-export declare const selectPosition: (state: RootState) => Position | undefined;
 /**
  * Composite selectors
  */
 export declare const selectIsConnected: (state: RootState) => boolean;
-export declare const selectCanSendMessage: (state: RootState) => boolean;

package/lib/stores/slices/appSlice.d.ts

@@ -1,11 +1,10 @@
-import { Position, FeatureConfig } from "../../types";
+import { FeatureConfig } from "../../types";
 export interface AppState {
     features: FeatureConfig;
-    position?: Position;
     debugMode?: boolean;
 }
 export declare const setFeatures: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
     feature: keyof FeatureConfig;
     config: FeatureConfig[keyof FeatureConfig];
-}, "app/setFeatures">, resetFeatures: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"app/resetFeatures">, setPosition: import("@reduxjs/toolkit").ActionCreatorWithOptionalPayload<Position | undefined, "app/setPosition">, setDebugMode: import("@reduxjs/toolkit").ActionCreatorWithOptionalPayload<boolean | undefined, "app/setDebugMode">;
+}, "app/setFeatures">, resetFeatures: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"app/resetFeatures">, setDebugMode: import("@reduxjs/toolkit").ActionCreatorWithOptionalPayload<boolean | undefined, "app/setDebugMode">;
 export declare const appReducer: import("redux").Reducer<AppState>;

package/lib/stores/slices/avatarSlice.d.ts

@@ -1,11 +1,5 @@
-export interface WebRTCStatus {
-    blocked: boolean;
-    reason: string;
-    message: string;
-}
 export interface AvatarState {
     sessionId?: string;
-    avatarReady: boolean;
     dataChannel: RTCDataChannel | null;
     stopInteraction: boolean;
     muted: boolean;
@@ -18,5 +12,5 @@ export interface AvatarState {
     closeConnectionHandler?: () => void;
     sessionTerminatedByServer: boolean;
 }
-export declare const setSessionId: import("@reduxjs/toolkit").ActionCreatorWithOptionalPayload<string | undefined, "avatar/setSessionId">, setAvatarReady: import("@reduxjs/toolkit").ActionCreatorWithPayload<boolean, "avatar/setAvatarReady">, setDataChannel: import("@reduxjs/toolkit").ActionCreatorWithPayload<RTCDataChannel | null, "avatar/setDataChannel">, setStopInteraction: import("@reduxjs/toolkit").ActionCreatorWithPayload<boolean, "avatar/setStopInteraction">, setMuted: import("@reduxjs/toolkit").ActionCreatorWithPayload<boolean, "avatar/setMuted">, setAutoMicActive: import("@reduxjs/toolkit").ActionCreatorWithPayload<boolean, "avatar/setAutoMicActive">, setVolume: import("@reduxjs/toolkit").ActionCreatorWithPayload<number, "avatar/setVolume">, setAvatarSpeaking: import("@reduxjs/toolkit").ActionCreatorWithPayload<boolean, "avatar/setAvatarSpeaking">, setScreenSharing: import("@reduxjs/toolkit").ActionCreatorWithPayload<boolean, "avatar/setScreenSharing">, setUserTalking: import("@reduxjs/toolkit").ActionCreatorWithPayload<boolean, "avatar/setUserTalking">, setConnectionToken: import("@reduxjs/toolkit").ActionCreatorWithOptionalPayload<string | undefined, "avatar/setConnectionToken">, setCloseConnectionHandler: import("@reduxjs/toolkit").ActionCreatorWithOptionalPayload<(() => void) | undefined, "avatar/setCloseConnectionHandler">, setSessionTerminatedByServer: import("@reduxjs/toolkit").ActionCreatorWithPayload<boolean, "avatar/setSessionTerminatedByServer">, resetAvatar: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"avatar/resetAvatar">;
+export declare const setSessionId: import("@reduxjs/toolkit").ActionCreatorWithOptionalPayload<string | undefined, "avatar/setSessionId">, setDataChannel: import("@reduxjs/toolkit").ActionCreatorWithPayload<RTCDataChannel | null, "avatar/setDataChannel">, setStopInteraction: import("@reduxjs/toolkit").ActionCreatorWithPayload<boolean, "avatar/setStopInteraction">, setMuted: import("@reduxjs/toolkit").ActionCreatorWithPayload<boolean, "avatar/setMuted">, setAutoMicActive: import("@reduxjs/toolkit").ActionCreatorWithPayload<boolean, "avatar/setAutoMicActive">, setVolume: import("@reduxjs/toolkit").ActionCreatorWithPayload<number, "avatar/setVolume">, setAvatarSpeaking: import("@reduxjs/toolkit").ActionCreatorWithPayload<boolean, "avatar/setAvatarSpeaking">, setScreenSharing: import("@reduxjs/toolkit").ActionCreatorWithPayload<boolean, "avatar/setScreenSharing">, setUserTalking: import("@reduxjs/toolkit").ActionCreatorWithPayload<boolean, "avatar/setUserTalking">, setConnectionToken: import("@reduxjs/toolkit").ActionCreatorWithOptionalPayload<string | undefined, "avatar/setConnectionToken">, setCloseConnectionHandler: import("@reduxjs/toolkit").ActionCreatorWithOptionalPayload<(() => void) | undefined, "avatar/setCloseConnectionHandler">, setSessionTerminatedByServer: import("@reduxjs/toolkit").ActionCreatorWithPayload<boolean, "avatar/setSessionTerminatedByServer">, resetAvatar: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"avatar/resetAvatar">;
 export declare const avatarReducer: import("redux").Reducer<AvatarState>;

package/lib/stores/store.d.ts

@@ -8,4 +8,3 @@ export declare const store: import("@reduxjs/toolkit").EnhancedStore<{
     }, undefined, import("redux").UnknownAction>;
 }>, import("redux").StoreEnhancer]>>;
 export type RootState = ReturnType<typeof store.getState>;
-export type AppDispatch = typeof store.dispatch;

package/lib/types/abstract-typing.d.ts

@@ -11,25 +11,3 @@ export interface BaseController<TOptions = unknown> {
      */
     destroy(silent?: boolean): void;
 }
-/**
- * Extended controller interface with lifecycle hooks
- */
-export interface LifecycleController<TOptions = unknown> extends BaseController<TOptions> {
-    /**
-     * Initialize controller (called after construction)
-     */
-    initialize?(): void;
-    /**
-     * Hook called before destroy
-     */
-    beforeDestroy?(): void;
-}
-/**
- * Controller with render capabilities
- */
-export interface RenderController<TOptions = unknown> extends LifecycleController<TOptions> {
-    /**
-     * Render or re-render the component
-     */
-    render(): void;
-}

package/lib/types/errors.d.ts

@@ -30,12 +30,6 @@ export declare class InitializationError extends SDKError {
 export declare class TokenError extends SDKError {
     constructor(message: string, context?: Record<string, unknown>);
 }
-/**
- * React version compatibility errors
- */
-export declare class ReactVersionError extends SDKError {
-    constructor(message: string, context?: Record<string, unknown>);
-}
 /**
  * Connection related errors
  */
@@ -48,30 +42,6 @@ export declare class ConnectionError extends SDKError {
 export declare class WebRTCError extends SDKError {
     constructor(message: string, context?: Record<string, unknown>);
 }
-/**
- * API related errors
- */
-export declare class APIError extends SDKError {
-    readonly status?: number;
-    readonly response?: unknown;
-    constructor(message: string, status?: number, response?: unknown, context?: Record<string, unknown>);
-    toJSON(): {
-        status: number | undefined;
-        response: unknown;
-        name: string;
-        message: string;
-        code: string;
-        timestamp: string;
-        context: Record<string, unknown> | undefined;
-        stack: string | undefined;
-    };
-}
-/**
- * Configuration related errors
- */
-export declare class ConfigurationError extends SDKError {
-    constructor(message: string, context?: Record<string, unknown>);
-}
 /**
  * Feature related errors
  */
@@ -123,10 +93,6 @@ export declare enum ErrorCodes {
  * Type guard to check if an error is an SDK error
  */
 export declare function isSDKError(error: unknown): error is SDKError;
-/**
- * Helper function to create appropriate error based on context
- */
-export declare function createError(type: "initialization" | "token" | "react" | "connection" | "webrtc" | "api" | "config" | "feature" | "media" | "faceTracking", message: string, context?: Record<string, unknown>): SDKError;
 /**
  * Error handler utility for consistent error processing
  */

package/lib/types/index.d.ts

@@ -1,7 +1,5 @@
-import type { AnalyticsConfig } from "./analytics";
 import { DataChannelMessageType } from "../constants/events";
 export * from "./errors";
-export * from "./analytics";
 export * from "./abstract-typing";
 /**
  * Placement positions used to anchor the UI on screen.
@@ -305,8 +303,7 @@ export interface NavigationProgressOptions {
     height?: string;
 }
 /**
- * Cross-page persistence options. Works with BOTH entry points — `init` and
- * `initWithButton` share the same persistence engine.
+ * Cross-page persistence options.
  */
 export interface PersistenceOptions {
     /** Turn persistence on. Required — there is no boolean shorthand. */
@@ -407,6 +404,19 @@ export interface PersistenceOptions {
  * All fields are optional; sensible defaults are used by the SDK.
  */
 export interface NapsterCompanionApiConfig {
+    /**
+     * Connection transport. Only `"webrtc"` exists today — any other value is a
+     * compile-time error. Reserved for future transports (e.g. WebSocket); until
+     * then the SDK defaults to `"webrtc"` and there is no reason to set this.
+     */
+    transport?: "webrtc";
+    /**
+     * Connection modality. Only `"video"` exists today — any other value is a
+     * compile-time error. Reserved for future modalities (e.g. audio-only,
+     * text); until then the SDK defaults to `"video"` and there is no reason to
+     * set this.
+     */
+    modality?: "video";
     /** Position of the avatar on screen. See `Position` enum. */
     position?: Position;
     /** CSS class name(s) to add to the SDK root container. Useful for theming. */
@@ -463,22 +473,10 @@ export interface NapsterCompanionApiConfig {
     /**
      * Keep the session alive across page navigation. When enabled, the page is wrapped in
      * a same-origin iframe so navigation happens inside it while the avatar stays in the
-     * top document, which never reloads. Works with both `init` and `initWithButton`.
+     * top document, which never reloads.
      * When on, `mountContainer` is ignored — the avatar must live in the top document.
      */
     persistence?: PersistenceOptions;
-    /**
-     * The click-to-start button's appearance. **Only used by `initWithButton()`** —
-     * passing it to `init()` (which connects immediately, with no button) throws.
-     */
-    button?: {
-        /** Button text. Default: `"Talk to an agent"`. */
-        label?: string;
-        /** Optional companion picture shown on the button. */
-        avatarUrl?: string;
-    };
-    /** Analytics configuration controls analytics delivery and tracking. */
-    analytics?: AnalyticsConfig;
     /** Lifecycle callbacks. All are optional. */
     /** Called when the SDK has finished initialization and is ready to render. */
     onReady?: () => void;
@@ -589,42 +587,17 @@ export interface NapsterCompanionApiInstance {
     readonly isUserTalking: boolean;
 }
 /**
- * Top-level SDK object exposed by the package. Call `init(token, config)` to
+ * Top-level SDK object exposed by the package. Call `init(getToken, config)` to
  * bootstrap the SDK and receive a `NapsterCompanionApiInstance` for runtime control.
  */
 export interface NapsterCompanionApiSDK {
     /**
-     * Initialize the SDK using the provided connection token and optional config.
-     * Returns a Promise that resolves to a controllable `NapsterCompanionApiInstance`.
-     */
-    init(token: string, config?: Partial<NapsterCompanionApiConfig>): Promise<NapsterCompanionApiInstance>;
-    /**
-     * Render a button and connect on click (instead of connecting immediately like
-     * `init`). Returns a `NapsterCompanionApiController` synchronously — nothing connects
-     * until the user clicks. With `persistence`, the session survives navigation. No-op
-     * when run inside the persistence site frame.
-     */
-    initWithButton(getToken: () => Promise<string>, config?: Partial<NapsterCompanionApiConfig>): import("../button").NapsterCompanionApiController;
-    /**
-     * Prompt for the microphone WITHOUT starting a session, so permission is settled
-     * before a connection token exists. A connection's lifetime starts the moment the
-     * backend creates it, and a prompt the user leaves open for seconds spends that
-     * budget before signaling runs — the session then fails to come up.
-     *
-     * `initWithButton` does this internally. Use it on the `init` path, where the host
-     * app owns when the token is minted:
-     *
-     * ```js
-     * await SDK.requestMicrophoneAccess();
-     * const token = await mintConnectionToken();
-     * await SDK.init(token, config);
-     * ```
-     *
-     * Rejects with a `ConnectionError` whose `context.name` is the underlying
-     * DOMException — `"NotAllowedError"` (refused) or `"NotFoundError"` (no device).
-     * Calling it is free once granted: the stream is cached and reused by the session.
+     * Initialize the SDK. `getToken` is called by the SDK itself once the microphone
+     * permission has settled, so the connection token is always fresh when signaling
+     * starts. A pre-minted token string is not accepted — minting it before the mic
+     * prompt lets it go stale while the user is deciding.
      */
-    requestMicrophoneAccess(): Promise<void>;
+    init(getToken: () => Promise<string>, config?: Partial<NapsterCompanionApiConfig>): Promise<NapsterCompanionApiInstance>;
     /** The SDK version string (useful for diagnostics). */
     version: string;
 }

package/lib/utils/debug.d.ts

@@ -96,9 +96,5 @@ declare class DebugLogger {
 /**
  * Global debug logger instance
  */
-export declare const debugLogger: DebugLogger;
-/**
- * Convenience export for common usage
- */
 export declare const debug: DebugLogger;
 export {};

package/lib/utils/mediaError.d.ts

@@ -5,10 +5,3 @@
  * level down in `context.error`.
  */
 export declare function rootCauseName(error: unknown): string | undefined;
-/**
- * Whether a media failure leaves the user with a recoverable permission
- * problem. Both flavors land on the same "access blocked" screen: a denied
- * prompt is fixable in site settings, and a missing device is equally fatal to
- * a voice session, so neither may negotiate a session the agent cannot hear.
- */
-export declare function isMicUnavailable(error: unknown): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@touchcastllc/napster-companion-api-dev",
-  "version": "1.5.0-alpha.1",
+  "version": "1.6.0-alpha.2",
   "keywords": [
     "napster",
     "companion-api",

package/lib/button/element.d.ts

@@ -1,6 +0,0 @@
-export interface ButtonElementOptions {
-    label: string;
-    avatarUrl?: string;
-    onClick: () => void;
-}
-export declare function createButtonElement(options: ButtonElementOptions): HTMLButtonElement;

package/lib/button/index.d.ts

@@ -1,46 +0,0 @@
-import "./Button.css";
-import type { NapsterCompanionApiConfig, NapsterCompanionApiInstance } from "../types";
-/**
- * Returned by {@link initWithButton}. A session controller: start/end the agent session,
- * reach the live instance, or tear the button down. Created synchronously — nothing
- * connects until `start()` (or a button click).
- *
- * Inside the SDK's own persistence frame (and during SSR) the call no-ops and every
- * method here is a harmless no-op — `getInstance()` stays `null`. With
- * `debug: true` the skip is logged.
- */
-export interface NapsterCompanionApiController {
-    /** The live avatar instance once connected, else `null`. */
-    getInstance(): NapsterCompanionApiInstance | null;
-    /** Start the session (as if the button was clicked). */
-    start(): Promise<void>;
-    /** End the session (and, if persisted, unwrap back to the plain site). The button reappears. */
-    end(): void;
-    /** Remove the button and any active session/iframe. */
-    destroy(): void;
-}
-/**
- * What the button entry point needs from the SDK. Wired by the SDK's `initWithButton`
- * method so this module never reaches into the singleton's internals.
- */
-export interface ButtonDeps {
-    /** Connect a session; mounts the avatar into the button-owned root. */
-    init: (token: string, config?: Partial<NapsterCompanionApiConfig>) => Promise<NapsterCompanionApiInstance>;
-    /** Create + position the persistent, button-owned `#np_companion-sdk-root` and return it. */
-    mountRoot: (config: Partial<NapsterCompanionApiConfig>) => HTMLElement;
-    /** Remove the button-owned root and release SDK ownership (on destroy). */
-    unmountRoot: () => void;
-    /**
-     * Tear down any live session AND its persisted iframe WITHOUT navigating — reveal the
-     * page in place. Called when the whole widget is being removed (`destroy()`), where a
-     * page reload would be the wrong response. Private to the SDK↔button seam.
-     */
-    disposeSession: () => void;
-}
-/**
- * Build the button entry point. Returns a {@link NapsterCompanionApiController}.
- *
- * A no-op (returns an inert controller) when run inside the persistence site frame,
- * so the same snippet is safe on every page.
- */
-export declare function createButton(deps: ButtonDeps, getToken: () => Promise<string>, config?: Partial<NapsterCompanionApiConfig>): NapsterCompanionApiController;

package/lib/services/analytics.d.ts

@@ -1,148 +0,0 @@
-import type { AnalyticsConfig } from "../types/analytics";
-/**
- * Analytics service class
- */
-export declare class AnalyticsService {
-    private config;
-    private eventQueue;
-    private performanceQueue;
-    private errorQueue;
-    private flushTimer?;
-    private sessionId;
-    private providers;
-    constructor(config?: Partial<AnalyticsConfig>);
-    /**
-     * Setup analytics providers from configuration
-     */
-    private setupProviders;
-    /**
-     * Generate a unique session ID
-     */
-    private generateSessionId;
-    /**
-     * Start the flush timer for batched sending
-     */
-    private startFlushTimer;
-    /**
-     * Setup automatic error tracking
-     */
-    private setupErrorTracking;
-    /**
-     * Setup performance tracking
-     */
-    private setupPerformanceTracking;
-    /**
-     * Track an analytics event
-     */
-    trackEvent(name: string, properties?: Record<string, unknown>): void;
-    /**
-     * Track a performance metric
-     */
-    trackPerformance(name: string, value: number, unit: "ms" | "bytes" | "count" | "percentage", context?: Record<string, unknown>): void;
-    /**
-     * Track an error
-     */
-    trackError(error: Error, context?: Record<string, unknown>): void;
-    /**
-     * Track user interaction
-     */
-    trackInteraction(action: string, target?: string, properties?: Record<string, unknown>): void;
-    /**
-     * Flush all queued data
-     */
-    flush(): void;
-    /**
-     * Flush events queue
-     */
-    private flushEvents;
-    /**
-     * Flush performance queue
-     */
-    private flushPerformance;
-    /**
-     * Flush errors queue
-     */
-    private flushErrors;
-    /**
-     * Send data to analytics endpoint
-     */
-    private sendData;
-    /**
-     * Send data to a specific analytics provider
-     */
-    private sendToProvider;
-    /**
-     * Send to custom endpoint (backward compatible)
-     */
-    private sendToCustomEndpoint;
-    /**
-     * Provider-specific send methods
-     */
-    private sendToGA4;
-    private sendToMixpanel;
-    private sendToSegment;
-    private sendToAmplitude;
-    private sendToPostHog;
-    private sendToAzureInsights;
-    /**
-     * Update configuration
-     */
-    updateConfig(newConfig: Partial<AnalyticsConfig>): void;
-    /**
-     * Destroy the analytics service
-     */
-    destroy(): void;
-}
-/**
- * Initialize analytics service
- *
- * @example
- * // Single provider configuration
- * const analytics = initializeAnalytics({
- *   enabled: true,
- *   provider: {
- *     type: 'google-analytics-4',
- *     measurementId: 'G-XXXXXXXXXX',
- *     apiKey: 'your-api-secret'
- *   }
- * });
- *
- * @example
- * // Multiple providers configuration
- * const analytics = initializeAnalytics({
- *   enabled: true,
- *   providers: [
- *     {
- *       type: 'google-analytics-4',
- *       measurementId: 'G-XXXXXXXXXX',
- *       apiKey: 'your-api-secret'
- *     },
- *     {
- *       type: 'mixpanel',
- *       projectToken: 'your-mixpanel-token'
- *     }
- *   ]
- * });
- *
- * @example
- * // Backward compatible legacy configuration
- * const analytics = initializeAnalytics({
- *   enabled: true,
- *   endpoint: 'https://your-api.com/analytics',
- *   apiKey: 'your-api-key'
- * });
- */
-export declare function initializeAnalytics(config: Partial<AnalyticsConfig>): AnalyticsService;
-/**
- * Get the global analytics instance
- */
-export declare function getAnalytics(): AnalyticsService | null;
-/**
- * Convenience functions for common tracking
- */
-export declare const analytics: {
-    track: (name: string, properties?: Record<string, unknown>) => void;
-    performance: (name: string, value: number, unit: "ms" | "bytes" | "count" | "percentage", context?: Record<string, unknown>) => void;
-    error: (error: Error, context?: Record<string, unknown>) => void;
-    interaction: (action: string, target?: string, properties?: Record<string, unknown>) => void;
-};

package/lib/types/analytics.d.ts

@@ -1,95 +0,0 @@
-/**
- * Analytics and monitoring service for SDK usage tracking
- */
-export interface AnalyticsEvent {
-    /** Name of the analytics event */
-    name: string;
-    /** Properties associated with the event */
-    properties?: Record<string, unknown>;
-    /** Timestamp of the event */
-    timestamp?: number;
-    /** User identifier */
-    userId?: string;
-    /** Session identifier */
-    sessionId?: string;
-}
-/**
- * Supported analytics providers
- */
-export type AnalyticsProvider = "custom" | "google-analytics-4" | "mixpanel" | "segment" | "amplitude" | "posthog" | "azure-insights";
-/**
- * Analytics provider configuration
- */
-export interface ProviderConfig {
-    /** Type of analytics provider */
-    type: AnalyticsProvider;
-    /** Measurement ID for Google Analytics 4 */
-    measurementId?: string;
-    /** Project token for Mixpanel */
-    projectToken?: string;
-    /** Write key for Segment */
-    writeKey?: string;
-    /** Generic API key */
-    apiKey?: string;
-    /** Custom endpoint */
-    endpoint?: string;
-    /** Regional endpoint */
-    region?: string;
-}
-/**
- * Performance metric data structure
- */
-export interface PerformanceMetric {
-    /** Name of the performance metric */
-    name: string;
-    /** Value of the metric */
-    value: number;
-    /** Unit of the metric value */
-    unit: "ms" | "bytes" | "count" | "percentage";
-    /** Timestamp of the metric */
-    timestamp?: number;
-    /** Additional context for the metric */
-    context?: Record<string, unknown>;
-}
-/**
- * Error event data structure
- */
-export interface ErrorEvent {
-    /** Error object */
-    error: Error;
-    /** Additional context for the error */
-    context?: Record<string, unknown>;
-    /** Timestamp of the error event */
-    timestamp?: number;
-    /** User identifier */
-    userId?: string;
-    /** Session identifier */
-    sessionId?: string;
-    /** Stack trace of the error */
-    stack?: string;
-}
-/**
- * Analytics configuration options
- */
-export interface AnalyticsConfig {
-    /** Enable or disable analytics tracking */
-    enabled: boolean;
-    /** Analytics service provider configuration */
-    provider?: ProviderConfig;
-    /** Support multiple analytics service providers */
-    providers?: ProviderConfig[];
-    /** Unique user identifier for tracking purposes */
-    userId?: string;
-    /** Unique session identifier for tracking purposes */
-    sessionId?: string;
-    /** Batch size for sending analytics events */
-    batchSize?: number;
-    /** Interval in milliseconds for flushing analytics data */
-    flushInterval?: number;
-    /** Enable or disable performance tracking */
-    enablePerformanceTracking?: boolean;
-    /** Enable or disable error tracking */
-    enableErrorTracking?: boolean;
-    /** Enable or disable user interaction tracking */
-    enableUserInteractionTracking?: boolean;
-}