{"_id":"@amid.ukr/virtual-network-framework","_rev":"1-c02af66a3d08a293c3fd3a136ef9aefb","name":"@amid.ukr/virtual-network-framework","dist-tags":{"latest":"0.2.1"},"versions":{"0.2.1":{"name":"@amid.ukr/virtual-network-framework","version":"0.2.1","description":"Virtual Network Framework","main":"dist/main.js","scripts":{"test":"karma start --single-run","codecov":"codecov","start":"http-server","build":"webpack --config webpack.config.js"},"repository":{"type":"git","url":"git+https://github.com/amidukr/virtual-network-framework-js.git"},"keywords":["webrtc","js","javascript"],"author":{"name":"Dmytro Brazhnyk","email":"amid.ukr@gmail.com"},"license":"Apache-2.0","bugs":{"url":"https://github.com/amidukr/virtual-network-framework-js/issues"},"homepage":"https://github.com/amidukr/virtual-network-framework-js#readme","devDependencies":{"@babel/core":"^7.6.2","@babel/preset-env":"^7.6.2","codecov":"^3.6.1","http-server":"^13.0.0","karma":"^6.3.4","karma-babel-preprocessor":"^8.0.1","karma-chrome-launcher":"^3.1.0","karma-commonjs":"^1.0.0","karma-coverage":"^2.0.1","karma-failed-reporter":"0.0.3","karma-firefox-launcher":"^1.2.0","karma-qunit":"^4.0.0","karma-spec-reporter":"0.0.32","qunit":"^2.9.2","webpack":"^5.50.0","webpack-cli":"^4.8.0"},"gitHead":"809c03d61424195b64f8809582cb0cfab02955bb","_id":"@amid.ukr/virtual-network-framework@0.2.1","_nodeVersion":"16.6.2","_npmVersion":"7.20.3","dist":{"integrity":"sha512-6CuyVzoeT3HPb/Q0WDmX4zS82Qa1py6ZXJMlgrqH5aBZXNejz1UII2N6ZkXUrfJa57bFVNHuAF6Nm4dTZq6YDw==","shasum":"71a14b4b1448588f882ddf463a44e7b6c41c08bd","tarball":"https://registry.npmjs.org/@amid.ukr/virtual-network-framework/-/virtual-network-framework-0.2.1.tgz","fileCount":41,"unpackedSize":134383,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJhGxl2CRA9TVsSAnZWagAAoJoP/12j9cm3dYpJU/iV9d1m\nZALDQwvXAWhL03j2C7daEwhUuzl2tXFwNgrVhOBA4eFeErCpeR2OdI0jBe8r\nGPw5Uq/ai9IEcreKyCE/JS6EwGzmZ8PFgODmqHxDZ4bpmCfMY3T+C2zma6nT\nJgmHHK6MzbGoWL3dRIm1553TeMq9XBizGAvI926RiHKj+FIje08I8KEpfVSJ\n/0pZ4DlvMXZCFwtL+S5IPcZDYqdb1KVYQ6tVArchIw1RxpssbfFkXp/RJNmi\npIYjgDQJOe7ZH9lT6nfAGcrrjpvjPc/NJCbL8223mqjgwPhiPtj76pnL4USq\nF8otv78+LECWjAtjv5zrVPrE3yEYrIy0M8z0SrhExdAME9QjBMh507uaLSTR\n0kgdy2ftHzbECrn5F7/D2QcMpSaUygcjjjXZ5OQOOWvGSbVMC4KGnHaToBGu\nPVjwIRgHksEQZfVsrGoRmRnAClyUMgTuwG5koCYTzufgYuktBcIRhxZ3+Anc\n6Hgi1Q1W/KRiy3qsQ90rE7j7Gz+8z/rWVbpZNJ3fWdR9e457h7nQnpWbJNj9\n9t9ta4YTx0VgXe9YyZKcDAfTQMgPjT/tsFMXY3kPwXfFuv/9n0qY/NE8oJw2\nti00RdSRCU5AHHFBX/r4J3QAbfSYT2g3gunbjdww4JLSvVKvNm1oycJ/fbKd\nvOc9\r\n=XXap\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIA0ZEFxYG2UwZ7ZyC9tM4XYawLJ+bHYyB89SLHVMRQX9AiAMvAEgWEJkethAO25QlxJ5aNOJ9Tsy3nforRq9VZbiIA=="}]},"_npmUser":{"name":"amid.ukr","email":"amid.ukr@gmail.com"},"directories":{},"maintainers":[{"name":"amid.ukr","email":"amid.ukr@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/virtual-network-framework_0.2.1_1629165941956_0.07270712587441697"},"_hasShrinkwrap":false}},"time":{"created":"2021-08-17T02:05:41.908Z","0.2.1":"2021-08-17T02:05:42.136Z","modified":"2022-04-04T13:48:32.108Z"},"maintainers":[{"name":"amid.ukr","email":"amid.ukr@gmail.com"}],"description":"Virtual Network Framework","homepage":"https://github.com/amidukr/virtual-network-framework-js#readme","keywords":["webrtc","js","javascript"],"repository":{"type":"git","url":"git+https://github.com/amidukr/virtual-network-framework-js.git"},"author":{"name":"Dmytro Brazhnyk","email":"amid.ukr@gmail.com"},"bugs":{"url":"https://github.com/amidukr/virtual-network-framework-js/issues"},"license":"Apache-2.0","readme":"[![Build Status](https://api.travis-ci.com/amidukr/virtual-network-framework-js.svg?branch=master)](https://travis-ci.com/amidukr/virtual-network-framework-js)\r\n[![codecov](https://codecov.io/gh/amidukr/virtual-network-framework-js/branch/master/graph/badge.svg)](https://codecov.io/gh/amidukr/virtual-network-framework-js)\r\n\r\n# Overview\r\n\r\nThis javascript client side part of VNF framework for peer-to-peer communication.\r\n\r\nIt has two essential parts:\r\n- **VNF Hub** - used to create channel between vnf endpoints\r\n- **VNF Registry** - registry for endpoint discovery\r\n\r\n# Specification\r\n\r\nMore details about framework design can be found in specification:\r\n[VNF Specification](./docs/amid-ukr-vnf.pdf)\r\n\r\n# VNF Channels\r\n\r\nVNF Channels are use for peer-to-peer communication.\r\n\r\nSupported channels\r\n\r\n- **InBrowserHub** - the simples hub for peer-to-peer, for communication of endpoint inside a browser, used mostly for testing and mocking.\r\n- **WebSocketHub** - uses web socket server for peer-to-peer comunication, and can be used as signaling channel to establish WebRTC connection.\r\n- **ReliableHub** - proxy hub, that can handle different network and connectivity issues.\r\n- **RtcHub** - hub for peer-to-peer channels, requires hub which will be used as signaling channels. \r\n- **ReliableRtcHub** - combines RtcHub and ReliableHub\r\n- **MarshallerHub** - proxy hub that can handle big message and can marshal/unmarshal js object into json.\r\n- **UnreliableHub** - proxy hub that create issue for chaos testing.\r\n\r\n## Example\r\n\r\n### Hub usage flow\r\n\r\n```js\r\n// Creating in browser hub of endpoints\r\nconst vnfHub = new Vnf.InBrowserHub()\r\n\r\n// Creating endpoint in hub\r\nconst endpoint1 = vnfHub.openEndpoint(\"endpoint1-name\")\r\nconst endpoint2 = vnfHub.openEndpoint(\"endpoint2-name\")\r\n\r\n// Listening to messages\r\nendpoint1.onMessage = function(event) {\r\n    console.info(\"Endpoint-1 got a message from endpoint \" + event.sourceEva + \", message is: \" + event.message)\r\n\r\n    if(event.message == \"I am good!\") {\r\n        console.info(\"Endpoint 1 is closing connection to \" + event.sourceEva)\r\n        endpoint1.closeConnection(event.sourceEva)\r\n    }\r\n}\r\n\r\nendpoint2.onMessage = function(event) {\r\n    console.info(\"Endpoint-2 got a message from endpoint \" + event.sourceEva + \", message is: \" + event.message)\r\n\r\n    if(event.message == \"How are you?\") {\r\n        endpoint2.send(event.sourceEva, \"I am good!\")\r\n    }\r\n}\r\n\r\n// Handling close connection and releasing endpoints\r\n\r\nendpoint2.onConnectionLost(function(targetEva){\r\n    console.info(\"Endpoint-2 lost connection to \" + targetEva + \", releasing endpoints\")\r\n    endpoint1.destroy()\r\n    endpoint2.destroy()\r\n})\r\n\r\n// Open connection and sending handshake message\r\n\r\nendpoint1.openConnection(\"endpoint2-name\", function(event){\r\n    if(event.status != \"CONNECTED\") return;\r\n\r\n    console.info(\"Endpoint-1 established connection to \" + event.targetEva + \", status is: \" + event.status)\r\n\r\n    endpoint1.send(event.targetEva, \"How are you?\")\r\n})\r\n\r\n\r\n```\r\n\r\n### WebSocket usage\r\n\r\n```js\r\n// Creating in browser hub of endpoints\r\nconst vnfHub = new Vnf.WebSocketHub(new Vnf.WebSocketFactory(\"wss://<server-host-name>/webbroker/vnf-ws\"));\r\n\r\n// Creating endpoint in hub\r\nconst endpoint1 = vnfHub.openEndpoint(\"endpoint1-name\")\r\nconst endpoint2 = vnfHub.openEndpoint(\"endpoint2-name\")\r\n\r\n// Rest part the same as InBrowserHub\r\n...\r\n\r\n```\r\n\r\n### WebSocket usage\r\n\r\n```js\r\n// Creating in browser hub of endpoints\r\nconst webSocketFactory = new Vnf.WebSocketFactory(\"wss://<server-host-name>/webbroker/vnf-ws\")\r\nconst vnfHub = new Vnf.WebSocketHub(webSocketFactory);\r\n\r\n// Creating endpoint in hub\r\nconst endpoint1 = vnfHub.openEndpoint(\"endpoint1-name\")\r\nconst endpoint2 = vnfHub.openEndpoint(\"endpoint2-name\")\r\n\r\n// Rest part the same as InBrowserHub\r\n...\r\n\r\n```\r\n### WebRTC with WebSocket as signaling channel\r\n\r\n```js\r\n// Creating in browser hub of endpoints\r\nconst webSocketFactory = new Vnf.WebSocketFactory(\"wss://<server-host-name>/webbroker/vnf-ws\")\r\nconst vnfHub = new Vnf.RtcHub(new Vnf.WebSocketHub(webSocketFactory));\r\n\r\n// Creating endpoint in hub\r\nconst endpoint1 = vnfHub.openEndpoint(\"endpoint1-name\")\r\nconst endpoint2 = vnfHub.openEndpoint(\"endpoint2-name\")\r\n\r\n// Rest part the same as InBrowserHub\r\n...\r\n\r\n```\r\n\r\n### Marshaller + Reliable over WebRtc with WebScoket as signaling\r\n\r\n```js\r\n// Creating in browser hub of endpoints\r\nconst webSocketFactory = new Vnf.WebSocketFactory(\"wss://<server-host-name>/webbroker/vnf-ws\")\r\nconst vnfHub = new Vnf.MarshallerHub(new Vnf.ReliableRtcHub((webSocketFactory)));\r\n\r\n// Creating endpoint in hub\r\nconst endpoint1 = vnfHub.openEndpoint(\"endpoint1-name\")\r\nconst endpoint2 = vnfHub.openEndpoint(\"endpoint2-name\")\r\n\r\n// Rest part the same as InBrowserHub\r\n...\r\n\r\n```\r\n\r\n# VNF Registry\r\n\r\nVNF Registry is used for discovery.\r\n\r\nFor example chat application can use it can register for chat channel, so other user can use registry to find active chats to connect. Registry entry will remain available until client channel will be closed or lost.\r\n\r\nTwo registries implementation are supported:\r\n- **InBrowserRegistry** - registry in browser memory, used for testing and mocking\r\n- **WebSocketRegistryClient** - registry client over websocket protocol\r\n\r\n## Examples\r\n\r\n### InBrowserRegistry\r\n\r\n```js\r\n\r\nconst sharedRegistry = new Vnf.InBrowserRegistry();\r\nconst registryClient = sharedRegistry.connect(\"endpoint1-name\")\r\n\r\nPromise.resolve()\r\n.then(registryClient.createEntry.bind(null, {collection: collection1Name, name:\"entry1\"}, \"entry value\"))\r\n.then(function(status) {\r\n    assert.equal(status, Vnf.Global.OK, \"asserting status\");\r\n})\r\n.then(registryClient.getEntry.bind(null, {collection: collection1Name, name:\"entry1\"}))\r\n.then(function(value){\r\n    assert.equal(value, \"entry value\", \"asserting inserted entry\");\r\n})\r\n.then(done);\r\n```\r\n\r\n### WebSocketRegistry example\r\n```js\r\nconst webSocketFactory = new Vnf.WebSocketFactory(\"wss://<server-host-name>/webbroker/vnf-ws\")\r\nconst registryClient = new Vnf.WebSocketRegistryClient(new Vnf.WebSocketRpc(eva, webSocketFactory))\r\n\r\n// Rest part the same as InBrowserRegistry\r\n...\r\n\r\n```\r\n\r\n### WebSocketRegistry and WebScoketHub\r\n```js\r\nconst webSocketFactory = new Vnf.WebSocketFactory(\"wss://<server-host-name>/webbroker/vnf-ws\")\r\nconst vnfHub = new Vnf.WebSocketHub(webSocketFactory);\r\n\r\n// Creating endpoint in hub\r\nconst endpoint1 = vnfHub.openEndpoint(\"endpoint1-name\")\r\nconst registryClient = new Vnf.WebSocketRegistryClient(endpoint1.getWebSocketRpc())\r\n\r\n// Rest part the same as InBrowserRegistry\r\n...\r\n\r\n```","readmeFilename":"README.md"}