From 7c670317877d2b1b35540819dd59678a706d3a83 Mon Sep 17 00:00:00 2001
From: Sean Zellmer <sean@lejeunerenard.com>
Date: Mon, 14 Apr 2025 12:29:02 -0500
Subject: [PATCH] Update Mobile guide with numeric `bare-rpc` commands (#181)

`bare-rpc` updated in `0.2.0` to take numbers as commands instead of
strings.
---
 guide/making-a-bare-mobile-app.md | 28 ++++++++++++++++++++++------
 1 file changed, 22 insertions(+), 6 deletions(-)

diff --git a/guide/making-a-bare-mobile-app.md b/guide/making-a-bare-mobile-app.md
index b882133..dfcc535 100644
--- a/guide/making-a-bare-mobile-app.md
+++ b/guide/making-a-bare-mobile-app.md
@@ -52,6 +52,13 @@ touch backend/backend.mjs
 
 Our React Native UI code will go in the existing `app/index.tsx` file.
 
+Finally we will use an RPC to communicate between React Native and the Pear-end.
+To define a common set of command ids we create a `rpc-commands.mjs`.
+
+```bash
+touch rpc-commands.mjs
+```
+
 ## Building the Application
 
 ### Building the UI
@@ -77,6 +84,7 @@ import { Worklet } from 'react-native-bare-kit'
 import bundle from './app.bundle'
 import RPC from 'bare-rpc'
 import b4a from 'b4a'
+import { RPC_RESET, RPC_MESSAGE } from '../rpc-commands.mjs'
 
 type PasswordEntry = {
   username: string
@@ -99,7 +107,7 @@ export default function App() {
     new RPC(IPC, (req) => {
       // Handle incoming RPC requests
 
-      if (req.command === 'message') {
+      if (req.command === RPC_MESSAGE) {
         const data = b4a.toString(req.data)
         const parsedData = JSON.parse(data) // Assuming data is a JSON string
         const entry: PasswordEntry = {
@@ -111,7 +119,7 @@ export default function App() {
         setDataList((prevDataList) => [...prevDataList, entry])
       }
 
-      if (req.command === 'reset') {
+      if (req.command === RPC_RESET) {
         setDataList(() => [])
       }
     })
@@ -202,6 +210,7 @@ Add the following code to `backend/backend.mjs`:
 
 import RPC from 'bare-rpc'
 import fs from 'bare-fs'
+import { RPC_RESET, RPC_MESSAGE } from '../rpc-commands.mjs'
 
 import Autopass from 'autopass'
 import Corestore from 'corestore'
@@ -232,20 +241,27 @@ const pass = await pair.finished()
 await pass.ready()
 
 pass.on('update', async (e) => {
-  const req = rpc.request('reset')
+  const req = rpc.request(RPC_RESET)
   req.send('data')
 
   for await (const data of pass.list()) {
     const value = JSON.parse(data.value)
 
     if (value[0] === 'password') {
-      const req = rpc.request('message')
+      const req = rpc.request(RPC_MESSAGE)
       req.send(JSON.stringify(value))
     }
   }
 })
 ```
 
+Finally define the RPC command enums in `rpc-commands.mjs`:
+
+```js
+export const RPC_RESET = 0
+export const RPC_MESSAGE = 1
+```
+
 ## Bundling the Pear-end
 
 Now we need to create a bundle with all of our Pear-end code, dependencies and references to native addon libraries so that Bare has everything it needs to run our code.
@@ -348,7 +364,7 @@ new RPC(IPC, (req) => {
 To that end, we create an RPC passing it the IPC stream and defining an `onrequest` callback for when a request is received from the other end.
 
 ```typescript
-if (req.command === 'message') {
+if (req.command === RPC_MESSAGE) {
   const data = b4a.toString(req.data)
   const parsedData = JSON.parse(data) // Assuming data is a JSON string
   // Use the parsedData...
@@ -383,7 +399,7 @@ const pair = Autopass.pair(new Corestore(path), invite)
 Start the pairing process with the other Autopass instance using the invite passed to the worklet. Checkout the `autopass` [README](https://github.com/holepunchto/autopass) to learn more.
 
 ```js
-const req = rpc.request('reset')
+const req = rpc.request(RPC_RESET)
 req.send('data')
 ```