iosignal 5.0.1 → 5.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iosignal",
-  "version": "5.0.1",
+  "version": "5.1.1",
   "description": "iosignal",
   "type": "module",
   "exports": {
@@ -37,9 +37,9 @@
     "typescript": "^5.8.3"
   },
   "dependencies": {
-    "boho": "^2.0.0",
+    "boho": "^2.1.1",
     "eventemitter3": "^5.0.1",
-    "meta-buffer-pack": "^2.1.0",
+    "meta-buffer-pack": "^2.1.1",
     "ws": "^8.18.3"
   },
   "optionalDependencies": {
@@ -48,9 +48,9 @@
   },
   "repository": {
     "type": "git",
-    "url": "git://github.com/remocons/iosignal.git"
+    "url": "https://github.com/remocons/iosignal.git",
+    "directory": "packages/iosignal"
   },
-  "homepage": "https://iosignal.net",
   "keywords": [
     "websocket",
     "pubsub",
@@ -65,4 +65,4 @@
     "arduino",
     "auth"
   ]
-}
+}

package/rollup.config.js

@@ -49,4 +49,4 @@ export default [
     ]
   }
 
-]
+]

package/test/attach-services/RedisService.js

@@ -0,0 +1,46 @@
+/**
+ * api/RediService.js 테스트
+ * 
+ * 사전준비. 
+ * localhost 에 redis-server 운영
+ * some sample data 저장.
+ */
+import { RedisService, Server , IO } from 'iosignal'
+import { createClient } from 'redis'
+
+const redisClient = createClient()  // default redis. localhost:6379
+redisClient.connect();
+
+redisClient.on('error', (err)=>{
+    console.log('redisCleint err: ', err)
+})
+redisClient.on('ready', ()=>{
+    console.log('redisClient is ready.')
+})
+redisClient.on('end', ()=>{
+    console.log('redisClient is end.')
+})
+
+const server = new Server({port:0, showMessage: 'message'})
+                    .attach('redis', new RedisService( redisClient , -1))
+
+server.on('ready',()=>{
+    let io = new IO('ws://localhost:'+server.port)
+    io.on('ready', async ()=>{
+        console.log('io ready. cid: ', io.cid )
+        let apiResult;
+        try {            
+            apiResult = await io.call('redis','hGetAll','device:one')
+            console.log(apiResult)
+            apiResult = await io.call('redis','HGETALL','device:one')
+            console.log(apiResult)
+            apiResult = await io.call('redis','save')
+            console.log(apiResult)
+        } catch (error) {
+            console.log('io api req err', error)
+        }
+    })
+    io.on('error',(err)=>{
+        console.log('io client error: ', err)
+    })
+})

package/test/attach-services/replyService.js

@@ -0,0 +1,46 @@
+
+import { IO, Server, replyService } from "iosignal"
+
+const server = new Server({ 
+    port: 0, 
+    // showMessage: 'message'
+ })
+server.attach('reply', replyService)
+
+server.on('ready', () => {
+  console.log('server is ready', server.port)
+
+  const io = new IO('ws://localhost:' + server.port)
+  io.on('ready', async () => {
+    console.log('ready cid', io.cid)
+
+    let result;
+    try {
+      result = await io.call('reply', 'echo', 'hello')
+      if (result.ok) console.log('[echo respose] ', result.body)
+
+      result = await io.call('reply', 'date')
+      if (result.ok) console.log('[date respose] ', result.body)
+
+      result = await io.call('reply', 'unixtime')
+      if (result.ok) console.log('[unixtime respose] ', result.body)
+    } catch (error) {
+      console.log('error:', error)
+    }
+
+    // UNKNOWN_COMMAND ERROR
+    try {
+      result = await io.call('reply', 'Unknown_command')
+      if (result.ok) console.log(result.body)
+    } catch (error) {
+      console.log('error:', error)
+    }
+
+    server.close()
+    setTimeout(() => {
+      process.exit();
+    }, 1000)
+  })
+
+
+})

package/test/auth_server_client/auth_server_client.js

