@enerlence/suntropy-cli 0.6.0 → 0.7.0

package/README.md

@@ -20,6 +20,10 @@ npx @enerlence/suntropy-cli <command>
 # API key (preferred for agents)
 suntropy auth set-key --key <jwt-api-key>
 
+# Target a specific server / profile (global options — see "Global Options")
+suntropy --server https://api-dev.example.cloud --profile dev auth set-key --key <jwt>
+suntropy --profile dev auth status
+
 # Email/password login
 suntropy auth login --email user@co.com --password pass
 
@@ -27,6 +31,10 @@ suntropy auth login --email user@co.com --password pass
 suntropy auth status
 ```
 
+> `--server`, `--profile` and `--token` are **global** options: pass them on the
+> root command (e.g. `suntropy --profile dev auth status`). They apply to every
+> subcommand, including `auth`.
+
 ## Global Options
 
 | Option | Default | Description |
@@ -254,6 +262,30 @@ suntropy shareables create --element-id <studyId> --data '{"customLayout":true}'
 `--element-type` (default `solarStudy`): `solarStudy | colectiveSolarStudy | veChargerStudy | heatpumpStudy | billing`.
 `--shareable-type` (default `TEMPLATE`): `TEMPLATE | CONTRACT`. The response includes the public `url` and `uid`.
 
+### `suntropy templates` - Document Templates
+
+List the client document templates (budget/document templates from the sharing
+service), proxied via solar under `GET /api/templates`. Returns only `_id` and
+`templateName`.
+
+```bash
+# Solar study templates (default --type solarStudy)
+suntropy templates list
+
+# Other template types
+suntropy templates list --type colectiveSolarStudy
+suntropy templates list --type veChargerStudy
+
+# Generic (untyped) templates
+suntropy templates list --type generic
+
+# Pick fields / change format
+suntropy templates list --fields _id,templateName --format csv
+```
+
+`--type` (default `solarStudy`): `solarStudy | colectiveSolarStudy | veChargerStudy | generic`.
+`generic` lists the untyped templates (sends no `templateIdentifier` filter).
+
 ### `suntropy config` - Configuration
 
 ```bash

package/dist/bin/suntropy.js

