wolves-js-client 1.0.0 → 1.0.1

package/dist/DeviceInfo.d.ts

@@ -0,0 +1,22 @@
+/**
+ * DeviceInfo - Collects device and environment information for event metadata
+ * Aligns with Statsig SDK's approach: sends raw user_agent for server-side parsing
+ *
+ * Note: Browser/OS parsing is done server-side from user_agent, not client-side
+ */
+export type DeviceInfoData = {
+    user_agent: string;
+    locale: string;
+    screen_width: number | null;
+    screen_height: number | null;
+    viewport_width: number | null;
+    viewport_height: number | null;
+    timezone: string;
+    timezone_offset: number | null;
+};
+export declare function getDeviceInfo(): DeviceInfoData;
+/**
+ * Get device info as a flat record suitable for event metadata
+ * Only includes non-null values
+ */
+export declare function getDeviceInfoForMetadata(): Record<string, string | number>;

package/dist/DeviceInfo.js

@@ -0,0 +1,98 @@
+"use strict";
+/**
+ * DeviceInfo - Collects device and environment information for event metadata
+ * Aligns with Statsig SDK's approach: sends raw user_agent for server-side parsing
+ *
+ * Note: Browser/OS parsing is done server-side from user_agent, not client-side
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDeviceInfo = getDeviceInfo;
+exports.getDeviceInfoForMetadata = getDeviceInfoForMetadata;
+function getWindowSafe() {
+    if (typeof window !== 'undefined') {
+        return window;
+    }
+    return null;
+}
+function getNavigatorSafe() {
+    var _a;
+    const win = getWindowSafe();
+    return (_a = win === null || win === void 0 ? void 0 : win.navigator) !== null && _a !== void 0 ? _a : null;
+}
+function getSafeTimezone() {
+    try {
+        return Intl.DateTimeFormat().resolvedOptions().timeZone || '';
+    }
+    catch (_a) {
+        return '';
+    }
+}
+function getSafeTimezoneOffset() {
+    try {
+        return new Date().getTimezoneOffset();
+    }
+    catch (_a) {
+        return null;
+    }
+}
+let cachedDeviceInfo = null;
+function getDeviceInfo() {
+    var _a, _b, _c, _d, _e, _f;
+    // Return cached info if available
+    if (cachedDeviceInfo) {
+        return cachedDeviceInfo;
+    }
+    const win = getWindowSafe();
+    const nav = getNavigatorSafe();
+    if (!win || !nav) {
+        // Return empty values for server-side or non-browser environments
+        return {
+            user_agent: '',
+            locale: '',
+            screen_width: null,
+            screen_height: null,
+            viewport_width: null,
+            viewport_height: null,
+            timezone: '',
+            timezone_offset: null,
+        };
+    }
+    const userAgent = nav.userAgent || '';
+    cachedDeviceInfo = {
+        // Send raw user_agent - server will parse browser/os info
+        user_agent: userAgent.length > 500 ? userAgent.substring(0, 500) : userAgent,
+        locale: nav.language || '',
+        screen_width: (_b = (_a = win.screen) === null || _a === void 0 ? void 0 : _a.width) !== null && _b !== void 0 ? _b : null,
+        screen_height: (_d = (_c = win.screen) === null || _c === void 0 ? void 0 : _c.height) !== null && _d !== void 0 ? _d : null,
+        viewport_width: (_e = win.innerWidth) !== null && _e !== void 0 ? _e : null,
+        viewport_height: (_f = win.innerHeight) !== null && _f !== void 0 ? _f : null,
+        timezone: getSafeTimezone(),
+        timezone_offset: getSafeTimezoneOffset(),
+    };
+    return cachedDeviceInfo;
+}
+/**
+ * Get device info as a flat record suitable for event metadata
+ * Only includes non-null values
+ */
+function getDeviceInfoForMetadata() {
+    const info = getDeviceInfo();
+    const result = {};
+    if (info.user_agent)
+        result['user_agent'] = info.user_agent;
+    if (info.locale)
+        result['locale'] = info.locale;
+    if (info.screen_width !== null)
+        result['screen_width'] = info.screen_width;
+    if (info.screen_height !== null)
+        result['screen_height'] = info.screen_height;
+    if (info.viewport_width !== null)
+        result['viewport_width'] = info.viewport_width;
+    if (info.viewport_height !== null)
+        result['viewport_height'] = info.viewport_height;
+    if (info.timezone)
+        result['timezone'] = info.timezone;
+    if (info.timezone_offset !== null)
+        result['timezone_offset'] = info.timezone_offset;
+    return result;
+}

package/dist/EventLogger.d.ts

@@ -9,5 +9,5 @@ export declare class EventLogger {
     enqueue(event: WolvesEvent): void;
     flush(): Promise<void>;
     private start;
-    stop(): void;
+    stop(): Promise<void>;
 }

package/dist/EventLogger.js

@@ -24,7 +24,9 @@ class EventLogger {
     enqueue(event) {
         this.queue.push(event);
         if (this.queue.length >= this.maxQueueSize) {
-            this.flush();
+            this.flush().catch((e) => {
+                Log_1.Log.error('Failed to flush events', e);
+            });
         }
     }
     flush() {
@@ -57,11 +59,13 @@ class EventLogger {
         }, DEFAULT_FLUSH_INTERVAL_MS);
     }
     stop() {
-        if (this.flushIntervalId) {
-            clearInterval(this.flushIntervalId);
-            this.flushIntervalId = null;
-        }
-        this.flush();
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.flushIntervalId) {
+                clearInterval(this.flushIntervalId);
+                this.flushIntervalId = null;
+            }
+            yield this.flush();
+        });
     }
 }
 exports.EventLogger = EventLogger;

