rocketmq-client-nodejs-bate 1.0.12

package/src/exception/StatusChecker.ts

@@ -0,0 +1,94 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { Status, Code } from '../../proto/apache/rocketmq/v2/definition_pb';
+import { BadRequestException } from './BadRequestException';
+import { ForbiddenException } from './ForbiddenException';
+import { InternalErrorException } from './InternalErrorException';
+import { NotFoundException } from './NotFoundException';
+import { PayloadTooLargeException } from './PayloadTooLargeException';
+import { PaymentRequiredException } from './PaymentRequiredException';
+import { ProxyTimeoutException } from './ProxyTimeoutException';
+import { RequestHeaderFieldsTooLargeException } from './RequestHeaderFieldsTooLargeException';
+import { TooManyRequestsException } from './TooManyRequestsException';
+import { UnauthorizedException } from './UnauthorizedException';
+import { UnsupportedException } from './UnsupportedException';
+
+export class StatusChecker {
+  static check(status?: Status.AsObject, requestId?: string) {
+    if (!status) return;
+    switch (status.code) {
+      case Code.OK:
+      case Code.MULTIPLE_RESULTS:
+        return;
+      case Code.BAD_REQUEST:
+      case Code.ILLEGAL_ACCESS_POINT:
+      case Code.ILLEGAL_TOPIC:
+      case Code.ILLEGAL_CONSUMER_GROUP:
+      case Code.ILLEGAL_MESSAGE_TAG:
+      case Code.ILLEGAL_MESSAGE_KEY:
+      case Code.ILLEGAL_MESSAGE_GROUP:
+      case Code.ILLEGAL_MESSAGE_PROPERTY_KEY:
+      case Code.INVALID_TRANSACTION_ID:
+      case Code.ILLEGAL_MESSAGE_ID:
+      case Code.ILLEGAL_FILTER_EXPRESSION:
+      case Code.ILLEGAL_INVISIBLE_TIME:
+      case Code.ILLEGAL_DELIVERY_TIME:
+      case Code.INVALID_RECEIPT_HANDLE:
+      case Code.MESSAGE_PROPERTY_CONFLICT_WITH_TYPE:
+      case Code.UNRECOGNIZED_CLIENT_TYPE:
+      case Code.MESSAGE_CORRUPTED:
+      case Code.CLIENT_ID_REQUIRED:
+      case Code.ILLEGAL_POLLING_TIME:
+        throw new BadRequestException(status.code, status.message, requestId);
+      case Code.UNAUTHORIZED:
+        throw new UnauthorizedException(status.code, status.message, requestId);
+      case Code.PAYMENT_REQUIRED:
+        throw new PaymentRequiredException(status.code, status.message, requestId);
+      case Code.FORBIDDEN:
+        throw new ForbiddenException(status.code, status.message, requestId);
+      case Code.MESSAGE_NOT_FOUND:
+        return;
+      case Code.NOT_FOUND:
+      case Code.TOPIC_NOT_FOUND:
+      case Code.CONSUMER_GROUP_NOT_FOUND:
+        throw new NotFoundException(status.code, status.message, requestId);
+      case Code.PAYLOAD_TOO_LARGE:
+      case Code.MESSAGE_BODY_TOO_LARGE:
+        throw new PayloadTooLargeException(status.code, status.message, requestId);
+      case Code.TOO_MANY_REQUESTS:
+        throw new TooManyRequestsException(status.code, status.message, requestId);
+      case Code.REQUEST_HEADER_FIELDS_TOO_LARGE:
+      case Code.MESSAGE_PROPERTIES_TOO_LARGE:
+        throw new RequestHeaderFieldsTooLargeException(status.code, status.message, requestId);
+      case Code.INTERNAL_ERROR:
+      case Code.INTERNAL_SERVER_ERROR:
+      case Code.HA_NOT_AVAILABLE:
+        throw new InternalErrorException(status.code, status.message, requestId);
+      case Code.PROXY_TIMEOUT:
+      case Code.MASTER_PERSISTENCE_TIMEOUT:
+      case Code.SLAVE_PERSISTENCE_TIMEOUT:
+        throw new ProxyTimeoutException(status.code, status.message, requestId);
+      case Code.UNSUPPORTED:
+      case Code.VERSION_UNSUPPORTED:
+      case Code.VERIFY_FIFO_MESSAGE_UNSUPPORTED:
+        throw new UnsupportedException(status.code, status.message, requestId);
+      default:
+        throw new UnsupportedException(status.code, status.message, requestId);
+    }
+  }
+}

package/src/exception/TooManyRequestsException.ts

