@busy-app/busy-lib 0.0.1 → 0.0.3

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";var d=Object.defineProperty;var w=(e,t,n)=>t in e?d(e,t,{enumerable:!0,configurable:!0,writable:!0,value:n}):e[t]=n;var a=(e,t,n)=>w(e,typeof t!="symbol"?t+"":t,n);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const y=require("openapi-fetch");function m(e){const t=e.split(".");if(t.length!==4)return!1;for(const n of t){if(n.length===0||n.length>1&&n[0]==="0"||!/^\d+$/.test(n))return!1;const r=Number(n);if(r<0||r>255)return!1}return!0}const g=(e,t)=>{if(typeof FormData<"u"&&e instanceof FormData||typeof Buffer<"u"&&typeof Buffer.isBuffer=="function"&&Buffer.isBuffer(e)||typeof File<"u"&&e instanceof File||typeof Blob<"u"&&e instanceof Blob||typeof ArrayBuffer<"u"&&e instanceof ArrayBuffer||typeof ArrayBuffer<"u"&&ArrayBuffer.isView&&ArrayBuffer.isView(e))return e;let n;return t&&(t instanceof Headers?n=t.get("Content-Type")??t.get("content-type")??void 0:typeof t=="object"&&(n=t["Content-Type"]??t["content-type"]),n==="application/x-www-form-urlencoded")?e&&typeof e=="object"&&!(e instanceof URLSearchParams)?new URLSearchParams(e).toString():String(e):JSON.stringify(e)};let o=null;function S(e){o=y({baseUrl:e,bodySerializer:g})}async function E(e){const{appId:t,fileName:n,file:r}=e;if(!o)throw new Error("API client is not initialized");const{data:i,error:s}=await o.POST("/v0/assets/upload",{params:{query:{app_id:t,file:n}},headers:{"Content-Type":"application/octet-stream"},body:r});if(s)throw s;return i}async function A(e){const{appId:t}=e;if(!o)throw new Error("API client is not initialized");const{data:n,error:r}=await o.DELETE("/v0/assets/upload",{params:{query:{app_id:t}}});if(r)throw r;return n}const B={timeout:5,x:0,y:0,display:"front"};function k(e){return{...B,...e}}async function T(e){const{appId:t,elements:n}=e;if(!o)throw new Error("API client is not initialized");const r=n.map(k),{data:i,error:s}=await o.POST("/v0/display/draw",{body:{app_id:t,elements:r}});if(s)throw s;return i}async function D(){if(!o)throw new Error("API client is not initialized");const{data:e,error:t}=await o.DELETE("/v0/display/draw");if(t)throw t;return e}async function L(e){const{appId:t,path:n}=e;if(!o)throw new Error("API client is not initialized");const{data:r,error:i}=await o.POST("/v0/audio/play",{params:{query:{app_id:t,path:n}}});if(i)throw i;return r}async function v(){if(!o)throw new Error("API client is not initialized");const{data:e,error:t}=await o.DELETE("/v0/audio/play");if(t)throw t;return e}class P{constructor(t="10.0.4.20"){a(this,"ip");if(!m(t))throw new Error(`Incorrect IPv4: ${t}`);this.ip=t,console.log(this.ip),S(`http://${this.ip}/api/`)}async uploadAsset(t){return await E(t)}async deleteAssets(t){return await A(t)}async drawDisplay(t){return await T(t)}async clearDisplay(){return await D()}async playSound(t){return await L(t)}async stopSound(){return await v()}}var l=(e=>(e[e.FRONT=0]="FRONT",e[e.BACK=1]="BACK",e))(l||{});const C=3e3,I=new Set([1001,1006,1012,1013,1014,3008]);function h(e,t){if(t<0||t>=e.length)throw new Error(`Index ${t} is out of bounds (0…${e.length-1})`);const n=e[t];if(n===void 0)throw new Error(`Unexpected undefined at index ${t}`);return n}function O(e,t){let n=0;const r=e.length,i=[];for(;n<r;){const s=h(e,n);if(n+=1,(s&128)!==0){const c=s&127;for(let f=0;f<c*t;f++)i.push(e[n+f]);n+=c*t}else{const c=s,f=e.slice(n,n+t);for(let p=0;p<c;p++)for(let u=0;u<t;u++)i.push(f[u]);n+=t}}return new Uint8Array(i)}function U(e){const t=new Uint8Array(e.length*2);let n=0,r=0;for(;n<e.length;){const i=h(e,n),s=i&15,c=i>>4&15;t[r]=s,t[r+1]=c,n+=1,r+=2}return t}class N{constructor(t){a(this,"connected",!1);a(this,"dataListeners",[]);a(this,"stopListeners",[]);a(this,"errorListeners",[]);a(this,"socket",null);a(this,"deviceScreen");if(this.config=t,!(()=>typeof window<"u"&&typeof window.document<"u"))throw new Error("not browser");this.deviceScreen=l[this.config.deviceScreen.toUpperCase()]}onData(t){this.dataListeners.push(t)}onStop(t){this.stopListeners.push(t)}onError(t){this.errorListeners.push(t)}emitData(t){for(const n of this.dataListeners)n(t)}emitStop(){for(const t of this.stopListeners)t()}emitError(t){for(const n of this.errorListeners)n(t)}async openWebsocket(){this.socket&&await this.closeWebsocket();let t="";this.config.mode==="cloud"?t=`${this.config.domain}/bars/${this.config.idDevice}/ws`:this.config.mode==="local"&&(t=`${this.config.barUrl}/api/v0/screen/ws`),this.socket=new WebSocket(t),this.socket.onopen=()=>{this.socket&&(this.config.mode==="cloud"?this.socket.send(JSON.stringify({token:this.config.token,display:this.deviceScreen})):this.config.mode==="local"&&this.socket.send(JSON.stringify({display:this.deviceScreen})),this.connected=!0)},this.socket.binaryType="arraybuffer",this.socket.onmessage=n=>{try{if(typeof n.data=="string")return;const r=new Uint8Array(n.data);if(this.config.mode==="cloud")this.emitData(r);else if(this.config.mode==="local"){let i;const s=this.deviceScreen===l.FRONT?3:2;try{const c=O(r,s);this.deviceScreen===l.BACK?i=U(c):i=c,this.emitData(i)}catch{this.emitData(r)}}}catch{this.connected=!1,this.emitStop()}},this.socket.onerror=n=>{this.connected=!1,this.emitError({code:1006,message:"WebSocket error occurred",raw:n}),this.emitStop()},this.socket.onclose=async n=>{if(this.socket=null,this.connected=!1,n.code===C||I.has(n.code)){this.emitError({code:n.code,message:n.reason,raw:n});return}this.emitStop()}}closeWebsocket(){return this.connected=!1,new Promise(t=>{this.socket?(this.socket.onclose=()=>{t()},this.socket.close(),this.socket=null):t(),this.emitStop()})}}exports.BusyBar=P;exports.ScreenStream=N;

