Add command ACTIVEUSERS (#106)

* add ACTIVEUSERS command

* docs

Author: mdroidian

docs/050-command-reference.md

@@ -16,6 +16,7 @@ This is a directory of all of the supported commands in the SmartBlocks extensio
 - [Serendipity](#serendipity-commands)
 - [TODO](#todo-commands)
 - [Block Related](#block-related-commands)
+- [User Related](#user-related-commands)
 - [Logic Control](#logic-control-commands)
 - [Cursor](#cursor-commands)
 - [Commands With Effects](#commands-with-effects)
@@ -449,28 +450,6 @@ Special note: if you want a comma to be a part of the output, put a \ in front o
 
 `<%CURRENTURL%>`
 
-## CURRENTUSER
-
-**Purpose:** Return the display name of the user.
-
-**Parameters:** None
-
-**Example:**
-
-`<%CURRENTUSER%>`
-
-## AUTHOR
-
-**Purpose:** Returns the username of the user who created the block or page.
-
-**Parameters:**
-
-1. Page name or block ref
-
-**Example:**
-
-`<%AUTHOR:((BVJoEW-aq))%>`
-
 ## CURRENTBLOCKREF
 
 **Purpose:** Gets the current block reference. Stores it in a variable if present.
@@ -637,6 +616,56 @@ Special note: if you want a comma to be a part of the output, put a \ in front o
 
 - `<%PARENT:ref,varName%>`
 
+# **User Related Commands**
+
+## CURRENTUSER
+
+**Purpose:** Return the display name of the user.
+
+**Parameters:** None
+
+**Example:**
+
+`<%CURRENTUSER%>`
+
+## AUTHOR
+
+**Purpose:** Returns the username of the user who created the block or page.
+
+**Parameters:**
+
+1. Page name or block ref
+
+**Example:**
+
+`<%AUTHOR:((BVJoEW-aq))%>`
+
+## ALLUSERS
+
+**Purpose:** Returns all users in the graph.
+
+**Parameters:** None
+
+**Example:**
+
+`<%ALLUSERS%>`
+
+## ACTIVEUSERS
+
+**Purpose:** Returns all users who created/edited a block.
+
+Default is set to the last three month.
+
+**Parameters:**
+
+1. (Optional) NLP expression for date basis
+2. (Optional) Format of Output
+
+**Example:**
+
+- `<%ACTIVEUSERS%>`
+- `<%ACTIVEUSERS:this year,{text}%>`
+
 # **Logic Control Commands**
 
 Logic Control Commands are commands that facilitate control flow and decision points in the workflow.

src/utils/core.ts

@@ -2121,6 +2121,39 @@ export const COMMANDS: {
       return users;
     },
   },
+  {
+    text: "ACTIVEUSERS",
+    help: "Gets all users who created/edited a block.\n\nDefault is set to the last three month.\n\n1: (Optional) NLP expression for date basis\n\n2: (Optional) Format of Output",
+    handler: (nlp = "three months ago", format = `[[{text}]]`) => {
+      const timestamp =
+        parseNlpDate(nlp, getDateBasisDate()).valueOf() ||
+        // chrono fails basic parsing requiring forward date if ambiguous
+        // https://github.com/wanasit/chrono/commit/4f264a9f21fbd04eb740bf48f5616f6e6e0e78b7
+        parseNlpDate(`in ${nlp}`, getDateBasisDate()).valueOf();
+
+      // [?block :edit/time ?time] assumes newly created blocks get an edit time
+      const activeUsers = (
+        window.roamAlphaAPI.data.fast.q(`
+          [
+            :find 
+              (pull ?user-page [:node/title :block/uid])
+            :where 
+                [?user :user/display-page ?user-page]
+                [?user-page :node/title ?user-title] 
+                [?block :create/user ?user] 
+                [?block :edit/time ?time] 
+                [(< ${timestamp} ?time)]
+          ]
+        `) as [PullBlock, PullBlock][]
+      ).map(([user]) => {
+        return getFormatter(format)({
+          text: user[":node/title"],
+          uid: user[":block/uid"],
+        });
+      });
+      return activeUsers;
+    },
+  },
   {
     text: "AUTHOR",
     help: "Returns the user who created the block or page \n\n1: Page name or UID.",