@nurama/sdk 0.0.0-stage → 1.4.1

package/dist/utils/uploadSessionManager.js

@@ -0,0 +1,321 @@
+/**
+ * Upload Session Manager for Nurama SDK
+ *
+ * Provides upload progress persistence and cross-tab synchronization
+ * - Persists upload progress to localStorage with project isolation
+ * - Syncs upload state across multiple browser tabs
+ * - Automatic cleanup of completed/failed uploads
+ */
+export class UploadSessionManager {
+    constructor() {
+        this.messageListeners = new Map();
+        this.STORAGE_PREFIX = 'nurama_upload_session_';
+        this.MESSAGE_CHANNEL = 'nurama_upload_sync';
+        this.initializeCrossTabSync();
+    }
+    static getInstance() {
+        if (!UploadSessionManager.instance) {
+            UploadSessionManager.instance = new UploadSessionManager();
+        }
+        return UploadSessionManager.instance;
+    }
+    /**
+     * Initialize cross-tab synchronization using BroadcastChannel
+     */
+    initializeCrossTabSync() {
+        if (typeof window !== 'undefined' && 'BroadcastChannel' in window) {
+            try {
+                this.broadcastChannel = new BroadcastChannel(this.MESSAGE_CHANNEL);
+                this.broadcastChannel.addEventListener('message', this.handleCrossTabMessage.bind(this));
+            }
+            catch (error) {
+                console.warn('[UploadSessionManager] BroadcastChannel not available:', error);
+            }
+        }
+    }
+    /**
+     * Handle cross-tab messages
+     */
+    handleCrossTabMessage(event) {
+        const message = event.data;
+        if (message && message.type && message.projectId && message.sessionId) {
+            // Notify registered listeners
+            this.messageListeners.forEach(listener => {
+                try {
+                    listener(message);
+                }
+                catch (error) {
+                    console.error('[UploadSessionManager] Error in message listener:', error);
+                }
+            });
+        }
+    }
+    /**
+     * Generate storage key for upload session
+     */
+    getStorageKey(projectId, sessionId) {
+        return `${this.STORAGE_PREFIX}${projectId}_${sessionId}`;
+    }
+    /**
+     * Create a new upload session
+     */
+    createSession(projectId, sessionId, uploadData) {
+        const session = {
+            sessionId,
+            projectId,
+            uploadId: uploadData.uploadId,
+            key: uploadData.key,
+            assetId: uploadData.assetId,
+            progress: 0,
+            partNumber: 1,
+            totalParts: uploadData.totalParts,
+            completedParts: [],
+            fileName: uploadData.fileName,
+            fileSize: uploadData.fileSize,
+            timestamp: Date.now(),
+            status: 'uploading'
+        };
+        this.saveSession(session);
+        this.broadcastMessage('upload_status_change', projectId, sessionId, session);
+        return session;
+    }
+    /**
+     * Update upload progress for a session
+     */
+    updateProgress(projectId, sessionId, progress) {
+        const session = this.getSession(projectId, sessionId);
+        if (!session) {
+            console.warn(`[UploadSessionManager] Session not found: ${sessionId}`);
+            return;
+        }
+        const updatedSession = {
+            ...session,
+            progress: progress.progress,
+            partNumber: progress.partNumber,
+            completedParts: progress.completedParts || session.completedParts,
+            timestamp: Date.now()
+        };
+        this.saveSession(updatedSession);
+        this.broadcastMessage('upload_progress_update', projectId, sessionId, {
+            progress: progress.progress,
+            partNumber: progress.partNumber,
+            completedParts: progress.completedParts,
+            timestamp: updatedSession.timestamp
+        });
+    }
+    /**
+     * Update upload status
+     */
+    updateStatus(projectId, sessionId, status, error) {
+        const session = this.getSession(projectId, sessionId);
+        if (!session) {
+            console.warn(`[UploadSessionManager] Session not found: ${sessionId}`);
+            return;
+        }
+        const updatedSession = {
+            ...session,
+            status,
+            error,
+            timestamp: Date.now()
+        };
+        this.saveSession(updatedSession);
+        this.broadcastMessage('upload_status_change', projectId, sessionId, {
+            status,
+            error,
+            timestamp: updatedSession.timestamp
+        });
+    }
+    /**
+     * Get upload session data
+     */
+    getSession(projectId, sessionId) {
+        if (typeof window === 'undefined')
+            return null;
+        try {
+            const key = this.getStorageKey(projectId, sessionId);
+            const data = localStorage.getItem(key);
+            if (data) {
+                const session = JSON.parse(data);
+                // Validate session data
+                if (session.projectId === projectId && session.sessionId === sessionId) {
+                    return session;
+                }
+            }
+        }
+        catch (error) {
+            console.warn(`[UploadSessionManager] Failed to get session ${sessionId}:`, error);
+        }
+        return null;
+    }
+    /**
+     * Get all upload sessions for a project
+     */
+    getProjectSessions(projectId) {
+        if (typeof window === 'undefined')
+            return [];
+        const sessions = [];
+        const prefix = `${this.STORAGE_PREFIX}${projectId}_`;
+        try {
+            for (let i = 0; i < localStorage.length; i++) {
+                const key = localStorage.key(i);
+                if (key && key.startsWith(prefix)) {
+                    const data = localStorage.getItem(key);
+                    if (data) {
+                        try {
+                            const session = JSON.parse(data);
+                            if (session.projectId === projectId) {
+                                sessions.push(session);
+                            }
+                        }
+                        catch (error) {
+                            console.warn(`[UploadSessionManager] Invalid session data in ${key}:`, error);
+                        }
+                    }
+                }
+            }
+        }
+        catch (error) {
+            console.warn('[UploadSessionManager] Failed to get project sessions:', error);
+        }
+        // Sort by timestamp (most recent first)
+        return sessions.sort((a, b) => b.timestamp - a.timestamp);
+    }
+    /**
+     * Get every upload session across ALL projects (scans the whole localStorage
+     * prefix, not a single project). Used by app-level guards that need a global
+     * "is anything uploading right now" answer without knowing the project id.
+     */
+    getAllSessions() {
+        if (typeof window === 'undefined')
+            return [];
+        const sessions = [];
+        try {
+            for (let i = 0; i < localStorage.length; i++) {
+                const key = localStorage.key(i);
+                if (key && key.startsWith(this.STORAGE_PREFIX)) {
+                    const data = localStorage.getItem(key);
+                    if (data) {
+                        try {
+                            sessions.push(JSON.parse(data));
+                        }
+                        catch (error) {
+                            console.warn(`[UploadSessionManager] Invalid session data in ${key}:`, error);
+                        }
+                    }
+                }
+            }
+        }
+        catch (error) {
+            console.warn('[UploadSessionManager] Failed to enumerate sessions:', error);
+        }
+        return sessions.sort((a, b) => b.timestamp - a.timestamp);
+    }
+    /**
+     * True when at least one upload is genuinely in flight anywhere in the app.
+     *
+     * "In flight" = status `uploading`/`completing` AND updated within `staleMs`.
+     * The freshness window matters: a tab that crashed mid-upload leaves an
+     * `uploading` row in localStorage forever (it never reaches a terminal
+     * status). Progress ticks bump `timestamp` on every part, so a real upload
+     * stays fresh; a dead one goes stale and stops counting — otherwise a stale
+     * row would block app refreshes/navigation indefinitely.
+     *
+     * @param staleMs How long since the last progress update still counts as
+     *   active. Default 2 minutes — comfortably longer than a single part PUT on
+     *   a slow connection, short enough that a crashed upload clears quickly.
+     */
+    hasActiveUploads(staleMs = 2 * 60 * 1000) {
+        const cutoff = Date.now() - staleMs;
+        return this.getAllSessions().some((s) => (s.status === 'uploading' || s.status === 'completing') &&
+            s.timestamp >= cutoff);
+    }
+    /**
+     * Save session to localStorage
+     */
+    saveSession(session) {
+        if (typeof window === 'undefined')
+            return;
+        try {
+            const key = this.getStorageKey(session.projectId, session.sessionId);
+            localStorage.setItem(key, JSON.stringify(session));
+        }
+        catch (error) {
+            console.warn(`[UploadSessionManager] Failed to save session ${session.sessionId}:`, error);
+        }
+    }
+    /**
+     * Remove upload session
+     */
+    removeSession(projectId, sessionId) {
+        if (typeof window === 'undefined')
+            return;
+        try {
+            const key = this.getStorageKey(projectId, sessionId);
+            localStorage.removeItem(key);
+            this.broadcastMessage('upload_cleanup', projectId, sessionId);
+        }
+        catch (error) {
+            console.warn(`[UploadSessionManager] Failed to remove session ${sessionId}:`, error);
+        }
+    }
+    /**
+     * Clean up old or completed sessions
+     */
+    cleanupSessions(projectId, olderThanMs = 24 * 60 * 60 * 1000) {
+        const sessions = this.getProjectSessions(projectId);
+        const cutoff = Date.now() - olderThanMs;
+        sessions.forEach(session => {
+            // Remove old sessions or completed/failed/cancelled sessions older than 1 hour
+            const shouldRemove = session.timestamp < cutoff ||
+                (['completed', 'failed', 'cancelled'].includes(session.status) &&
+                    session.timestamp < (Date.now() - 60 * 60 * 1000));
+            if (shouldRemove) {
+                this.removeSession(projectId, session.sessionId);
+            }
+        });
+    }
+    /**
+     * Register a listener for cross-tab messages
+     */
+    onMessage(listenerId, callback) {
+        this.messageListeners.set(listenerId, callback);
+    }
+    /**
+     * Unregister a message listener
+     */
+    offMessage(listenerId) {
+        this.messageListeners.delete(listenerId);
+    }
+    /**
+     * Broadcast a message to other tabs
+     */
+    broadcastMessage(type, projectId, sessionId, data) {
+        if (this.broadcastChannel) {
+            try {
+                const message = {
+                    type,
+                    projectId,
+                    sessionId,
+                    data
+                };
+                this.broadcastChannel.postMessage(message);
+            }
+            catch (error) {
+                console.warn('[UploadSessionManager] Failed to broadcast message:', error);
+            }
+        }
+    }
+    /**
+     * Cleanup resources
+     */
+    destroy() {
+        if (this.broadcastChannel) {
+            this.broadcastChannel.close();
+            this.broadcastChannel = undefined;
+        }
+        this.messageListeners.clear();
+    }
+}
+// Export a singleton instance for convenience
+export const uploadSessionManager = UploadSessionManager.getInstance();
+//# sourceMappingURL=uploadSessionManager.js.map

