logos-messaging-js/src/lib/waku_message.ts
Franck Royer 5a967ecbcc
Avoid possible type name clash between js-waku and consuming apps
`Message` is a very generic name and JS does not offer strong namespace
boundaries. Using `WakuMessage` avoid name clashing with classes
of the consumer app.
2021-04-01 11:18:35 +11:00

80 lines
2.0 KiB
TypeScript

// Ensure that this class matches the proto interface while
import { Reader } from 'protobufjs/minimal';
// Protecting the user from protobuf oddities
import { WakuMessageProto } from '../proto/waku/v2/waku';
const DEFAULT_CONTENT_TOPIC = 1;
const DEFAULT_VERSION = 0;
export class WakuMessage {
private constructor(
public payload?: Uint8Array,
public contentTopic?: number,
public version?: number
) {}
/**
* Create Message with a utf-8 string as payload
* @param payload
* @returns {WakuMessage}
*/
static fromUtf8String(payload: string): WakuMessage {
const buf = Buffer.from(payload, 'utf-8');
return new WakuMessage(buf, DEFAULT_CONTENT_TOPIC, DEFAULT_VERSION);
}
/**
* Create Message with a byte array as payload
* @param payload
* @returns {WakuMessage}
*/
static fromBytes(payload: Uint8Array): WakuMessage {
return new WakuMessage(payload, DEFAULT_CONTENT_TOPIC, DEFAULT_VERSION);
}
static decode(bytes: Uint8Array): WakuMessage {
const wakuMsg = WakuMessageProto.decode(Reader.create(bytes));
return new WakuMessage(
wakuMsg.payload,
wakuMsg.contentTopic,
wakuMsg.version
);
}
toBinary(): Uint8Array {
return WakuMessageProto.encode({
payload: this.payload,
version: this.version,
contentTopic: this.contentTopic,
}).finish();
}
utf8Payload(): string {
if (!this.payload) {
return '';
}
return Array.from(this.payload)
.map((char) => {
return String.fromCharCode(char);
})
.join('');
}
// Purely for tests purposes.
// We do consider protobuf field when checking equality
// As the content is held by the other fields.
isEqualTo(other: WakuMessage) {
const payloadsAreEqual =
this.payload && other.payload
? Buffer.compare(this.payload, other.payload) === 0
: !(this.payload || other.payload);
return (
payloadsAreEqual &&
this.contentTopic === other.contentTopic &&
this.version === other.version
);
}
}