@tenxyte/core 0.1.5 → 0.9.0

package/src/utils/base64url.ts

@@ -0,0 +1,25 @@
+export function bufferToBase64url(buffer: ArrayBuffer | Uint8Array): string {
+    const bytes = new Uint8Array(buffer);
+    let binary = '';
+    for (let i = 0; i < bytes.byteLength; i++) {
+        binary += String.fromCharCode(bytes[i]);
+    }
+    return btoa(binary)
+        .replace(/\+/g, '-')
+        .replace(/\//g, '_')
+        .replace(/=/g, '');
+}
+
+export function base64urlToBuffer(base64url: string): Uint8Array {
+    const base64 = base64url
+        .replace(/-/g, '+')
+        .replace(/_/g, '/');
+    const padLen = (4 - (base64.length % 4)) % 4;
+    const padded = base64 + '='.repeat(padLen);
+    const binary = atob(padded);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes;
+}

package/src/utils/device_info.ts

@@ -1,94 +1,94 @@
-/**
- * Helper utility to build the device fingerprint required by Tenxyte security features.
- * Format: `v=1|os=windows;osv=11|device=desktop|arch=x64|app=tenxyte;appv=1.0.0|runtime=chrome;rtv=122|tz=Europe/Paris`
- */
-export interface CustomDeviceInfo {
-    os?: string;
-    osVersion?: string;
-    device?: string;
-    arch?: string;
-    app?: string;
-    appVersion?: string;
-    runtime?: string;
-    runtimeVersion?: string;
-    timezone?: string;
-}
-
-export function buildDeviceInfo(customInfo: CustomDeviceInfo = {}): string {
-    // Try to determine automatically from navigator
-    const autoInfo = getAutoInfo();
-
-    const v = '1';
-    const os = customInfo.os || autoInfo.os;
-    const osv = customInfo.osVersion || autoInfo.osVersion;
-    const device = customInfo.device || autoInfo.device;
-    const arch = customInfo.arch || autoInfo.arch;
-    const app = customInfo.app || autoInfo.app;
-    const appv = customInfo.appVersion || autoInfo.appVersion;
-    const runtime = customInfo.runtime || autoInfo.runtime;
-    const rtv = customInfo.runtimeVersion || autoInfo.runtimeVersion;
-    const tz = customInfo.timezone || autoInfo.timezone;
-
-    const parts = [
-        `v=${v}`,
-        `os=${os}` + (osv ? `;osv=${osv}` : ''),
-        `device=${device}`,
-        arch ? `arch=${arch}` : '',
-        app ? `app=${app}${appv ? `;appv=${appv}` : ''}` : '',
-        `runtime=${runtime}` + (rtv ? `;rtv=${rtv}` : ''),
-        tz ? `tz=${tz}` : ''
-    ];
-
-    return parts.filter(Boolean).join('|');
-}
-
-function getAutoInfo() {
-    const info = {
-        os: 'unknown',
-        osVersion: '',
-        device: 'desktop', // default
-        arch: '',
-        app: 'sdk',
-        appVersion: '0.1.0',
-        runtime: 'unknown',
-        runtimeVersion: '',
-        timezone: ''
-    };
-
-    try {
-        if (typeof Intl !== 'undefined') {
-            info.timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;
-        }
-
-        if (typeof process !== 'undefined' && process.version) {
-            info.runtime = 'node';
-            info.runtimeVersion = process.version;
-            info.os = process.platform;
-            info.arch = process.arch;
-            info.device = 'server';
-        } else if (typeof window !== 'undefined' && window.navigator) {
-            const ua = window.navigator.userAgent.toLowerCase();
-
-            // Basic OS detection
-            if (ua.includes('windows')) info.os = 'windows';
-            else if (ua.includes('mac')) info.os = 'macos';
-            else if (ua.includes('linux')) info.os = 'linux';
-            else if (ua.includes('android')) info.os = 'android';
-            else if (ua.includes('ios') || ua.includes('iphone') || ua.includes('ipad')) info.os = 'ios';
-
-            // Basic Device Type
-            if (/mobi|android|touch|mini/i.test(ua)) info.device = 'mobile';
-            if (/tablet|ipad/i.test(ua)) info.device = 'tablet';
-
-            // Basic Runtime (Browser)
-            if (ua.includes('firefox')) info.runtime = 'firefox';
-            else if (ua.includes('edg/')) info.runtime = 'edge';
-            else if (ua.includes('chrome')) info.runtime = 'chrome';
-            else if (ua.includes('safari')) info.runtime = 'safari';
-        }
-    } catch (e) {
-        // Ignore context extraction errors
-    }
-
-    return info;
-}
+/**
+ * Helper utility to build the device fingerprint required by Tenxyte security features.
+ * Format: `v=1|os=windows;osv=11|device=desktop|arch=x64|app=tenxyte;appv=1.0.0|runtime=chrome;rtv=122|tz=Europe/Paris`
+ */
+export interface CustomDeviceInfo {
+    os?: string;
+    osVersion?: string;
+    device?: string;
+    arch?: string;
+    app?: string;
+    appVersion?: string;
+    runtime?: string;
+    runtimeVersion?: string;
+    timezone?: string;
+}
+
+export function buildDeviceInfo(customInfo: CustomDeviceInfo = {}): string {
+    // Try to determine automatically from navigator
+    const autoInfo = getAutoInfo();
+
+    const v = '1';
+    const os = customInfo.os || autoInfo.os;
+    const osv = customInfo.osVersion || autoInfo.osVersion;
+    const device = customInfo.device || autoInfo.device;
+    const arch = customInfo.arch || autoInfo.arch;
+    const app = customInfo.app || autoInfo.app;
+    const appv = customInfo.appVersion || autoInfo.appVersion;
+    const runtime = customInfo.runtime || autoInfo.runtime;
+    const rtv = customInfo.runtimeVersion || autoInfo.runtimeVersion;
+    const tz = customInfo.timezone || autoInfo.timezone;
+
+    const parts = [
+        `v=${v}`,
+        `os=${os}` + (osv ? `;osv=${osv}` : ''),
+        `device=${device}`,
+        arch ? `arch=${arch}` : '',
+        app ? `app=${app}${appv ? `;appv=${appv}` : ''}` : '',
+        `runtime=${runtime}` + (rtv ? `;rtv=${rtv}` : ''),
+        tz ? `tz=${tz}` : ''
+    ];
+
+    return parts.filter(Boolean).join('|');
+}
+
+function getAutoInfo() {
+    const info = {
+        os: 'unknown',
+        osVersion: '',
+        device: 'desktop', // default
+        arch: '',
+        app: 'sdk',
+        appVersion: '0.1.0',
+        runtime: 'unknown',
+        runtimeVersion: '',
+        timezone: ''
+    };
+
+    try {
+        if (typeof Intl !== 'undefined') {
+            info.timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;
+        }
+
+        if (typeof process !== 'undefined' && process.version) {
+            info.runtime = 'node';
+            info.runtimeVersion = process.version;
+            info.os = process.platform;
+            info.arch = process.arch;
+            info.device = 'server';
+        } else if (typeof window !== 'undefined' && window.navigator) {
+            const ua = window.navigator.userAgent.toLowerCase();
+
+            // Basic OS detection
+            if (ua.includes('windows')) info.os = 'windows';
+            else if (ua.includes('mac')) info.os = 'macos';
+            else if (ua.includes('linux')) info.os = 'linux';
+            else if (ua.includes('android')) info.os = 'android';
+            else if (ua.includes('ios') || ua.includes('iphone') || ua.includes('ipad')) info.os = 'ios';
+
+            // Basic Device Type
+            if (/mobi|android|touch|mini/i.test(ua)) info.device = 'mobile';
+            if (/tablet|ipad/i.test(ua)) info.device = 'tablet';
+
+            // Basic Runtime (Browser)
+            if (ua.includes('firefox')) info.runtime = 'firefox';
+            else if (ua.includes('edg/')) info.runtime = 'edge';
+            else if (ua.includes('chrome')) info.runtime = 'chrome';
+            else if (ua.includes('safari')) info.runtime = 'safari';
+        }
+    } catch (e) {
+        // Ignore context extraction errors
+    }
+
+    return info;
+}

package/src/utils/events.ts

@@ -1,71 +1,71 @@
-/**
- * Lightweight EventEmitter for TenxyteClient.
- * Provides `.on`, `.once`, `.off`, and `.emit`.
- */
-export class EventEmitter<Events extends Record<string, any>> {
-    private events: Map<keyof Events, Array<Function>>;
-
-    constructor() {
-        this.events = new Map();
-    }
-
-    /**
-     * Subscribe to an event.
-     * @param event The event name
-     * @param callback The callback function
-     * @returns Unsubscribe function
-     */
-    on<K extends keyof Events>(event: K, callback: (payload: Events[K]) => void): () => void {
-        if (!this.events.has(event)) {
-            this.events.set(event, []);
-        }
-        this.events.get(event)!.push(callback);
-        return () => this.off(event, callback);
-    }
-
-    /**
-     * Unsubscribe from an event.
-     * @param event The event name
-     * @param callback The exact callback function that was passed to .on()
-     */
-    off<K extends keyof Events>(event: K, callback: (payload: Events[K]) => void): void {
-        const callbacks = this.events.get(event);
-        if (!callbacks) return;
-        const index = callbacks.indexOf(callback);
-        if (index !== -1) {
-            callbacks.splice(index, 1);
-        }
-    }
-
-    /**
-     * Subscribe to an event exactly once.
-     */
-    once<K extends keyof Events>(event: K, callback: (payload: Events[K]) => void): () => void {
-        const wrapped = (payload: Events[K]) => {
-            this.off(event, wrapped);
-            callback(payload);
-        };
-        return this.on(event, wrapped);
-    }
-
-    /**
-     * Emit an event internally.
-     */
-    emit<K extends keyof Events>(event: K, payload: Events[K]): void {
-        const callbacks = this.events.get(event);
-        if (!callbacks) return;
-        // Copy array to prevent mutation issues during emission
-        const copy = [...callbacks];
-        for (const callback of copy) {
-            try {
-                callback(payload);
-            } catch (err) {
-                console.error(`[Tenxyte EventEmitter] Error executing callback for event ${String(event)}`, err);
-            }
-        }
-    }
-
-    removeAllListeners(): void {
-        this.events.clear();
-    }
-}
+/**
+ * Lightweight EventEmitter for TenxyteClient.
+ * Provides `.on`, `.once`, `.off`, and `.emit`.
+ */
+export class EventEmitter<Events extends Record<string, any>> {
+    private events: Map<keyof Events, Array<Function>>;
+
+    constructor() {
+        this.events = new Map();
+    }
+
+    /**
+     * Subscribe to an event.
+     * @param event The event name
+     * @param callback The callback function
+     * @returns Unsubscribe function
+     */
+    on<K extends keyof Events>(event: K, callback: (payload: Events[K]) => void): () => void {
+        if (!this.events.has(event)) {
+            this.events.set(event, []);
+        }
+        this.events.get(event)!.push(callback);
+        return () => this.off(event, callback);
+    }
+
+    /**
+     * Unsubscribe from an event.
+     * @param event The event name
+     * @param callback The exact callback function that was passed to .on()
+     */
+    off<K extends keyof Events>(event: K, callback: (payload: Events[K]) => void): void {
+        const callbacks = this.events.get(event);
+        if (!callbacks) return;
+        const index = callbacks.indexOf(callback);
+        if (index !== -1) {
+            callbacks.splice(index, 1);
+        }
+    }
+
+    /**
+     * Subscribe to an event exactly once.
+     */
+    once<K extends keyof Events>(event: K, callback: (payload: Events[K]) => void): () => void {
+        const wrapped = (payload: Events[K]) => {
+            this.off(event, wrapped);
+            callback(payload);
+        };
+        return this.on(event, wrapped);
+    }
+
+    /**
+     * Emit an event internally.
+     */
+    emit<K extends keyof Events>(event: K, payload: Events[K]): void {
+        const callbacks = this.events.get(event);
+        if (!callbacks) return;
+        // Copy array to prevent mutation issues during emission
+        const copy = [...callbacks];
+        for (const callback of copy) {
+            try {
+                callback(payload);
+            } catch (err) {
+                console.error(`[Tenxyte EventEmitter] Error executing callback for event ${String(event)}`, err);
+            }
+        }
+    }
+
+    removeAllListeners(): void {
+        this.events.clear();
+    }
+}

package/src/utils/jwt.ts

@@ -1,51 +1,51 @@
-export interface DecodedTenxyteToken {
-    exp?: number;
-    iat?: number;
-    sub?: string;
-    roles?: string[];
-    permissions?: string[];
-    [key: string]: any;
-}
-
-/**
- * Decodes the payload of a JWT without verifying the signature.
- * Suitable for client-side routing and UI state.
- */
-export function decodeJwt(token: string): DecodedTenxyteToken | null {
-    try {
-        const parts = token.split('.');
-        if (parts.length !== 3) {
-            return null;
-        }
-
-        let base64Url = parts[1];
-        if (!base64Url) return null;
-
-        let base64 = base64Url.replace(/-/g, '+').replace(/_/g, '/');
-
-        // Pad with standard base64 padding
-        while (base64.length % 4) {
-            base64 += '=';
-        }
-
-        const isBrowser = typeof window !== 'undefined' && typeof window.atob === 'function';
-        let jsonPayload: string;
-
-        if (isBrowser) {
-            // Browser decode
-            jsonPayload = decodeURIComponent(
-                window.atob(base64)
-                    .split('')
-                    .map((c) => '%' + ('00' + c.charCodeAt(0).toString(16)).slice(-2))
-                    .join('')
-            );
-        } else {
-            // Node.js decode
-            jsonPayload = Buffer.from(base64, 'base64').toString('utf8');
-        }
-
-        return JSON.parse(jsonPayload);
-    } catch (e) {
-        return null;
-    }
-}
+export interface DecodedTenxyteToken {
+    exp?: number;
+    iat?: number;
+    sub?: string;
+    roles?: string[];
+    permissions?: string[];
+    [key: string]: any;
+}
+
+/**
+ * Decodes the payload of a JWT without verifying the signature.
+ * Suitable for client-side routing and UI state.
+ */
+export function decodeJwt(token: string): DecodedTenxyteToken | null {
+    try {
+        const parts = token.split('.');
+        if (parts.length !== 3) {
+            return null;
+        }
+
+        let base64Url = parts[1];
+        if (!base64Url) return null;
+
+        let base64 = base64Url.replace(/-/g, '+').replace(/_/g, '/');
+
+        // Pad with standard base64 padding
+        while (base64.length % 4) {
+            base64 += '=';
+        }
+
+        const isBrowser = typeof window !== 'undefined' && typeof window.atob === 'function';
+        let jsonPayload: string;
+
+        if (isBrowser) {
+            // Browser decode
+            jsonPayload = decodeURIComponent(
+                window.atob(base64)
+                    .split('')
+                    .map((c) => '%' + ('00' + c.charCodeAt(0).toString(16)).slice(-2))
+                    .join('')
+            );
+        } else {
+            // Node.js decode
+            jsonPayload = Buffer.from(base64, 'base64').toString('utf8');
+        }
+
+        return JSON.parse(jsonPayload);
+    } catch (e) {
+        return null;
+    }
+}