@@ -0,0 +1,45 @@
+import { Server , IO, BohoAuth, StringKeyProvider} from 'iosignal'
+
+// serverOption.showMetric = 2;
+
+const authManager = new BohoAuth( new StringKeyProvider('io.key.io.3,io2.password.io2.3')) 
+const s = new Server({
+    port: 0,
+    // showMetric: 2,
+    showMessage: 'message'
+}, authManager);
+// s.attach('sudo', sudoService );
+
+
+const delay = ms => new Promise(resolve => setTimeout(resolve, ms));
+
+s.on('ready',async ()=>{
+    // 서버 listen 포트가 0으로 설정된경우,  자동설정된 값이 s.port 속성으로 확정됨.
+    console.log('listening port: ', s.port )
+
+    let io = new IO('ws://localhost:'+ s.port)
+    .on('error',(err)=>{
+        console.log(err)
+    }).on('change',(name)=>{
+        console.log(`<io(${name}:${io.state})`)  
+    }).on('ready',()=>{
+        console.log('#ready cid:', io.cid )
+    })
+
+    let io2 = new IO('ws://localhost:'+ s.port)
+    .on('error',(err)=>{
+        console.log(err)
+    }).on('change',(name)=>{
+        console.log(`<io2(${name}:${io2.state})`)  
+    }).on('ready',()=>{
+        console.log('#ready cid:', io2.cid )
+    }).on('auth_fail',()=>{
+        console.log('#auth_fail: io2')
+    }).auth('io2.password')
+
+
+})
+
+// await delay(2000)
+// process.exit()
+

package/test/pubsub-counter/pubsub-counter.js

@@ -0,0 +1,61 @@
+
+import { IO } from 'iosignal'
+const ch_base = 'ch_'
+const url = 'wss://io.remocon.kr/ws'
+
+
+/*
+    시그널 서버 연결된 노드들의 pub/sub 전달 상태 테스트
+
+    2025. Aug 16.
+    여러개의 장치가 하나의 채널을 공유한다.
+    하나의 채널당 연결된 node 개수는 nodePerChannel
+    총 채널의 개수가 channels
+    총 노드수는 channels * nodePerChannel
+
+    모든 노드가 수신하는 메시지 수를  rCounter 에 누적하고, 1초마다 출력.
+*/
+const channels = 20;
+const nodePerChannel = 5;
+
+let remotes = [];
+let rCounter = 0;
+
+
+for( let j= 0; j < channels ; j++){
+    let ch = ch_base + j;
+
+    console.log( j, ch)
+    for(let i = 0; i < nodePerChannel ; i++){
+
+        let io =  new IO(url);   
+
+        let range = 10000; // msec
+        let minPeriod = 500; //msec
+        let randRange =  Math.ceil(  Math.random() * range );
+        if( i == 0){
+            setInterval( ()=>{
+                io.signal(ch, 'hello')
+            }, minPeriod + randRange)
+        } 
+        io.on('ready',()=>{
+            io.subscribe(ch)
+        })
+        io.on( 'message', (tag, msg )=>{ 
+            rCounter++;
+        })
+        remotes.push(io)
+    }
+
+}
+
+
+console.log('total remotes: ', remotes.length )
+
+
+setInterval( ()=>{
+    console.log('rcounter/sec', rCounter )
+    rCounter = 0;
+}, 1000)
+
+

package/test/subscribe-signal/cid-a-b.js

