JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 3
  • Score
    100M100P100Q36451F
  • License BSD

simple pure js library for generating random 64 bit numbers with XOR support

Package Exports

  • xor64

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (xor64) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

node-xor64

A simple package to xor 64 bit integers (byte buffers)

Install

npm install xor64

Why

I needed this module to create random 64 bit numbers and xor them to implement an acker system similar to what storm does.

Note

This is not used in production yet, and may exhibit some issues. If you find any report them please.

Usage

See the test.js which shows many examples. Most important use case for tracking is:

var xor64 = require('xor64');

// this will be true once all messages have been ack'ed
var hasHandledAllMessages;

var originalMessageId = xor64.createRandom();
var trackingId = xor64.clone(originalMessageId); // of course in a real progam one could use the originalMessageId without cloning

...

// start tracking dependentMessageIdA   
dependentMessageIdA = xor64.createRandom();
xor64.applyXor(trackingId, dependentMessageIdA);

// start tracking dependentMessageIdB
dependentMessageIdB = xor64.createRandom();
xor64.applyXor(trackingId, dependentMessageIdA);

// finished with originalMessageId    
hasHandledAllMessages = xor64.applyXor(trackingId, originalMessageId);

// finished with dependentMessageIdA    
hasHandledAllMessages = xor64.applyXor(trackingId, dependentMessageIdA);

// finished with dependentMessageIdB
hasHandledAllMessages = xor64.applyXor(trackingId, dependentMessageIdB);

require('assert').assert( hasHandledAllMessages === true );