hookdeck-cli 0.8.5 → 0.9.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +37 -37
  2. package/bin/hookdeck +0 -0
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -4,9 +4,9 @@
4
4
 
5
5
  [![slack-badge]](https://join.slack.com/t/hookdeckdevelopers/shared_invite/zt-yw7hlyzp-EQuO3QvdiBlH9Tz2KZg5MQ)
6
6
 
7
- Using the Hookdeck CLI, you can forward your webhooks to your local webserver. We offer unlimited **free** and **permanent** webhook URLs. Your webhook history is preserved between session and can be viewed, replayed or used for testing by you and your teammates.
7
+ Using the Hookdeck CLI, you can forward your events (e.g. webhooks) to your local webserver. We offer unlimited **free** and **permanent** event URLs. Your event history is preserved between sessions and can be viewed, replayed, or used for testing by you and your teammates.
8
8
 
9
- Hookdeck CLI is compatible with most of Hookdeck features such as filtering and fan-out delivery. You can use Hookdeck CLI to develop or test your webhook integration code locally.
9
+ Hookdeck CLI is compatible with most of Hookdeck's features, such as filtering and fan-out delivery. You can use Hookdeck CLI to develop or test your event (e.g. webhook) integration code locally.
10
10
 
11
11
  Although it uses a different approach and philosophy, it's a replacement for ngrok and alternative HTTP tunnel solutions.
12
12
 
@@ -18,7 +18,7 @@ For a complete reference, see the [CLI reference](https://hookdeck.com/cli)
18
18
 
19
19
  ## Installation
20
20
 
21
- Hookdeck CLI is available for macOS, Windows, and Linux for distros like Ubuntu, Debian, RedHat and CentOS.
21
+ Hookdeck CLI is available for macOS, Windows, and Linux for distros like Ubuntu, Debian, RedHat, and CentOS.
22
22
 
23
23
  ### NPM
24
24
 
@@ -102,19 +102,19 @@ hookdeck login
102
102
 
103
103
  ### Listen
104
104
 
105
- Start a session to forward your webhooks to an HTTP server.
105
+ Start a session to forward your events to an HTTP server.
106
106
 
107
107
  ```sh-session
108
108
  hookdeck listen <port-or-URL> <source-alias?> <connection-query?>
109
109
  ```
110
110
 
111
- Hookdeck works by routing webhooks receive for a given `source` (ie: Shopify, Github, etc.) to its defined `destination` by connecting them with a `connection` to a `destination`. The CLI allows you to receive webhooks for any given connection and forward them to your localhost at the specified port or any valid URL.
111
+ Hookdeck works by routing events received for a given `source` (i.e., Shopify, Github, etc.) to its defined `destination` by connecting them with a `connection` to a `destination`. The CLI allows you to receive events for any given connection and forward them to your localhost at the specified port or any valid URL.
112
112
 
113
- Each `source` is assigned a Webhook URL, which you can use to receive webhooks. When starting with a fresh account, the CLI will prompt you to create your first source. Each CLI process can listen to one source at a time.
113
+ Each `source` is assigned a Event URL, which you can use to receive events. When starting with a fresh account, the CLI will prompt you to create your first source. Each CLI process can listen to one source at a time.
114
114
 
115
- Contrarily to ngrok, **Hookdeck does not allow to append a path to your Webhook URL**. Instead, the routing is done within Hookdeck configuration. This means you will also be prompted to specify your `destination` path, and you can have as many as you want per `source`.
115
+ Contrary to ngrok, **Hookdeck does not allow to append a path to your enent URL**. Instead, the routing is done within Hookdeck configuration. This means you will also be prompted to specify your `destination` path, and you can have as many as you want per `source`.
116
116
 
117
- > The `port-or-URL` param is mandatory, webhooks will be forwarded to http://localhost:$PORT/$DESTINATION_PATH when inputing a valid port or your provided URL.
117
+ > The `port-or-URL` param is mandatory, events will be forwarded to http://localhost:$PORT/$DESTINATION_PATH when inputing a valid port or your provided URL.
118
118
 
119
119
  #### Listen to all your connections for a given source
120
120
 
@@ -123,10 +123,10 @@ The second param, `source-alias` is used to select a specific source to listen o
123
123
  ```sh-session
124
124
  $ hookdeck listen 3000 shopify
125
125
 
126
- 👉 Inspect and replay webhooks: https://dashboard.hookdeck.com/cli/events
126
+ 👉 Inspect and replay events: https://dashboard.hookdeck.com/cli/events
127
127
 
128
128
  Shopify Source
129
- 🔌 Webhook URL: https://events.hookdeck.com/e/src_DAjaFWyyZXsFdZrTOKpuHnOH
129
+ 🔌 Event URL: https://events.hookdeck.com/e/src_DAjaFWyyZXsFdZrTOKpuHnOH
130
130
 
131
131
  Connections
132
132
  Inventory Service forwarding to /webhooks/shopify/inventory
@@ -137,17 +137,17 @@ Orders Service forwarding to /webhooks/shopify/orders
137
137
 
138
138
  ```
139
139
 
140
- #### Listen to a subset of connection
140
+ #### Listen to a subset of connections
141
141
 
142
142
  The 3rd param, `connection-query` can be used to filter the list of connections the CLI will listen to. The connection query can either be the `connection` `alias` or the `path`
143
143
 
144
144
  ```sh-session
145
145
  $ hookdeck listen 3000 shopify orders
146
146
 
147
- 👉 Inspect and replay webhooks: https://dashboard.hookdeck.com/cli/events
147
+ 👉 Inspect and replay events: https://dashboard.hookdeck.com/cli/events
148
148
 
149
149
  Shopify Source
150
- 🔌 Webhook URL: https://events.hookdeck.com/e/src_DAjaFWyyZXsFdZrTOKpuHnOH
150
+ 🔌 Event URL: https://events.hookdeck.com/e/src_DAjaFWyyZXsFdZrTOKpuHnOH
151
151
 
152
152
  Connections
153
153
  Inventory Service forwarding to /webhooks/shopify/inventory
@@ -157,9 +157,9 @@ Inventory Service forwarding to /webhooks/shopify/inventory
157
157
 
158
158
  ```
159
159
 
160
- #### Viewing and interacting with your webhooks
160
+ #### Viewing and interacting with your events
161
161
 
162
- Webhooks logs for your CLI can be found at https://dashboard.hookdeck.com/cli/events. Events can be replayed or saved at any time.
162
+ Event logs for your CLI can be found at https://dashboard.hookdeck.com/cli/events. Events can be replayed or saved at any time.
163
163
 
164
164
  ### Logout
165
165
 
@@ -202,14 +202,14 @@ If you want to use Hookdeck in CI for tests or any other purposes, you can use y
202
202
 
203
203
  ```sh-session
204
204
  $ hookdeck ci --api-key $HOOKDECK_API_KEY
205
- Done! The Hookdeck CLI is configured in workspace MyWorkspace
205
+ Done! The Hookdeck CLI is configured in project MyProject
206
206
 
207
207
  $ hookdeck listen 3000 shopify orders
208
208
 
209
- 👉 Inspect and replay webhooks: https://dashboard.hookdeck.com/cli/events
209
+ 👉 Inspect and replay events: https://dashboard.hookdeck.com/cli/events
210
210
 
211
211
  Shopify Source
212
- 🔌 Webhook URL: https://events.hookdeck.com/e/src_DAjaFWyyZXsFdZrTOKpuHnOH
212
+ 🔌 Event URL: https://events.hookdeck.com/e/src_DAjaFWyyZXsFdZrTOKpuHnOH
213
213
 
214
214
  Connections
215
215
  Inventory Service forwarding to /webhooks/shopify/inventory
@@ -219,44 +219,44 @@ Inventory Service forwarding to /webhooks/shopify/inventory
219
219
 
220
220
  ```
221
221
 
222
- ### Manage active workspace
222
+ ### Manage active project
223
223
 
224
- If you are a part of multiple workspaces, you can switch between them using our workspace management commands.
224
+ If you are a part of multiple project, you can switch between them using our project management commands.
225
225
 
226
226
  ```sh-session
227
- $ hookdeck workspace list
228
- My Workspace (current)
229
- Another Workspace
227
+ $ hookdeck project list
228
+ My Project (current)
229
+ Another Project
230
230
  Yet Another One
231
231
 
232
- $ hookdeck workspace use
232
+ $ hookdeck project use
233
233
  Use the arrow keys to navigate: ↓ ↑ → ←
234
- ? Select Workspace:
235
- My Workspace
236
- Another Workspace
234
+ ? Select Project:
235
+ My Project
236
+ Another Project
237
237
  ▸ Yet Another One
238
238
 
239
- Selecting workspace Yet Another One
239
+ Selecting project Yet Another One
240
240
 
241
241
  $ hookdeck whoami
242
242
  Using profile default
243
- Logged in as Me in workspace Yet Another One
243
+ Logged in as Me in project Yet Another One
244
244
  ```
245
245
 
246
- You can also pin an active workspace in the current working directory with the `--local` flag.
246
+ You can also pin an active project in the current working directory with the `--local` flag.
247
247
 
248
248
  ```sh-session
249
- $ hookdeck workspace use --local
249
+ $ hookdeck project use --local
250
250
  Use the arrow keys to navigate: ↓ ↑ → ←
251
- ? Select Workspace:
252
- My Workspace
253
- Another Workspace
251
+ ? Select Project:
252
+ My Project
253
+ Another Project
254
254
  ▸ Yet Another One
255
255
 
256
- Selecting workspace Yet Another One
256
+ Selecting project Yet Another One
257
257
  ```
258
258
 
259
- This will create a local config file in your current directory at `myproject/.hookdeck/config.toml`. Depending on your team's Hookdeck usage and workspace setup, you may or may not want to commit this configuration file to version control.
259
+ This will create a local config file in your current directory at `myproject/.hookdeck/config.toml`. Depending on your team's Hookdeck usage and project setup, you may or may not want to commit this configuration file to version control.
260
260
 
261
261
  ## Developing
262
262
 
@@ -290,4 +290,4 @@ docker run --rm -it \
290
290
 
291
291
  Copyright (c) Hookdeck. All rights reserved.
292
292
 
293
- Licensed under the [Apache License 2.0 license](blob/master/LICENSE).
293
+ Licensed under the [Apache License 2.0 license](LICENSE).
package/bin/hookdeck CHANGED
Binary file
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "hookdeck-cli",
3
- "version": "0.8.5",
3
+ "version": "0.9.2",
4
4
  "description": "Hookdeck CLI",
5
5
  "repository": {
6
6
  "type": "git",