1.2.0 • Published 21h ago

bfast-client

Licence

MIT

Version

1.2.0

Deps

Size

36 kB

Vulns

Weekly

Stars

Summary Dependency Versions

bfast-client

Client ultra-fast binary decoder for B-FAST format in TypeScript/JavaScript.

Installation

npm install bfast-client

Usage

Basic Decoding

import { BFastDecoder } from 'bfast-client';

// Fetch B-FAST data from API
const response = await fetch('/api/data');
const buffer = await response.arrayBuffer();

// Decode (automatically handles LZ4 decompression)
const data = BFastDecoder.decode(buffer);
console.log(data);

Error Handling

import { BFastDecoder, BFastError } from 'bfast-client';

try {
    const data = BFastDecoder.decode(buffer);
    console.log(data);
} catch (error) {
    if (error instanceof BFastError) {
        console.error('B-FAST decode error:', error.message);
    } else {
        console.error('Unexpected error:', error);
    }
}

React Hook

import { useState, useEffect } from 'react';
import { BFastDecoder } from 'bfast-client';

function useBFastData<T>(url: string) {
    const [data, setData] = useState<T | null>(null);
    const [loading, setLoading] = useState(true);
    const [error, setError] = useState<string | null>(null);

    useEffect(() => {
        async function fetchData() {
            try {
                const response = await fetch(url);
                const buffer = await response.arrayBuffer();
                const decoded = BFastDecoder.decode(buffer);
                setData(decoded);
            } catch (err) {
                setError(err instanceof Error ? err.message : 'Unknown error');
            } finally {
                setLoading(false);
            }
        }
        fetchData();
    }, [url]);

    return { data, loading, error };
}

Axios Integration

import axios from 'axios';
import { BFastDecoder } from 'bfast-client';

// Configure axios to handle B-FAST responses
axios.interceptors.response.use(response => {
    if (response.headers['content-type'] === 'application/x-bfast') {
        response.data = BFastDecoder.decode(response.data);
    }
    return response;
});

// Use normally
const { data } = await axios.get('/api/users');
console.log(data); // Already decoded