@enerlence/suntropy-cli 0.11.4 → 0.11.5

package/dist/bin/suntropy.js

@@ -139,6 +139,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 +2284,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 +3280,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 +3604,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 +3618,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 +3641,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}`);
@@ -4622,7 +4636,7 @@ function registerCommandProfileCommand(program2) {
 }
 
 // src/index.ts
-var CLI_VERSION = true ? "0.11.4" : "0.0.0-dev";
+var CLI_VERSION = true ? "0.11.5" : "0.0.0-dev";
 function createProgram() {
   const program2 = new Command3();
   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)");