package/dist/utils/uploadSessionManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploadSessionManager.js","sourceRoot":"","sources":["../../src/utils/uploadSessionManager.ts"],"names":[],"mappings":"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"}

package/dist/utils/urlParams.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Utility functions for handling URL parameters
+ */
+/**
+ * Converts a parameter object to URL-safe query parameters.
+ * Arrays are serialized as comma-separated values, using bracket notation, or as repeated parameters.
+ * Objects are serialized as JSON strings.
+ *
+ * @param params - The parameter object to convert
+ * @param options - Options for serialization
+ * @returns An array of [key, value] pairs suitable for URLSearchParams
+ */
+export interface UrlParamsOptions {
+    /** How to handle arrays: 'comma' for comma-separated, 'brackets' for key[]=value&key[]=value2, 'repeat' for key=value1&key=value2 */
+    arrayFormat?: 'comma' | 'brackets' | 'repeat';
+    /** How to handle nested objects: 'json' to stringify, 'dot' for dot notation, 'bracket' for key[subkey]=value */
+    objectFormat?: 'json' | 'dot' | 'bracket';
+    /** Whether to encode values (default: true) */
+    encode?: boolean;
+}
+export declare function parseUrlParams(params: Record<string, any>, options?: UrlParamsOptions): Array<[string, string]>;
+/**
+ * Converts parsed URL parameters back to a URLSearchParams object
+ * @param params - The parsed parameters as key-value pairs
+ * @returns URLSearchParams object
+ */
+export declare function createUrlSearchParams(params: Array<[string, string]>): URLSearchParams;
+/**
+ * Convenience function that combines parseUrlParams and createUrlSearchParams
+ * @param params - The parameter object to convert
+ * @param options - Options for serialization
+ * @returns URLSearchParams object
+ */
+export declare function paramsToUrlSearchParams(params: Record<string, any>, options?: UrlParamsOptions): URLSearchParams;
+//# sourceMappingURL=urlParams.d.ts.map

