@enerlence/suntropy-cli 0.11.5 → 0.11.7

package/dist/bin/suntropy.js

@@ -7,7 +7,7 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
 });
 
 // src/index.ts
-import { Command as Command3 } from "commander";
+import { Command as Command4 } from "commander";
 
 // src/config.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
@@ -68,14 +68,16 @@ var SERVICE_PATHS = {
   solar: "/solar",
   templates: "/templates",
   profiles: "/profiles",
-  periods: "/periods"
+  periods: "/periods",
+  notifications: "/notifications"
 };
 var LOCAL_PORTS = {
   security: 8080,
   solar: 8086,
   templates: 8090,
   profiles: 8085,
-  periods: 8084
+  periods: 8084,
+  notifications: 8093
 };
 function getServiceUrl(baseServer, service) {
   if (baseServer.includes("localhost") || baseServer.match(/:\d+$/)) {
@@ -4475,6 +4477,96 @@ function registerGeocodeCommands(program2) {
   });
 }
 
+// src/commands/notifications/index.ts
+import { Option as Option2 } from "commander";
+function getGlobalOpts16(cmd) {
+  let root = cmd;
+  while (root.parent) root = root.parent;
+  return root.opts();
+}
+var ALEXANDRIA_USER_UID = "alexandria";
+var SEVERITIES = ["info", "warning", "urgent"];
+function registerNotificationsCommands(program2) {
+  const notifications = program2.command("notifications").description(
+    "Send in-app (and email) notifications to Suntropy users.\nUseful for Alexandria to proactively tell a user a task is done, since a\ndirect/email execution leaves no study comment (and thus no auto-notification)."
+  );
+  notifications.command("send").description(
+    `Send a notification to a user. It appears in the recipient's notification
+bell and, if enabled in their config, is also emailed. Sent FROM Alexandria
+by default so it is not shown as a self-notification.
+Examples:
+  suntropy notifications send --to-user <userUID> --message "He terminado el estudio."
+  suntropy notifications send --to-user <userUID> --title "Estudio listo" \\
+    --message "Revisa los resultados." --study <solarStudyId> --mention`
+  ).requiredOption("--to-user <userUID>", "Recipient userUID (who gets notified)").requiredOption("--message <text>", "Notification body (supports Markdown)").option("--title <text>", "Notification title", "Alexandria").option("--severity <severity>", `Severity: ${SEVERITIES.join(" | ")}`, "info").option(
+    "--mention",
+    `Send as a mention (type new_mention) instead of an update (new_comment). Mentions are gated by the user's "mention" notification setting.`
+  ).option(
+    "--study <solarStudyId>",
+    "Link the notification to a solar study: makes it click-through to that study"
+  ).option("--link <url>", "Custom link for the email call-to-action").option(
+    "--from-user <userUID>",
+    "Sender userUID shown as the author (default: the authenticated user)"
+  ).addOption(new Option2("--as-alexandria").hideHelp()).action(async (opts) => {
+    try {
+      const global = getGlobalOpts16(notifications);
+      const severity = opts.severity;
+      if (!SEVERITIES.includes(severity)) {
+        throw new Error(
+          `Invalid --severity "${opts.severity}". Use one of: ${SEVERITIES.join(", ")}.`
+        );
+      }
+      if (opts.study) assertStudyObjectId(opts.study);
+      const client = createServiceClient("notifications", global);
+      const profile = getActiveProfile(loadConfig());
+      const fromUserUid = opts.fromUser ? opts.fromUser : opts.asAlexandria ? ALEXANDRIA_USER_UID : profile.userUID;
+      const notification = {
+        notificationType: opts.mention ? "new_mention" : "new_comment",
+        severity,
+        origin: opts.asAlexandria ? "ALEXANDRIA" : "CLI",
+        fromUserUid,
+        toUserUid: opts.toUser,
+        notificationContent: {
+          contentType: "COMMENT",
+          name: opts.title,
+          description: opts.message,
+          ...opts.study ? { externalId: opts.study } : {},
+          ...opts.link ? { link: opts.link } : {},
+          // The notifications backend only persists notificationContent when a
+          // `data` payload is present (the OneToOne isn't cascaded), so without
+          // this the notification renders blank in the bell. Always send a
+          // small data object; harmless once the backend also persists content
+          // without it. Not read by the front for these types.
+          data: {
+            source: opts.asAlexandria ? "alexandria" : "cli",
+            ...opts.study ? { studyId: opts.study } : {}
+          }
+        }
+      };
+      const res = await client.post("/notifications", notification);
+      if (typeof res.data === "string") {
+        output(
+          { sent: false, reason: res.data, toUser: opts.toUser },
+          global
+        );
+        return;
+      }
+      output(
+        {
+          sent: true,
+          notificationId: res.data?.idNotification,
+          toUser: opts.toUser,
+          type: notification.notificationType,
+          severity
+        },
+        global
+      );
+    } catch (err) {
+      outputError(handleApiError(err));
+    }
+  });
+}
+
 // src/access.ts
 var COMMAND_TIERS = ["read", "write", "delete"];
 var TIER_VALUE = { read: 0, write: 1, delete: 2 };
@@ -4525,6 +4617,7 @@ var WRITE_VERBS = /* @__PURE__ */ new Set([
   "init-default",
   "add-comment",
   "comment",
+  "send",
   "calculate-results",
   "optimize-peakpower"
 ]);
@@ -4573,7 +4666,7 @@ function keepCommand(cmd, segs, max) {
 }
 
 // src/commands/command-profile.ts
-function getGlobalOpts16(cmd) {
+function getGlobalOpts17(cmd) {
   let root = cmd;
   while (root.parent) root = root.parent;
   return root.opts();
@@ -4581,7 +4674,7 @@ function getGlobalOpts16(cmd) {
 function registerCommandProfileCommand(program2) {
   program2.command("command-profile [tier]", { hidden: true }).description("Admin: get/set the command access profile (read | write | delete | reset)").action((tier) => {
     try {
-      const global = getGlobalOpts16(program2);
+      const global = getGlobalOpts17(program2);
       if (!tier) {
         const resolved = getActiveCommandProfile();
         output(
@@ -4636,9 +4729,9 @@ function registerCommandProfileCommand(program2) {
 }
 
 // src/index.ts
-var CLI_VERSION = true ? "0.11.5" : "0.0.0-dev";
+var CLI_VERSION = true ? "0.11.7" : "0.0.0-dev";
 function createProgram() {
-  const program2 = new Command3();
+  const program2 = new Command4();
   program2.name("suntropy").description("Agent-first CLI for Suntropy solar platform. Optimized for programmatic data manipulation and progressive exploration.").version(CLI_VERSION).option("--format <format>", "Output format: json (default), human, csv", "json").option("--fields <fields>", "Comma-separated fields to include in output").option("--server <url>", "Override API server URL").option("--token <jwt>", "Override authentication token").option("--profile <name>", "Use a specific config profile").option("--verbose", "Show HTTP request/response details on stderr").option("--quiet", "Suppress non-data output").option("--save <file>", "Save output to file (also writes to stdout)");
   registerAuthCommands(program2);
   registerConfigCommands(program2);
@@ -4651,6 +4744,7 @@ function createProgram() {
   registerShareableCommands(program2);
   registerTemplatesCommands(program2);
   registerGeocodeCommands(program2);
+  registerNotificationsCommands(program2);
   registerCommandProfileCommand(program2);
   applyCommandProfile(program2);
   return program2;