@neurodevs/ndx-native 0.0.1

package/build/impl/LiblslAdapter.d.ts

@@ -0,0 +1,172 @@
+import { define, JsExternal, load, open } from 'ffi-rs';
+import { CHANNEL_FORMATS } from '../consts.js';
+import { LslErrorCode } from '../lib/handleError.js';
+export default class LiblslAdapter implements Liblsl {
+    static open: typeof open;
+    static define: typeof define;
+    static load: typeof load;
+    static alloc: (size: number, fill?: string | Uint8Array | number, encoding?: BufferEncoding) => Buffer<ArrayBuffer>;
+    private static instance?;
+    liblslPath: string;
+    private bindings;
+    private readonly defaultMacOsPath;
+    protected constructor();
+    private tryToLoadBindings;
+    private throwFailedToLoadLiblsl;
+    static getInstance(): Liblsl;
+    static setInstance(instance: Liblsl): void;
+    static resetInstance(): void;
+    private loadBindings;
+    private openLiblsl;
+    private defineLiblslBindings;
+    createStreamInfo(options: CreateStreamInfoOptions): InfoHandle;
+    appendChannelsToStreamInfo(options: AppendChannelsToStreamInfoOptions): void;
+    destroyStreamInfo(options: DestroyStreamInfoOptions): void;
+    resolveByProp(options: ResolveByPropOptions): Promise<InfoHandle[]>;
+    createOutlet(options: CreateOutletOptions): OutletHandle;
+    pushSampleFloatTimestamp(options: PushSampleFloatTimestampOptions): LslErrorCode;
+    pushSampleStringTimestamp(options: PushSampleStringTimestampOptions): LslErrorCode;
+    destroyOutlet(options: DestroyOutletOptions): void;
+    createInlet(options: CreateInletOptions): InletHandle;
+    private readonly maxChunkSize;
+    private readonly shouldRecover;
+    getChannelCount(options: GetChannelCountOptions): number;
+    openStream(options: OpenStreamOptions): Promise<void>;
+    closeStream(options: CloseStreamOptions): void;
+    pullSample(options: PullSampleOptions): number;
+    pullChunk(options: PullChunkOptions): number;
+    flushInlet(options: FlushInletOptions): void;
+    destroyInlet(options: DestroyInletOptions): void;
+    localClock(): number;
+    private get open();
+    private get define();
+    private get load();
+    private get alloc();
+    private get liblslFuncs();
+}
+export interface Liblsl {
+    liblslPath: string;
+    createStreamInfo(options: CreateStreamInfoOptions): InfoHandle;
+    destroyStreamInfo(options: DestroyStreamInfoOptions): void;
+    appendChannelsToStreamInfo(options: AppendChannelsToStreamInfoOptions): void;
+    getChannelCount(options: GetChannelCountOptions): number;
+    resolveByProp(options: ResolveByPropOptions): Promise<InfoHandle[]>;
+    createOutlet(options: CreateOutletOptions): OutletHandle;
+    pushSampleFloatTimestamp(options: PushSampleFloatTimestampOptions): LslErrorCode;
+    pushSampleStringTimestamp(options: PushSampleStringTimestampOptions): LslErrorCode;
+    destroyOutlet(options: DestroyOutletOptions): void;
+    createInlet(options: CreateInletOptions): InletHandle;
+    openStream(options: OpenStreamOptions): Promise<void>;
+    closeStream(options: CloseStreamOptions): void;
+    pullSample(options: PullSampleOptions): number;
+    pullChunk(options: PullChunkOptions): number;
+    flushInlet(options: FlushInletOptions): void;
+    destroyInlet(options: DestroyInletOptions): void;
+    localClock(): number;
+}
+export interface CreateStreamInfoOptions {
+    name: string;
+    type: string;
+    sourceId: string;
+    channelCount: number;
+    channelFormat: number;
+    sampleRateHz: number;
+    manufacturer?: string;
+    units?: string;
+}
+export interface AppendChannelsToStreamInfoOptions {
+    infoHandle: InfoHandle;
+    channels: LslChannel[];
+}
+export interface GetChannelCountOptions {
+    infoHandle: InfoHandle;
+}
+export interface DestroyStreamInfoOptions {
+    infoHandle: InfoHandle;
+}
+export interface ResolveByPropOptions {
+    prop: string;
+    value: string;
+    minResults?: number;
+    timeoutMs?: number;
+}
+export interface CreateOutletOptions {
+    infoHandle: InfoHandle;
+    chunkSize: number;
+    maxBufferedMs: number;
+}
+export interface PushSampleFloatTimestampOptions {
+    outletHandle: OutletHandle;
+    sample: number[];
+    timestamp: number;
+}
+export interface PushSampleStringTimestampOptions {
+    outletHandle: OutletHandle;
+    sample: string[];
+    timestamp: number;
+}
+export interface DestroyOutletOptions {
+    outletHandle: OutletHandle;
+}
+export interface CreateInletOptions {
+    infoHandle: InfoHandle;
+    maxBufferedMs: number;
+}
+export interface OpenStreamOptions {
+    inletHandle: InletHandle;
+    timeoutMs: number;
+    errorCodePtr: JsExternal;
+}
+export interface CloseStreamOptions {
+    inletHandle: InletHandle;
+}
+export interface PullSampleOptions {
+    inletHandle: InletHandle;
+    sampleBufferPtr: JsExternal;
+    sampleBufferElements: number;
+    timeoutMs: number;
+    errorCodePtr: JsExternal;
+}
+export interface PullChunkOptions extends PullSampleOptions {
+    timestampBufferPtr: JsExternal;
+    timestampBufferElements: number;
+}
+export interface FlushInletOptions {
+    inletHandle: InletHandle;
+}
+export interface DestroyInletOptions {
+    inletHandle: InletHandle;
+}
+export interface LiblslBindings {
+    lsl_create_streaminfo(args: [string, string, number, number, number, string]): InfoHandle;
+    lsl_get_desc(args: [InfoHandle]): DescriptionHandle;
+    lsl_get_channel_count(args: [InfoHandle]): number;
+    lsl_append_child(args: [DescriptionHandle, string]): ChildHandle;
+    lsl_append_child_value(args: [ChildHandle, string, string]): void;
+    lsl_destroy_streaminfo(args: [InfoHandle]): void;
+    lsl_create_outlet(args: [InfoHandle, number, number]): OutletHandle;
+    lsl_push_sample_ft(args: [OutletHandle, LslSample, number]): LslErrorCode;
+    lsl_push_sample_strt(args: [OutletHandle, LslSample, number]): LslErrorCode;
+    lsl_destroy_outlet(args: [OutletHandle]): void;
+    lsl_create_inlet(args: any): InletHandle;
+    lsl_inlet_flush(args: [InletHandle]): void;
+    lsl_destroy_inlet(args: any): void;
+    lsl_local_clock(args: []): number;
+}
+export type ChannelFormat = (typeof CHANNEL_FORMATS)[number];
+export interface LslChannel {
+    label: string;
+    units: string;
+    type: string;
+}
+export type LslSample = (number | string | undefined)[];
+export interface InfoHandle {
+}
+export interface OutletHandle {
+}
+export interface InletHandle {
+}
+export interface DescriptionHandle {
+}
+export interface ChildHandle {
+}