package/dist/Network.d.ts

@@ -1,4 +1,6 @@
 import { WolvesUser } from './WolvesUser';
+export declare const API_LOCAL = "http://localhost:8000/api";
+export declare const API_DEV = "https://wolves-nova-dev.azurewebsites.net/api";
 export declare class Network {
     private sdkKey;
     private api;

package/dist/Network.js

@@ -9,11 +9,15 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Network = void 0;
+exports.Network = exports.API_DEV = exports.API_LOCAL = void 0;
 const Log_1 = require("./Log");
+const WolvesMetadata_1 = require("./WolvesMetadata");
 const RETRYABLE_CODES = [408, 500, 502, 503, 504, 522, 524, 599];
+// API endpoints - switch between local and production
+exports.API_LOCAL = 'http://localhost:8000/api';
+exports.API_DEV = 'https://wolves-nova-dev.azurewebsites.net/api';
 class Network {
-    constructor(sdkKey, api = 'https://wolves-nova-dev.azurewebsites.net/api') {
+    constructor(sdkKey, api = exports.API_LOCAL) {
         this.sdkKey = sdkKey;
         this.api = api;
     }
@@ -57,6 +61,7 @@ class Network {
     }
     sendEvents(events_1) {
         return __awaiter(this, arguments, void 0, function* (events, retries = 3, backoff = 1000) {
+            const sdkMetadata = WolvesMetadata_1.WolvesMetadataProvider.get();
             const apiEvents = events.map(e => {
                 var _a, _b;
                 return ({
@@ -68,6 +73,10 @@ class Network {
                     metadata: e.metadata
                 });
             });
+            const requestBody = {
+                events: apiEvents,
+                wolvesMetadata: sdkMetadata,
+            };
             try {
                 const controller = new AbortController();
                 const timeoutId = setTimeout(() => controller.abort(), 10000); // 10s timeout
@@ -77,7 +86,7 @@ class Network {
                         'Content-Type': 'application/json',
                         'wolves-api-key': this.sdkKey,
                     },
-                    body: JSON.stringify({ events: apiEvents }),
+                    body: JSON.stringify(requestBody),
                     signal: controller.signal,
                 }).finally(() => clearTimeout(timeoutId));
                 if (!response.ok) {

package/dist/WolvesClient.d.ts

@@ -20,6 +20,6 @@ export declare class WolvesClient {
      */
     getExperimentForTest(experimentName: string, groupName: string): Experiment;
     logEvent(eventName: string, value?: string | number, metadata?: Record<string, string>): void;
-    shutdown(): void;
+    shutdown(): Promise<void>;
     private logExposure;
 }

package/dist/WolvesClient.js

@@ -122,7 +122,9 @@ class WolvesClient {
         this.logger.enqueue(event);
     }
     shutdown() {
-        this.logger.stop();
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.logger.stop();
+        });
     }
     logExposure(experimentName, experiment) {
         var _a, _b, _c;

package/dist/WolvesMetadata.d.ts

@@ -0,0 +1,13 @@
+export declare const SDK_VERSION = "1.0.0";
+export declare const SDK_TYPE = "wolves-js-client";
+export type WolvesMetadata = {
+    readonly [key: string]: string | undefined | null;
+    readonly sdkVersion: string;
+    readonly sdkType: string;
+};
+export declare const WolvesMetadataProvider: {
+    get: () => WolvesMetadata;
+    add: (additions: {
+        [key: string]: string | undefined;
+    }) => void;
+};

package/dist/WolvesMetadata.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WolvesMetadataProvider = exports.SDK_TYPE = exports.SDK_VERSION = void 0;
+exports.SDK_VERSION = '1.0.0';
+exports.SDK_TYPE = 'wolves-js-client';
+let metadata = {
+    sdkVersion: exports.SDK_VERSION,
+    sdkType: exports.SDK_TYPE,
+};
+exports.WolvesMetadataProvider = {
+    get: () => metadata,
+    add: (additions) => {
+        metadata = Object.assign(Object.assign({}, metadata), additions);
+    },
+};

package/dist/index.d.ts

@@ -2,3 +2,5 @@ export { WolvesClient } from './WolvesClient';
 export { WolvesUser } from './WolvesUser';
 export { Experiment } from './Types';
 export { Log, LogLevel } from './Log';
+export { SDK_VERSION, SDK_TYPE, WolvesMetadataProvider } from './WolvesMetadata';
+export type { WolvesMetadata } from './WolvesMetadata';

package/dist/index.js

@@ -1,8 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LogLevel = exports.Log = exports.WolvesClient = void 0;
+exports.WolvesMetadataProvider = exports.SDK_TYPE = exports.SDK_VERSION = exports.LogLevel = exports.Log = exports.WolvesClient = void 0;
 var WolvesClient_1 = require("./WolvesClient");
 Object.defineProperty(exports, "WolvesClient", { enumerable: true, get: function () { return WolvesClient_1.WolvesClient; } });
 var Log_1 = require("./Log");
 Object.defineProperty(exports, "Log", { enumerable: true, get: function () { return Log_1.Log; } });
 Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function () { return Log_1.LogLevel; } });
+var WolvesMetadata_1 = require("./WolvesMetadata");
+Object.defineProperty(exports, "SDK_VERSION", { enumerable: true, get: function () { return WolvesMetadata_1.SDK_VERSION; } });
+Object.defineProperty(exports, "SDK_TYPE", { enumerable: true, get: function () { return WolvesMetadata_1.SDK_TYPE; } });
+Object.defineProperty(exports, "WolvesMetadataProvider", { enumerable: true, get: function () { return WolvesMetadata_1.WolvesMetadataProvider; } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wolves-js-client",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "A Wolves JavaScript Client SDK",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",