package/dist/utils/urlParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urlParams.d.ts","sourceRoot":"","sources":["../../src/utils/urlParams.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qIAAqI;IACrI,WAAW,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC9C,iHAAiH;IACjH,YAAY,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;IAC1C,+CAA+C;IAC/C,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,OAAO,GAAE,gBAAqB,GAC7B,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAkEzB;AA8DD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,eAAe,CAMtF;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,OAAO,CAAC,EAAE,gBAAgB,GACzB,eAAe,CAKjB"}

package/dist/utils/urlParams.js

@@ -0,0 +1,146 @@
+/**
+ * Utility functions for handling URL parameters
+ */
+export function parseUrlParams(params, options = {}) {
+    const { arrayFormat = 'repeat', // Changed default to repeat for backend compatibility
+    objectFormat = 'bracket', // Changed default to bracket for API compatibility
+    encode = true // Changed default to true as requested
+     } = options;
+    const result = [];
+    const encodeValue = (value) => {
+        return encode ? encodeURIComponent(value) : value;
+    };
+    const processValue = (key, value) => {
+        if (value === null || value === undefined) {
+            return; // Skip null/undefined values
+        }
+        if (Array.isArray(value)) {
+            if (arrayFormat === 'comma') {
+                // Convert array to comma-separated string
+                result.push([key, encodeValue(value.join(','))]);
+            }
+            else if (arrayFormat === 'brackets') {
+                // Use bracket notation: key[]=value1&key[]=value2
+                const bracketKey = `${key}[]`;
+                value.forEach((item) => {
+                    result.push([bracketKey, encodeValue(String(item))]);
+                });
+            }
+            else if (arrayFormat === 'repeat') {
+                // Use repeated key: key=value1&key=value2
+                value.forEach((item) => {
+                    result.push([key, encodeValue(String(item))]);
+                });
+            }
+        }
+        else if (value instanceof Date) {
+            // Handle Date objects specifically
+            result.push([key, encodeValue(value.toString())]);
+        }
+        else if (typeof value === 'object') {
+            if (objectFormat === 'json') {
+                // Stringify objects as JSON
+                result.push([key, encodeValue(JSON.stringify(value))]);
+            }
+            else if (objectFormat === 'dot') {
+                // Use dot notation for nested objects
+                flattenObject(value, key, result, encodeValue);
+            }
+            else if (objectFormat === 'bracket') {
+                // Use bracket notation for nested objects
+                flattenObjectBracket(value, key, result, encodeValue);
+            }
+        }
+        else if (typeof value === 'boolean') {
+            result.push([key, encodeValue(value.toString())]);
+        }
+        else if (typeof value === 'number') {
+            result.push([key, encodeValue(value.toString())]);
+        }
+        else if (typeof value === 'string') {
+            result.push([key, encodeValue(value)]);
+        }
+        else {
+            // For any other type, convert to string
+            result.push([key, encodeValue(String(value))]);
+        }
+    };
+    // Process each parameter
+    Object.entries(params).forEach(([key, value]) => {
+        processValue(key, value);
+    });
+    return result;
+}
+/**
+ * Flattens nested objects using dot notation
+ * @param obj - The object to flatten
+ * @param prefix - The current key prefix
+ * @param result - The result array to populate
+ * @param encodeValue - Function to encode values
+ */
+function flattenObject(obj, prefix, result, encodeValue) {
+    Object.entries(obj).forEach(([key, value]) => {
+        const newKey = `${prefix}.${key}`;
+        if (value === null || value === undefined) {
+            return;
+        }
+        if (typeof value === 'object' && !Array.isArray(value)) {
+            flattenObject(value, newKey, result, encodeValue);
+        }
+        else if (Array.isArray(value)) {
+            result.push([newKey, encodeValue(value.join(','))]);
+        }
+        else {
+            result.push([newKey, encodeValue(String(value))]);
+        }
+    });
+}
+/**
+ * Flattens nested objects using bracket notation
+ * @param obj - The object to flatten
+ * @param prefix - The current key prefix
+ * @param result - The result array to populate
+ * @param encodeValue - Function to encode values
+ */
+function flattenObjectBracket(obj, prefix, result, encodeValue) {
+    Object.entries(obj).forEach(([key, value]) => {
+        const newKey = `${prefix}[${key}]`;
+        if (value === null || value === undefined) {
+            return;
+        }
+        if (typeof value === 'object' && !Array.isArray(value)) {
+            flattenObjectBracket(value, newKey, result, encodeValue);
+        }
+        else if (Array.isArray(value)) {
+            result.push([newKey, encodeValue(value.join(','))]);
+        }
+        else {
+            result.push([newKey, encodeValue(String(value))]);
+        }
+    });
+}
+/**
+ * Converts parsed URL parameters back to a URLSearchParams object
+ * @param params - The parsed parameters as key-value pairs
+ * @returns URLSearchParams object
+ */
+export function createUrlSearchParams(params) {
+    const searchParams = new URLSearchParams();
+    params.forEach(([key, value]) => {
+        searchParams.append(key, value);
+    });
+    return searchParams;
+}
+/**
+ * Convenience function that combines parseUrlParams and createUrlSearchParams
+ * @param params - The parameter object to convert
+ * @param options - Options for serialization
+ * @returns URLSearchParams object
+ */
+export function paramsToUrlSearchParams(params, options) {
+    // Force encode: false because URLSearchParams.toString() handles encoding.
+    // Pre-encoding here would cause double-encoding (e.g. space → %20 → %2520).
+    const parsedParams = parseUrlParams(params, { ...options, encode: false });
+    return createUrlSearchParams(parsedParams);
+}
+//# sourceMappingURL=urlParams.js.map