@@ -0,0 +1,94 @@
+/*
+unicast using cid
+A,B ready 되면 cidA, cidB에 저장
+A는 B에게, B는 A에게 unicast 1:1 시그널 전송
+
+A -> B
+B -> A
+
+2. cid 구독, cid 발행
+C는 A의 cid를 구독, C가 cid 발행하면 수신.
+
+A cid publish -> C
+
+채널 시그널
+유니캐스트 시그널
+
+
+*/
+import { Server , IO, MBP , StringKeyProvider, BohoAuth} from 'iosignal'
+const stringKey = 'A.akey.A.3,B.bkey.B.3,C.ckey.C.3'
+const authManager = new BohoAuth(new StringKeyProvider(stringKey) )
+const tag = 'channel'
+const s = new Server({
+    port: 0,
+    // congPort: 55488,
+    // showMessage: 'message'
+}, authManager);
+
+const delay = ms => new Promise(resolve => setTimeout(resolve, ms));
+
+
+s.on('ready',async ()=>{
+    // 서버 listen 포트가 0으로 설정된경우,  자동설정된 값이 s.port 속성으로 확정됨.
+    console.log('listening port: ', s.port )
+
+    const A = new IO('ws://localhost:'+ s.port)
+    A.on('ready', async ()=>{
+        console.log('ready A:', A.cid)
+    })
+    A.on('message',( tag, ...args )=>{
+        console.log('[Am]', tag, ...args)
+    })
+    A.on('@',( tag, ...args )=>{
+        console.log('[A@]',tag, ...args)
+    }).auth('A.akey')
+
+    const B = new IO('ws://localhost:'+ s.port)
+    .on('ready', async ()=>{
+        console.log('ready B:', B.cid)
+        B.subscribe('A@news')
+    })
+    .on('message',( tag, ...args )=>{
+        console.log('[Bm]', tag, ...args)
+    })
+    .on( 'A@news',( tag, ...args )=>{
+        console.log('[Bs]', tag, ...args)
+    })
+    .on('@',( tag, ...args )=>{
+        console.log('[B@]', tag, ...args)
+    }).auth('B.bkey')
+
+
+    const C = new IO('ws://localhost:'+ s.port)
+    C.on('ready', async ()=>{
+        console.log('ready C:', C.cid)
+        C.subscribe('A@news')
+    })
+    C.on( 'A@news',( tag, ...args )=>{
+        console.log('[Cs]', tag, ...args)
+    })
+    C.on('message',( tag, ...args )=>{
+        console.log('[Cm]', tag, ...args)
+    })
+    C.on('@',( tag, ...args )=>{
+        console.log('[C@]', tag, ...args)
+    }).auth('C.ckey')
+
+    await delay(200)
+    // unicast A -> B@
+    A.signal( 'B@', 'A -> B@')
+
+    // cid_subscribe  A -> A@ subscirbers
+    A.signal( '@news', 'A -> A@news -> B,C')
+
+    // unicast B -> A@
+    B.signal( 'A@', 'B -> A@')
+
+    // unicast B -> A@topic
+    B.signal( 'A@topic', 'B -> A@topic')
+})
+
+await delay(3000)
+process.exit()
+

package/test/subscribe-signal/cs-signal-test.js

@@ -0,0 +1,47 @@
+import { Server , IO, MBP ,delay } from 'iosignal'
+
+const tag = 'ch1'
+const tag2 = 'ch2'
+
+const s = new Server({port:0, showMessage: 'message'});
+
+s.on('ready',async ()=>{
+    // 서버 listen 포트가 0으로 설정된경우,  자동설정된 값이 s.port 속성으로 확정됨.
+    console.log('listening port: ', s.port )
+
+    const io = new IO('ws://localhost:'+ s.port)
+
+    io.on('message',( tag, ...args )=>{
+        console.log('io message: ', tag, ...args)
+    })
+    
+    io.on('ready',()=>{
+        io.subscribe(tag + ',' + tag2 )
+    })
+
+    await delay(1000)
+    io.signal(tag, 'text', 'hello')
+    io.signal(tag) //empty
+    io.signal(tag, 'number', 123)
+    io.signal(tag, 'object', {key:'str value', key2: 123 })
+    io.signal(tag, 'buffer', Buffer.from('aaaaa'))
+    io.signal(tag, 'buffer,str,number', Buffer.from('aaaaa'),'hello', 123)
+    let u8 = new Uint8Array(4)
+    u8[0] = 1;
+    let u32 = new Uint32Array(4)
+    u32[0] = 1;
+    u32[1] = 2;
+    io.signal(tag, 'uit8,uint32', u8, u32 )
+    
+    let mbp = MBP.pack( 
+        MBP.MB('name8','8', 200),
+        MBP.MB('name32', '32', 256 + 200)
+    )
+    io.signal(tag2 , mbp )
+
+    io.signal(tag , '1k',Buffer.alloc(1000))
+})
+
+
+await delay(3000)
+process.exit()

package/test/subscribe-signal/meta.js

