{"_id":"@armoredfuzzball/fjtp","_rev":"2-c6fbf80ccf67105236d55c39674ad750","name":"@armoredfuzzball/fjtp","dist-tags":{"latest":"2.0.2"},"versions":{"2.0.1":{"name":"@armoredfuzzball/fjtp","version":"2.0.1","keywords":["ipc","interprocess","communication","uds","unix","domain","sockets","fjtp","fast","json","transfer","protocol"],"license":"MIT","_id":"@armoredfuzzball/fjtp@2.0.1","maintainers":[{"name":"armoredfuzzball","email":"armoredredfox@gmail.com"}],"homepage":"https://github.com/ArmoredFuzzball/fjtp#readme","dist":{"shasum":"50e84b0516fec93c1c61dc50a44e12fb75ee1cbc","tarball":"https://registry.npmjs.org/@armoredfuzzball/fjtp/-/fjtp-2.0.1.tgz","fileCount":16,"integrity":"sha512-5T1+QgtruPwxwHnGZ1sPNgELdzjWeiOmfCmxaSBTJRplc5NR3sWIm8cjQAhOly1tksxOe+DE1u5xxGMMNMKMgg==","signatures":[{"sig":"MEUCIEXC5/zFVp5ApdGGFxRHX84MdHHHOu0X2ouQpTxgRpbRAiEAjjsSuOrTkL4WuYq4Gkw8fENK2bzTHPaLqFiOMvulv6U=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":31119},"main":"dist/protocol.js","type":"module","types":"dist/protocol.d.ts","exports":{".":{"types":"./dist/protocol.d.ts","import":"./dist/protocol.js","default":"./dist/protocol.js"},"./package.json":"./package.json"},"gitHead":"b19733ec60f763df5de9896006a6ad0957548905","scripts":{"build":"tsc"},"_npmUser":{"name":"armoredfuzzball","email":"armoredredfox@gmail.com"},"repository":{"url":"git://ArmoredFuzzball/fjtp.git","type":"git"},"_npmVersion":"11.11.0","description":"Node.js interprocess communication with JSON","directories":{},"_nodeVersion":"24.14.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.9.3","@types/node":"^25.3.3"},"_npmOperationalInternal":{"tmp":"tmp/fjtp_2.0.1_1772336085742_0.04229690044389689","host":"s3://npm-registry-packages-npm-production"}},"2.0.2":{"name":"@armoredfuzzball/fjtp","description":"Node.js interprocess communication with JSON","version":"2.0.2","type":"module","main":"dist/protocol.js","types":"dist/protocol.d.ts","exports":{".":{"types":"./dist/protocol.d.ts","import":"./dist/protocol.js","default":"./dist/protocol.js"},"./package.json":"./package.json"},"repository":{"type":"git","url":"git://ArmoredFuzzball/fjtp.git"},"homepage":"https://github.com/ArmoredFuzzball/fjtp#readme","license":"MIT","keywords":["ipc","interprocess","communication","uds","unix","domain","sockets","fjtp","fast","json","transfer","protocol"],"devDependencies":{"@types/node":"^25.3.3","typescript":"^5.9.3"},"scripts":{"build":"tsc"},"gitHead":"778e8f1018d65a7ba5aad6890c329ac2600b6c01","_id":"@armoredfuzzball/fjtp@2.0.2","_nodeVersion":"24.14.0","_npmVersion":"11.11.0","dist":{"integrity":"sha512-W43zypp1pCCZSo03zMfqOdXxjFEjUpISFnatsEk9DXdbOUCX+xWAUamP7pjkPsw3C8n2TLCQ3FfP5Jl6XWpdmQ==","shasum":"ae80a1c114a3e21833eb1ed8a52ee6e332caf919","tarball":"https://registry.npmjs.org/@armoredfuzzball/fjtp/-/fjtp-2.0.2.tgz","fileCount":16,"unpackedSize":31308,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIHFfkbBmCAE6y9BPM3Hz2YpL9ODemDEjwgEYYM2QD4iGAiBLU0/EZt3KYbNoXSoCR4l0/8V1ZkQo9/zXhI03ppMvog=="}]},"_npmUser":{"name":"armoredfuzzball","email":"armoredredfox@gmail.com"},"directories":{},"maintainers":[{"name":"armoredfuzzball","email":"armoredredfox@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/fjtp_2.0.2_1772344607292_0.6511160932751643"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-01T03:34:45.668Z","modified":"2026-03-01T05:56:47.579Z","2.0.1":"2026-03-01T03:34:45.889Z","2.0.2":"2026-03-01T05:56:47.463Z"},"license":"MIT","homepage":"https://github.com/ArmoredFuzzball/fjtp#readme","keywords":["ipc","interprocess","communication","uds","unix","domain","sockets","fjtp","fast","json","transfer","protocol"],"repository":{"type":"git","url":"git://ArmoredFuzzball/fjtp.git"},"description":"Node.js interprocess communication with JSON","maintainers":[{"name":"armoredfuzzball","email":"armoredredfox@gmail.com"}],"readme":"

Fast JSON Transfer Protocol

\nThis simple library provides a fast and efficient way to communicate between different Node.js processes using JSON over Unix Domain Sockets.\n\n

Performance

\nFor small to medium payloads, this library offers extremely high speed communication with minimal overhead, considerably higher bandwidth and lower latency than popular alternatives.\n
\nNOTE: For larger payloads (more than ~256 KB), popular HTTP-based libraries start to quickly outperform this library by a large margin, as their protocol overhead no longer dominates at that scale and actually starts helping.\n\n

Benchmarks

\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
Performance comparison of Fastify+Fetch and FJTP
Payload
size (KB)		Req/secLatency (ms)
FastifyFJTPFastifyFJTP
~015,400121,0000.0650.008
0.514,40096,0000.0700.010
113,50084,5000.0740.012
212,90067,0000.0780.015
411,70049,0000.0860.021
810,50032,0000.0960.030
129,10023,5000.1100.041
168,00019,3000.1260.052
246,30014,0000.1580.071
325,00010,0000.2000.100
484,3009,0000.2300.112
642,9005,8000.3400.172
722,8005,7000.3510.176
962,4004,2000.4250.240
1281,3001,8000.7450.570
2568008001.3001.200
5124004002.3702.550
7683002003.4804.100
\n\n*Test conducted with FJTP 2.0.1, Fastify 5.7.4, Node.js v24.14.0*\n\nFJTP is best suited for scenarios where you need high bandwidth and low latency with small to medium JSON payloads (for example, a backend authentication service, which just transmits tokens or user credentials to other services).\n\n

Security

\nUnix Domain Sockets are not exposed to the network. Instead, they are files in the file system. This typically makes them more secure than communication over localhost. Care should still be taken to ensure that the folder which contains the Unix Domain Socket file is properly permissioned and accessible only to trusted users. This helps prevent unauthorized access to the communication channel.\n\n

Server Example

\n\n```js\nimport { FJTPServer } from 'fjtp';\nconst SOCKET_PATH = './secure_directory/my_socket.sock';\n\nconst options = { clientOptions: { UDSInterfaceOptions: { payloadCodecOptions: { encoding: 'ascii' } } } };\nconst server = new FJTPServer(options);\n\n// Handle incoming connections\nserver.onConnection((socket) => {\n console.log('Client connected');\n\n // Handle incoming messages\n socket.onRequest((message) => {\n console.log('Received message:', message);\n return { anything: 'Hello from server!' };\n //or throw an error to the client\n throw new Error(\"Something went wrong!\");\n });\n\n // Handle socket disconnect\n socket.on('close', () => {\n console.log('Client disconnected');\n });\n\n // Handle socket errors\n socket.on('error', (error) => {\n console.error('Socket error:', error);\n });\n});\n\n// Listen for incoming connections\nserver.listen(SOCKET_PATH, () => console.log(`Server listening on ${SOCKET_PATH}`));\n```\n\n

Client Example

\n\n```js\nimport { FJTPClient } from 'fjtp';\nconst SOCKET_PATH = './secure_directory/my_socket.sock';\n\nconst options = { UDSInterfaceOptions: { payloadCodecOptions: { encoding: 'ascii' } } };\nconst socket = new FJTPClient(options);\n\n// Handle socket errors\nsocket.on('error', (error) => {\n console.error('Socket error:', error);\n});\n\n// Connect to the server\nsocket.connect(SOCKET_PATH, () => {\n console.log(\"Connected to the server\");\n\n // Send a message and wait for a response\n socket.rpc({ anything: 'Hello from client!' }, 3000) //custom timeout ms\n .then(response => {\n console.log('Received response:', response);\n })\n .catch(error => {\n console.error('RPC error:', error);\n });\n});\n```","readmeFilename":"README.md"}