@@ -0,0 +1,25 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { ClientException } from './ClientException';
+
+export class TooManyRequestsException extends ClientException {
+  constructor(code: number, message: string, requestId?: string) {
+    super(code, message, requestId);
+    this.name = 'TooManyRequestsException';
+  }
+}

package/src/exception/UnauthorizedException.ts

@@ -0,0 +1,25 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { ClientException } from './ClientException';
+
+export class UnauthorizedException extends ClientException {
+  constructor(code: number, message: string, requestId?: string) {
+    super(code, message, requestId);
+    this.name = 'UnauthorizedException';
+  }
+}

package/src/exception/UnsupportedException.ts

@@ -0,0 +1,25 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { ClientException } from './ClientException';
+
+export class UnsupportedException extends ClientException {
+  constructor(code: number, message: string, requestId?: string) {
+    super(code, message, requestId);
+    this.name = 'UnsupportedException';
+  }
+}

package/src/exception/index.ts

@@ -0,0 +1,30 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export * from './BadRequestException';
+export * from './ClientException';
+export * from './ForbiddenException';
+export * from './InternalErrorException';
+export * from './NotFoundException';
+export * from './PayloadTooLargeException';
+export * from './PaymentRequiredException';
+export * from './ProxyTimeoutException';
+export * from './RequestHeaderFieldsTooLargeException';
+export * from './StatusChecker';
+export * from './TooManyRequestsException';
+export * from './UnauthorizedException';
+export * from './UnsupportedException';

package/src/index.ts

@@ -0,0 +1,23 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export * from './consumer';
+export * from './exception';
+export * from './message';
+export * from './producer';
+export * from './retry';
+export * from './route';

package/src/message/Message.ts

@@ -0,0 +1,67 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export interface MessageOptions {
+  topic: string;
+  body: Buffer;
+  tag?: string;
+  messageGroup?: string;
+  keys?: string[];
+  properties?: Map<string, string>;
+  delay?: number;
+  deliveryTimestamp?: Date;
+  priority?: number;
+}
+
+export class Message {
+  topic: string;
+  body: Buffer;
+  tag?: string;
+  messageGroup?: string;
+  keys: string[];
+  properties?: Map<string, string>;
+  deliveryTimestamp?: Date;
+  priority?: number;
+
+  constructor(options: MessageOptions) {
+    // Validate priority and mutual exclusivity
+    if (options.priority !== undefined) {
+      if (options.priority < 0) {
+        throw new Error('priority must be greater than or equal to 0');
+      }
+      if (options.deliveryTimestamp) {
+        throw new Error('priority and deliveryTimestamp should not be set at same time');
+      }
+      if (options.messageGroup) {
+        throw new Error('priority and messageGroup should not be set at same time');
+      }
+    }
+
+    this.topic = options.topic;
+    this.body = options.body;
+    this.tag = options.tag;
+    this.messageGroup = options.messageGroup;
+    this.keys = options.keys ?? [];
+    this.properties = options.properties;
+    let deliveryTimestamp = options.deliveryTimestamp;
+    if (options.delay && !deliveryTimestamp) {
+      deliveryTimestamp = new Date(Date.now() + options.delay);
+    }
+    this.deliveryTimestamp = deliveryTimestamp;
+    this.priority = options.priority;
+  }
+}

package/src/message/MessageId.ts