@@ -0,0 +1,61 @@
+import {MBP} from 'iosignal'
+
+export const Meta = {
+
+  SERVER_TIME_NONCE: MBP.meta(  // 13
+    MBP.MB('header','8', 0),
+    MBP.MB('unixTime','32L', 0),
+    MBP.MB('milTime','32L', 0 ),
+    MBP.MB('nonce', Buffer.alloc(4))
+  ),
+
+  AUTH_REQ: MBP.meta( // 45
+    MBP.MB('header','8', 0),
+    MBP.MB('id8',Buffer.alloc(8)),
+    MBP.MB('nonce', Buffer.alloc(4)),
+    MBP.MB('hmac32', Buffer.alloc(32))
+  ),
+
+  AUTH_RES: MBP.meta( // 33
+    MBP.MB('header','8', 0),
+    MBP.MB('hmac32', Buffer.alloc(32))
+  ),
+
+
+  ENC_PACK: MBP.meta(  //25 + payload
+    MBP.MB('type','8',0),
+    MBP.MB('len','32L',0),  // pure xdata size.
+    MBP.MB('salt12', Buffer.alloc(12)),  // sec,mil,rand
+    MBP.MB('hmac',8,0)
+    // MBP.MB( 'xdata', encData )
+    ),
+
+
+  ENC_488: MBP.meta(   // 21 + payload
+    MBP.MB('type','8', 0 ),
+    MBP.MB('len','32L', 0 ),
+    MBP.MB('otpSrc8', Buffer.alloc(8) ),
+    MBP.MB('hmac8', Buffer.alloc(8) )
+    // MBP.MB('xdata', encData )
+    )
+
+  }
+
+console.log( Meta.ENC_488 )
+
+const MB = MBP.MB;
+
+  let mbPack = MBP.pack(
+MB('a','8',120),
+MB('b','16',64000),
+MB('c', Buffer.alloc(1000) ),
+MB('c2', 1000, 0)  //c와 동일한 역활.
+)
+
+let mbObj = MBP.unpack( mbPack)
+let a = mbObj.a
+console.log('a', a)
+
+let metaDetail = MBP.getMeta(mbPack ,true)
+
+console.log(metaDetail)

package/test/subscribe-signal/self-listen.js

@@ -0,0 +1,40 @@
+import { Server , IO, MBP ,delay } from 'iosignal'
+
+const tag = 'channel1'
+const s = new Server({
+    port:0,
+    showMessage: 'message'
+});
+
+s.on('ready',async ()=>{
+    // 서버 listen 포트가 0으로 설정된경우,  자동설정된 값이 s.port 속성으로 확정됨.
+    console.log('listening port: ', s.port )
+
+    const io = new IO('ws://localhost:'+ s.port)
+    io.on('change',(name)=>{
+        console.log(`(${name}:${io.state})`)  
+    })
+
+    io.on('ready',()=>{
+        console.log('io is ready. cid:', io.cid )
+        io.subscribe(tag)
+        io.signal(tag, 'hi')
+    })
+    io.on('message',( tag, ...args )=>{
+        console.log('io message: ', tag, ...args)
+    })
+    io.listen(tag,( tag, ...args )=>{
+        console.log('io listen tag h1: ', tag, ...args)
+    })
+    io.listen(tag,( tag, ...args )=>{
+        console.log('io listen tag h2: ', tag, ...args)
+    })
+
+    console.log('listeners',  io.listeners( tag ) )
+    await delay(200)
+    io.signal(tag, 'hello')
+})
+
+await delay(1000)
+process.exit()
+

package/test/subscribe-signal/self-subscribe.js

@@ -0,0 +1,35 @@
+import { Server , IO, MBP } from 'iosignal'
+
+const tag = 'aaaaaaaa'
+const s = new Server({
+    port:0,
+    showMessage: 'message'
+});
+const delay = ms => new Promise(resolve => setTimeout(resolve, ms));
+
+s.on('ready',async ()=>{
+    // 서버 listen 포트가 0으로 설정된경우,  자동설정된 값이 s.port 속성으로 확정됨.
+    console.log('listening port: ', s.port )
+
+    const io = new IO('ws://localhost:'+ s.port)
+    io.on('change',(name)=>{
+        console.log(`(${name}:${io.state})`)  
+    })
+
+    io.on('ready',()=>{
+        console.log('ready cid:', io.cid )
+        io.subscribe(tag)
+        io.signal(tag, io.cid + ' is ready.')
+    })
+    io.on('message',( tag, msg )=>{
+        console.log('rx tag, message', tag,  msg)
+    })
+
+
+    await delay(200)
+    io.signal(tag, 'hello')
+})
+
+await delay(1000)
+process.exit()
+

package/test/subscribe-signal/signal-MBA.js

