queuebear 0.1.8 → 0.1.9

package/README.md

@@ -493,33 +493,34 @@ The signing secret is available in your QueueBear project settings. When configu
 
 ## Local Development
 
-When developing locally, your webhook endpoints run on `localhost` which isn't accessible from QueueBear's servers. Use a tunnel service to expose your local server.
+When developing locally, your webhook endpoints run on `localhost` which isn't accessible from QueueBear's servers. Use [Tunnelmole](https://tunnelmole.com) to expose your local server - it's free and requires no signup.
 
-### Using ngrok (Recommended)
+### Installing Tunnelmole
 
-[ngrok](https://ngrok.com) provides stable URLs and a built-in request inspector.
-
-**1. Install and authenticate:**
+**Linux, macOS, Windows WSL:**
 
 ```bash
-# Install
-brew install ngrok  # or download from ngrok.com/download
+curl -O https://install.tunnelmole.com/t357g/install && sudo bash install
+```
 
-# Authenticate (free account required)
-ngrok config add-authtoken YOUR_AUTH_TOKEN
+**Node.js (all platforms, requires Node 16+):**
+
+```bash
+npm install -g tunnelmole
 ```
 
-**2. Start the tunnel:**
+### Starting a Tunnel
 
 ```bash
-ngrok http 3000
+tmole 3000
+# Output: https://xxxx.tunnelmole.com is forwarding to localhost:3000
 ```
 
-**3. Use the forwarding URL:**
+### Using the Tunnel URL
 
 ```typescript
-// Use ngrok URL instead of localhost
-await qb.messages.publish("https://abc123.ngrok.io/api/webhooks", {
+// Use tunnelmole URL instead of localhost
+await qb.messages.publish("https://xxxx.tunnelmole.com/api/webhooks", {
   event: "user.created",
   userId: "123"
 });
@@ -527,37 +528,16 @@ await qb.messages.publish("https://abc123.ngrok.io/api/webhooks", {
 // Works for workflows too
 await qb.workflows.trigger(
   "onboarding",
-  "https://abc123.ngrok.io/api/workflows/onboarding",
+  "https://xxxx.tunnelmole.com/api/workflows/onboarding",
   { userId: "123" }
 );
 ```
 
-**Debugging:** ngrok provides a web inspector at `http://localhost:4040` to view requests, responses, and replay failed deliveries.
-
-### Using localtunnel
-
-[localtunnel](https://localtunnel.me) is free and requires no signup.
-
-```bash
-npx localtunnel --port 3000
-# Output: your url is: https://good-months-leave.loca.lt
-```
-
-**Note:** localtunnel shows a reminder page on first visit. Bypass it by adding a header:
-
-```typescript
-await qb.messages.publish(
-  "https://good-months-leave.loca.lt/api/webhooks",
-  { event: "test" },
-  { headers: { "bypass-tunnel-reminder": "true" } }
-);
-```
-
 ### Tips
 
 - Store your tunnel URL in `.env` for easy switching between local and production
 - Both `callbackUrl` and `failureCallbackUrl` need public URLs for local testing
-- ngrok URLs change on restart (stable URLs require a paid plan)
+- Tunnel URLs change on restart
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "queuebear",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "QueueBear SDK for message queues, scheduled jobs, and durable workflows",
   "type": "module",
   "main": "./dist/index.js",