Updates to API examples

Author: jonathanbossenger

docs/7.javascript-client.md

@@ -1,15 +1,16 @@
 # 7. JavaScript/TypeScript Client
 
-The JavaScript client provides a simple interface for discovering and executing WordPress Abilities from frontend applications, block editor plugins, and external systems.
+The JavaScript client provides an interface for discovering and executing WordPress Abilities from the browser.
 
 ## Overview
 
-The JavaScript client enables frontend code to interact with the PHP Abilities API system. It can:
+The JavaScript client enables frontend code to interact with the Abilities API system. It can:
 
 - Discover all registered abilities on your WordPress site
-- Execute server-side PHP abilities via REST API calls
+- Execute server-side PHP abilities
 - Register and execute client-side JavaScript abilities
-- Handle input validation and permission checking
+
+You can read more about installation and setup in the [package readme](../packages/client/README.md).
 
 ## Core API Functions
 
@@ -31,10 +32,6 @@ console.log(`Found ${abilities.length} abilities`);
 abilities.forEach(ability => {
     console.log(`${ability.name}: ${ability.description}`);
 });
-
-// Filter by type
-const tools = abilities.filter(ability => ability.meta?.type === 'tool');
-const resources = abilities.filter(ability => ability.meta?.type === 'resource');
 ```
 
 ### getAbility(name)
@@ -80,13 +77,6 @@ const posts = await executeAbility('my-plugin/get-posts', {
     limit: 5
 });
 posts.forEach(post => console.log(post.title));
-
-// Execute with complex input
-const result = await executeAbility('my-plugin/update-option', {
-    option_name: 'blogname',
-    option_value: 'My New Site Title'
-});
-console.log('Success:', result.success);
 ```
 
 ### registerAbility(ability)
@@ -101,7 +91,13 @@ Registers a client-side ability that runs in the browser.
 **Example:**
 
 ```javascript
-// Register a simple notification ability
+// showNotification function
+const showNotification = (message) => {
+  new Notification(message);
+  return { success: true, displayed: message };
+}
+
+// Register a notification ability which calls the showNotification function
 registerAbility({
     name: 'my-plugin/show-notification',
     label: 'Show Notification',
@@ -115,11 +111,19 @@ registerAbility({
         required: ['message']
     },
     callback: async ({ message, type = 'info' }) => {
-        // Show browser notification
-        if (Notification.permission === 'granted') {
-            new Notification(message);
-        }
-        return { success: true, displayed: message };
+      // Show browser notification
+      if (!("Notification" in window)) {
+         alert("This browser does not support desktop notification");
+        return { success: false, error: 'Browser does not support notifications' };
+      }
+      if (Notification.permission !== 'granted') {
+        Notification.requestPermission().then((permission) => {
+          if (permission === "granted") {
+            return showNotification(message);
+          }
+        });
+      }
+      return showNotification(message);
     },
     permissionCallback: () => {
         return !!wp.data.select('core').getCurrentUser();