jupyterlab_notifications_extension 1.1.21 → 1.1.22

package/README.md

@@ -128,44 +128,47 @@ await app.commands.execute('jupyterlab-notifications:send', {
 });
 ```
 
-### Python Script
+### CLI Tool
 
-The included script auto-detects tokens from `JUPYTERHUB_API_TOKEN`, `JPY_API_TOKEN`, or `JUPYTER_TOKEN` environment variables:
+The `jupyter-notify` command is installed with the extension:
 
 ```bash
-# Basic notification
-./scripts/send_notification.py --message "Deployment complete" --type success
+# Basic notification (localhost, no auth needed)
+jupyter-notify -m "Deployment complete" -t success
 
 # Persistent warning (no auto-close)
-./scripts/send_notification.py --message "System maintenance in 1 hour" --type warning --no-auto-close
+jupyter-notify -m "System maintenance in 1 hour" -t warning --no-auto-close
 
-# Silent mode (notification center only)
-./scripts/send_notification.py --message "Background task finished" --auto-close 0
+# JupyterHub with base path
+jupyter-notify --url "http://127.0.0.1:8888/jupyterhub/user/alice" -m "Hello"
+
+# Silent mode (notification center only, no toast)
+jupyter-notify -m "Background task finished" --auto-close 0
+
+# With dismiss button
+jupyter-notify -m "Action required" -t warning --no-auto-close --action "Dismiss"
 ```
 
+Auto-detects tokens from `JUPYTERHUB_API_TOKEN`, `JPY_API_TOKEN`, or `JUPYTER_TOKEN` for remote servers.
+
 ### cURL
 
 ```bash
-# Basic info notification
+# Localhost - no authentication required
 curl -X POST http://localhost:8888/jupyterlab-notifications-extension/ingest \
   -H "Content-Type: application/json" \
-  -H "Authorization: token YOUR_TOKEN" \
-  -d '{"message": "Build completed", "type": "info"}'
+  -d '{"message": "Build completed", "type": "success"}'
 
-# Error notification with action button
+# Localhost - warning that stays until dismissed
 curl -X POST http://localhost:8888/jupyterlab-notifications-extension/ingest \
   -H "Content-Type: application/json" \
-  -H "Authorization: token YOUR_TOKEN" \
-  -d '{
-    "message": "Build failed on main branch",
-    "type": "error",
-    "autoClose": false,
-    "actions": [{
-      "label": "View Logs",
-      "caption": "Open build logs",
-      "displayType": "accent"
-    }]
-  }'
+  -d '{"message": "System maintenance in 1 hour", "type": "warning", "autoClose": false}'
+
+# Remote - requires authentication token
+curl -X POST http://jupyterhub.example.com/user/alice/jupyterlab-notifications-extension/ingest \
+  -H "Content-Type: application/json" \
+  -H "Authorization: token YOUR_JUPYTER_TOKEN" \
+  -d '{"message": "Deployment complete", "type": "info"}'
 ```
 
 ## Architecture

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "jupyterlab_notifications_extension",
-    "version": "1.1.21",
+    "version": "1.1.22",
     "description": "Jupyterlab extension to receive and display notifications in the main panel. Those can be from the jupyterjub administrator or from other places.",
     "keywords": [
         "jupyter",