hookdeck-cli 0.8.6 → 0.9.8-alpha-1
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.
- package/README.md +37 -37
- package/bin/hookdeck +0 -0
- package/package.json +2 -2
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**
|
|
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
|
|
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
|
|
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
|
|
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
|
-
|
|
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,
|
|
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
|
|
126
|
+
👉 Inspect and replay events: https://dashboard.hookdeck.com/cli/events
|
|
127
127
|
|
|
128
128
|
Shopify Source
|
|
129
|
-
🔌
|
|
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
|
|
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
|
|
147
|
+
👉 Inspect and replay events: https://dashboard.hookdeck.com/cli/events
|
|
148
148
|
|
|
149
149
|
Shopify Source
|
|
150
|
-
🔌
|
|
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
|
|
160
|
+
#### Viewing and interacting with your events
|
|
161
161
|
|
|
162
|
-
|
|
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
|
|
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
|
|
209
|
+
👉 Inspect and replay events: https://dashboard.hookdeck.com/cli/events
|
|
210
210
|
|
|
211
211
|
Shopify Source
|
|
212
|
-
🔌
|
|
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
|
|
222
|
+
### Manage active project
|
|
223
223
|
|
|
224
|
-
If you are a part of multiple
|
|
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
|
|
228
|
-
My
|
|
229
|
-
Another
|
|
227
|
+
$ hookdeck project list
|
|
228
|
+
My Project (current)
|
|
229
|
+
Another Project
|
|
230
230
|
Yet Another One
|
|
231
231
|
|
|
232
|
-
$ hookdeck
|
|
232
|
+
$ hookdeck project use
|
|
233
233
|
Use the arrow keys to navigate: ↓ ↑ → ←
|
|
234
|
-
? Select
|
|
235
|
-
My
|
|
236
|
-
Another
|
|
234
|
+
? Select Project:
|
|
235
|
+
My Project
|
|
236
|
+
Another Project
|
|
237
237
|
▸ Yet Another One
|
|
238
238
|
|
|
239
|
-
Selecting
|
|
239
|
+
Selecting project Yet Another One
|
|
240
240
|
|
|
241
241
|
$ hookdeck whoami
|
|
242
242
|
Using profile default
|
|
243
|
-
Logged in as Me in
|
|
243
|
+
Logged in as Me in project Yet Another One
|
|
244
244
|
```
|
|
245
245
|
|
|
246
|
-
You can also pin an active
|
|
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
|
|
249
|
+
$ hookdeck project use --local
|
|
250
250
|
Use the arrow keys to navigate: ↓ ↑ → ←
|
|
251
|
-
? Select
|
|
252
|
-
My
|
|
253
|
-
Another
|
|
251
|
+
? Select Project:
|
|
252
|
+
My Project
|
|
253
|
+
Another Project
|
|
254
254
|
▸ Yet Another One
|
|
255
255
|
|
|
256
|
-
Selecting
|
|
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
|
|
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](
|
|
293
|
+
Licensed under the [Apache License 2.0 license](LICENSE).
|
package/bin/hookdeck
CHANGED
|
Binary file
|
package/package.json
CHANGED