Device2SMS Node.js SDK (End-to-End Encrypted SMS)

The official Node.js SDK for Device2SMS.

This SDK sends SMS messages through your paired Android devices using
end-to-end encryption (E2EE) powered by Google Tink.

To ensure cryptographic correctness and long-term support, the SDK uses
a bundled Java-based Tink CLI helper for message encryption.

---

🔐 What it does

- Accepts a Tink public keyset (Base64, binary format)
- Encrypts plaintext using HybridEncrypt
- Outputs Base64-encoded ciphertext to stdout
- Uses Google Tink (official Java implementation)

---

▶️ Usage

``bash
java -jar device2sms-tink-cli.jar <br /></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> <br /> <br /><h3 class="text-lg font-medium mt-4 mb-2">$3</h3> <br /> <br />| Argument | Description | <br />|--------|-------------| <br />| </code>publicKeysetB64<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> | Base64-encoded binary Tink public keyset | <br />| </code>aad<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> | Associated Authenticated Data (AAD) | <br />| </code>plaintext<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> | UTF-8 plaintext message | <br /> <br /><h3 class="text-lg font-medium mt-4 mb-2">$3</h3> <br /> <br />- Base64-encoded ciphertext (written to stdout) <br /> <br />--- <br /> <br /><h2 class="text-xl font-semibold mt-5 mb-3">🏗 Build</h2> <br /> <br /></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">bash <br />mvn clean package <br /></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> <br /> <br />The shaded JAR will be created at: <br /> <br /></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> <br />target/device2sms-tink-cli-0.1.0.jar <br /></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> <br /> <br />Copy this file into: <br /> <br /></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> <br />sdk/node/bin/device2sms-tink-cli.jar <br /></code>`` <br /> <br />--- <br /> <br /><h2 class="text-xl font-semibold mt-5 mb-3">🔐 Java Tink Encryption Helper</h2> <br /> <br />The Node.js SDK internally uses a <strong>small Java command-line tool</strong> <br />(bundled with the package) to perform encryption using <br /><strong>Google Tink Hybrid Encryption</strong>. <br /> <br />This ensures: <br />- Official, supported cryptography <br />- No reimplementation of crypto in JavaScript <br />- Full compatibility with Android (Tink-based) decryption <br /> <br />This tool is <strong>not intended for direct end-user use</strong>. <br /> <br />--- <br /> <br /><h2 class="text-xl font-semibold mt-5 mb-3">📦 Runtime requirements</h2> <br /> <br />- Java <strong>11 or newer</strong> <br />- No external configuration required <br />- No network access required at runtime <br /> <br />--- <br /> <br /><h2 class="text-xl font-semibold mt-5 mb-3">⚠️ Security notes</h2> <br /> <br />- Only <strong>public keys</strong> are accepted <br />- No private key material is handled <br />- No plaintext is written to disk <br />- Errors are written to stderr only <br /> <br />--- <br /> <br /><h2 class="text-xl font-semibold mt-5 mb-3">📄 License</h2> <br /> <br />This tool is licensed under the same license as the Device2SMS SDKs. <br /> <br />--- <br /> <br /><h2 class="text-xl font-semibold mt-5 mb-3">📚 Documentation & Support</h2> <br /> <br />- Homepage: https://device2sms.ie <br />- API reference: https://docs.device2sms.ie <br />- Support: support@device2sms.ie <br /> <br /></p></div><div class="flex justify-center absolute inset-x-0 bottom-0 bg-gradient-to-t from-background via-background to-transparent pb-4 pt-16"><button data-slot="button" class="inline-flex items-center justify-center whitespace-nowrap text-sm font-medium transition-all disabled:pointer-events-none disabled:opacity-50 [&amp;_svg]:pointer-events-none [&amp;_svg:not([class*=&#x27;size-&#x27;])]:size-4 shrink-0 [&amp;_svg]:shrink-0 outline-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive border bg-background shadow-xs hover:bg-accent hover:text-accent-foreground dark:bg-input/30 dark:border-input dark:hover:bg-input/50 h-8 rounded-md gap-1.5 px-3 has-[&gt;svg]:px-2.5"><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-down mr-1 h-4 w-4"><path d="m6 9 6 6 6-6"></path></svg>Show more</button></div></div></div><div data-state="inactive" data-orientation="horizontal" role="tabpanel" aria-labelledby="radix-_R_aav5ubrb_-trigger-dependencies" hidden="" id="radix-_R_aav5ubrb_-content-dependencies" tabindex="0" data-slot="tabs-content" class="flex-1 outline-none mt-6"></div><template id="P:3"></template></div></div></div><div hidden id="S:3"><div data-state="inactive" data-orientation="horizontal" role="tabpanel" aria-labelledby="radix-_R_aav5ubrb_-trigger-versions" hidden="" id="radix-_R_aav5ubrb_-content-versions" tabindex="0" data-slot="tabs-content" class="flex-1 outline-none mt-6"></div></div><script>$RS=function(a,b){a=document.getElementById(a);b=document.getElementById(b);for(a.parentNode.removeChild(a);a.firstChild;)b.parentNode.insertBefore(a.firstChild,b);b.parentNode.removeChild(b)};$RS("S:3","P:3")</script><script>$RC("B:1","S:1")</script></body></html>