package/dist/index.d.ts

@@ -0,0 +1,859 @@
+declare interface AudioParams {
+    appId: paths["/v0/audio/play"]["post"]["parameters"]["query"]["app_id"];
+    path: paths["/v0/audio/play"]["post"]["parameters"]["query"]["path"];
+}
+
+declare interface BaseConfig {
+    deviceScreen: Lowercase<keyof typeof DeviceScreen>;
+}
+
+/**
+ * Main library class for interacting with the Busy Bar API.
+ *
+ * @class
+ */
+export declare class BusyBar {
+    /**
+     * Device IPv4 address.
+     * @type {IPv4}
+     * @readonly
+     */
+    readonly ip: IPv4;
+    /**
+     * Creates an instance of BUSY Bar.
+     * Initializes the API client with the provided IPv4 address.
+     *
+     * @param {IPv4} [ip="10.0.4.20"] - The IPv4 address of the device.
+     * @throws {Error} If the provided IP is not a valid IPv4 address.
+     */
+    constructor(ip?: IPv4);
+    /**
+     * Uploads an asset to the device.
+     *
+     * @param {UploadParams} params - Parameters for the upload.
+     * @param {UploadParams['appId']} params.appId - Application ID for organizing assets.
+     * @param {UploadParams['fileName']} params.fileName - Filename for the uploaded asset.
+     * @param {UploadParams['file']} params.file - File data to upload.
+     * @returns {Promise<{ result: string }>} Result of the upload operation.
+     */
+    uploadAsset(params: UploadParams): Promise<{
+        result: string;
+    }>;
+    /**
+     * Deletes all assets for a specific application from the device.
+     *
+     * @param {DeleteParams} params - Parameters for the delete.
+     * @param {DeleteParams['appId']} params.appId - Application ID whose assets should be deleted.
+     * @returns {Promise<{ result: string }>} Result of the delete operation.
+     */
+    deleteAssets(params: DeleteParams): Promise<{
+        result: string;
+    }>;
+    /**
+     * Draws elements on the device display.
+     *
+     * @param {DrawParams} params - Parameters for the draw operation.
+     * @param {DrawParams['appId']} params.appId - Application ID for organizing display elements.
+     * @param {DrawParams['elements'][]} params.elements - Array of display elements (text or image).
+     * @returns {Promise<{ result: string }>} Result of the draw operation.
+     */
+    drawDisplay(params: DrawParams): Promise<{
+        result: string;
+    }>;
+    /**
+     * Clears the device display and stops the Canvas application if running.
+     *
+     * @returns {Promise<{ result: string }>} Result of the clear operation.
+     */
+    clearDisplay(): Promise<{
+        result: string;
+    }>;
+    /**
+     * Plays an audio file from the assets directory.
+     *
+     * @param {AudioParams} params - Parameters for the audio playback.
+     * @param {AudioParams['appId']} params.appId - Application ID for organizing assets.
+     * @param {AudioParams['path']} params.path - Path to the audio file within the app's assets directory.
+     * @returns {Promise<{ result: string }>} Result of the play operation.
+     */
+    playSound(params: AudioParams): Promise<{
+        result: string;
+    }>;
+    /**
+     * Stops any currently playing audio on the device.
+     *
+     * @returns {Promise<{ result: string }>} Result of the stop operation.
+     */
+    stopSound(): Promise<{
+        result: string;
+    }>;
+}
+
+declare interface components {
+    schemas: {
+        /** @example {
+         *       "state": 1
+         *     } */
+        LedState: {
+            /**
+             * @description Current LED state (0 for off, 1 for on)
+             * @enum {integer}
+             */
+            state: 0 | 1;
+        };
+        /** @example {
+         *       "state": 1
+         *     } */
+        LedStateRequest: {
+            /**
+             * @description LED state (0 for off, 1 for on)
+             * @enum {integer}
+             */
+            state: 0 | 1;
+        };
+        SuccessResponse: {
+            /**
+             * @description Success status message
+             * @example OK
+             */
+            result: string;
+        };
+        LedStateResponse: components["schemas"]["SuccessResponse"] & {
+            /**
+             * @description Current LED state (0 for off, 1 for on)
+             * @enum {integer}
+             */
+            state: 0 | 1;
+        };
+        /** @example {
+         *       "branch": "main",
+         *       "version": "1.0.0",
+         *       "build_date": "2024-01-01",
+         *       "commit_hash": "abc123def456"
+         *     } */
+        VersionInfo: {
+            /**
+             * @description Git branch name
+             * @example main
+             */
+            branch: string;
+            /**
+             * @description Firmware version
+             * @example 1.0.0
+             */
+            version: string;
+            /**
+             * @description Build date
+             * @example 2024-01-01
+             */
+            build_date: string;
+            /**
+             * @description Git commit hash (may include -dirty suffix)
+             * @example abc123def456-dirty
+             */
+            commit_hash: string;
+        };
+        /**
+         * Format: binary
+         * @description Binary data upload
+         */
+        BinaryUpload: string;
+        FileUpload: {
+            /**
+             * Format: binary
+             * @description File to upload
+             */
+            file: string;
+        };
+        /** @example {
+         *       "error": "Invalid parameter",
+         *       "code": 400
+         *     } */
+        Error: {
+            /** @description Error message */
+            error: string;
+            /** @description Error code */
+            code?: number;
+        };
+        /** @example {
+         *       "app_id": "my_app",
+         *       "elements": [
+         *         {
+         *           "id": "0",
+         *           "timeout": 5,
+         *           "type": "text",
+         *           "text": "Hello, world!",
+         *           "x": 0,
+         *           "y": 0,
+         *           "display": "front"
+         *         },
+         *         {
+         *           "id": "1",
+         *           "timeout": 6,
+         *           "type": "image",
+         *           "path": "data.png",
+         *           "x": 0,
+         *           "y": 0,
+         *           "display": "back"
+         *         }
+         *       ]
+         *     } */
+        DisplayElements: {
+            /**
+             * @description Application ID for organizing assets
+             * @example my_app
+             */
+            app_id: string;
+            /** @description Array of elements to display */
+            elements: components["schemas"]["DisplayElement"][];
+        };
+        DisplayElement: {
+            /** @description Unique identifier for the element */
+            id: string;
+            /** @description Time in seconds the element should be displayed (0 for no timeout) */
+            timeout?: number;
+            /**
+             * @description Type of display element
+             * @enum {string}
+             */
+            type: "text" | "image";
+            /** @description X coordinate for placement on display */
+            x: number;
+            /** @description Y coordinate for placement on display */
+            y: number;
+            /**
+             * @description Which display to show the element on (for dual-display devices)
+             * @default front
+             * @enum {string}
+             */
+            display: "front" | "back";
+        };
+        TextElement: Omit<components["schemas"]["DisplayElement"], "type"> & {
+            /** @description Text content to display */
+            text: string;
+        } & {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            type: "text";
+        };
+        ImageElement: Omit<components["schemas"]["DisplayElement"], "type"> & {
+            /** @description Path to the image file in the app's assets */
+            path: string;
+        } & {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            type: "image";
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+
+declare type CustomElement = CustomTextElement | CustomImageElement;
+
+declare type CustomImageElement = MakeOptional<components["schemas"]["ImageElement"], OptionalFields>;
+
+declare type CustomTextElement = MakeOptional<components["schemas"]["TextElement"], OptionalFields>;
+
+declare type DataListener = (data: Uint8Array) => void;
+
+declare interface DeleteParams {
+    appId: paths["/v0/assets/upload"]["delete"]["parameters"]["query"]["app_id"];
+}
+
+declare type DeviceConfig = LocalConfig | SiteConfig;
+
+declare enum DeviceScreen {
+    FRONT = 0,
+    BACK = 1
+}
+
+declare interface DrawParams {
+    appId: paths["/v0/display/draw"]["post"]["requestBody"]["content"]["application/json"]["app_id"];
+    elements: CustomElement[];
+}
+
+declare type ErrorListener = (payload: ErrorPayload) => void;
+
+declare interface ErrorPayload {
+    code: number;
+    message: string;
+    raw: Error | CloseEvent | Event;
+}
+
+declare type IPv4 = string;
+
+declare interface LocalConfig extends BaseConfig {
+    mode: "local";
+    barUrl: string;
+}
+
+declare type MakeOptional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+
+declare interface operations {
+    getLedState: {
+        parameters: {
+            query?: {
+                /** @description LED state (0 for off, 1 for on) - alternative to JSON body */
+                state?: 0 | 1;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description LED state retrieved successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LedStateResponse"];
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    setLedState: {
+        parameters: {
+            query?: {
+                /** @description LED state (0 for off, 1 for on) - alternative to JSON body */
+                state?: 0 | 1;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description LED state as JSON (alternative to query parameter) */
+        requestBody?: {
+            content: {
+                "application/json": components["schemas"]["LedStateRequest"];
+            };
+        };
+        responses: {
+            /** @description LED state set successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LedStateResponse"];
+                };
+            };
+            /** @description Invalid state parameter */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    getVersion: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Version information retrieved successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["VersionInfo"];
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    uploadAssetWithAppId: {
+        parameters: {
+            query: {
+                /**
+                 * @description Application ID for organizing assets
+                 * @example my_app
+                 */
+                app_id: string;
+                /**
+                 * @description Filename for the uploaded asset
+                 * @example data.png
+                 */
+                file: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/octet-stream": string;
+            };
+        };
+        responses: {
+            /** @description File uploaded successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SuccessResponse"];
+                };
+            };
+            /** @description Invalid parameters or upload failed */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description File too large */
+            413: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    deleteAppAssets: {
+        parameters: {
+            query: {
+                /**
+                 * @description Application ID whose assets should be deleted
+                 * @example my_app
+                 */
+                app_id: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Assets deleted successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SuccessResponse"];
+                };
+            };
+            /** @description Invalid app_id or deletion failed */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    drawOnDisplay: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DisplayElements"];
+            };
+        };
+        responses: {
+            /** @description Drawing command executed successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SuccessResponse"];
+                };
+            };
+            /** @description Invalid drawing data */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Display error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    clearDisplay: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Display cleared successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SuccessResponse"];
+                };
+            };
+            /** @description Display error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    playAudio: {
+        parameters: {
+            query: {
+                /**
+                 * @description Application ID for organizing assets
+                 * @example my_app
+                 */
+                app_id: string;
+                /**
+                 * @description Path to audio file within app's assets directory
+                 * @example data.snd
+                 */
+                path: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Audio playback started successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SuccessResponse"];
+                };
+            };
+            /** @description Invalid file path or file not found */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Audio system error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    stopAudio: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Audio playback stopped successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SuccessResponse"];
+                };
+            };
+            /** @description Audio system error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    connectWebSocket: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description WebSocket connection established */
+            101: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description WebSocket upgrade failed */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Upgrade required */
+            426: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+}
+
+declare type OptionalFields = "timeout" | "x" | "y" | "display";
+
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+declare interface paths {
+    "/v0/led": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get LED state
+         * @description Retrieves the current LED state
+         */
+        get: operations["getLedState"];
+        put?: never;
+        /**
+         * Set LED state
+         * @description Sets the LED state via query parameter or JSON body
+         */
+        post: operations["setLedState"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v0/version": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get firmware version information
+         * @description Retrieves firmware version, branch, build date, and commit information
+         */
+        get: operations["getVersion"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v0/assets/upload": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Upload asset file with app ID
+         * @description Uploads a file to a specific app's assets directory
+         */
+        post: operations["uploadAssetWithAppId"];
+        /**
+         * Delete app assets
+         * @description Deletes all assets for a specific app ID
+         */
+        delete: operations["deleteAppAssets"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v0/display/draw": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Draw on display
+         * @description Sends drawing data to the display.
+         *     Supports JSON-defined display elements.
+         *
+         */
+        post: operations["drawOnDisplay"];
+        /**
+         * Clear display
+         * @description Clears the display and stops the Canvas application if running
+         */
+        delete: operations["clearDisplay"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v0/audio/play": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Play audio file
+         * @description Plays an audio file from the assets directory.
+         *     Supported formats include .snd files.
+         *
+         */
+        post: operations["playAudio"];
+        /**
+         * Stop audio playback
+         * @description Stops any currently playing audio
+         */
+        delete: operations["stopAudio"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/ws_test": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * WebSocket test endpoint
+         * @description WebSocket connection for real-time communication and testing.
+         *     Upgrade from HTTP to WebSocket protocol is required.
+         *
+         */
+        get: operations["connectWebSocket"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+
+export declare class ScreenStream {
+    private config;
+    connected: boolean;
+    private dataListeners;
+    private stopListeners;
+    private errorListeners;
+    private socket;
+    private deviceScreen;
+    constructor(config: DeviceConfig);
+    onData(listener: DataListener): void;
+    onStop(listener: StopListener): void;
+    onError(listener: ErrorListener): void;
+    protected emitData(data: Uint8Array): void;
+    protected emitStop(): void;
+    protected emitError(payload: ErrorPayload): void;
+    openWebsocket(): Promise<void>;
+    closeWebsocket(): Promise<void>;
+}
+
+declare interface SiteConfig extends BaseConfig {
+    mode: "cloud";
+    domain: string;
+    token: string;
+    idDevice: string;
+}
+
+declare type StopListener = () => void;
+
+declare interface UploadParams {
+    appId: paths["/v0/assets/upload"]["post"]["parameters"]["query"]["app_id"];
+    fileName: paths["/v0/assets/upload"]["post"]["parameters"]["query"]["file"];
+    file: Buffer | Blob | File | ArrayBuffer;
+}
+
+export { }

package/dist/index.js

@@ -0,0 +1,328 @@
+var d = Object.defineProperty;
+var w = (e, t, n) => t in e ? d(e, t, { enumerable: !0, configurable: !0, writable: !0, value: n }) : e[t] = n;
+var a = (e, t, n) => w(e, typeof t != "symbol" ? t + "" : t, n);
+import y from "openapi-fetch";
+function m(e) {
+  const t = e.split(".");
+  if (t.length !== 4)
+    return !1;
+  for (const n of t) {
+    if (n.length === 0 || n.length > 1 && n[0] === "0" || !/^\d+$/.test(n))
+      return !1;
+    const r = Number(n);
+    if (r < 0 || r > 255)
+      return !1;
+  }
+  return !0;
+}
+const g = (e, t) => {
+  if (typeof FormData < "u" && e instanceof FormData || typeof Buffer < "u" && typeof Buffer.isBuffer == "function" && Buffer.isBuffer(e) || typeof File < "u" && e instanceof File || typeof Blob < "u" && e instanceof Blob || typeof ArrayBuffer < "u" && e instanceof ArrayBuffer || typeof ArrayBuffer < "u" && ArrayBuffer.isView && ArrayBuffer.isView(e))
+    return e;
+  let n;
+  return t && (t instanceof Headers ? n = t.get("Content-Type") ?? t.get("content-type") ?? void 0 : typeof t == "object" && (n = t["Content-Type"] ?? t["content-type"]), n === "application/x-www-form-urlencoded") ? e && typeof e == "object" && !(e instanceof URLSearchParams) ? new URLSearchParams(e).toString() : String(e) : JSON.stringify(e);
+};
+let o = null;
+function E(e) {
+  o = y({
+    baseUrl: e,
+    bodySerializer: g
+  });
+}
+async function S(e) {
+  const { appId: t, fileName: n, file: r } = e;
+  if (!o)
+    throw new Error("API client is not initialized");
+  const { data: i, error: s } = await o.POST("/v0/assets/upload", {
+    params: {
+      query: {
+        app_id: t,
+        file: n
+      }
+    },
+    headers: {
+      "Content-Type": "application/octet-stream"
+    },
+    body: r
+  });
+  if (s)
+    throw s;
+  return i;
+}
+async function A(e) {
+  const { appId: t } = e;
+  if (!o)
+    throw new Error("API client is not initialized");
+  const { data: n, error: r } = await o.DELETE("/v0/assets/upload", {
+    params: {
+      query: {
+        app_id: t
+      }
+    }
+  });
+  if (r)
+    throw r;
+  return n;
+}
+const B = { timeout: 5, x: 0, y: 0, display: "front" };
+function k(e) {
+  return { ...B, ...e };
+}
+async function D(e) {
+  const { appId: t, elements: n } = e;
+  if (!o)
+    throw new Error("API client is not initialized");
+  const r = n.map(k), { data: i, error: s } = await o.POST("/v0/display/draw", {
+    body: {
+      app_id: t,
+      elements: r
+    }
+  });
+  if (s)
+    throw s;
+  return i;
+}
+async function L() {
+  if (!o)
+    throw new Error("API client is not initialized");
+  const { data: e, error: t } = await o.DELETE("/v0/display/draw");
+  if (t)
+    throw t;
+  return e;
+}
+async function T(e) {
+  const { appId: t, path: n } = e;
+  if (!o)
+    throw new Error("API client is not initialized");
+  const { data: r, error: i } = await o.POST("/v0/audio/play", {
+    params: {
+      query: {
+        app_id: t,
+        path: n
+      }
+    }
+  });
+  if (i)
+    throw i;
+  return r;
+}
+async function v() {
+  if (!o)
+    throw new Error("API client is not initialized");
+  const { data: e, error: t } = await o.DELETE("/v0/audio/play");
+  if (t)
+    throw t;
+  return e;
+}
+class $ {
+  /**
+   * Creates an instance of BUSY Bar.
+   * Initializes the API client with the provided IPv4 address.
+   *
+   * @param {IPv4} [ip="10.0.4.20"] - The IPv4 address of the device.
+   * @throws {Error} If the provided IP is not a valid IPv4 address.
+   */
+  constructor(t = "10.0.4.20") {
+    /**
+     * Device IPv4 address.
+     * @type {IPv4}
+     * @readonly
+     */
+    a(this, "ip");
+    if (!m(t))
+      throw new Error(`Incorrect IPv4: ${t}`);
+    this.ip = t, console.log(this.ip), E(`http://${this.ip}/api/`);
+  }
+  /**
+   * Uploads an asset to the device.
+   *
+   * @param {UploadParams} params - Parameters for the upload.
+   * @param {UploadParams['appId']} params.appId - Application ID for organizing assets.
+   * @param {UploadParams['fileName']} params.fileName - Filename for the uploaded asset.
+   * @param {UploadParams['file']} params.file - File data to upload.
+   * @returns {Promise<{ result: string }>} Result of the upload operation.
+   */
+  async uploadAsset(t) {
+    return await S(t);
+  }
+  /**
+   * Deletes all assets for a specific application from the device.
+   *
+   * @param {DeleteParams} params - Parameters for the delete.
+   * @param {DeleteParams['appId']} params.appId - Application ID whose assets should be deleted.
+   * @returns {Promise<{ result: string }>} Result of the delete operation.
+   */
+  async deleteAssets(t) {
+    return await A(t);
+  }
+  /**
+   * Draws elements on the device display.
+   *
+   * @param {DrawParams} params - Parameters for the draw operation.
+   * @param {DrawParams['appId']} params.appId - Application ID for organizing display elements.
+   * @param {DrawParams['elements'][]} params.elements - Array of display elements (text or image).
+   * @returns {Promise<{ result: string }>} Result of the draw operation.
+   */
+  async drawDisplay(t) {
+    return await D(t);
+  }
+  /**
+   * Clears the device display and stops the Canvas application if running.
+   *
+   * @returns {Promise<{ result: string }>} Result of the clear operation.
+   */
+  async clearDisplay() {
+    return await L();
+  }
+  /**
+   * Plays an audio file from the assets directory.
+   *
+   * @param {AudioParams} params - Parameters for the audio playback.
+   * @param {AudioParams['appId']} params.appId - Application ID for organizing assets.
+   * @param {AudioParams['path']} params.path - Path to the audio file within the app's assets directory.
+   * @returns {Promise<{ result: string }>} Result of the play operation.
+   */
+  async playSound(t) {
+    return await T(t);
+  }
+  /**
+   * Stops any currently playing audio on the device.
+   *
+   * @returns {Promise<{ result: string }>} Result of the stop operation.
+   */
+  async stopSound() {
+    return await v();
+  }
+}
+var l = /* @__PURE__ */ ((e) => (e[e.FRONT = 0] = "FRONT", e[e.BACK = 1] = "BACK", e))(l || {});
+const C = 3e3, I = /* @__PURE__ */ new Set([1001, 1006, 1012, 1013, 1014, 3008]);
+function h(e, t) {
+  if (t < 0 || t >= e.length)
+    throw new Error(`Index ${t} is out of bounds (0…${e.length - 1})`);
+  const n = e[t];
+  if (n === void 0)
+    throw new Error(`Unexpected undefined at index ${t}`);
+  return n;
+}
+function P(e, t) {
+  let n = 0;
+  const r = e.length, i = [];
+  for (; n < r; ) {
+    const s = h(e, n);
+    if (n += 1, (s & 128) !== 0) {
+      const c = s & 127;
+      for (let f = 0; f < c * t; f++)
+        i.push(e[n + f]);
+      n += c * t;
+    } else {
+      const c = s, f = e.slice(n, n + t);
+      for (let p = 0; p < c; p++)
+        for (let u = 0; u < t; u++)
+          i.push(f[u]);
+      n += t;
+    }
+  }
+  return new Uint8Array(i);
+}
+function U(e) {
+  const t = new Uint8Array(e.length * 2);
+  let n = 0, r = 0;
+  for (; n < e.length; ) {
+    const i = h(e, n), s = i & 15, c = i >> 4 & 15;
+    t[r] = s, t[r + 1] = c, n += 1, r += 2;
+  }
+  return t;
+}
+class F {
+  constructor(t) {
+    a(this, "connected", !1);
+    a(this, "dataListeners", []);
+    a(this, "stopListeners", []);
+    a(this, "errorListeners", []);
+    a(this, "socket", null);
+    a(this, "deviceScreen");
+    if (this.config = t, !(() => typeof window < "u" && typeof window.document < "u"))
+      throw new Error("not browser");
+    this.deviceScreen = l[this.config.deviceScreen.toUpperCase()];
+  }
+  onData(t) {
+    this.dataListeners.push(t);
+  }
+  onStop(t) {
+    this.stopListeners.push(t);
+  }
+  onError(t) {
+    this.errorListeners.push(t);
+  }
+  emitData(t) {
+    for (const n of this.dataListeners)
+      n(t);
+  }
+  emitStop() {
+    for (const t of this.stopListeners)
+      t();
+  }
+  emitError(t) {
+    for (const n of this.errorListeners)
+      n(t);
+  }
+  async openWebsocket() {
+    this.socket && await this.closeWebsocket();
+    let t = "";
+    this.config.mode === "cloud" ? t = `${this.config.domain}/bars/${this.config.idDevice}/ws` : this.config.mode === "local" && (t = `${this.config.barUrl}/api/v0/screen/ws`), this.socket = new WebSocket(t), this.socket.onopen = () => {
+      this.socket && (this.config.mode === "cloud" ? this.socket.send(
+        JSON.stringify({
+          token: this.config.token,
+          display: this.deviceScreen
+        })
+      ) : this.config.mode === "local" && this.socket.send(JSON.stringify({ display: this.deviceScreen })), this.connected = !0);
+    }, this.socket.binaryType = "arraybuffer", this.socket.onmessage = (n) => {
+      try {
+        if (typeof n.data == "string")
+          return;
+        const r = new Uint8Array(n.data);
+        if (this.config.mode === "cloud")
+          this.emitData(r);
+        else if (this.config.mode === "local") {
+          let i;
+          const s = this.deviceScreen === l.FRONT ? 3 : 2;
+          try {
+            const c = P(r, s);
+            this.deviceScreen === l.BACK ? i = U(c) : i = c, this.emitData(i);
+          } catch {
+            this.emitData(r);
+          }
+        }
+      } catch {
+        this.connected = !1, this.emitStop();
+      }
+    }, this.socket.onerror = (n) => {
+      this.connected = !1, this.emitError({
+        code: 1006,
+        // Standard «abnormal closure» code per RFC-6455
+        message: "WebSocket error occurred",
+        raw: n
+      }), this.emitStop();
+    }, this.socket.onclose = async (n) => {
+      if (this.socket = null, this.connected = !1, n.code === C || I.has(n.code)) {
+        this.emitError({
+          code: n.code,
+          message: n.reason,
+          raw: n
+        });
+        return;
+      }
+      this.emitStop();
+    };
+  }
+  closeWebsocket() {
+    return this.connected = !1, new Promise((t) => {
+      this.socket ? (this.socket.onclose = () => {
+        t();
+      }, this.socket.close(), this.socket = null) : t(), this.emitStop();
+    });
+  }
+}
+export {
+  $ as BusyBar,
+  F as ScreenStream
+};

package/package.json

@@ -2,7 +2,10 @@
   "name": "@busy-app/busy-lib",
   "private": false,
   "description": "A library for interacting with the BUSY Bar API",
-  "version": "0.0.1",
+  "version": "0.0.3",
+  "publishConfig": {
+    "access": "public"
+  },
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -17,10 +20,6 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "vite build",
-    "docs:generate": "typedoc"
-  },
   "dependencies": {
     "openapi-fetch": "^0.14.0"
   },
@@ -34,7 +33,10 @@
     "vite-tsconfig-paths": "^5.1.4"
   },
   "engines": {
-    "node": "22.15.1"
+    "node": ">=18"
   },
-  "packageManager": "pnpm@9.12.2+sha512.22721b3a11f81661ae1ec68ce1a7b879425a1ca5b991c975b074ac220b187ce56c708fe5db69f4c962c989452eee76c82877f4ee80f474cebd61ee13461b6228"
-}
+  "scripts": {
+    "build": "vite build",
+    "docs:generate": "typedoc"
+  }
+}