package/build/impl/LiblslAdapter.js

@@ -0,0 +1,360 @@
+import { createPointer, DataType, define, load, open, unwrapPointer, } from 'ffi-rs';
+export default class LiblslAdapter {
+    static open = open;
+    static define = define;
+    static load = load;
+    static alloc = Buffer.alloc;
+    static instance;
+    liblslPath;
+    bindings;
+    defaultMacOsPath = `/opt/homebrew/Cellar/lsl/1.16.2/lib/liblsl.1.16.2.dylib`;
+    constructor() {
+        this.liblslPath = process.env.LIBLSL_PATH ?? this.defaultMacOsPath;
+        this.tryToLoadBindings();
+    }
+    tryToLoadBindings() {
+        try {
+            this.loadBindings();
+        }
+        catch (error) {
+            this.throwFailedToLoadLiblsl(error);
+        }
+    }
+    throwFailedToLoadLiblsl(error) {
+        throw new Error(`Loading the liblsl dylib failed! I tried to load it from ${this.liblslPath}.\n\n${error.message}\n\n`);
+    }
+    static getInstance() {
+        if (!this.instance) {
+            this.setInstance(new this());
+        }
+        return this.instance;
+    }
+    static setInstance(instance) {
+        this.instance = instance;
+    }
+    static resetInstance() {
+        delete this.instance;
+    }
+    loadBindings() {
+        this.openLiblsl();
+        this.bindings = this.defineLiblslBindings();
+    }
+    openLiblsl() {
+        this.open({
+            library: 'lsl',
+            path: this.liblslPath,
+        });
+    }
+    defineLiblslBindings() {
+        return this.define(this.liblslFuncs);
+    }
+    createStreamInfo(options) {
+        const { name, type, sourceId, channelCount, channelFormat, sampleRateHz, } = options;
+        return this.bindings.lsl_create_streaminfo([
+            name,
+            type,
+            channelCount,
+            sampleRateHz,
+            channelFormat,
+            sourceId,
+        ]);
+    }
+    appendChannelsToStreamInfo(options) {
+        const { infoHandle, channels } = options;
+        const description = this.bindings.lsl_get_desc([infoHandle]);
+        const parent = this.bindings.lsl_append_child([description, 'channels']);
+        for (const channel of channels) {
+            const child = this.bindings.lsl_append_child([parent, 'channel']);
+            this.bindings.lsl_append_child_value([
+                child,
+                'label',
+                channel.label,
+            ]);
+            this.bindings.lsl_append_child_value([child, 'unit', channel.units]);
+            this.bindings.lsl_append_child_value([child, 'type', channel.type]);
+        }
+    }
+    destroyStreamInfo(options) {
+        const { infoHandle } = options;
+        this.bindings.lsl_destroy_streaminfo([infoHandle]);
+    }
+    async resolveByProp(options) {
+        const { prop, value, minResults = 1, timeoutMs = 1000 } = options;
+        const maxResults = 1024;
+        const bytesPerPointer = 8;
+        const resultsBuffer = this.alloc(maxResults * bytesPerPointer);
+        const resultsBufferPtr = unwrapPointer(createPointer({
+            paramsType: [DataType.U8Array],
+            paramsValue: [resultsBuffer],
+        }))[0];
+        const numResults = await this.load({
+            library: 'lsl',
+            funcName: 'lsl_resolve_byprop',
+            retType: DataType.I32,
+            paramsType: [
+                DataType.External,
+                DataType.I32,
+                DataType.String,
+                DataType.String,
+                DataType.I32,
+                DataType.Double,
+            ],
+            paramsValue: [
+                resultsBufferPtr,
+                maxResults,
+                prop,
+                value,
+                minResults,
+                timeoutMs / 1000,
+            ],
+            runInNewThread: true,
+        });
+        const handles = [];
+        for (let i = 0; i < numResults; i++) {
+            const handle = resultsBuffer.readBigUInt64LE(i * bytesPerPointer);
+            if (handle !== 0n) {
+                const handleRef = createPointer({
+                    paramsType: [DataType.BigInt],
+                    paramsValue: [handle],
+                });
+                const handlePtr = unwrapPointer(handleRef)[0];
+                handles.push(handlePtr);
+            }
+        }
+        return handles;
+    }
+    createOutlet(options) {
+        const { infoHandle, chunkSize, maxBufferedMs } = options;
+        return this.bindings.lsl_create_outlet([
+            infoHandle,
+            chunkSize,
+            maxBufferedMs / 1000,
+        ]);
+    }
+    pushSampleFloatTimestamp(options) {
+        const { outletHandle, sample, timestamp } = options;
+        return this.bindings.lsl_push_sample_ft([
+            outletHandle,
+            sample,
+            timestamp,
+        ]);
+    }
+    pushSampleStringTimestamp(options) {
+        const { outletHandle, sample, timestamp } = options;
+        return this.bindings.lsl_push_sample_strt([
+            outletHandle,
+            sample,
+            timestamp,
+        ]);
+    }
+    destroyOutlet(options) {
+        const { outletHandle } = options;
+        this.bindings.lsl_destroy_outlet([outletHandle]);
+    }
+    createInlet(options) {
+        const { infoHandle, maxBufferedMs } = options;
+        return this.bindings.lsl_create_inlet([
+            infoHandle,
+            maxBufferedMs / 1000,
+            this.maxChunkSize,
+            this.shouldRecover,
+        ]);
+    }
+    maxChunkSize = 0;
+    shouldRecover = 1;
+    getChannelCount(options) {
+        const { infoHandle } = options;
+        return this.bindings.lsl_get_channel_count([infoHandle]);
+    }
+    async openStream(options) {
+        const { inletHandle, timeoutMs, errorCodePtr } = options;
+        await this.load({
+            library: 'lsl',
+            funcName: 'lsl_open_stream',
+            retType: DataType.Void,
+            paramsType: [DataType.External, DataType.Double, DataType.External],
+            paramsValue: [inletHandle, timeoutMs / 1000, errorCodePtr],
+            runInNewThread: true,
+        });
+    }
+    closeStream(options) {
+        const { inletHandle } = options;
+        this.load({
+            library: 'lsl',
+            funcName: 'lsl_close_stream',
+            retType: DataType.Void,
+            paramsType: [DataType.External],
+            paramsValue: [inletHandle],
+        });
+    }
+    pullSample(options) {
+        const { inletHandle, sampleBufferPtr, sampleBufferElements, timeoutMs, errorCodePtr: errorCodePtr, } = options;
+        return this.load({
+            library: 'lsl',
+            funcName: 'lsl_pull_sample_f',
+            retType: DataType.Double,
+            paramsType: [
+                DataType.External,
+                DataType.External,
+                DataType.I32,
+                DataType.Double,
+                DataType.External,
+            ],
+            paramsValue: [
+                inletHandle,
+                sampleBufferPtr,
+                sampleBufferElements,
+                timeoutMs / 1000,
+                errorCodePtr,
+            ],
+        });
+    }
+    pullChunk(options) {
+        const { inletHandle, sampleBufferPtr, timestampBufferPtr, sampleBufferElements, timestampBufferElements, timeoutMs, errorCodePtr: errorCodePtr, } = options;
+        return this.load({
+            library: 'lsl',
+            funcName: 'lsl_pull_chunk_f',
+            retType: DataType.Double,
+            paramsType: [
+                DataType.External,
+                DataType.External,
+                DataType.External,
+                DataType.I32,
+                DataType.I32,
+                DataType.Double,
+                DataType.External,
+            ],
+            paramsValue: [
+                inletHandle,
+                sampleBufferPtr,
+                timestampBufferPtr,
+                sampleBufferElements,
+                timestampBufferElements,
+                timeoutMs / 1000,
+                errorCodePtr,
+            ],
+        });
+    }
+    flushInlet(options) {
+        const { inletHandle } = options;
+        this.bindings.lsl_inlet_flush([inletHandle]);
+    }
+    destroyInlet(options) {
+        const { inletHandle } = options;
+        this.bindings.lsl_destroy_inlet([inletHandle]);
+    }
+    localClock() {
+        return this.bindings.lsl_local_clock([]);
+    }
+    get open() {
+        return LiblslAdapter.open;
+    }
+    get define() {
+        return LiblslAdapter.define;
+    }
+    get load() {
+        return LiblslAdapter.load;
+    }
+    get alloc() {
+        return LiblslAdapter.alloc;
+    }
+    get liblslFuncs() {
+        return {
+            lsl_create_streaminfo: {
+                library: 'lsl',
+                retType: DataType.External,
+                paramsType: [
+                    DataType.String,
+                    DataType.String,
+                    DataType.I32,
+                    DataType.Double,
+                    DataType.I32,
+                    DataType.String,
+                ],
+            },
+            lsl_destroy_streaminfo: {
+                library: 'lsl',
+                retType: DataType.Void,
+                paramsType: [DataType.External],
+            },
+            lsl_create_outlet: {
+                library: 'lsl',
+                retType: DataType.External,
+                paramsType: [DataType.External, DataType.I32, DataType.I32],
+            },
+            lsl_push_sample_ft: {
+                library: 'lsl',
+                retType: DataType.I32,
+                paramsType: [
+                    DataType.External,
+                    DataType.FloatArray,
+                    DataType.Double,
+                ],
+            },
+            lsl_push_sample_strt: {
+                library: 'lsl',
+                retType: DataType.I32,
+                paramsType: [
+                    DataType.External,
+                    DataType.StringArray,
+                    DataType.Double,
+                ],
+            },
+            lsl_destroy_outlet: {
+                library: 'lsl',
+                retType: DataType.Void,
+                paramsType: [DataType.External],
+            },
+            lsl_create_inlet: {
+                library: 'lsl',
+                retType: DataType.External,
+                paramsType: [
+                    DataType.External,
+                    DataType.I32,
+                    DataType.I32,
+                    DataType.I32,
+                ],
+            },
+            lsl_inlet_flush: {
+                library: 'lsl',
+                retType: DataType.I32,
+                paramsType: [DataType.External],
+            },
+            lsl_destroy_inlet: {
+                library: 'lsl',
+                retType: DataType.Void,
+                paramsType: [DataType.External],
+            },
+            lsl_get_desc: {
+                library: 'lsl',
+                retType: DataType.External,
+                paramsType: [DataType.External],
+            },
+            lsl_get_channel_count: {
+                library: 'lsl',
+                retType: DataType.I32,
+                paramsType: [DataType.External],
+            },
+            lsl_append_child: {
+                library: 'lsl',
+                retType: DataType.External,
+                paramsType: [DataType.External, DataType.String],
+            },
+            lsl_append_child_value: {
+                library: 'lsl',
+                retType: DataType.External,
+                paramsType: [
+                    DataType.External,
+                    DataType.String,
+                    DataType.String,
+                ],
+            },
+            lsl_local_clock: {
+                library: 'lsl',
+                retType: DataType.Double,
+                paramsType: [],
+            },
+        };
+    }
+}
+//# sourceMappingURL=LiblslAdapter.js.map

