jw-automator 3.0.0 → 3.1.0

package/README.md

@@ -257,6 +257,15 @@ automator.updateActionByID(1, {
 });
 ```
 
+#### `updateActionByName(name, updates)`
+Update all actions with the given name. Returns the number of actions updated.
+
+```js
+automator.updateActionByName('My Action', {
+  payload: { newData: 'newValue' }
+});
+```
+
 #### `removeActionByID(id)`
 Remove an action by ID.
 

package/docs/ARCHITECTURE.md

@@ -156,7 +156,7 @@ setTimeout(() => tick(), wait);
 - Event emission
 
 **Key APIs**:
-- Action management: `addAction`, `updateActionByID`, `removeActionByID`, etc.
+- Action management: `addAction`, `updateActionByID`, `updateActionByName`, `removeActionByID`, etc.
 - Function registration: `addFunction`, `removeFunction`
 - Introspection: `getActions`, `describeAction`, `getActionsInRange`
 - Lifecycle: `start`, `stop`

package/docs/MIGRATION.md

@@ -136,6 +136,10 @@ automator.updateActionByID(id, {
   name: 'New Name',
   repeat: { type: 'hour', interval: 2 }
 });
+
+automator.updateActionByName('Old Name', {
+  name: 'New Name'
+});
 ```
 
 ---

package/docs/QUICKSTART.md

@@ -269,10 +269,16 @@ const id = automator.addAction({
 ### Update
 
 ```javascript
+// By ID
 automator.updateActionByID(id, {
   name: 'Updated Task',
   repeat: { type: 'hour', interval: 2 }
 });
+
+// By name
+automator.updateActionByName('My Task', {
+  payload: { updated: true }
+});
 ```
 
 ### Remove

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jw-automator",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "A resilient, local-time, 1-second precision automation scheduler for Node.js",
   "main": "index.js",
   "files": [

package/src/Automator.js

@@ -159,6 +159,53 @@ class Automator {
     }
   }
 
+  /**
+   * Update actions by name
+   */
+  updateActionByName(name, updates) {
+    const state = this.host.getState();
+    const toUpdate = state.actions.filter(a => a.name === name);
+
+    if (toUpdate.length === 0) {
+      // For consistency with removeActionByName, we could throw an error.
+      // However, it might be more convenient to simply return 0.
+      // Let's return 0 for now.
+      return 0;
+    }
+
+    const allowedUpdates = ['cmd', 'payload', 'date', 'unBuffered', 'repeat', 'count'];
+
+    for (const action of toUpdate) {
+      for (const key of allowedUpdates) {
+        if (key in updates) {
+          if (key === 'date' && updates[key]) {
+            action[key] = new Date(updates[key]);
+          } else if (key === 'repeat' && updates[key]) {
+            action[key] = { ...action.repeat, ...updates[key] };
+            if (!action[key].dstPolicy) {
+              action[key].dstPolicy = 'once';
+            }
+          } else {
+            action[key] = updates[key];
+          }
+        }
+      }
+
+      this._emit('update', {
+        type: 'update',
+        operation: 'update',
+        actionId: action.id,
+        action: { ...action }
+      });
+    }
+
+    if (this.options.autoSave) {
+      this._saveState();
+    }
+
+    return toUpdate.length;
+  }
+
   /**
    * Remove action by ID
    */