@@ -275,17 +275,18 @@ function getGlobalOpts(cmd) {
 }
 function registerAuthCommands(program2) {
   const auth = program2.command("auth").description("Authentication management");
-  auth.command("set-key").description("Set an API key (JWT) for authentication. Preferred method for agents.").requiredOption("--key <jwt>", "JWT API key").option("--server <url>", "API server URL").option("--profile <name>", "Profile name").action(async (opts) => {
+  auth.command("set-key").description("Set an API key (JWT) for authentication. Preferred method for agents.").requiredOption("--key <jwt>", "JWT API key").action(async (opts) => {
     try {
+      const global = getGlobalOpts(auth);
       const config = loadConfig();
-      const profileName = opts.profile || config.activeProfile;
+      const profileName = global.profile || config.activeProfile;
       if (!config.profiles[profileName]) {
         config.profiles[profileName] = { server: "https://api.enerlence.com" };
       }
       const profile = config.profiles[profileName];
       profile.token = opts.key;
       profile.authMethod = "api-key";
-      if (opts.server) profile.server = opts.server;
+      if (global.server) profile.server = global.server;
       try {
         const payload = JSON.parse(Buffer.from(opts.key.split(".")[1], "base64").toString());
         profile.clientUID = payload.clientUID;
@@ -298,15 +299,16 @@ function registerAuthCommands(program2) {
       outputError(err);
     }
   });
-  auth.command("login").description("Login with email and password").requiredOption("--email <email>", "User email").requiredOption("--password <password>", "User password").option("--server <url>", "API server URL").option("--profile <name>", "Profile name").action(async (opts) => {
+  auth.command("login").description("Login with email and password").requiredOption("--email <email>", "User email").requiredOption("--password <password>", "User password").action(async (opts) => {
     try {
+      const global = getGlobalOpts(auth);
       const config = loadConfig();
-      const profileName = opts.profile || config.activeProfile;
+      const profileName = global.profile || config.activeProfile;
       if (!config.profiles[profileName]) {
         config.profiles[profileName] = { server: "https://api.enerlence.com" };
       }
       const profile = config.profiles[profileName];
-      if (opts.server) profile.server = opts.server;
+      if (global.server) profile.server = global.server;
       const securityUrl = getServiceUrl(profile.server, "security");
       const client = createUnauthClient(securityUrl);
       const res = await client.post("/auth/login", { email: opts.email, password: opts.password });
@@ -334,10 +336,11 @@ function registerAuthCommands(program2) {
       outputError(handleApiError(err));
     }
   });
-  auth.command("status").description("Show current authentication status").option("--profile <name>", "Profile name").action(async (opts) => {
+  auth.command("status").description("Show current authentication status").action(async () => {
     try {
+      const global = getGlobalOpts(auth);
       const config = loadConfig();
-      const profile = getActiveProfile(config, opts.profile);
+      const profile = getActiveProfile(config, global.profile);
       if (!profile.token) {
         output({ authenticated: false, message: "No token configured" }, getGlobalOpts(auth));
         return;
@@ -367,11 +370,11 @@ function registerAuthCommands(program2) {
       outputError(err);
     }
   });
-  auth.command("refresh").description("Refresh the current JWT token").option("--profile <name>", "Profile name").action(async (opts) => {
+  auth.command("refresh").description("Refresh the current JWT token").action(async () => {
     try {
+      const globalOpts = getGlobalOpts(auth);
       const config = loadConfig();
-      const profileName = opts.profile || config.activeProfile;
-      const globalOpts = program2.opts();
+      const profileName = globalOpts.profile || config.activeProfile;
       const client = createServiceClient("security", { ...globalOpts, profile: profileName });
       const res = await client.get("/auth/jwt/refreshToken");
       if (res.data?.access_token || res.data?.token?.access_token) {
@@ -4206,12 +4209,44 @@ function registerShareableCommands(program2) {
   });
 }
 
-// src/commands/geocode/index.ts
+// src/commands/templates/index.ts
 function getGlobalOpts14(cmd) {
   let root = cmd;
   while (root.parent) root = root.parent;
   return root.opts();
 }
+function registerTemplatesCommands(program2) {
+  const templates = program2.command("templates").description(
+    "Read client document templates (id + name), proxied via solar from the sharing service."
+  );
+  templates.command("list").description(
+    "List templates returning only _id and templateName (GET /api/templates).\nDefaults to the solar study templates (--type solarStudy).\n\nTypes: solarStudy (default) | colectiveSolarStudy | veChargerStudy.\nUse --type generic for the generic (untyped) templates.\n\nExamples:\n  suntropy templates list\n  suntropy templates list --type colectiveSolarStudy\n  suntropy templates list --type generic --fields _id,templateName --format csv"
+  ).option(
+    "--type <identifier>",
+    "solarStudy (default) | colectiveSolarStudy | veChargerStudy | generic",
+    "solarStudy"
+  ).action(async (opts) => {
+    try {
+      const global = getGlobalOpts14(templates);
+      const client = createServiceClient("solar", global);
+      const params = {};
+      if (opts.type && opts.type !== "generic") {
+        params.templateIdentifier = opts.type;
+      }
+      const res = await client.get("/api/templates", { params });
+      output(res.data, global);
+    } catch (err) {
+      outputError(handleApiError(err));
+    }
+  });
+}
+
+// src/commands/geocode/index.ts
+function getGlobalOpts15(cmd) {
+  let root = cmd;
+  while (root.parent) root = root.parent;
+  return root.opts();
+}
 function emit(envelope, all, query, global) {
   if (envelope.error) {
     outputError({
@@ -4245,7 +4280,7 @@ function registerGeocodeCommands(program2) {
     'Resolve an address into coordinates (lat/lng + formatted address).\nExamples:\n  suntropy geocode resolve --address "Calle Mayor 1, Madrid"\n  suntropy geocode resolve --address "Gran V\xEDa, Madrid" --country es --all'
   ).requiredOption("--address <string>", "Address to geocode (quote it)").option("--country <code>", "Bias results to a country (ISO code, e.g. es, pt, it)").option("--all", "Return all candidate matches instead of only the best one").action(async (opts) => {
     try {
-      const global = getGlobalOpts14(geocode);
+      const global = getGlobalOpts15(geocode);
       const client = createServiceClient("solar", global);
       const res = await client.get(
         "/api/geocode",
@@ -4260,7 +4295,7 @@ function registerGeocodeCommands(program2) {
     "Resolve coordinates into an address (reverse geocoding).\nExample:\n  suntropy geocode reverse --lat 40.4168 --lng -3.7038"
   ).requiredOption("--lat <number>", "Latitude").requiredOption("--lng <number>", "Longitude").option("--all", "Return all candidate matches instead of only the best one").action(async (opts) => {
     try {
-      const global = getGlobalOpts14(geocode);
+      const global = getGlobalOpts15(geocode);
       const client = createServiceClient("solar", global);
       const res = await client.get(
         "/api/reverse-geocode",
@@ -4274,7 +4309,7 @@ function registerGeocodeCommands(program2) {
 }
 
 // src/index.ts
-var CLI_VERSION = true ? "0.6.0" : "0.0.0-dev";
+var CLI_VERSION = true ? "0.7.0" : "0.0.0-dev";
 function createProgram() {
   const program2 = new Command2();
   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)");
@@ -4287,6 +4322,7 @@ function createProgram() {
   registerSolarformCommands(program2);
   registerPPACommands(program2);
   registerShareableCommands(program2);
+  registerTemplatesCommands(program2);
   registerGeocodeCommands(program2);
   return program2;
 }