@enerlence/suntropy-cli 0.11.4 → 0.11.6

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+$/)) {
@@ -139,6 +141,15 @@ function createUnauthClient(baseURL) {
     headers: { "Content-Type": "application/json" }
   });
 }
+var OBJECT_ID_RE = /^[a-f0-9]{24}$/i;
+function assertStudyObjectId(id) {
+  if (OBJECT_ID_RE.test(id)) return id;
+  const looksLikeUuid = /^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/i.test(id);
+  const hint = looksLikeUuid ? `It looks like a UUID (e.g. a chat or shareable uid), not a study _id.` : `A study _id is a 24-character hex MongoDB ObjectId.`;
+  throw new Error(
+    `Invalid study id: "${id}". ${hint} Get the correct id from \`suntropy studies list\` (the \`solarStudyId\` field).`
+  );
+}
 function assertFound(data, entity, id) {
   const isEmptyObject = data != null && typeof data === "object" && !Array.isArray(data) && Object.keys(data).length === 0;
   if (data == null || typeof data !== "object" || Array.isArray(data) || isEmptyObject) {
@@ -2275,6 +2286,7 @@ function registerStudyBuilderCommands(studies) {
     "Download an existing study from the backend into a local file.\nExample: suntropy studies pull abc123 --file /tmp/study.json"
   ).option("--file <path>", "Output file path").action(async (studyId, opts) => {
     try {
+      assertStudyObjectId(studyId);
       const filePath = resolveFile(opts);
       const global = getGlobalOpts7(studies);
       const client = createServiceClient("solar", global);
@@ -3270,6 +3282,7 @@ Example: suntropy studies set data --file study.json --data '{"referenceId":"REF
     'Add a comment to an existing study via API.\nExample: suntropy studies comment abc123 --content "Revisado por agente"'
   ).requiredOption("--content <text>", "Comment text").addOption(new Option("--as-alexandria").hideHelp()).addOption(new Option("--reply-to-user <userUID>").hideHelp()).addOption(new Option("--reply-to-name <name>").hideHelp()).action(async (studyId, opts) => {
     try {
+      assertStudyObjectId(studyId);
       const global = getGlobalOpts7(studies);
       const client = createServiceClient("solar", global);
       const comment = createComment("commented", opts.content, {
@@ -3593,6 +3606,7 @@ function registerStudiesCommands(program2) {
   });
   studies.command("metadata <id>").description("Get solar study metadata by metadata ID (relational). Full MySQL record with state, costs, versions.").option("--by-study-id", "Interpret <id> as MongoDB solarStudyId instead of metadata ID").action(async (id, opts) => {
     try {
+      if (opts.byStudyId) assertStudyObjectId(id);
       const global = getGlobalOpts8(studies);
       const client = createServiceClient("solar", global);
       const path = opts.byStudyId ? `/solar-study/metadata/solar-study-id/${id}` : `/solar-study/findSolarStudyMetadataById/${id}`;
@@ -3606,6 +3620,7 @@ function registerStudiesCommands(program2) {
     "Get solar study by MongoDB ID. By default returns summary (no heavy curves).\nExpand sections: surfaces, results, economics, batteries, consumption, equipment, client, location\nExamples:\n  suntropy studies get abc123\n  suntropy studies get abc123 --expand surfaces,results\n  suntropy studies get abc123 --expand all\n  suntropy studies get abc123 --fields name,market  (bypasses expand filter)"
   ).option("--expand <sections>", 'Comma-separated sections to expand (or "all")').action(async (studyId, opts) => {
     try {
+      assertStudyObjectId(studyId);
       const global = getGlobalOpts8(studies);
       const client = createServiceClient("solar", global);
       const res = await client.get(`/solar-study/findById/${studyId}`);
@@ -3628,6 +3643,7 @@ function registerStudiesCommands(program2) {
     "Extract and analyze a PowerCurve from a study.\nCurve names: consumption, production, net-consumption, excesses\nDefault: --stats. Use --raw for full hourly data (8760 values).\nUse --monthly for monthly aggregates, --daily for daily totals."
   ).option("--stats", "Show statistics (default if no other flag)").option("--monthly", "Monthly accumulated values").option("--daily", "Daily accumulated values").option("--raw", "Full hourly DayCurve[] data").option("--total", "Just the total accumulated value").option("--surface-index <n>", "Surface index for production curve", "0").option("--save <file>", "Save curve data to file").action(async (studyId, curveName, opts) => {
     try {
+      assertStudyObjectId(studyId);
       const global = getGlobalOpts8(studies);
       const client = createServiceClient("solar", global);
       const res = await client.get(`/solar-study/findById/${studyId}`);
@@ -4461,6 +4477,87 @@ 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 } : {}
+        }
+      };
+      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 };
@@ -4511,6 +4608,7 @@ var WRITE_VERBS = /* @__PURE__ */ new Set([
   "init-default",
   "add-comment",
   "comment",
+  "send",
   "calculate-results",
   "optimize-peakpower"
 ]);
@@ -4559,7 +4657,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();
@@ -4567,7 +4665,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(
@@ -4622,9 +4720,9 @@ function registerCommandProfileCommand(program2) {
 }
 
 // src/index.ts
-var CLI_VERSION = true ? "0.11.4" : "0.0.0-dev";
+var CLI_VERSION = true ? "0.11.6" : "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);
@@ -4637,6 +4735,7 @@ function createProgram() {
   registerShareableCommands(program2);
   registerTemplatesCommands(program2);
   registerGeocodeCommands(program2);
+  registerNotificationsCommands(program2);
   registerCommandProfileCommand(program2);
   applyCommandProfile(program2);
   return program2;