[dev] Update instructions to run tests (#208)

We have for very long relied on folks relying on some form of production
infra to test this.

This change now allows folks to test this out with a local checkout of
goval.

Author: lhchavez

.semaphore/semaphore.yml

@@ -2,8 +2,8 @@ version: v1.0
 name: Node JS
 agent:
   machine:
-    type: e1-standard-2
-    os_image: ubuntu1804
+    type: e2-standard-2
+    os_image: ubuntu2204
 execution_time_limit:
   minutes: 30
 fail_fast:
@@ -17,8 +17,7 @@ auto_cancel:
 global_job_config:
   prologue:
     commands:
-      - sem-version node 16
-      - sem-version cpp 5
+      - sem-version node 18
       - checkout --use-cache
       - git switch -c pr
       - cache restore yarn-cache-main

README.md

@@ -2,7 +2,7 @@
 
 `yarn add @replit/crosis @replit/protocol`
 
-Crosis relies on the `@replit/protocol` package as a peer dependency. 
+Crosis relies on the `@replit/protocol` package as a peer dependency.
 
 ### Prerequisites
 
@@ -99,16 +99,17 @@ const closeChannel = client.openChannel({ service: 'exec' }, function open({ cha
 
 ### Developing
 
-To run tests run
+To run tests, in your Replit devvm check out the goval repository and run `process-compose up`, then
+run
 
 ```bash
-USER_KEY_ID=XXXX USER_PRIVATE_KEY=XXXX yarn test
+yarn test
 ```
 
 To interact with a connected client in the browser run
 
 ```bash
-USER_KEY_ID=XXXX USER_PRIVATE_KEY=XXXX yarn debug
+yarn debug
 ```
 
 You can then access the client from the console an send messages like:

debug/genConnectionMetadata.js

@@ -3,6 +3,14 @@ const crypto = require('crypto');
 const { api } = require('@replit/protocol');
 const paseto = require('./paseto');
 
+let cluster = 'mark';
+if (!process.env.USER_KEY_ID && !process.env.USER_PRIVATE_KEY) {
+  process.env.USER_KEY_ID = 'dev';
+  process.env.USER_PRIVATE_KEY =
+    'h/Qn2Wtu0bq85i3EF17r/diy4xNdYAMkCgHxLmu3xG+ifQWRKYQL5x7jRX1VzhAAFdLHpNej6WGn31voprSCug==';
+  cluster = 'development';
+}
+
 if (!process.env.USER_KEY_ID || !process.env.USER_PRIVATE_KEY) {
   throw new Error('Expected USER_KEY_ID and USER_PRIVATE_KEY in ENV');
 }
@@ -23,9 +31,9 @@ ${keyData.toString('base64')}
 function genConnectionMetadata(options) {
   const now = Date.now();
 
-  const restrictNetwork = !!options?.restrictNetwork;
+  const restrictNetwork = !!(options && options.restrictNetwork);
 
-  const repl = options?.repl || {
+  const repl = (options && options.repl) || {
     id: `testing-crosis-${Math.random().toString(36).split('.')[1]}`,
     language: 'bash',
     slug: Math.random().toString(36).slice(2),
@@ -44,7 +52,7 @@ function genConnectionMetadata(options) {
     exp: {
       seconds: Math.floor(now / 1000) + 60 * 60,
     },
-    cluster: 'global',
+    cluster,
     persistence: api.repl.Persistence.NONE,
     format: api.ReplToken.WireFormat.PROTOBUF,
     repl,
@@ -74,12 +82,23 @@ function genConnectionMetadata(options) {
     ),
   );
 
+  const clusterMetadata =
+    cluster === 'development'
+      ? {
+          gurl: 'ws://localhost:4560',
+          conmanURL: 'http://localhost:4560',
+          dotdevHostname: `http://${repl.id}-00-replittesting.${cluster}.replit.localhost:8081`,
+        }
+      : {
+          gurl: `wss://eval.${cluster}.replit.com`,
+          conmanURL: `https://eval.${cluster}.replit.com`,
+          dotdevHostname: `https://${repl.id}-00-replittesting.${cluster}.replit.dev`,
+        };
+
   return {
     token: encodedToken,
-    gurl: 'wss://eval.global.replit.com',
-    conmanURL: 'https://eval.global.replit.com',
     repl,
-    dotdevHostname: `https://${repl.id}-00-replittesting.gloval.replit.dev`,
+    ...clusterMetadata,
   };
 }