dashcam 0.2.1 → 0.3.1

package/README.md

@@ -1,76 +1,142 @@
-<img src="https://user-images.githubusercontent.com/318295/204898620-922afee0-5415-46a9-a84f-ae6237001bf0.png" height="50" alt="Replayable"/>
+<img src="https://user-images.githubusercontent.com/318295/204898620-922afee0-5415-46a9-a84f-ae6237001bf0.png" height="50" alt="Dashcam"/>
 
-# CLI + SDK
+# Dashcam API
 
-Why double-back when you can capture it the first time? Playback and share exactly what happened with Replayable's desktop replay buffer.
+Add Dashcam to your app or workflow. This package allows you to control the Dashcam desktop application from the via CLI SDK.
 
-This package allows you to control the Replayable desktop application from the CLI or SDK.
+> Why double-back when you can capture it the first time? Playback and share exactly what happened with Dashcam's desktop replay buffer.
 
-You can easily embed desktop replays within git commits, pull requests, bug reports, jira tickets, and even within log files.
+You can easily embed desktop replays within git commits, pull requests, bug reports, jira tickets, and even within log files. Desktop replays are a great way to share context behind problems and document the application state within logs, tickets and more.
 
-Desktop replays are a great way to share context behind problems and document the application state within logs, tickets and more.
+Requires that you [install Dashcam Desktop](https://dashcam.io). Dashcam Desktop runs in the background giving you access to a buffer of video.
 
-<a href="https://www.loom.com/share/ea9c2831013a4b5eb996bd47f8178f4e">
-  <p>Capture bugs with replayable. - Watch Video</p>
-  <img style="max-width:300px;" src="https://cdn.loom.com/sessions/thumbnails/ea9c2831013a4b5eb996bd47f8178f4e-with-play.gif">
-</a>
+## Table of contents
 
-## Quick Setup
+- [Dashcam API](#dashcam-api)
+  - [Install Dashcam Desktop](#install-dashcam-desktop)
+- [Examples](#examples)
+  - [Web](#web)
+    - [Setup](#setup)
+    - [HTML Anchor Tag](#html-anchor-tag)
+    - [JS Error Handler](#js-error-handler)
+  - [NodeJS SDK](#nodejs-sdk)
+    - [Setup](#setup)
+    - [Create a Replay](#create-a-replay)
+    - [Error Handler](#error-handler)
+  - [CLI](#cli)
+    - [Setup](#setup)
+    - [Create a Replay](#create-a-replay)
+    - [Return a rich markdown link](#return-a-rich-markdown-link)
+    - [Set a replay title](#set-a-replay-title)
+    - [Attach the last 20 CLI commands to the replay](#attach-the-last-20-cli-commands-to-the-replay)
+    - [Attach a logfile to the replay](#attach-a-logfile-to-the-replay)
+  - [GitHub CLI](#github-cli)
+    - [Create a github issue with a replay in the description](#create-a-github-issue-with-a-replay-in-the-description)
+    - [Create a github pull request with a replay in the description](#create-a-github-pull-request-with-a-replay-in-the-description)
+    - [Append a 30 second replay to a commit](#append-a-30-second-replay-to-a-commit)
+- [Advanced Usage](#advanced-usage)
+  - [Ideas](#ideas)
+
+# Examples
+
+Also see [the examples folder](https://github.com/replayableio/cli/tree/main/examples).
+
+## Web
+
+### Setup
 
-### Install Replayable Desktop
+Nothing! The app exposes the protocol to the system natively via `dashcam://`.
 
-First, [install Replayable Desktop](https://replayable.io/?betacode=CLIENTRY). Replayable Desktop runs in the background giving you access to a buffer of video.
+### HTML Anchor Tag
 
-### Install this package
+```html
+<a href="dashcam://replay/create" target="_blank">Create a Replay</a>
+```
+
+### JS Error Handler
+
+```js
+window.onerror = function myErrorHandler() {
+  window.open("dashcam://replay/create", "_blank");
+};
+
+setTimeout(() => {
+  throw new Error("Throw makes it go boom!");
+}, 3000);
+```
+
+## NodeJS SDK
+
+### Setup
 
 ```sh
-npm install replayable -g
+npm install dashcam
 ```
 
-# Table of contents
+### Create a Replay
 
-- [CLI + SDK](#cli--sdk)
-  - [Quick Setup](#quick-setup)
-- [Examples](#examples)
-  - [CLI](#cli)
-  - [GitHub CLI](#github-cli)
-  - [NodeJS SDK](#nodejs-sdk)
-  - [Javascript Integration](#javascript-integration)
-- [Advanced Usage](#advanced-usage)
+```js
+const dashcam = require("dashcam");
 
-# Examples
+let replay = await dashcam.createReplay({
+  title: "My New Replay",
+  description: `This **renders markdown** or plaintext in monospace font.`,
+});
+```
 
-Also see the examples folder.
+### Error Handler
+
+```js
+const dashcam = require("dashcam");
+
+process.on("uncaughtException", async (err) => {
+  let replay = await dashcam.createReplay({
+    title: "uncaughtException",
+    description: err,
+  });
+  console.log("Dashcam", replay);
+});
+
+setTimeout(() => {
+  throw new Error("Throw makes it go boom!");
+}, 3000);
+```
 
 ## CLI
 
+### Setup
+
+```sh
+npm install dashcam -g
+```
+
 ### Create a Replay
 
 ```sh
-$ replayable
-https://replayable.io/replay/123?share=xyz
+$ dashcam
+https://dashcam.io/replay/123?share=xyz
 ```
 
 ### Return a rich markdown link
 
 ```sh
-$ replayable --md
+$ dashcam --md
 
-[![Replayable - New Replay](https://replayable-api-production.herokuapp.com/replay/123/gif?shareKey=xyz)](https://replayable.io/replay/123?share=xyz)
+[![Dashcam - New Replay](https://replayable-api-production.herokuapp.com/replay/123/gif?shareKey=xyz)](https://replayable.io/replay/123?share=xyz)
 
-Watch [Replayable - New Replay](https://replayable.io/replay/123?share=xyz) on Replayable
+Watch [Dashcam - New Replay](https://dashcam.io/replay/123?share=xyz) on Dashcam
 ```
 
 ### Set a replay title
 
 ```sh
-$ replayable -t "My New Title"
+$ dashcam -t "My New Title"
 ```
 
 ### Attach the last 20 CLI commands to the replay
 
 ```sh
-$ history -20 | replayable
+$ history -20 | dashcam
 ```
 
 ### Attach a logfile to the replay
@@ -78,7 +144,7 @@ $ history -20 | replayable
 This will attach the mac system log to the replay.
 
 ```sh
-$ cat /var/log/system.log | replayable
+$ cat /var/log/system.log | dashcam
 ```
 
 ## GitHub CLI
@@ -88,69 +154,37 @@ The following examples depend on having the [GitHub CLI](https://cli.github.com/
 ### Create a github issue with a replay in the description
 
 ```sh
-$ gh issue create -w -t "Title" -b "`replayable --md`"
+$ gh issue create -w -t "Title" -b "`dashcam --md`"
 ```
 
 This is where it gets really cool. For example, this single command will create a GitHub issue with a video replay and the mac system logs.
 
 ```
-gh issue create -w -t "Title" -b "`cat /var/log/system.log | replayable --md`"
+gh issue create -w -t "Title" -b "`cat /var/log/system.log | dashcam --md`"
 ```
 
 ### Create a github pull request with a replay in the description
 
 ```sh
-$ gh pr create -w -t "Title" -b "`replayable --md`"
+$ gh pr create -w -t "Title" -b "`dashcam --md`"
 ```
 
 ### Append a 30 second replay to a commit
 
 ```sh
-$ git commit -am "`replayable`"
-```
-
-## NodeJS SDK
-
-```js
-const replayable = require("replayable");
-
-process.on("uncaughtException", async (err) => {
-  let replay = await replayable.createReplay({
-    title: "uncaughtException",
-    description: err,
-  });
-  console.log("Replayable", replay);
-});
-
-setTimeout(() => {
-  throw new Error("Throw makes it go boom!");
-}, 3000);
-```
-
-## Javascript Integration
-
-Note that this example does not require any library to be installed as the app exposes the protocol natively.
-
-```js
-window.onerror = function myErrorHandler() {
-  window.open("replayable://replay/create", "_blank");
-};
-
-setTimeout(() => {
-  throw new Error("Throw makes it go boom!");
-}, 3000);
+$ git commit -am "`dashcam`"
 ```
 
 # Advanced Usage
 
 ```
-Usage: replayable create [options]
+Usage: dashcam create [options]
 
 Create a replay and output the resulting url or markdown. Will launch desktop app for local editing before publishing.
 
 Options:
   -t, --title <string>      Title of the replay. Automatically generated if not supplied.
-  -d, --description [text]  Replay markdown body. This may also be piped in: `cat README.md | replayable create`
+  -d, --description [text]  Replay markdown body. This may also be piped in: `cat README.md | dashcam create`
   --md                      Returns code for a rich markdown image link.
   -h, --help                display help for command
 ```

package/index.js

@@ -6,26 +6,24 @@ const { program } = require("commander");
 let stdin = "";
 
 program
-  .name("replayable")
-  .description(
-    "Upgrade your bug reports, pulls, and readmes with clips from local development"
-  )
-  .version("0.0.9");
+  .name("dashcam")
+  .description("Capture the steps to reproduce every bug.")
+  .version("0.1.0");
 
 program.showHelpAfterError();
 
 program
   .command("create", { isDefault: true })
   .description(
-    "Create a replay and output the resulting url or markdown. Will launch desktop app for local editing before publishing."
+    "Create a clip and output the resulting url or markdown. Will launch desktop app for local editing before publishing."
   )
   .option(
     "-t, --title <string>",
-    "Title of the replay. Automatically generated if not supplied."
+    "Title of the clip. Automatically generated if not supplied."
   )
   .option(
     "-d, --description [text]",
-    "Replay markdown body. This may also be piped in: `cat README.md | replayable create`"
+    "Markdown body. This may also be piped in: `cat README.md | dashcam create`"
   )
   .option("--md", "Returns code for a rich markdown image link.")
   .action(async function (str, options) {

package/lib.js

@@ -1,19 +1,19 @@
 const ipc = require("node-ipc").default;
 const clc = require("cli-color");
 
-ipc.config.id = "replayable-cli";
+ipc.config.id = "dashcam-cli";
 ipc.config.retry = 1500;
 ipc.config.silent = true;
 ipc.config.maxRetries = 0;
 
 const connectToIpc = function () {
   return new Promise((resolve, reject) => {
-    ipc.connectTo("replayable");
-    ipc.of.replayable.on("connect", resolve);
-    ipc.of.replayable.on("error", (e) => {
+    ipc.connectTo("dashcam");
+    ipc.of.dashcam.on("connect", resolve);
+    ipc.of.dashcam.on("error", (e) => {
       if (e.code === "ENOENT") {
         console.log(
-          clc.red("Could not connect to Replayable Desktop App. Is it running?")
+          clc.red("Could not connect to Dashcam Desktop App. Is it running?")
         );
         console.log(
           clc.yellow(
@@ -22,8 +22,8 @@ const connectToIpc = function () {
         );
       }
     });
-    ipc.of.replayable.on("disconnect", function () {
-      console.log("Disconnected from Replayable");
+    ipc.of.dashcam.on("disconnect", function () {
+      console.log("Disconnected from Dashcam");
     });
   });
 };
@@ -37,7 +37,7 @@ const createReplay = async function (options = {}) {
   await connectToIpc();
 
   return new Promise(async (resolve, reject) => {
-    ipc.of.replayable.on(
+    ipc.of.dashcam.on(
       "upload", //any event or message type your server listens for
       function (data) {
         if (options.md) {
@@ -50,11 +50,11 @@ const createReplay = async function (options = {}) {
 
     setTimeout(() => {
       reject(
-        "Replayable Desktop App did not respond in time. Did you publish a replay?"
+        "Dashcam Desktop App did not respond in time. Did you publish a replay?"
       );
     }, 60000 * 5);
 
-    ipc.of.replayable.emit("create", {
+    ipc.of.dashcam.emit("create", {
       title: options.title,
       description: options.description,
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dashcam",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "description": "Fix bugs, close pulls, and update your team with desktop instant replay.",
   "main": "index.js",
   "scripts": {
@@ -8,7 +8,7 @@
     "prepare": "husky install"
   },
   "bin": {
-    "replayable": "index.js"
+    "dashcam": "index.js"
   },
   "author": "",
   "license": "ISC",