@@ -0,0 +1,15 @@
+import { Server , IO, MBP } from 'iosignal'
+
+let mbaPack = MBP.pack( 
+    MBP.MBA(
+        'name', 'hong', 
+        'age', 33,
+        Buffer.alloc(10000),
+        Buffer.alloc(10000),
+    ) 
+)
+
+let mbaMeta = MBP.getMetaDetail( mbaPack)
+console.log('mbaMeta', mbaMeta )
+// console.log('unpackMba', MBP.unpack( mbaPack ))
+console.log('size', mbaPack.byteLength)

package/test/subscribe-signal/signalPack.js

@@ -0,0 +1,34 @@
+import { parsePayload, getSignalPack, getPayloadFromSignalPack, PAYLOAD_TYPE, MBP } from 'iosignal'
+
+const type0 = []
+const type1t = ['a1']
+const type1n = [11]
+const type2 = [new Uint8Array(5)]
+const type3 = [{ name: 'type3' }]
+const type4a = ['a2', 222]
+const type4b = [{ name: 'a3' }, 333]
+const type5 = [{ a: 1 }, Buffer.from('BBBBBB')]
+
+// zero or one argument support: 0:EMPTY, 1:TEXT , 2:BINARY signal payload type
+console.log(PAYLOAD_TYPE[parsePayload(type0).type], type0) // empty
+console.log(PAYLOAD_TYPE[parsePayload(type1t).type], type1t) // text
+console.log(PAYLOAD_TYPE[parsePayload(type1n).type], type1n)  // number text. there is no Number type of signalPaylod.
+console.log(PAYLOAD_TYPE[parsePayload(type2).type], type2)  // binary.
+
+// over two arguments support: 3:Object, 4:MJSON and 5:MBA can hold Number item.
+console.log(PAYLOAD_TYPE[parsePayload(type3).type], type3)  // Object 
+console.log(PAYLOAD_TYPE[parsePayload(type4a).type], type4a) // MJSON
+console.log(PAYLOAD_TYPE[parsePayload(type4b).type], type4b) // MJSON
+console.log(PAYLOAD_TYPE[parsePayload(type5).type], type5)  // MBA
+
+
+let signalTag = 'channel'
+let signalPack = getSignalPack(signalTag, ...type5)
+console.log('signalPack', signalPack)
+
+let payloadBuffer = getPayloadFromSignalPack(signalPack)
+let unpack = MBP.unpack(payloadBuffer)
+console.log(unpack)
+
+
+

package/test/subscribe-signal/signaling.js

@@ -0,0 +1,61 @@
+import { IO, Server } from 'iosignal'
+
+let url = 'ws://localhost:5555'
+let server = new Server({
+  port: 5555
+  //  ,showMessage: 'message'
+})
+let done = false;
+
+let tx = new IO(url)
+tx.on('ready', () => {
+  console.log('tx ready', tx.cid)
+})
+
+
+let rx = new IO(url)
+rx.on('ready', () => {
+  console.log('rx ready', rx.cid)
+})
+
+rx.listen('@', (tag,  ...args) => {
+  console.log('uni-cast rxi', args)
+})
+
+rx.listen('channel', (tag, ...args) => {
+  console.log('multi-cast rxi', args)
+})
+
+function sendSignals() {
+  // uni-casting: tag is receiver CID@.
+  let tag = rx.cid + '@topic'
+  tx.signal(tag, ...arg1)
+  tx.signal(tag, ...arg2)
+  tx.signal(tag, ...arg3)
+  tx.signal(tag, ...arg4)
+  tx.signal(tag, ...arg5)
+
+  // multi-casting: tag is channel name.
+  tag = 'channel'
+  tx.signal(tag, ...arg1)
+  tx.signal(tag, ...arg2)
+  tx.signal(tag, ...arg3)
+  tx.signal(tag, ...arg4)
+  tx.signal(tag, ...arg5)
+}
+
+
+const arg1 = ['a1']
+const arg2 = ['a2', 222]
+const arg3 = [{ name: 'a3' }, 333]
+const arg4 = [{ a: 1 }, Buffer.from('KKKKK')]
+const arg5 = [new Uint8Array(20)]
+
+
+setTimeout(() => {
+  sendSignals();
+}, 1000)
+
+setTimeout(() => {
+  process.exit()
+}, 2000)

package/.vscode/settings.json

@@ -1,3 +0,0 @@
-{
-    "liveServer.settings.port": 5501
-}