@enerlence/suntropy-cli 0.11.8 → 0.11.9

package/dist/bin/suntropy.js

@@ -1324,7 +1324,11 @@ function createResourceCommands(cfg) {
       const client = createServiceClient(service, global);
       const body = parseData(opts.data);
       if (cfg.putBodyOnly) {
-        const res = await client.put(cfg.basePath, { ...body, [cfg.idField]: id });
+        const numericId = Number(id);
+        const res = await client.put(cfg.basePath, {
+          ...body,
+          [cfg.idField]: Number.isFinite(numericId) ? numericId : id
+        });
         output(res.data, global);
       } else {
         const res = await client.put(`${cfg.basePath}/${id}`, body);
@@ -2141,6 +2145,21 @@ function updateStudy(filePath, updater) {
     cascadeResets
   };
 }
+function distributePanels(surfaces, total) {
+  if (!surfaces.length) return [];
+  if (surfaces.length === 1) return [total];
+  const current = surfaces.map((s) => Number(s.panelNumber) || 0);
+  const currentTotal = current.reduce((a, b) => a + b, 0);
+  const weights = currentTotal > 0 ? current.map((n) => n / currentTotal) : surfaces.map(() => 1 / surfaces.length);
+  const counts = weights.map((w) => Math.floor(total * w));
+  let remainder = total - counts.reduce((a, b) => a + b, 0);
+  const order = counts.map((n, i) => ({ n, i })).sort((a, b) => b.n - a.n).map((x) => x.i);
+  for (let k = 0; remainder > 0; k = (k + 1) % order.length) {
+    counts[order[k]] += 1;
+    remainder -= 1;
+  }
+  return counts;
+}
 function deepMerge(target, source) {
   for (const key of Object.keys(source)) {
     const sv = source[key];
@@ -2559,26 +2578,45 @@ Examples:
     }
   });
   set.command("panel").description(
-    'Set solar panel for the study. Auto-sets peakPowerIntroductionMode to "solarPanel".\nFetches full panel data from inventory.\nExample: suntropy studies set panel --file study.json --panel-id 456 --panels-count 12'
-  ).option("--file <path>", "Study file path").requiredOption("--panel-id <n>", "Solar panel ID from inventory").option("--panels-count <n>", "Number of panels").action(async (opts) => {
+    'Set solar panel for the study. Auto-sets peakPowerIntroductionMode to "solarPanel".\nFetches full panel data from inventory.\n--panels-count is the TOTAL for the study: it is spread over the surfaces keeping\ntheir current proportion (use --surface-index to target a single surface).\nThe response lists the resulting panelNumber per surface.\nExample: suntropy studies set panel --file study.json --panel-id 456 --panels-count 12'
+  ).option("--file <path>", "Study file path").requiredOption("--panel-id <n>", "Solar panel ID from inventory").option("--panels-count <n>", "TOTAL number of panels of the study, spread over its surfaces keeping their current proportion").option("--surface-index <n>", "Apply --panels-count to this surface only (0-based) instead of spreading it").action(async (opts) => {
     try {
       const global = getGlobalOpts7(studies);
       const solarClient = createServiceClient("solar", global);
       const panelRes = await solarClient.get(`/solar-panels/${opts.panelId}`);
       const panel = panelRes.data;
+      let distribution = [];
       const result = updateStudy(resolveFile(opts), (study) => {
         study.solarPanel = panel;
         study.peakPowerIntroductionMode = "solarPanel";
         study.solarKit = void 0;
         if (opts.panelsCount) {
           const surfaces = study.surfaces;
+          const total = parseInt(opts.panelsCount);
           if (surfaces?.length) {
-            surfaces[0].panelNumber = parseInt(opts.panelsCount);
+            if (opts.surfaceIndex !== void 0) {
+              const idx = parseInt(opts.surfaceIndex);
+              if (!Number.isInteger(idx) || idx < 0 || idx >= surfaces.length) {
+                throw new Error(
+                  `--surface-index ${opts.surfaceIndex} is out of range: the study has ${surfaces.length} surface(s)`
+                );
+              }
+              surfaces[idx].panelNumber = total;
+            } else {
+              const counts = distributePanels(surfaces, total);
+              surfaces.forEach((surface, i) => {
+                surface.panelNumber = counts[i];
+              });
+            }
+            distribution = surfaces.map((surface, i) => ({
+              surfaceIndex: i,
+              panelNumber: Number(surface.panelNumber) || 0
+            }));
           }
         }
         return void 0;
       });
-      output(result, global);
+      output(distribution.length ? { ...result, surfaces: distribution } : result, global);
     } catch (err) {
       outputError(handleApiError(err));
     }
@@ -2610,7 +2648,7 @@ Examples:
     }
   });
   set.command("inverter").description(
-    "Set inverter(s) for the study (when using solarPanel mode).\nExample: suntropy studies set inverter --file study.json --inverter-id 789"
+    "Set inverter(s) for the study (when using solarPanel mode).\nREPLACES the whole list: pass every inverter of the installation, comma-separated,\nrepeating an id as many times as units there are. The response reports how many\nwere there before and how many are there now.\nExample: suntropy studies set inverter --file study.json --inverter-id 789,789"
   ).option("--file <path>", "Study file path").requiredOption("--inverter-id <ids>", "Inverter ID(s), comma-separated for multiple").action(async (opts) => {
     try {
       const global = getGlobalOpts7(studies);
@@ -2621,11 +2659,13 @@ Examples:
         const res = await solarClient.get(`/solar-inverter/${id}`);
         inverters.push(res.data);
       }
+      let previousCount = 0;
       const result = updateStudy(resolveFile(opts), (study) => {
+        previousCount = study.solarInverters?.length ?? 0;
         study.solarInverters = inverters;
         return void 0;
       });
-      output(result, global);
+      output({ ...result, inverters: { before: previousCount, after: inverters.length } }, global);
     } catch (err) {
       outputError(handleApiError(err));
     }
@@ -4729,7 +4769,7 @@ function registerCommandProfileCommand(program2) {
 }
 
 // src/index.ts
-var CLI_VERSION = true ? "0.11.8" : "0.0.0-dev";
+var CLI_VERSION = true ? "0.11.9" : "0.0.0-dev";
 function createProgram() {
   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)");