@neurodevs/node-lsl 10.2.1 → 11.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (120) hide show
  1. package/README.md +17 -38
  2. package/build/__tests__/{AbstractNodeLslTest.d.ts → AbstractLslTest.d.ts} +7 -6
  3. package/build/__tests__/{AbstractNodeLslTest.js → AbstractLslTest.js} +30 -24
  4. package/build/__tests__/AbstractLslTest.js.map +1 -0
  5. package/build/__tests__/{TimeMarkerOutlet.test.d.ts → EventMarkerOutlet.test.d.ts} +9 -8
  6. package/build/__tests__/{TimeMarkerOutlet.test.js → EventMarkerOutlet.test.js} +53 -48
  7. package/build/__tests__/EventMarkerOutlet.test.js.map +1 -0
  8. package/build/__tests__/{Liblsl.test.d.ts → LiblslAdapter.test.d.ts} +2 -2
  9. package/build/__tests__/{Liblsl.test.js → LiblslAdapter.test.js} +43 -75
  10. package/build/__tests__/LiblslAdapter.test.js.map +1 -0
  11. package/build/__tests__/LslStreamInfo.test.d.ts +3 -3
  12. package/build/__tests__/LslStreamInfo.test.js +3 -3
  13. package/build/__tests__/LslStreamInfo.test.js.map +1 -1
  14. package/build/__tests__/{LslInlet.test.d.ts → LslStreamInlet.test.d.ts} +4 -4
  15. package/build/__tests__/{LslInlet.test.js → LslStreamInlet.test.js} +19 -19
  16. package/build/__tests__/LslStreamInlet.test.js.map +1 -0
  17. package/build/__tests__/{LslOutlet.test.d.ts → LslStreamOutlet.test.d.ts} +3 -3
  18. package/build/__tests__/{LslOutlet.test.js → LslStreamOutlet.test.js} +45 -41
  19. package/build/__tests__/LslStreamOutlet.test.js.map +1 -0
  20. package/build/components/EventMarkerOutlet.d.ts +20 -0
  21. package/build/components/{TimeMarkerOutlet.js → EventMarkerOutlet.js} +11 -10
  22. package/build/components/EventMarkerOutlet.js.map +1 -0
  23. package/build/components/{Liblsl.d.ts → LiblslAdapter.d.ts} +1 -1
  24. package/build/components/{Liblsl.js → LiblslAdapter.js} +7 -7
  25. package/build/components/LiblslAdapter.js.map +1 -0
  26. package/build/components/LslStreamInfo.js +2 -2
  27. package/build/components/LslStreamInfo.js.map +1 -1
  28. package/build/components/{LslInlet.d.ts → LslStreamInlet.d.ts} +4 -4
  29. package/build/components/{LslInlet.js → LslStreamInlet.js} +5 -5
  30. package/build/components/LslStreamInlet.js.map +1 -0
  31. package/build/components/{LslOutlet.d.ts → LslStreamOutlet.d.ts} +1 -1
  32. package/build/components/{LslOutlet.js → LslStreamOutlet.js} +5 -5
  33. package/build/components/LslStreamOutlet.js.map +1 -0
  34. package/build/index.d.ts +20 -19
  35. package/build/index.js +33 -28
  36. package/build/index.js.map +1 -1
  37. package/build/nodeLsl.types.d.ts +3 -3
  38. package/build/testDoubles/{FakeLiblsl.d.ts → Liblsl/FakeLiblsl.d.ts} +1 -1
  39. package/build/testDoubles/Liblsl/FakeLiblsl.js.map +1 -0
  40. package/build/testDoubles/LslInlet/SpyLslInlet.d.ts +7 -0
  41. package/build/testDoubles/{SpyLslInlet.js → LslInlet/SpyLslInlet.js} +2 -2
  42. package/build/testDoubles/LslInlet/SpyLslInlet.js.map +1 -0
  43. package/build/testDoubles/{FakeLslOutlet.d.ts → LslOutlet/FakeLslOutlet.d.ts} +3 -5
  44. package/build/testDoubles/{FakeLslOutlet.js → LslOutlet/FakeLslOutlet.js} +0 -4
  45. package/build/testDoubles/LslOutlet/FakeLslOutlet.js.map +1 -0
  46. package/build/testDoubles/{FakeTimeMarkerOutlet.d.ts → MarkerOutlet/FakeMarkerOutlet.d.ts} +4 -4
  47. package/build/testDoubles/{FakeTimeMarkerOutlet.js → MarkerOutlet/FakeMarkerOutlet.js} +4 -4
  48. package/build/testDoubles/MarkerOutlet/FakeMarkerOutlet.js.map +1 -0
  49. package/build/testDoubles/{MockTimeMarkerOutlet.d.ts → MarkerOutlet/MockMarkerOutlet.d.ts} +3 -2
  50. package/build/testDoubles/{MockTimeMarkerOutlet.js → MarkerOutlet/MockMarkerOutlet.js} +3 -3
  51. package/build/testDoubles/MarkerOutlet/MockMarkerOutlet.js.map +1 -0
  52. package/build/testDoubles/MarkerOutlet/SpyMarkerOutlet.d.ts +9 -0
  53. package/build/testDoubles/MarkerOutlet/SpyMarkerOutlet.js +24 -0
  54. package/build/testDoubles/MarkerOutlet/SpyMarkerOutlet.js.map +1 -0
  55. package/build/testDoubles/{FakeStreamInfo.d.ts → StreamInfo/FakeStreamInfo.d.ts} +2 -2
  56. package/build/testDoubles/StreamInfo/FakeStreamInfo.js.map +1 -0
  57. package/build/testDoubles/StreamInfo/SpyStreamInfo.d.ts +9 -0
  58. package/build/testDoubles/{SpyLslStreamInfo.js → StreamInfo/SpyStreamInfo.js} +4 -4
  59. package/build/testDoubles/StreamInfo/SpyStreamInfo.js.map +1 -0
  60. package/build/testDoubles/generateRandomOutletOptions.d.ts +1 -1
  61. package/package.json +1 -1
  62. package/src/__tests__/AbstractLslTest.ts +58 -0
  63. package/src/__tests__/EventMarkerOutlet.test.ts +165 -0
  64. package/src/__tests__/{Liblsl.test.ts → LiblslAdapter.test.ts} +18 -22
  65. package/src/__tests__/LslStreamInfo.test.ts +12 -12
  66. package/src/__tests__/{LslInlet.test.ts → LslStreamInlet.test.ts} +13 -13
  67. package/src/__tests__/{LslOutlet.test.ts → LslStreamOutlet.test.ts} +28 -22
  68. package/src/components/{TimeMarkerOutlet.ts → EventMarkerOutlet.ts} +17 -17
  69. package/src/components/{Liblsl.ts → LiblslAdapter.ts} +3 -3
  70. package/src/components/LslStreamInfo.ts +2 -2
  71. package/src/components/{LslInlet.ts → LslStreamInlet.ts} +5 -5
  72. package/src/components/{LslOutlet.ts → LslStreamOutlet.ts} +3 -3
  73. package/src/index.ts +28 -19
  74. package/src/nodeLsl.types.ts +3 -3
  75. package/src/testDoubles/{FakeLiblsl.ts → Liblsl/FakeLiblsl.ts} +1 -1
  76. package/src/testDoubles/{SpyLslInlet.ts → LslInlet/SpyLslInlet.ts} +5 -3
  77. package/src/testDoubles/{FakeLslOutlet.ts → LslOutlet/FakeLslOutlet.ts} +3 -9
  78. package/src/testDoubles/{FakeTimeMarkerOutlet.ts → MarkerOutlet/FakeMarkerOutlet.ts} +4 -4
  79. package/src/testDoubles/{MockTimeMarkerOutlet.ts → MarkerOutlet/MockMarkerOutlet.ts} +3 -2
  80. package/src/testDoubles/MarkerOutlet/SpyMarkerOutlet.ts +24 -0
  81. package/src/testDoubles/{FakeStreamInfo.ts → StreamInfo/FakeStreamInfo.ts} +2 -2
  82. package/src/testDoubles/{SpyLslStreamInfo.ts → StreamInfo/SpyStreamInfo.ts} +4 -2
  83. package/src/testDoubles/generateRandomOutletOptions.ts +1 -1
  84. package/build/__tests__/AbstractNodeLslTest.js.map +0 -1
  85. package/build/__tests__/Liblsl.test.js.map +0 -1
  86. package/build/__tests__/LslInlet.test.js.map +0 -1
  87. package/build/__tests__/LslOutlet.test.js.map +0 -1
  88. package/build/__tests__/SpyLslStreamInfo.d.ts +0 -5
  89. package/build/__tests__/SpyLslStreamInfo.js +0 -17
  90. package/build/__tests__/SpyLslStreamInfo.js.map +0 -1
  91. package/build/__tests__/TimeMarkerOutlet.test.js.map +0 -1
  92. package/build/components/Liblsl.js.map +0 -1
  93. package/build/components/LslInlet.js.map +0 -1
  94. package/build/components/LslOutlet.js.map +0 -1
  95. package/build/components/TimeMarkerOutlet.d.ts +0 -19
  96. package/build/components/TimeMarkerOutlet.js.map +0 -1
  97. package/build/demo.d.ts +0 -1
  98. package/build/demo.js +0 -42
  99. package/build/demo.js.map +0 -1
  100. package/build/testDoubles/FakeLiblsl.js.map +0 -1
  101. package/build/testDoubles/FakeLslOutlet.js.map +0 -1
  102. package/build/testDoubles/FakeLslStreamInfo.d.ts +0 -5
  103. package/build/testDoubles/FakeLslStreamInfo.js +0 -10
  104. package/build/testDoubles/FakeLslStreamInfo.js.map +0 -1
  105. package/build/testDoubles/FakeStreamInfo.js.map +0 -1
  106. package/build/testDoubles/FakeTimeMarkerOutlet.js.map +0 -1
  107. package/build/testDoubles/MockTimeMarkerOutlet.js.map +0 -1
  108. package/build/testDoubles/SpyLslInlet.d.ts +0 -7
  109. package/build/testDoubles/SpyLslInlet.js.map +0 -1
  110. package/build/testDoubles/SpyLslStreamInfo.d.ts +0 -9
  111. package/build/testDoubles/SpyLslStreamInfo.js.map +0 -1
  112. package/build/testDoubles/SpyTimeMarkerOutlet.d.ts +0 -9
  113. package/build/testDoubles/SpyTimeMarkerOutlet.js +0 -19
  114. package/build/testDoubles/SpyTimeMarkerOutlet.js.map +0 -1
  115. package/src/__tests__/AbstractNodeLslTest.ts +0 -50
  116. package/src/__tests__/TimeMarkerOutlet.test.ts +0 -151
  117. package/src/demo.ts +0 -43
  118. package/src/testDoubles/SpyTimeMarkerOutlet.ts +0 -19
  119. /package/build/testDoubles/{FakeLiblsl.js → Liblsl/FakeLiblsl.js} +0 -0
  120. /package/build/testDoubles/{FakeStreamInfo.js → StreamInfo/FakeStreamInfo.js} +0 -0
