@enerlence/suntropy-cli 0.2.0 → 0.3.0

package/dist/bin/suntropy.js

@@ -2617,6 +2617,50 @@ var EXPAND_SECTIONS = {
   client: ["clientDetails", "clientsDetails"],
   location: ["location", "mapCenter", "geographicalZone", "atrTariff"]
 };
+var METADATA_ONLY_FIELDS = {
+  peakPower: "metadata",
+  sellingPrice: "metadata",
+  totalCost: "metadata",
+  anualProduction: "metadata",
+  anualConsumption: "metadata",
+  currentState: "metadata",
+  clientName: "metadata",
+  idSolarStudyMetadata: "metadata",
+  solarStudyId: "metadata"
+};
+var COMPUTED_OR_UNKNOWN_FIELDS = {
+  completionPercentage: "computed by `studies validate` / `studies save` from stepsProgress",
+  isCompleted: "not a persisted field; derive from solarStudyProgress or completionPercentage",
+  stepsProgress: "computed by `studies validate` / `studies save`"
+};
+function explainMissingStudyFields(missing, studyId) {
+  const metadataFields = missing.filter((f) => f in METADATA_ONLY_FIELDS);
+  const computedFields = missing.filter((f) => f in COMPUTED_OR_UNKNOWN_FIELDS);
+  const unknownFields = missing.filter((f) => !(f in METADATA_ONLY_FIELDS) && !(f in COMPUTED_OR_UNKNOWN_FIELDS));
+  const lines = [];
+  lines.push(`warning: ${missing.length} requested field(s) are not present on the study document returned by findById.`);
+  if (metadataFields.length > 0) {
+    lines.push("");
+    lines.push(`  These fields live on the STUDY METADATA (MySQL), not on the study document:`);
+    for (const f of metadataFields) lines.push(`    - ${f}`);
+    lines.push(`  Use:  suntropy studies metadata ${studyId} --by-study-id --fields ${metadataFields.join(",")}`);
+    lines.push(`  Or:   suntropy studies list --client-name <name>   (list already projects these fields)`);
+  }
+  if (computedFields.length > 0) {
+    lines.push("");
+    lines.push(`  These fields are not persisted on the study:`);
+    for (const f of computedFields) lines.push(`    - ${f}: ${COMPUTED_OR_UNKNOWN_FIELDS[f]}`);
+    lines.push(`  Use:  suntropy studies validate ${studyId}   (returns stepsProgress + completionPercentage)`);
+  }
+  if (unknownFields.length > 0) {
+    lines.push("");
+    lines.push(`  These fields were not found on the study document:`);
+    for (const f of unknownFields) lines.push(`    - ${f}`);
+    lines.push(`  If you expected them, try:  suntropy studies get ${studyId} --expand all --format json`);
+    lines.push(`  and inspect the full payload to locate the correct field path.`);
+  }
+  process.stderr.write(lines.join("\n") + "\n");
+}
 var CORE_FIELDS = [
   "_id",
   "id",
@@ -2701,14 +2745,22 @@ function registerStudiesCommands(program2) {
     }
   });
   studies.command("get <studyId>").description(
-    "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"
+    "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 {
       const global = getGlobalOpts7(studies);
       const client = createServiceClient("solar", global);
       const res = await client.get(`/solar-study/findById/${studyId}`);
       const study = res.data;
-      const filtered = filterStudy(study, opts.expand);
+      const filtered = global.fields ? study : filterStudy(study, opts.expand);
+      if (global.fields) {
+        const requested = global.fields.split(",").map((f) => f.trim());
+        const topLevel = requested.map((f) => f.split(".")[0]);
+        const missing = topLevel.filter((f) => !(f in study));
+        if (missing.length > 0) {
+          explainMissingStudyFields(missing, studyId);
+        }
+      }
       output(filtered, global);
     } catch (err) {
       outputError(handleApiError(err));