node-srt/src/async-worker.js
Stephan Hesse bf60795889
Async API server/streams impl & functional tests + Allow to use local SRT source repo instead of remote (#9)
* replace stream module by improved version of readable/writable impl

* rm server.js

* async api improvments:
- better tracing of calls from worker back and forth
- fix transferrable handling to avoid copying buffers for r/w
- optional debug logs
- completed jsdocs annotations
- add dispose method
- add setLogLevel method (analoguous to added binding)

* node-srt C bindings:
- add SetLogLevel to get libSRT log output if desired
- add OK static member
- add #define EPOLL_EVENTS_NUM_MAX 1024
- improve error string thrown in Read (add that it comes from srt_recvmsg)
- improve error string thrown in Write (add that it comes from srt_sendmsg2)
- misc isofunctional improvements (var names) and comments

* add SRT logging related JS-side helper

* rewrite flat TypeScript decl files without "module" keyword

* add ts enum decl for all libSRT enums

* async-worker: enable using transferrable for zero-copy
+ allow better debugging (like in api/dispatcher side)
+ misc improvements on code quality

* add async-helpers: various functions to help dealing with transferrables
+ tracing calls to native bindings in debug output

* add async read/write modes functions + async-reader-writer class
- these will allow for performing high-level r/w operations conveniently
at optimum throughput for larger pieces of payload i.e list of packets.

* add srt-server and srt-connection (can manage multiple clients),
- based on async-api
- can be used with reader/writer (i.e the underlying modes)

* srt-server/connection typings

* async srt spec: add dispose method usage (but commented out as crashing atm)

* async srt spec: rm redundant checks on SRT static members (they are done
in other spec already)

* promises api spec: formal fixes

* stream spec: add dummy test

* package.json:
- put gyp toolchain in runtime deps (since the build happens on install)
- add JEST test runner
- shorten check-tsc script
- rebuild script: check & use all CPU cores available
- run rebuild actually on install, not preinstall (fixes deps not being there)
- remove preinstall and thus "npm install git-clone" in the package scripts

* update package lock

* update typings index not to need triple-slashs anymore

* in srt.ts example: check for read return value type

* build-srt-sdk script:
- allow to use any local libSRT code repo
- when using make: use all amount of cores available for build
- isolate better code running on different platforms

* update package main index with new things

* add enum typings index

* add jest config

* add "use strict" on async-srt-await example

* add integration/smoke testing for client-to-server one-way burst write

* readme: add note on build prerequisites

* readme: add infos on new components SRTServer/Connection & AsyncReaderWriter
2020-10-21 13:09:52 +02:00

79 lines
1.9 KiB
JavaScript

const {
isMainThread, parentPort
} = require('worker_threads');
const debug = require('debug')('srt-async-worker');
const { SRT } = require('../build/Release/node_srt.node');
const { argsToString, traceCallToString, extractTransferListFromParams } = require('./async-helpers');
const DEBUG = false;
const DRY_RUN = false;
if (isMainThread) {
throw new Error("Worker module can not load on main thread");
}
try {
run()
} catch(err) {
console.error('AsyncSRT task-runner internal exception:', err);
}
function run() {
DEBUG && debug('AsyncSRT: Launching task-runner');
const srtNapiObjw = new SRT();
DEBUG && debug('AsyncSRT: SRT native object-wrap created');
parentPort.on('close', () => {
DEBUG && debug('AsyncSRT: Closing task-runner');
})
parentPort.on('message', (data) => {
if (!data.method) {
throw new Error('Worker message needs `method` property');
}
/*
if (!data.workId) {
throw new Error('Worker message needs `workId` property');
}
*/
if (data.args.some((arg) => arg === undefined)) {
const err = new Error(
`Ignoring call: Can't have any arguments be undefined: ${argsToString(data.args)}`);
parentPort.postMessage(err);
return;
}
DEBUG && debug('Received call:', traceCallToString(data.method, data.args));
let result = 0;
if (!DRY_RUN) {
try {
result = srtNapiObjw[data.method].apply(srtNapiObjw, data.args);
} catch(err) {
console.error(
`Exception thrown by native binding call "${traceCallToString(data.method, data.args)}":`,
err);
parentPort.postMessage({err, call: data});
return;
}
}
const transferList = extractTransferListFromParams([result]);
parentPort.postMessage({
// workId: data.workId,
timestamp: data.timestamp,
result
}, transferList);
});
}