@@ -1,151 +0,0 @@
1
- import { randomInt } from 'crypto'
2
- import { assert, generateId, test } from '@sprucelabs/test-utils'
3
- import { LslOutletOptions } from '../components/LslOutlet'
4
- import TimeMarkerOutletImpl from '../components/TimeMarkerOutlet'
5
- import generateRandomOutletOptions from '../testDoubles/generateRandomOutletOptions'
6
- import SpyTimeMarkerOutlet from '../testDoubles/SpyTimeMarkerOutlet'
7
- import AbstractNodeLslTest from './AbstractNodeLslTest'
8
-
9
- export default class TimeMarkerOutletTest extends AbstractNodeLslTest {
10
- private static outlet: SpyTimeMarkerOutlet
11
-
12
- protected static async beforeEach() {
13
- await super.beforeEach()
14
-
15
- this.setSpyTimeMarkerOutlet()
16
- this.setFakeLiblsl()
17
-
18
- this.outlet = await this.Outlet()
19
- }
20
-
21
- @test()
22
- protected static async loadsWithTimeMarkerSpecificOptions() {
23
- assert.isEqualDeep(this.outlet.passedOptions, {
24
- name: 'Time markers',
25
- type: 'Markers',
26
- channelNames: ['Markers'],
27
- sampleRate: 0,
28
- channelFormat: 'string',
29
- sourceId: 'time-markers',
30
- manufacturer: 'N/A',
31
- unit: 'N/A',
32
- chunkSize: 0,
33
- maxBuffered: 0,
34
- })
35
- }
36
-
37
- @test()
38
- protected static async canOverrideDefaultOptions() {
39
- const options = generateRandomOutletOptions()
40
- const outlet = await this.Outlet(options)
41
- assert.isEqualDeep(outlet.passedOptions, options)
42
- }
43
-
44
- @test()
45
- protected static async pushingSingleMarkerIncrementsHitCountAndWaitTime() {
46
- const markers = [this.generateDurationMarkerValues()]
47
- await this.outlet.pushMarkers(markers)
48
-
49
- assert.isEqual(this.fakeLiblsl.pushSampleStringTimestampHitCount, 1)
50
- assert.isEqual(this.outlet.totalWaitTimeMs, markers[0].durationMs)
51
- }
52
-
53
- @test()
54
- protected static async pushingTwoMarkersIncrementsHitCountAndWaitTimeTwice() {
55
- const markers = await this.pushTotalMarkers(2)
56
-
57
- assert.isEqual(this.fakeLiblsl.pushSampleStringTimestampHitCount, 2)
58
- assert.isEqual(
59
- this.outlet.totalWaitTimeMs,
60
- markers[0].durationMs + markers[1].durationMs
61
- )
62
- }
63
-
64
- @test('can stop on the first marker', 1)
65
- @test('can stop on the second marker', 2)
66
- @test('can stop on the third marker', 3)
67
- protected static async canStopTimeMarkersMidPush(bailIdx: number) {
68
- let hitCount = 0
69
-
70
- this.outlet.pushSample = () => {
71
- hitCount += 1
72
- if (hitCount === bailIdx) {
73
- this.outlet.stop()
74
- }
75
- }
76
-
77
- await this.pushTotalMarkers(10)
78
-
79
- assert.isEqual(hitCount, bailIdx)
80
- }
81
-
82
- @test()
83
- protected static async canStartAgainAfterStopping() {
84
- this.outlet.stop()
85
-
86
- let hitCount = 0
87
-
88
- this.outlet.pushSample = () => {
89
- hitCount++
90
- }
91
-
92
- await this.pushTotalMarkers(10)
93
-
94
- assert.isEqual(hitCount, 10)
95
- }
96
-
97
- @test()
98
- protected static async doesNotWaitIfStopped() {
99
- await this.setupTimeMarkerImpl()
100
-
101
- const startMs = Date.now()
102
- const promise = this.pushTotalMarkers(2, 1000)
103
- this.outlet.stop()
104
- await promise
105
- const endMs = Date.now()
106
-
107
- assert.isBelow(endMs - startMs, 10)
108
- }
109
-
110
- @test()
111
- protected static async clearsTheTimeoutOnStop() {
112
- await this.setupTimeMarkerImpl()
113
-
114
- const promise = this.pushTotalMarkers(2, 100)
115
-
116
- this.outlet.stop()
117
- this.outlet.pushSample = () =>
118
- assert.fail('Should not have been called')
119
-
120
- await promise
121
- await this.wait(100)
122
- }
123
-
124
- private static async setupTimeMarkerImpl() {
125
- TimeMarkerOutletImpl.Class = TimeMarkerOutletImpl as any
126
- this.outlet = await this.Outlet()
127
- }
128
-
129
- private static async pushTotalMarkers(total: number, durationMs?: number) {
130
- const markers = new Array(total)
131
- .fill(null)
132
- .map(() => this.generateDurationMarkerValues(durationMs))
133
-
134
- await this.outlet.pushMarkers(markers)
135
-
136
- return markers
137
- }
138
-
139
- private static generateDurationMarkerValues(durationMs?: number) {
140
- return {
141
- name: generateId(),
142
- durationMs: durationMs ?? randomInt(100, 1000),
143
- }
144
- }
145
-
146
- private static async Outlet(options?: Partial<LslOutletOptions>) {
147
- return (await TimeMarkerOutletImpl.Create(
148
- options
149
- )) as SpyTimeMarkerOutlet
150
- }
151
- }
package/src/demo.ts DELETED
@@ -1,43 +0,0 @@
1
- import LslInlet from './components/LslInlet'
2
- import LslOutletImpl from './components/LslOutlet'
3
-
4
- async function waitForMs(ms: number) {
5
- return new Promise((resolve) => {
6
- setTimeout(resolve, ms)
7
- })
8
- }
9
-
10
- async function main() {
11
- const outlet = await LslOutletImpl.Create({
12
- name: 'Test Outlet',
13
- type: 'Test Type',
14
- sourceId: 'Test Source ID',
15
- channelNames: ['Channel 1', 'Channel 2'],
16
- channelFormat: 'float32',
17
- sampleRate: 0,
18
- chunkSize: 1,
19
- maxBuffered: 0,
20
- manufacturer: 'Test Manufacturer',
21
- unit: 'Test Unit',
22
- })
23
-
24
- const inlet = LslInlet.Create({
25
- channelNames: ['Channel 1', 'Channel 2'],
26
- channelFormat: 'float32',
27
- sampleRate: 0,
28
- chunkSize: 1,
29
- maxBuffered: 0,
30
- })
31
-
32
- // @ts-ignore
33
- const promise = inlet.start()
34
-
35
- for (let i = 0; i < 100; i++) {
36
- outlet.pushSample([i])
37
- await waitForMs(1000)
38
- }
39
-
40
- await promise
41
- }
42
-
43
- main().catch(console.error)
@@ -1,19 +0,0 @@
1
- import { LslOutletOptions } from '../components/LslOutlet'
2
- import { StreamInfo } from '../components/LslStreamInfo'
3
- import TimeMarkerOutletImpl from '../components/TimeMarkerOutlet'
4
-
5
- export default class SpyTimeMarkerOutlet extends TimeMarkerOutletImpl {
6
- public passedOptions: LslOutletOptions
7
- public totalWaitTimeMs: number
8
-
9
- public constructor(info: StreamInfo, options: LslOutletOptions) {
10
- super(info, options)
11
- this.passedOptions = options
12
- this.totalWaitTimeMs = 0
13
- }
14
-
15
- public async wait(durationMs: number) {
16
- this.totalWaitTimeMs += durationMs
17
- return Promise.resolve()
18
- }
19
- }