@@ -0,0 +1,123 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import address from 'address';
+
+export enum MESSAGE_VERSION {
+  V0 = 0x00,
+  V1 = 0x01,
+}
+
+export class MessageId {
+  id: string;
+  /**
+   * e.g.: 0x01: fixed 1 byte for current version
+   * offset = 0
+   */
+  version: MESSAGE_VERSION;
+  /**
+   * e.g.: 0x56F7E71C361B: lower 6 bytes of local mac address
+   * offset = 1
+   */
+  macAddress: string;
+  /**
+   * e.g.: 0x21BC: lower 2 bytes of process id
+   * offset = 7
+   */
+  processId: number;
+  /**
+   * e.g: 0x024CCDBE: seconds since 2021-01-01 00:00:00(UTC+0, lower 4 bytes)
+   * offset = 9
+   */
+  timestamp: number;
+  /**
+   * e.g.: 0x00000000: sequence number(4 bytes)
+   * offset = 13
+   */
+  sequence: number;
+
+  toString() {
+    return this.id;
+  }
+}
+
+const MAX_UINT32 = 0xFFFFFFFF;
+const MAX_UINT16 = 0xFFFF;
+
+/**
+ * Message Identifier
+ * https://github.com/apache/rocketmq-clients/blob/master/docs/message_id.md
+ */
+export class MessageIdFactory {
+  // static #hostname = hostname();
+  static #sequence = 0;
+  static #buf = Buffer.alloc(1 + 6 + 2 + 4 + 4);
+  // 2021-01-01 00:00:00(UTC+0), 1609459200000
+  static #sinceTimestamp = new Date('2021-01-01T00:00:00Z').getTime() / 1000;
+  // lower 2 bytes of process id
+  static #processId = process.pid % MAX_UINT16;
+  static MAC = '000000000000';
+
+  static create() {
+    const messageId = new MessageId();
+    messageId.version = MESSAGE_VERSION.V1;
+    messageId.macAddress = this.MAC;
+    messageId.processId = this.#processId;
+    messageId.timestamp = this.#getCurrentTimestamp();
+    messageId.sequence = this.#sequence++;
+    if (this.#sequence > MAX_UINT32) {
+      this.#sequence = 0;
+    }
+    this.#buf.writeUInt8(messageId.version, 0);
+    this.#buf.write(messageId.macAddress, 1, 'hex');
+    this.#buf.writeUInt16BE(messageId.processId, 7);
+    this.#buf.writeUInt32BE(messageId.timestamp, 9);
+    this.#buf.writeUInt32BE(messageId.sequence, 13);
+    messageId.id = this.#buf.toString('hex').toUpperCase();
+    return messageId;
+  }
+
+  static decode(id: string) {
+    const messageId = new MessageId();
+    messageId.id = id;
+    this.#buf.write(id, 0, 'hex');
+    messageId.version = this.#buf.readUInt8(0);
+    messageId.macAddress = this.#buf.subarray(1, 7).toString('hex');
+    messageId.processId = this.#buf.readUInt16BE(7);
+    messageId.timestamp = this.#buf.readUInt32BE(9);
+    messageId.sequence = this.#buf.readUInt32BE(13);
+    return messageId;
+  }
+
+  static #getCurrentTimestamp() {
+    // use lower 4 bytes
+    return Math.floor(Date.now() / 1000 - this.#sinceTimestamp) % MAX_UINT32;
+  }
+}
+
+// set current mac address
+address.mac((err, mac) => {
+  if (err) {
+    console.warn('[rocketmq-client-nodejs] can\'t get mac address, %s', err.message);
+    return;
+  }
+  if (!mac) {
+    console.warn('[rocketmq-client-nodejs] can\'t get mac address');
+    return;
+  }
+  MessageIdFactory.MAC = mac.replaceAll(':', '');
+});

package/src/message/MessageView.ts

@@ -0,0 +1,94 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { gunzipSync } from 'node:zlib';
+import {
+  DigestType,
+  Encoding,
+  Message as MessagePB,
+} from '../../proto/apache/rocketmq/v2/definition_pb';
+import { crc32CheckSum, md5CheckSum, sha1CheckSum } from '../util';
+import { Endpoints, MessageQueue } from '../route';
+
+export class MessageView {
+  readonly messageId: string;
+  readonly topic: string;
+  readonly body: Buffer;
+  readonly corrupted: boolean;
+  readonly transportDeliveryTimestamp?: Date;
+  readonly tag?: string;
+  readonly messageGroup?: string;
+  readonly deliveryTimestamp?: Date;
+  readonly keys: string[];
+  readonly bornHost: string;
+  readonly bornTimestamp?: Date;
+  readonly deliveryAttempt?: number;
+  readonly endpoints: Endpoints;
+  readonly receiptHandle: string;
+  readonly offset?: number;
+  readonly decodeTimestamp: Date;
+  readonly properties = new Map<string, string>();
+
+  constructor(message: MessagePB, messageQueue?: MessageQueue, transportDeliveryTimestamp?: Date) {
+    const systemProperties = message.getSystemProperties()!;
+    const bodyDigest = systemProperties.getBodyDigest()!.toObject();
+    const digestType = bodyDigest.type;
+    const checksum = bodyDigest.checksum;
+    let expectedChecksum = '';
+    let bodyBytes = Buffer.from(message.getBody_asU8());
+    switch (digestType) {
+      case DigestType.CRC32:
+        expectedChecksum = crc32CheckSum(bodyBytes);
+        break;
+      case DigestType.MD5:
+        expectedChecksum = md5CheckSum(bodyBytes);
+        break;
+      case DigestType.SHA1:
+        expectedChecksum = sha1CheckSum(bodyBytes);
+        break;
+      default:
+        // log.error("Unsupported message body digest algorithm, digestType={}, topic={}, messageId={}",
+        //             digestType, topic, messageId);
+    }
+    if (expectedChecksum && expectedChecksum !== checksum) {
+      this.corrupted = true;
+    }
+    if (systemProperties.getBodyEncoding() === Encoding.GZIP) {
+      bodyBytes = gunzipSync(bodyBytes);
+    }
+
+    for (const [ key, value ] of message.getUserPropertiesMap().entries()) {
+      this.properties.set(key, value);
+    }
+    this.messageId = systemProperties.getMessageId();
+    this.topic = message.getTopic()!.getName();
+    this.tag = systemProperties.getTag();
+    this.messageGroup = systemProperties.getMessageGroup();
+    this.deliveryTimestamp = systemProperties.getDeliveryTimestamp()?.toDate();
+    this.keys = systemProperties.getKeysList();
+    this.bornHost = systemProperties.getBornHost();
+    this.bornTimestamp = systemProperties.getBornTimestamp()?.toDate();
+    this.deliveryAttempt = systemProperties.getDeliveryAttempt();
+    this.offset = systemProperties.getQueueOffset();
+    this.receiptHandle = systemProperties.getReceiptHandle()!;
+    this.transportDeliveryTimestamp = transportDeliveryTimestamp;
+    if (messageQueue) {
+      this.endpoints = messageQueue.broker.endpoints;
+    }
+    this.body = bodyBytes;
+  }
+}

