node-red-contrib-meshtastic-advanced 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Node-RED Meshtastic Advanced Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,258 @@
+# node-red-contrib-meshtastic-advanced
+
+Advanced Node-RED nodes for Meshtastic message encoding, decoding, encryption, and decryption.
+
+## Features
+
+- ✅ **Full Encryption Support**: Both channel (PSK) and direct message (PKC) encryption
+- ✅ **All Message Types**: Supports all Meshtastic message types (TEXT, POSITION, TELEMETRY, etc.)
+- ✅ **Modern Architecture**: TypeScript-based with proper error handling
+- ✅ **Secure Key Storage**: Uses Node-RED credentials API for encrypted key storage
+- ✅ **Flexible Design**: Modular nodes that can be chained for custom workflows
+
+## Installation
+
+```bash
+npm install node-red-contrib-meshtastic-advanced
+```
+
+Or install directly in Node-RED:
+1. Go to Menu → Manage palette
+2. Select the Install tab
+3. Search for `node-red-contrib-meshtastic-advanced`
+4. Click Install
+
+## Nodes
+
+### 🔓 meshtastic-decrypt
+
+Decrypts encrypted Meshtastic packets using either:
+- **Channel encryption (PSK)**: AES-128/256-CTR with pre-shared key
+- **Direct message encryption (PKC)**: x25519 + AES-256-CCM
+
+**Configuration:**
+- **Mode**: Auto-detect, Channel (PSK), or Direct Message (PKC)
+- **Channel Key**: Pre-shared key for channel decryption (16 or 32 bytes)
+- **Private Key**: Your x25519 private key for DM decryption
+- **Public Keys**: JSON mapping of sender node numbers to public keys
+
+**Input:** Binary ServiceEnvelope with encrypted packet
+
+**Output:** ServiceEnvelope with decrypted payload
+
+### 📖 meshtastic-decode
+
+Decodes Meshtastic protobuf payloads to readable JSON.
+
+**Configuration:**
+- **Output Format**: Flat (all fields at top level) or Nested (organized structure)
+- **Include Raw**: Optionally include raw protobuf bytes
+
+**Input:** ServiceEnvelope (binary or object) with decoded payload
+
+**Output:** JSON object with decoded message content
+
+**Supported Message Types:**
+- TEXT_MESSAGE_APP
+- POSITION_APP
+- NODEINFO_APP
+- TELEMETRY_APP
+- ROUTING_APP
+- ADMIN_APP
+- WAYPOINT_APP
+- NEIGHBORINFO_APP
+- TRACEROUTE_APP
+- And more...
+
+### ✏️ meshtastic-encode
+
+Encodes JSON messages to Meshtastic protobuf format.
+
+**Configuration:**
+- **Default To**: Destination node (default: broadcast 0xFFFFFFFF)
+- **Default Channel**: Channel index 0-7 (default: 0)
+- **Default Hop Limit**: Max hops 0-7 (default: 3)
+- **Output Type**: ServiceEnvelope (full packet) or Data only
+- **Output Format**: Object or Buffer
+
+**Input Example:**
+```json
+{
+  "portNum": "TEXT_MESSAGE_APP",
+  "message": "Hello, mesh!",
+  "to": 123456,
+  "channel": 0,
+  "wantAck": false
+}
+```
+
+### 🔒 meshtastic-encrypt
+
+Encrypts Meshtastic payloads using channel PSK or direct message PKC.
+
+**Configuration:**
+- **Mode**: Channel (PSK) or Direct Message (PKC)
+- **From Node**: Source node number
+- **Channel Key**: Pre-shared key for channel encryption
+- **My Private Key**: Your x25519 private key for DM encryption
+- **Recipient Public Key**: Recipient's x25519 public key
+
+**Input:** Data protobuf or ServiceEnvelope
+
+**Output:** Encrypted ServiceEnvelope
+
+## Example Flows
+
+### Receive and Decode Encrypted Messages
+
+```
+[MQTT In] → [meshtastic-decrypt] → [meshtastic-decode] → [Debug]
+```
+
+1. Subscribe to MQTT topic for incoming Meshtastic messages
+2. Decrypt using channel key
+3. Decode to readable JSON
+4. Display in debug panel
+
+### Send Encrypted Text Messages
+
+```
+[Inject] → [meshtastic-encode] → [meshtastic-encrypt] → [MQTT Out]
+```
+
+1. Create message payload
+2. Encode to protobuf
+3. Encrypt with channel key
+4. Publish to MQTT
+
+### Multi-Channel Monitoring
+
+```
+[MQTT In] → [Switch] → [meshtastic-decrypt (ch 0)]
+                     → [meshtastic-decrypt (ch 1)]
+                     → [meshtastic-decrypt (ch 2)]
+```
+
+Monitor multiple channels with different encryption keys.
+
+## Security Considerations
+
+### Default Key Warning
+
+⚠️ **The default Meshtastic channel key is `AQ==` (base64) which is INSECURE.**
+
+Always configure a secure channel key. The nodes will warn you if you use the default key.
+
+### Key Storage
+
+All encryption keys are stored using Node-RED's credentials system, which encrypts them at rest. Keys are never exported in flow JSON files.
+
+### Supported Key Formats
+
+- **Base64**: Standard base64 encoding (e.g., `AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=`)
+- **Hex**: Hexadecimal encoding (e.g., `0000000000000000000000000000000000000000000000000000000000000000`)
+
+### Key Lengths
+
+- **Channel PSK**: 16 bytes (AES-128) or 32 bytes (AES-256)
+- **x25519 Keys**: 32 bytes
+
+## Encryption Details
+
+### Channel Encryption (PSK + AES-CTR)
+
+Meshtastic uses AES-CTR for channel encryption with a nonce constructed from:
+- Node number (from field): 32 bits
+- Packet ID: 32 bits
+- Counter: Increments per 16-byte block
+
+### Direct Message Encryption (PKC + AES-CCM)
+
+For v2.5+ direct messages:
+1. Each node has an x25519 key pair
+2. Shared secret derived using ECDH
+3. Messages encrypted with AES-256-CCM (provides authentication)
+4. Random nonce per message
+
+## Development
+
+### Build
+
+```bash
+npm install
+npm run build
+```
+
+### Run Tests
+
+```bash
+npm test
+```
+
+### Local Development
+
+```bash
+# Link to local Node-RED
+cd ~/.node-red
+npm link /path/to/node-red-contrib-meshtastic-advanced
+
+# Watch mode
+npm run dev
+```
+
+## Troubleshooting
+
+### "Packet is still encrypted" error
+
+Make sure you use the **meshtastic-decrypt** node before the decode node. The decode node only works with already-decrypted packets.
+
+### "Channel decryption requires a channelKey" error
+
+Configure the channel key in the decrypt node settings. Make sure it matches the key used by your Meshtastic devices.
+
+### "No public key found for sender" error
+
+For DM decryption, you need to configure the sender's public key in the decrypt node's "Public Keys" field.
+
+### "Invalid key length" error
+
+Check that your keys are the correct length:
+- Channel keys: 16 bytes (AES-128) or 32 bytes (AES-256)
+- x25519 keys: 32 bytes
+
+## Migration from Old Plugin
+
+The old `@meshtastic/node-red-contrib-meshtastic` plugin had limited functionality:
+- Only had a decode node (no decrypt, encode, or encrypt)
+- Decrypt node was non-functional
+- No PKC/DM support
+
+This new plugin is a complete rewrite with full functionality.
+
+### Migration Steps
+
+1. Uninstall old plugin: `npm uninstall @meshtastic/node-red-contrib-meshtastic`
+2. Install new plugin: `npm install node-red-contrib-meshtastic-advanced`
+3. Update flows to use new node names (meshtastic-decrypt, meshtastic-decode, etc.)
+4. Configure encryption keys in decrypt/encrypt nodes
+
+## References
+
+- [Meshtastic Official Site](https://meshtastic.org/)
+- [Meshtastic Encryption Docs](https://meshtastic.org/docs/overview/encryption/)
+- [Meshtastic Protobufs](https://github.com/meshtastic/protobufs)
+- [Node-RED Documentation](https://nodered.org/docs/)
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions are welcome! Please open an issue or pull request on GitHub.
+
+## Acknowledgments
+
+- [Meshtastic Project](https://github.com/meshtastic) for the amazing mesh networking platform
+- [@noble/curves](https://github.com/paulmillr/noble-curves) for x25519 implementation
+- Node-RED community for the excellent flow-based programming tool

package/dist/decoder-BvBAtm2U.js

@@ -0,0 +1,166 @@
+"use strict";
+const protobufs = require("@meshtastic/protobufs");
+class MeshtasticError extends Error {
+  constructor(message, cause) {
+    super(message);
+    this.cause = cause;
+    this.name = "MeshtasticError";
+    if (cause) {
+      this.stack = `${this.stack}
+Caused by: ${cause.stack}`;
+    }
+  }
+}
+class MeshtasticDecryptError extends MeshtasticError {
+  constructor(message, cause) {
+    super(message, cause);
+    this.name = "MeshtasticDecryptError";
+  }
+}
+class MeshtasticDecodeError extends MeshtasticError {
+  constructor(message, cause) {
+    super(message, cause);
+    this.name = "MeshtasticDecodeError";
+  }
+}
+class MeshtasticEncodeError extends MeshtasticError {
+  constructor(message, cause) {
+    super(message, cause);
+    this.name = "MeshtasticEncodeError";
+  }
+}
+class MeshtasticEncryptError extends MeshtasticError {
+  constructor(message, cause) {
+    super(message, cause);
+    this.name = "MeshtasticEncryptError";
+  }
+}
+class InvalidKeyError extends MeshtasticError {
+  constructor(message) {
+    super(message);
+    this.name = "InvalidKeyError";
+  }
+}
+class InvalidNonceError extends MeshtasticError {
+  constructor(message) {
+    super(message);
+    this.name = "InvalidNonceError";
+  }
+}
+class ProtobufError extends MeshtasticError {
+  constructor(message, cause) {
+    super(message, cause);
+    this.name = "ProtobufError";
+  }
+}
+function ensureBuffer(input) {
+  if (Buffer.isBuffer(input)) {
+    return input;
+  }
+  return Buffer.from(input);
+}
+function ensureUint8Array(input) {
+  if (input instanceof Uint8Array && !(input instanceof Buffer)) {
+    return input;
+  }
+  return new Uint8Array(input);
+}
+function decodeServiceEnvelope(buffer) {
+  try {
+    const uint8 = ensureUint8Array(buffer);
+    return protobufs.Protobuf.Mqtt.ServiceEnvelope.fromBinary(uint8);
+  } catch (error) {
+    throw new ProtobufError(
+      `Failed to decode ServiceEnvelope: ${error instanceof Error ? error.message : String(error)}`,
+      error instanceof Error ? error : void 0
+    );
+  }
+}
+function decodeData(buffer) {
+  try {
+    const uint8 = ensureUint8Array(buffer);
+    return protobufs.Protobuf.Mesh.Data.fromBinary(uint8);
+  } catch (error) {
+    throw new ProtobufError(
+      `Failed to decode Data: ${error instanceof Error ? error.message : String(error)}`,
+      error instanceof Error ? error : void 0
+    );
+  }
+}
+function decodeMessageByPortNum(portNum, payload) {
+  try {
+    const uint8 = ensureUint8Array(payload);
+    switch (portNum) {
+      case protobufs.Protobuf.Portnums.PortNum.TEXT_MESSAGE_APP:
+        return new TextDecoder().decode(uint8);
+      case protobufs.Protobuf.Portnums.PortNum.POSITION_APP:
+        return protobufs.Protobuf.Mesh.Position.fromBinary(uint8);
+      case protobufs.Protobuf.Portnums.PortNum.NODEINFO_APP:
+        return protobufs.Protobuf.Mesh.User.fromBinary(uint8);
+      case protobufs.Protobuf.Portnums.PortNum.TELEMETRY_APP:
+        return protobufs.Protobuf.Telemetry.Telemetry.fromBinary(uint8);
+      case protobufs.Protobuf.Portnums.PortNum.ROUTING_APP:
+        return protobufs.Protobuf.Mesh.Routing.fromBinary(uint8);
+      case protobufs.Protobuf.Portnums.PortNum.ADMIN_APP:
+        return protobufs.Protobuf.Admin.AdminMessage.fromBinary(uint8);
+      case protobufs.Protobuf.Portnums.PortNum.WAYPOINT_APP:
+        return protobufs.Protobuf.Mesh.Waypoint.fromBinary(uint8);
+      case protobufs.Protobuf.Portnums.PortNum.NEIGHBORINFO_APP:
+        return protobufs.Protobuf.Mesh.NeighborInfo.fromBinary(uint8);
+      case protobufs.Protobuf.Portnums.PortNum.STORE_FORWARD_APP:
+        return protobufs.Protobuf.StoreForward.StoreAndForward.fromBinary(uint8);
+      case protobufs.Protobuf.Portnums.PortNum.RANGE_TEST_APP:
+        return new TextDecoder("ascii").decode(uint8);
+      case protobufs.Protobuf.Portnums.PortNum.REMOTE_HARDWARE_APP:
+        return protobufs.Protobuf.RemoteHardware.HardwareMessage.fromBinary(uint8);
+      case protobufs.Protobuf.Portnums.PortNum.DETECTION_SENSOR_APP:
+        return new TextDecoder().decode(uint8);
+      case protobufs.Protobuf.Portnums.PortNum.REPLY_APP:
+        return new TextDecoder("ascii").decode(uint8);
+      case protobufs.Protobuf.Portnums.PortNum.TRACEROUTE_APP:
+        return protobufs.Protobuf.Mesh.RouteDiscovery.fromBinary(uint8);
+      case protobufs.Protobuf.Portnums.PortNum.PAXCOUNTER_APP:
+        return protobufs.Protobuf.Paxcount.Paxcount.fromBinary(uint8);
+      case protobufs.Protobuf.Portnums.PortNum.MAP_REPORT_APP:
+        return protobufs.Protobuf.Mqtt.MapReport.fromBinary(uint8);
+      case protobufs.Protobuf.Portnums.PortNum.UNKNOWN_APP:
+      case protobufs.Protobuf.Portnums.PortNum.IP_TUNNEL_APP:
+      case protobufs.Protobuf.Portnums.PortNum.SERIAL_APP:
+      case protobufs.Protobuf.Portnums.PortNum.AUDIO_APP:
+      case protobufs.Protobuf.Portnums.PortNum.ZPS_APP:
+      case protobufs.Protobuf.Portnums.PortNum.SIMULATOR_APP:
+      case protobufs.Protobuf.Portnums.PortNum.PRIVATE_APP:
+      case protobufs.Protobuf.Portnums.PortNum.ATAK_FORWARDER:
+      case protobufs.Protobuf.Portnums.PortNum.TEXT_MESSAGE_COMPRESSED_APP:
+      default:
+        return {
+          raw: Buffer.from(uint8),
+          portNum,
+          note: `Unsupported or binary message type: ${getPortNumName(portNum)}`
+        };
+    }
+  } catch (error) {
+    throw new MeshtasticDecodeError(
+      `Failed to decode message for portNum ${portNum}: ${error instanceof Error ? error.message : String(error)}`,
+      error instanceof Error ? error : void 0
+    );
+  }
+}
+function getPortNumName(portNum) {
+  const name = protobufs.Protobuf.Portnums.PortNum[portNum];
+  return name || `UNKNOWN(${portNum})`;
+}
+exports.InvalidKeyError = InvalidKeyError;
+exports.InvalidNonceError = InvalidNonceError;
+exports.MeshtasticDecodeError = MeshtasticDecodeError;
+exports.MeshtasticDecryptError = MeshtasticDecryptError;
+exports.MeshtasticEncodeError = MeshtasticEncodeError;
+exports.MeshtasticEncryptError = MeshtasticEncryptError;
+exports.MeshtasticError = MeshtasticError;
+exports.ProtobufError = ProtobufError;
+exports.decodeData = decodeData;
+exports.decodeMessageByPortNum = decodeMessageByPortNum;
+exports.decodeServiceEnvelope = decodeServiceEnvelope;
+exports.ensureBuffer = ensureBuffer;
+exports.getPortNumName = getPortNumName;
+//# sourceMappingURL=decoder-BvBAtm2U.js.map

package/dist/decoder-BvBAtm2U.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoder-BvBAtm2U.js","sources":["../src/lib/utils/error-types.ts","../src/lib/utils/buffer-utils.ts","../src/lib/protobuf/decoder.ts"],"sourcesContent":["/**\n * Custom error types for Meshtastic operations\n */\n\nexport class MeshtasticError extends Error {\n  constructor(message: string, public cause?: Error) {\n    super(message);\n    this.name = 'MeshtasticError';\n    if (cause) {\n      this.stack = `${this.stack}\\nCaused by: ${cause.stack}`;\n    }\n  }\n}\n\nexport class MeshtasticDecryptError extends MeshtasticError {\n  constructor(message: string, cause?: Error) {\n    super(message, cause);\n    this.name = 'MeshtasticDecryptError';\n  }\n}\n\nexport class MeshtasticDecodeError extends MeshtasticError {\n  constructor(message: string, cause?: Error) {\n    super(message, cause);\n    this.name = 'MeshtasticDecodeError';\n  }\n}\n\nexport class MeshtasticEncodeError extends MeshtasticError {\n  constructor(message: string, cause?: Error) {\n    super(message, cause);\n    this.name = 'MeshtasticEncodeError';\n  }\n}\n\nexport class MeshtasticEncryptError extends MeshtasticError {\n  constructor(message: string, cause?: Error) {\n    super(message, cause);\n    this.name = 'MeshtasticEncryptError';\n  }\n}\n\nexport class InvalidKeyError extends MeshtasticError {\n  constructor(message: string) {\n    super(message);\n    this.name = 'InvalidKeyError';\n  }\n}\n\nexport class InvalidNonceError extends MeshtasticError {\n  constructor(message: string) {\n    super(message);\n    this.name = 'InvalidNonceError';\n  }\n}\n\nexport class ProtobufError extends MeshtasticError {\n  constructor(message: string, cause?: Error) {\n    super(message, cause);\n    this.name = 'ProtobufError';\n  }\n}\n","/**\n * Buffer manipulation utilities\n */\n\n/**\n * Convert a Uint8Array to Buffer\n * @param uint8Array - Uint8Array to convert\n * @returns Buffer\n */\nexport function uint8ArrayToBuffer(uint8Array: Uint8Array): Buffer {\n  return Buffer.from(uint8Array);\n}\n\n/**\n * Convert a Buffer to Uint8Array\n * @param buffer - Buffer to convert\n * @returns Uint8Array\n */\nexport function bufferToUint8Array(buffer: Buffer): Uint8Array {\n  return new Uint8Array(buffer);\n}\n\n/**\n * Check if input is a Buffer or Uint8Array\n * @param input - Input to check\n * @returns true if input is Buffer or Uint8Array\n */\nexport function isBufferLike(input: any): input is Buffer | Uint8Array {\n  return Buffer.isBuffer(input) || input instanceof Uint8Array;\n}\n\n/**\n * Ensure input is a Buffer (convert if needed)\n * @param input - Buffer or Uint8Array\n * @returns Buffer\n */\nexport function ensureBuffer(input: Buffer | Uint8Array): Buffer {\n  if (Buffer.isBuffer(input)) {\n    return input;\n  }\n  return Buffer.from(input);\n}\n\n/**\n * Ensure input is a Uint8Array (convert if needed)\n * @param input - Buffer or Uint8Array\n * @returns Uint8Array\n */\nexport function ensureUint8Array(input: Buffer | Uint8Array): Uint8Array {\n  if (input instanceof Uint8Array && !(input instanceof Buffer)) {\n    return input;\n  }\n  return new Uint8Array(input);\n}\n\n/**\n * Convert a hex string to Buffer\n * @param hex - Hex string\n * @returns Buffer\n */\nexport function hexToBuffer(hex: string): Buffer {\n  return Buffer.from(hex, 'hex');\n}\n\n/**\n * Convert a base64 string to Buffer\n * @param base64 - Base64 string\n * @returns Buffer\n */\nexport function base64ToBuffer(base64: string): Buffer {\n  return Buffer.from(base64, 'base64');\n}\n\n/**\n * Convert a Buffer to hex string\n * @param buffer - Buffer\n * @returns Hex string\n */\nexport function bufferToHex(buffer: Buffer): string {\n  return buffer.toString('hex');\n}\n\n/**\n * Convert a Buffer to base64 string\n * @param buffer - Buffer\n * @returns Base64 string\n */\nexport function bufferToBase64(buffer: Buffer): string {\n  return buffer.toString('base64');\n}\n\n/**\n * Check if two buffers are equal\n * @param a - First buffer\n * @param b - Second buffer\n * @returns true if buffers are equal\n */\nexport function buffersEqual(a: Buffer, b: Buffer): boolean {\n  return a.equals(b);\n}\n","/**\n * Protobuf decoding utilities for Meshtastic messages\n */\n\nimport { Protobuf } from '@meshtastic/protobufs';\nimport { ProtobufError, MeshtasticDecodeError } from '../utils/error-types';\nimport { ensureUint8Array } from '../utils/buffer-utils';\n\n/**\n * Decode a ServiceEnvelope from binary data\n * @param buffer - Binary data containing ServiceEnvelope\n * @returns Decoded ServiceEnvelope\n * @throws {ProtobufError} If decoding fails\n */\nexport function decodeServiceEnvelope(buffer: Buffer | Uint8Array): Protobuf.Mqtt.ServiceEnvelope {\n  try {\n    const uint8 = ensureUint8Array(buffer);\n    return Protobuf.Mqtt.ServiceEnvelope.fromBinary(uint8);\n  } catch (error) {\n    throw new ProtobufError(\n      `Failed to decode ServiceEnvelope: ${error instanceof Error ? error.message : String(error)}`,\n      error instanceof Error ? error : undefined\n    );\n  }\n}\n\n/**\n * Decode a Data protobuf from binary data\n * @param buffer - Binary data containing Data message\n * @returns Decoded Data\n * @throws {ProtobufError} If decoding fails\n */\nexport function decodeData(buffer: Buffer | Uint8Array): Protobuf.Mesh.Data {\n  try {\n    const uint8 = ensureUint8Array(buffer);\n    return Protobuf.Mesh.Data.fromBinary(uint8);\n  } catch (error) {\n    throw new ProtobufError(\n      `Failed to decode Data: ${error instanceof Error ? error.message : String(error)}`,\n      error instanceof Error ? error : undefined\n    );\n  }\n}\n\n/**\n * Decode a message payload based on its port number\n * @param portNum - Port number (message type)\n * @param payload - Binary payload data\n * @returns Decoded message (type depends on portNum)\n * @throws {MeshtasticDecodeError} If decoding fails\n */\nexport function decodeMessageByPortNum(\n  portNum: Protobuf.Portnums.PortNum | number,\n  payload: Uint8Array | Buffer\n): any {\n  try {\n    const uint8 = ensureUint8Array(payload);\n\n    switch (portNum) {\n      case Protobuf.Portnums.PortNum.TEXT_MESSAGE_APP:\n        return new TextDecoder().decode(uint8);\n\n      case Protobuf.Portnums.PortNum.POSITION_APP:\n        return Protobuf.Mesh.Position.fromBinary(uint8);\n\n      case Protobuf.Portnums.PortNum.NODEINFO_APP:\n        return Protobuf.Mesh.User.fromBinary(uint8);\n\n      case Protobuf.Portnums.PortNum.TELEMETRY_APP:\n        return Protobuf.Telemetry.Telemetry.fromBinary(uint8);\n\n      case Protobuf.Portnums.PortNum.ROUTING_APP:\n        return Protobuf.Mesh.Routing.fromBinary(uint8);\n\n      case Protobuf.Portnums.PortNum.ADMIN_APP:\n        return Protobuf.Admin.AdminMessage.fromBinary(uint8);\n\n      case Protobuf.Portnums.PortNum.WAYPOINT_APP:\n        return Protobuf.Mesh.Waypoint.fromBinary(uint8);\n\n      case Protobuf.Portnums.PortNum.NEIGHBORINFO_APP:\n        return Protobuf.Mesh.NeighborInfo.fromBinary(uint8);\n\n      case Protobuf.Portnums.PortNum.STORE_FORWARD_APP:\n        return Protobuf.StoreForward.StoreAndForward.fromBinary(uint8);\n\n      case Protobuf.Portnums.PortNum.RANGE_TEST_APP:\n        return new TextDecoder('ascii').decode(uint8);\n\n      case Protobuf.Portnums.PortNum.REMOTE_HARDWARE_APP:\n        return Protobuf.RemoteHardware.HardwareMessage.fromBinary(uint8);\n\n      case Protobuf.Portnums.PortNum.DETECTION_SENSOR_APP:\n        return new TextDecoder().decode(uint8);\n\n      case Protobuf.Portnums.PortNum.REPLY_APP:\n        return new TextDecoder('ascii').decode(uint8);\n\n      case Protobuf.Portnums.PortNum.TRACEROUTE_APP:\n        return Protobuf.Mesh.RouteDiscovery.fromBinary(uint8);\n\n      case Protobuf.Portnums.PortNum.PAXCOUNTER_APP:\n        return Protobuf.Paxcount.Paxcount.fromBinary(uint8);\n\n      case Protobuf.Portnums.PortNum.MAP_REPORT_APP:\n        return Protobuf.Mqtt.MapReport.fromBinary(uint8);\n\n      // For unknown or unsupported message types, return raw bytes\n      case Protobuf.Portnums.PortNum.UNKNOWN_APP:\n      case Protobuf.Portnums.PortNum.IP_TUNNEL_APP:\n      case Protobuf.Portnums.PortNum.SERIAL_APP:\n      case Protobuf.Portnums.PortNum.AUDIO_APP:\n      case Protobuf.Portnums.PortNum.ZPS_APP:\n      case Protobuf.Portnums.PortNum.SIMULATOR_APP:\n      case Protobuf.Portnums.PortNum.PRIVATE_APP:\n      case Protobuf.Portnums.PortNum.ATAK_FORWARDER:\n      case Protobuf.Portnums.PortNum.TEXT_MESSAGE_COMPRESSED_APP:\n      default:\n        return {\n          raw: Buffer.from(uint8),\n          portNum,\n          note: `Unsupported or binary message type: ${getPortNumName(portNum)}`\n        };\n    }\n  } catch (error) {\n    throw new MeshtasticDecodeError(\n      `Failed to decode message for portNum ${portNum}: ${error instanceof Error ? error.message : String(error)}`,\n      error instanceof Error ? error : undefined\n    );\n  }\n}\n\n/**\n * Get the name of a port number\n * @param portNum - Port number\n * @returns Port number name (e.g., \"TEXT_MESSAGE_APP\")\n */\nexport function getPortNumName(portNum: Protobuf.Portnums.PortNum | number): string {\n  const name = Protobuf.Portnums.PortNum[portNum];\n  return name || `UNKNOWN(${portNum})`;\n}\n\n/**\n * Format a ServiceEnvelope as a JSON object for output\n * @param envelope - ServiceEnvelope to format\n * @param decodePayload - Whether to decode the payload (default: true)\n * @returns Formatted JSON object\n */\nexport function formatServiceEnvelopeAsJson(\n  envelope: Protobuf.Mqtt.ServiceEnvelope,\n  decodePayload: boolean = true\n): any {\n  const packet = envelope.packet;\n\n  if (!packet) {\n    return {\n      channelId: envelope.channelId,\n      gatewayId: envelope.gatewayId,\n      error: 'No packet in ServiceEnvelope'\n    };\n  }\n\n  const result: any = {\n    channelId: envelope.channelId,\n    gatewayId: envelope.gatewayId,\n    from: packet.from,\n    to: packet.to,\n    channel: packet.channel,\n    packetId: packet.id,\n    rxTime: packet.rxTime,\n    rxSnr: packet.rxSnr,\n    rxRssi: packet.rxRssi,\n    hopLimit: packet.hopLimit,\n    wantAck: packet.wantAck,\n    priority: packet.priority,\n    hopStart: packet.hopStart,\n  };\n\n  // Handle payload based on variant type\n  if (packet.payloadVariant.case === 'encrypted') {\n    result.encrypted = true;\n    result.encryptedData = Buffer.from(packet.payloadVariant.value).toString('base64');\n  } else if (packet.payloadVariant.case === 'decoded') {\n    const decoded = packet.payloadVariant.value;\n    result.encrypted = false;\n    result.portNum = getPortNumName(decoded.portnum);\n    result.portNumValue = decoded.portnum;\n    result.wantResponse = decoded.wantResponse;\n    result.requestId = decoded.requestId;\n    result.emoji = decoded.emoji;\n\n    if (decodePayload && decoded.payload && decoded.payload.length > 0) {\n      try {\n        result.payload = decodeMessageByPortNum(decoded.portnum, decoded.payload);\n      } catch (error) {\n        result.payload = {\n          raw: Buffer.from(decoded.payload).toString('base64'),\n          error: error instanceof Error ? error.message : String(error)\n        };\n      }\n    } else {\n      result.payload = decoded.payload ? Buffer.from(decoded.payload).toString('base64') : null;\n    }\n  }\n\n  return result;\n}\n"],"names":["Protobuf"],"mappings":"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"}

package/dist/encoder-DU3wTIEA.js

@@ -0,0 +1,126 @@
+"use strict";
+const protobufs = require("@meshtastic/protobufs");
+const decoder = require("./decoder-BvBAtm2U.js");
+function encodeMessageByPortNum(portNum, message) {
+  try {
+    switch (portNum) {
+      case protobufs.Protobuf.Portnums.PortNum.TEXT_MESSAGE_APP:
+        if (typeof message !== "string") {
+          throw new Error("TEXT_MESSAGE_APP requires a string message");
+        }
+        return new TextEncoder().encode(message);
+      case protobufs.Protobuf.Portnums.PortNum.POSITION_APP:
+        return protobufs.Protobuf.Mesh.Position.toBinary(message);
+      case protobufs.Protobuf.Portnums.PortNum.NODEINFO_APP:
+        return protobufs.Protobuf.Mesh.User.toBinary(message);
+      case protobufs.Protobuf.Portnums.PortNum.TELEMETRY_APP:
+        return protobufs.Protobuf.Telemetry.Telemetry.toBinary(message);
+      case protobufs.Protobuf.Portnums.PortNum.ROUTING_APP:
+        return protobufs.Protobuf.Mesh.Routing.toBinary(message);
+      case protobufs.Protobuf.Portnums.PortNum.ADMIN_APP:
+        return protobufs.Protobuf.Admin.AdminMessage.toBinary(message);
+      case protobufs.Protobuf.Portnums.PortNum.WAYPOINT_APP:
+        return protobufs.Protobuf.Mesh.Waypoint.toBinary(message);
+      case protobufs.Protobuf.Portnums.PortNum.NEIGHBORINFO_APP:
+        return protobufs.Protobuf.Mesh.NeighborInfo.toBinary(message);
+      case protobufs.Protobuf.Portnums.PortNum.STORE_FORWARD_APP:
+        return protobufs.Protobuf.StoreForward.StoreAndForward.toBinary(message);
+      case protobufs.Protobuf.Portnums.PortNum.RANGE_TEST_APP:
+      case protobufs.Protobuf.Portnums.PortNum.DETECTION_SENSOR_APP:
+      case protobufs.Protobuf.Portnums.PortNum.REPLY_APP:
+        if (typeof message !== "string") {
+          throw new Error(`${portNum} requires a string message`);
+        }
+        return new TextEncoder().encode(message);
+      case protobufs.Protobuf.Portnums.PortNum.REMOTE_HARDWARE_APP:
+        return protobufs.Protobuf.RemoteHardware.HardwareMessage.toBinary(message);
+      case protobufs.Protobuf.Portnums.PortNum.TRACEROUTE_APP:
+        return protobufs.Protobuf.Mesh.RouteDiscovery.toBinary(message);
+      case protobufs.Protobuf.Portnums.PortNum.PAXCOUNTER_APP:
+        return protobufs.Protobuf.Paxcount.Paxcount.toBinary(message);
+      case protobufs.Protobuf.Portnums.PortNum.MAP_REPORT_APP:
+        return protobufs.Protobuf.Mqtt.MapReport.toBinary(message);
+      default:
+        throw new Error(`Encoding not supported for portNum: ${portNum}`);
+    }
+  } catch (error) {
+    throw new decoder.MeshtasticEncodeError(
+      `Failed to encode message for portNum ${portNum}: ${error instanceof Error ? error.message : String(error)}`,
+      error instanceof Error ? error : void 0
+    );
+  }
+}
+function createDataPayload(portNum, payload, options) {
+  return {
+    portnum: portNum,
+    payload,
+    wantResponse: (options == null ? void 0 : options.wantResponse) ?? false,
+    requestId: (options == null ? void 0 : options.requestId) ?? 0,
+    emoji: (options == null ? void 0 : options.emoji) ?? 0
+  };
+}
+function createServiceEnvelope(data, from, to = 4294967295, channel = 0, packetId, options) {
+  return {
+    packet: {
+      from,
+      to,
+      channel,
+      id: packetId ?? 0,
+      rxTime: 0,
+      rxSnr: 0,
+      rxRssi: 0,
+      hopLimit: (options == null ? void 0 : options.hopLimit) ?? 3,
+      wantAck: (options == null ? void 0 : options.wantAck) ?? false,
+      priority: (options == null ? void 0 : options.priority) ?? protobufs.Protobuf.Mesh.MeshPacket_Priority.UNSET,
+      hopStart: (options == null ? void 0 : options.hopLimit) ?? 3,
+      payloadVariant: {
+        case: "decoded",
+        value: data
+      }
+    },
+    channelId: (options == null ? void 0 : options.channelId) ?? "",
+    gatewayId: (options == null ? void 0 : options.gatewayId) ?? ""
+  };
+}
+function encodeServiceEnvelope(envelope) {
+  try {
+    const binary = protobufs.Protobuf.Mqtt.ServiceEnvelope.toBinary(envelope);
+    return decoder.ensureBuffer(binary);
+  } catch (error) {
+    throw new decoder.ProtobufError(
+      `Failed to encode ServiceEnvelope: ${error instanceof Error ? error.message : String(error)}`,
+      error instanceof Error ? error : void 0
+    );
+  }
+}
+function encodeData(data) {
+  try {
+    const binary = protobufs.Protobuf.Mesh.Data.toBinary(data);
+    return decoder.ensureBuffer(binary);
+  } catch (error) {
+    throw new decoder.ProtobufError(
+      `Failed to encode Data: ${error instanceof Error ? error.message : String(error)}`,
+      error instanceof Error ? error : void 0
+    );
+  }
+}
+function parsePortNum(portNum) {
+  if (typeof portNum === "number") {
+    if (portNum in protobufs.Protobuf.Portnums.PortNum) {
+      return portNum;
+    }
+    throw new decoder.MeshtasticEncodeError(`Invalid port number: ${portNum}`);
+  }
+  const enumValue = protobufs.Protobuf.Portnums.PortNum[portNum];
+  if (enumValue === void 0) {
+    throw new decoder.MeshtasticEncodeError(`Unknown port number name: ${portNum}`);
+  }
+  return enumValue;
+}
+exports.createDataPayload = createDataPayload;
+exports.createServiceEnvelope = createServiceEnvelope;
+exports.encodeData = encodeData;
+exports.encodeMessageByPortNum = encodeMessageByPortNum;
+exports.encodeServiceEnvelope = encodeServiceEnvelope;
+exports.parsePortNum = parsePortNum;
+//# sourceMappingURL=encoder-DU3wTIEA.js.map

package/dist/encoder-DU3wTIEA.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoder-DU3wTIEA.js","sources":["../src/lib/protobuf/encoder.ts"],"sourcesContent":["/**\n * Protobuf encoding utilities for Meshtastic messages\n */\n\nimport { Protobuf } from '@meshtastic/protobufs';\nimport { MeshtasticEncodeError, ProtobufError } from '../utils/error-types';\nimport { ensureBuffer } from '../utils/buffer-utils';\n\n/**\n * Encode a message payload based on its port number\n * @param portNum - Port number (message type)\n * @param message - Message data to encode\n * @returns Encoded binary payload\n * @throws {MeshtasticEncodeError} If encoding fails\n */\nexport function encodeMessageByPortNum(\n  portNum: Protobuf.Portnums.PortNum | number,\n  message: any\n): Uint8Array {\n  try {\n    switch (portNum) {\n      case Protobuf.Portnums.PortNum.TEXT_MESSAGE_APP:\n        // Encode string as UTF-8 bytes\n        if (typeof message !== 'string') {\n          throw new Error('TEXT_MESSAGE_APP requires a string message');\n        }\n        return new TextEncoder().encode(message);\n\n      case Protobuf.Portnums.PortNum.POSITION_APP:\n        return Protobuf.Mesh.Position.toBinary(message as Protobuf.Mesh.Position);\n\n      case Protobuf.Portnums.PortNum.NODEINFO_APP:\n        return Protobuf.Mesh.User.toBinary(message as Protobuf.Mesh.User);\n\n      case Protobuf.Portnums.PortNum.TELEMETRY_APP:\n        return Protobuf.Telemetry.Telemetry.toBinary(message as Protobuf.Telemetry.Telemetry);\n\n      case Protobuf.Portnums.PortNum.ROUTING_APP:\n        return Protobuf.Mesh.Routing.toBinary(message as Protobuf.Mesh.Routing);\n\n      case Protobuf.Portnums.PortNum.ADMIN_APP:\n        return Protobuf.Admin.AdminMessage.toBinary(message as Protobuf.Admin.AdminMessage);\n\n      case Protobuf.Portnums.PortNum.WAYPOINT_APP:\n        return Protobuf.Mesh.Waypoint.toBinary(message as Protobuf.Mesh.Waypoint);\n\n      case Protobuf.Portnums.PortNum.NEIGHBORINFO_APP:\n        return Protobuf.Mesh.NeighborInfo.toBinary(message as Protobuf.Mesh.NeighborInfo);\n\n      case Protobuf.Portnums.PortNum.STORE_FORWARD_APP:\n        return Protobuf.StoreForward.StoreAndForward.toBinary(message as Protobuf.StoreForward.StoreAndForward);\n\n      case Protobuf.Portnums.PortNum.RANGE_TEST_APP:\n      case Protobuf.Portnums.PortNum.DETECTION_SENSOR_APP:\n      case Protobuf.Portnums.PortNum.REPLY_APP:\n        // Encode string as ASCII/UTF-8 bytes\n        if (typeof message !== 'string') {\n          throw new Error(`${portNum} requires a string message`);\n        }\n        return new TextEncoder().encode(message);\n\n      case Protobuf.Portnums.PortNum.REMOTE_HARDWARE_APP:\n        return Protobuf.RemoteHardware.HardwareMessage.toBinary(message as Protobuf.RemoteHardware.HardwareMessage);\n\n      case Protobuf.Portnums.PortNum.TRACEROUTE_APP:\n        return Protobuf.Mesh.RouteDiscovery.toBinary(message as Protobuf.Mesh.RouteDiscovery);\n\n      case Protobuf.Portnums.PortNum.PAXCOUNTER_APP:\n        return Protobuf.Paxcount.Paxcount.toBinary(message as Protobuf.Paxcount.Paxcount);\n\n      case Protobuf.Portnums.PortNum.MAP_REPORT_APP:\n        return Protobuf.Mqtt.MapReport.toBinary(message as Protobuf.Mqtt.MapReport);\n\n      default:\n        throw new Error(`Encoding not supported for portNum: ${portNum}`);\n    }\n  } catch (error) {\n    throw new MeshtasticEncodeError(\n      `Failed to encode message for portNum ${portNum}: ${error instanceof Error ? error.message : String(error)}`,\n      error instanceof Error ? error : undefined\n    );\n  }\n}\n\n/**\n * Create a Data protobuf from encoded payload\n * @param portNum - Port number (message type)\n * @param payload - Encoded message payload\n * @param options - Additional options (wantResponse, requestId, emoji)\n * @returns Data protobuf\n */\nexport function createDataPayload(\n  portNum: Protobuf.Portnums.PortNum | number,\n  payload: Uint8Array,\n  options?: {\n    wantResponse?: boolean;\n    requestId?: number;\n    emoji?: number;\n  }\n): Protobuf.Mesh.Data {\n  return {\n    portnum: portNum as Protobuf.Portnums.PortNum,\n    payload,\n    wantResponse: options?.wantResponse ?? false,\n    requestId: options?.requestId ?? 0,\n    emoji: options?.emoji ?? 0,\n  };\n}\n\n/**\n * Create a ServiceEnvelope with a Data payload\n * @param data - Data protobuf\n * @param from - Source node number\n * @param to - Destination node number (0xFFFFFFFF for broadcast)\n * @param channel - Channel index\n * @param packetId - Packet ID (if undefined, needs to be set later)\n * @param options - Additional options\n * @returns ServiceEnvelope\n */\nexport function createServiceEnvelope(\n  data: Protobuf.Mesh.Data,\n  from: number,\n  to: number = 0xFFFFFFFF,\n  channel: number = 0,\n  packetId?: number,\n  options?: {\n    wantAck?: boolean;\n    hopLimit?: number;\n    priority?: Protobuf.Mesh.MeshPacket_Priority;\n    channelId?: string;\n    gatewayId?: string;\n  }\n): Protobuf.Mqtt.ServiceEnvelope {\n  return {\n    packet: {\n      from,\n      to,\n      channel,\n      id: packetId ?? 0,\n      rxTime: 0,\n      rxSnr: 0,\n      rxRssi: 0,\n      hopLimit: options?.hopLimit ?? 3,\n      wantAck: options?.wantAck ?? false,\n      priority: options?.priority ?? Protobuf.Mesh.MeshPacket_Priority.UNSET,\n      hopStart: options?.hopLimit ?? 3,\n      payloadVariant: {\n        case: 'decoded',\n        value: data,\n      },\n    },\n    channelId: options?.channelId ?? '',\n    gatewayId: options?.gatewayId ?? '',\n  };\n}\n\n/**\n * Encode a complete ServiceEnvelope to binary\n * @param envelope - ServiceEnvelope to encode\n * @returns Binary encoded ServiceEnvelope\n * @throws {ProtobufError} If encoding fails\n */\nexport function encodeServiceEnvelope(envelope: Protobuf.Mqtt.ServiceEnvelope): Buffer {\n  try {\n    const binary = Protobuf.Mqtt.ServiceEnvelope.toBinary(envelope);\n    return ensureBuffer(binary);\n  } catch (error) {\n    throw new ProtobufError(\n      `Failed to encode ServiceEnvelope: ${error instanceof Error ? error.message : String(error)}`,\n      error instanceof Error ? error : undefined\n    );\n  }\n}\n\n/**\n * Encode a Data protobuf to binary\n * @param data - Data protobuf to encode\n * @returns Binary encoded Data\n * @throws {ProtobufError} If encoding fails\n */\nexport function encodeData(data: Protobuf.Mesh.Data): Buffer {\n  try {\n    const binary = Protobuf.Mesh.Data.toBinary(data);\n    return ensureBuffer(binary);\n  } catch (error) {\n    throw new ProtobufError(\n      `Failed to encode Data: ${error instanceof Error ? error.message : String(error)}`,\n      error instanceof Error ? error : undefined\n    );\n  }\n}\n\n/**\n * Parse port number from string name or number\n * @param portNum - Port number as string name or number\n * @returns Port number as enum value\n * @throws {MeshtasticEncodeError} If port number is invalid\n */\nexport function parsePortNum(portNum: string | number): Protobuf.Portnums.PortNum {\n  if (typeof portNum === 'number') {\n    // Validate that the number is a valid PortNum\n    if (portNum in Protobuf.Portnums.PortNum) {\n      return portNum as Protobuf.Portnums.PortNum;\n    }\n    throw new MeshtasticEncodeError(`Invalid port number: ${portNum}`);\n  }\n\n  // Parse string name to enum value\n  const enumValue = (Protobuf.Portnums.PortNum as any)[portNum];\n  if (enumValue === undefined) {\n    throw new MeshtasticEncodeError(`Unknown port number name: ${portNum}`);\n  }\n\n  return enumValue;\n}\n"],"names":["Protobuf","MeshtasticEncodeError","ensureBuffer","ProtobufError"],"mappings":"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"}