package/dist/utils/urlParams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"urlParams.js","sourceRoot":"","sources":["../../src/utils/urlParams.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -0,0 +1,15 @@
+/**
+ * SDK Version Information
+ * AUTO-GENERATED by scripts/generate-version-info.cjs - DO NOT EDIT MANUALLY
+ */
+export interface SDKVersionInfo {
+    /** The release number for a published build; `<package.json version>+<source hash>` for any other build. */
+    version: string;
+    buildTimestamp: string;
+    buildHash: string;
+    gitCommit: string;
+    /** The build included uncommitted SDK changes. */
+    dirty: boolean;
+}
+export declare const SDK_VERSION: SDKVersionInfo;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,cAAc;IAC7B,4GAA4G;IAC5G,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,eAAO,MAAM,WAAW,EAAE,cAMzB,CAAC"}

package/dist/version.js

@@ -0,0 +1,12 @@
+/**
+ * SDK Version Information
+ * AUTO-GENERATED by scripts/generate-version-info.cjs - DO NOT EDIT MANUALLY
+ */
+export const SDK_VERSION = {
+    version: '1.4.1',
+    buildTimestamp: '2026-10-10T06:58:40.258Z',
+    buildHash: 'f6505e2eb9725dc8d239bb401ced8f88',
+    gitCommit: '1c00e18',
+    dirty: false,
+};
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH,MAAM,CAAC,MAAM,WAAW,GAAmB;IACzC,OAAO,EAAE,OAAO;IAChB,cAAc,EAAE,0BAA0B;IAC1C,SAAS,EAAE,kCAAkC;IAC7C,SAAS,EAAE,SAAS;IACpB,KAAK,EAAE,KAAK;CACb,CAAC"}

package/package.json

@@ -1,6 +1,90 @@
 {
   "name": "@nurama/sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.4.1",
+  "description": "Provides API, web-socket, and additional utilities for interfacing with the Nurama platform.",
+  "main": "dist/NuramaClient.js",
+  "module": "dist/NuramaClient.js",
+  "browser": "dist/browser/nurama-sdk.js",
+  "types": "dist/NuramaClient.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/NuramaClient.d.ts",
+      "import": "./dist/NuramaClient.js",
+      "require": "./dist/NuramaClient.js"
+    },
+    "./bot": {
+      "types": "./dist/BotClient.d.ts",
+      "import": "./dist/BotClient.js",
+      "require": "./dist/BotClient.js"
+    },
+    "./browser": "./dist/browser/nurama-sdk.js",
+    "./browser-min": "./dist/browser/nurama-sdk.min.js",
+    "./bot-browser": "./dist/browser/nurama-bot-sdk.js",
+    "./bot-browser-min": "./dist/browser/nurama-bot-sdk.min.js"
+  },
+  "keywords": [
+    "api",
+    "sdk",
+    "nurama"
+  ],
+  "author": "Nurama Team",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "jwt-decode": "^4.0.0",
+    "socket.io-client": "^4.7.2",
+    "@nurama/types": "1.4.1"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.14",
+    "@types/jwt-decode": "^2.2.1",
+    "@types/node": "^22.14.1",
+    "@types/socket.io-client": "^1.4.36",
+    "@typescript-eslint/eslint-plugin": "^6.18.0",
+    "@typescript-eslint/parser": "^6.18.0",
+    "dotenv": "^16.3.1",
+    "esbuild": "^0.21.5",
+    "eslint": "^8.56.0",
+    "jest": "^29.7.0",
+    "shx": "^0.3.4",
+    "ts-jest": "^29.3.4",
+    "tslib": "^2.8.1",
+    "typedoc": "^0.28.20",
+    "typedoc-plugin-markdown": "^4.13.1",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.32.0"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nurama-team/nurama.git",
+    "directory": "packages/sdk"
+  },
+  "scripts": {
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "dev": "node scripts/dev.cjs",
+    "gen:version": "node scripts/generate-version-info.cjs",
+    "prebuild": "pnpm gen:version",
+    "build:tsc": "tsc",
+    "build:browser": "esbuild src/browser-entry.js --bundle --outfile=dist/browser/nurama-sdk.js --format=iife --platform=browser",
+    "build:browser-min": "esbuild src/browser-entry.js --bundle --minify --outfile=dist/browser/nurama-sdk.min.js --format=iife --platform=browser",
+    "build:bot": "pnpm gen:version && esbuild src/bot-browser-entry.js --bundle --outfile=dist/browser/nurama-bot-sdk.js --format=iife --platform=browser",
+    "build:bot-min": "pnpm gen:version && esbuild src/bot-browser-entry.js --bundle --minify --outfile=dist/browser/nurama-bot-sdk.min.js --format=iife --platform=browser",
+    "copy:examples": "shx mkdir -p examples/example-html && shx cp dist/browser/nurama-sdk.min.js examples/example-html/",
+    "build": "pnpm build:tsc && pnpm build:browser && pnpm build:browser-min && pnpm build:bot && pnpm build:bot-min && pnpm copy:examples",
+    "lint": "eslint .",
+    "lint:main": "eslint --ignore-pattern 'example-react/**' --ext .js,.jsx,.ts,.tsx .",
+    "docs:typedoc": "pnpm gen:version && typedoc"
+  }
 }