package/src/message/PublishingMessage.ts

@@ -0,0 +1,104 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { Timestamp } from 'google-protobuf/google/protobuf/timestamp_pb';
+import {
+  MessageType, Message as MessagePB, SystemProperties, Encoding,
+} from '../../proto/apache/rocketmq/v2/definition_pb';
+import { PublishingSettings } from '../producer';
+import { createResource } from '../util';
+import { MessageQueue } from '../route';
+import { UserAgent } from '../client';
+import { Message, MessageOptions } from './Message';
+import { MessageIdFactory } from './MessageId';
+
+export class PublishingMessage extends Message {
+  readonly messageId: string;
+  readonly messageType: MessageType;
+
+  constructor(options: MessageOptions, publishingSettings: PublishingSettings, txEnabled: boolean) {
+    super(options);
+    const length = this.body.length;
+    const maxBodySizeBytes = publishingSettings.maxBodySizeBytes;
+    if (length > maxBodySizeBytes) {
+      throw new TypeError(`Message body size exceeds the threshold, max size=${maxBodySizeBytes} bytes`);
+    }
+    // Generate message id.
+    this.messageId = MessageIdFactory.create().toString();
+    // Normal message.
+    if (!this.messageGroup && !this.deliveryTimestamp && !txEnabled) {
+      this.messageType = MessageType.NORMAL;
+      return;
+    }
+    // Fifo message.
+    if (this.messageGroup && !txEnabled) {
+      this.messageType = MessageType.FIFO;
+      return;
+    }
+    // Delay message.
+    if (this.deliveryTimestamp && !txEnabled) {
+      this.messageType = MessageType.DELAY;
+      return;
+    }
+    // Transaction message.
+    if (!this.messageGroup &&
+        !this.deliveryTimestamp && txEnabled) {
+      this.messageType = MessageType.TRANSACTION;
+      return;
+    }
+    // Transaction semantics is conflicted with fifo/delay.
+    throw new TypeError('Transactional message should not set messageGroup or deliveryTimestamp');
+  }
+
+  /**
+   * This method should be invoked before each message sending, because the born time is reset before each
+   * invocation, which means that it should not be invoked ahead of time.
+   */
+  toProtobuf(namespace: string, mq: MessageQueue) {
+    const systemProperties = new SystemProperties()
+      .setKeysList(this.keys)
+      .setMessageId(this.messageId)
+      .setBornTimestamp(Timestamp.fromDate(new Date()))
+      .setBornHost(UserAgent.INSTANCE.hostname)
+      .setBodyEncoding(Encoding.IDENTITY)
+      .setQueueId(mq.queueId)
+      .setMessageType(this.messageType);
+    if (this.tag) {
+      systemProperties.setTag(this.tag);
+    }
+    if (this.deliveryTimestamp) {
+      systemProperties.setDeliveryTimestamp(Timestamp.fromDate(this.deliveryTimestamp));
+    }
+    if (this.messageGroup) {
+      systemProperties.setMessageGroup(this.messageGroup);
+    }
+
+    const resource = createResource(this.topic);
+    resource.setResourceNamespace(namespace);
+    const message = new MessagePB()
+      .setTopic(resource)
+      .setBody(this.body)
+      .setSystemProperties(systemProperties);
+    if (this.properties) {
+      const userProperties = message.getUserPropertiesMap();
+      for (const [ key, value ] of this.properties.entries()) {
+        userProperties.set(key, value);
+      }
+    }
+    return message;
+  }
+}

package/src/message/index.ts

@@ -0,0 +1,21 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export * from './Message';
+export * from './MessageId';
+export * from './MessageView';
+export * from './PublishingMessage';