powr-sdk-api 4.7.2 → 4.8.0

package/dist/index.js

@@ -22,7 +22,8 @@ const {
   initializeTools,
   executeTasks,
   executeTool,
-  createTask
+  createTask,
+  emitActivity
 } = require("./managers");
 const {
   verifyToken
@@ -44,5 +45,6 @@ module.exports = {
   executeTasks,
   executeTool,
   createTask,
+  emitActivity,
   getPowrDb
 };

package/dist/managers/activities.js

@@ -0,0 +1,57 @@
+"use strict";
+
+const {
+  getDb
+} = require("../services/mongo");
+const {
+  ObjectId
+} = require("mongodb");
+
+/**
+ * Emit an activity to PowrBase. Inserts one document into the activities collection.
+ * Does not send notification; an Atlas trigger on the collection handles that.
+ *
+ * @param {Object} options
+ * @param {string} options.projectId - Project context (required)
+ * @param {string} options.action - e.g. "task_created", "task_assigned", "enquiry_converted"
+ * @param {string|ObjectId} options.userId - Who performed the action
+ * @param {string} [options.targetType] - e.g. "task", "project", "enquiry"
+ * @param {string|ObjectId} [options.targetId] - ID of the target entity
+ * @param {Object} [options.metadata] - Extra payload (e.g. recipientIds, title, body, url for notification)
+ * @returns {Promise<{ insertedId: ObjectId }>} The inserted document's _id
+ */
+async function emitActivity(options) {
+  const {
+    projectId,
+    action,
+    userId,
+    targetType,
+    targetId,
+    metadata = {}
+  } = options;
+  if (!projectId || !action) {
+    throw new Error("emitActivity: projectId and action are required");
+  }
+  const normalizeId = id => {
+    if (id == null) return null;
+    if (typeof id === "string" && ObjectId.isValid(id)) return new ObjectId(id);
+    return id;
+  };
+  const doc = {
+    projectId,
+    action,
+    userId: normalizeId(userId),
+    targetType: targetType || null,
+    targetId: normalizeId(targetId),
+    metadata,
+    createdAt: new Date()
+  };
+  const db = await getDb();
+  const result = await db.collection("activities").insertOne(doc);
+  return {
+    insertedId: result.insertedId
+  };
+}
+module.exports = {
+  emitActivity
+};

package/dist/managers/index.js

@@ -3,6 +3,7 @@
 const functionsManager = require('./functions');
 const toolsManager = require('./tools');
 const scheduledTasksManager = require('./tasks');
+const activitiesManager = require('./activities');
 
 // Async Functions initialization function
 const initializeFunctions = async (options = {}) => {
@@ -27,11 +28,12 @@ const createTask = async taskData => {
   // Create a new task/workflow
   return await scheduledTasksManager.createTask(taskData);
 };
+const emitActivity = activitiesManager.emitActivity;
 module.exports = {
-  // Initialization/Execution methods
   initializeFunctions,
   initializeTools,
   executeTasks,
   executeTool,
-  createTask
+  createTask,
+  emitActivity
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "powr-sdk-api",
-  "version": "4.7.2",
+  "version": "4.8.0",
   "description": "Shared API core library for PowrStack projects. Zero dependencies - works with Express, Next.js API routes, and other frameworks. All features are optional and install only what you need.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",