package/build/impl/LiblslAdapter.js.map

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

package/build/impl/LibxdfAdapter.d.ts

@@ -0,0 +1,92 @@
+import { MangledNameMap } from '@neurodevs/node-mangled-names';
+import { define, FieldType, FuncObj, open } from 'ffi-rs';
+export default class LibxdfAdapter implements Libxdf {
+    static Class?: LibxdfConstructor;
+    static ffiRsOpen: typeof open;
+    static ffiRsDefine: typeof define;
+    private static readonly loadXdfName;
+    private static unmangledNames;
+    protected bindings: LibxdfBindings;
+    private libxdfPath;
+    private mangledNameMap;
+    protected constructor(libxdfPath: string, mangledNameMap: MangledNameMap);
+    static Create(libxdfPath: string, throwIfPathNotExists?: boolean): Promise<Libxdf>;
+    private tryToLoadBindings;
+    private loadBindings;
+    private openLibxdf;
+    private defineBindings;
+    private throwFailedToLoadLiblsl;
+    private generateFailedMessage;
+    loadXdf(path: string): {
+        path: string;
+        streams: {
+            id: number;
+            name: string;
+            type: string;
+            channelCount: number;
+            channelFormat: string;
+            nominalSampleRateHz: number;
+            data: number[][];
+            timestamps: number[];
+        }[];
+        events: {
+            name: string;
+            timestamp: number;
+            streamId: number;
+        }[];
+    };
+    private get unmangledNames();
+    private get loadXdfName();
+    private static generateFailedMessage;
+    private static loadMangledNameMap;
+    private static MangledNameExtractor;
+}
+export interface Libxdf {
+    loadXdf(path: string): XdfFile;
+}
+export type LibxdfConstructor = new (libxdfPath: string, mangledNameMap: MangledNameMap) => Libxdf;
+export type LibxdfBindings = Record<string, (path: string[]) => string>;
+export type LibxdfStatusCode = 0 | Exclude<number, 0>;
+export type FfiRsDefineOptions = FuncObj<FieldType, boolean | undefined, boolean | undefined>;
+export interface XdfFile {
+    path: string;
+    streams: XdfStream[];
+    events: XdfEvent[];
+}
+export interface XdfStream {
+    id: number;
+    name: string;
+    type: string;
+    channelCount: number;
+    channelFormat: string;
+    nominalSampleRateHz: number;
+    data: number[][];
+    timestamps: number[];
+}
+export interface XdfEvent {
+    name: string;
+    timestamp: number;
+    streamId: number;
+}
+export interface LibxdfFile {
+    streams: LibxdfStream[];
+    events: LibxdfEvent[];
+}
+export interface LibxdfStream {
+    stream_id: number;
+    stream_info: LibxdfStreamInfo;
+    time_series: number[][];
+    time_stamps: number[];
+}
+export interface LibxdfStreamInfo {
+    channel_count: number;
+    channel_format: string;
+    nominal_srate: number;
+    stream_name: string;
+    stream_type: string;
+}
+export interface LibxdfEvent {
+    stream_id: number;
+    event_name: string;
+    event_timestamp: number;
+}