@reporting-bi/cli 0.0.2 → 0.0.3

package/README.md

@@ -29,18 +29,28 @@ Originally built for browser use (`rp-app-auth` login page), it may require adap
 
 **Important:** `rp-vscode` currently has its own auth implementation (`src/auth.ts`) with VS Code-specific OAuth2 flow (local HTTP callback server, VS Code secrets storage). This will be refactored to use `rp-auth-client-v2` instead, keeping only VS Code-specific concerns (secrets API, URI handler) in the extension.
 
-## Planned Features
+## Features
 
-- **Authentication** — Login via `rp-auth-client-v2` (OAuth2, token storage & refresh)
-- **ETL management** — List, view, edit, and execute ETL threads
-- **SQL execution** — Run SQL queries against Reporting.bi databases
-- **Accounting management** — List and switch between accountings
-- **Schema inspection** — Browse database objects (tables, procedures, functions)
-- **Module management** — List accounting modules and definitions
+- **Authentication** — OAuth2 login via browser, token storage & refresh
+- **ETL** — List, view, search, and execute ETL threads
+- **Jobs** — List, start, stop, and monitor SQL Agent jobs
+- **Analytics** — Browse report contexts, execute reports, list dimensions/years
+- **Users** — List users, view profiles, check access rights and roles
+- **Definition** — Browse statements, dimensions, modules, scenarios, fiscal years
+- **MDM** — Browse master data tables, view values, export as CSV
+- **Helpdesk** — List/view tickets, read messages, create new tickets
+- **Wiki** — Full CRUD for wiki pages (list, read, search, save, delete)
+- **Accounting** — List and switch between accountings
+
+All commands output formatted tables by default, with `--json` flag for raw JSON output.
+
+## Installation
+
+See [INSTALL.md](INSTALL.md) for installation instructions.
 
 ## Tech Stack
 
-- Node.js + TypeScript
+- Node.js + TypeScript, bundled with esbuild (zero runtime dependencies)
 - `@reporting/rp-auth-client-v2` — Shared authentication client (OAuth2)
 - `@reporting/rp-client` — HTTP client for Reporting.bi microservices
 - `@reporting/rp-types` — Shared TypeScript types
@@ -48,6 +58,7 @@ Originally built for browser use (`rp-app-auth` login page), it may require adap
 ## Development
 
 ```bash
-yarn build    # compile TypeScript
-yarn watch    # compile in watch mode
+yarn build    # bundle with esbuild
+yarn watch    # bundle in watch mode
+yarn release  # bump version, build, commit, push, publish to npm
 ```

package/dist/index.js

@@ -663,16 +663,16 @@ var require_side_channel_list = __commonJS({
     "use strict";
     var inspect = require_object_inspect();
     var $TypeError = require_type();
-    var listGetNode = function(list3, key, isDelete) {
-      var prev = list3;
+    var listGetNode = function(list7, key, isDelete) {
+      var prev = list7;
       var curr;
       for (; (curr = prev.next) != null; prev = curr) {
         if (curr.key === key) {
           prev.next = curr.next;
           if (!isDelete) {
             curr.next = /** @type {NonNullable<typeof list.next>} */
-            list3.next;
-            list3.next = curr;
+            list7.next;
+            list7.next = curr;
           }
           return curr;
         }
@@ -2106,9 +2106,9 @@ var require_stringify = __commonJS({
         }
         return [formatter(prefix) + "=" + formatter(String(obj))];
       }
-      var values = [];
+      var values2 = [];
       if (typeof obj === "undefined") {
-        return values;
+        return values2;
       }
       var objKeys;
       if (generateArrayPrefix === "comma" && isArray(obj)) {
@@ -2138,7 +2138,7 @@ var require_stringify = __commonJS({
         sideChannel.set(object, step);
         var valueSideChannel = getSideChannel();
         valueSideChannel.set(sentinel, sideChannel);
-        pushToArray(values, stringify2(
+        pushToArray(values2, stringify2(
           value,
           keyPrefix,
           generateArrayPrefix,
@@ -2159,7 +2159,7 @@ var require_stringify = __commonJS({
           valueSideChannel
         ));
       }
-      return values;
+      return values2;
     };
     var normalizeStringifyOptions = function normalizeStringifyOptions2(opts) {
       if (!opts) {
@@ -3423,8 +3423,8 @@ async function get(id, flags) {
 async function read(id, flags) {
   const lang = flags.lang || DEFAULT_LANG;
   const service = createService("wiki");
-  const content = await service.get(`pageContent/${lang}/${id}`, void 0, { parseResponse: false });
-  process.stdout.write(content || "");
+  const content2 = await service.get(`pageContent/${lang}/${id}`, void 0, { parseResponse: false });
+  process.stdout.write(content2 || "");
 }
 async function search(query, flags) {
   const service = createService("wiki");
@@ -3452,10 +3452,10 @@ async function readContent(flags) {
 async function save(id, flags) {
   const lang = flags.lang || DEFAULT_LANG;
   const service = createService("wiki");
-  const content = await readContent(flags);
+  const content2 = await readContent(flags);
   const page = {
     lang,
-    content
+    content: content2
   };
   if (id) page.id_wiki_page = parseInt(id);
   if (flags.name) page.name = flags.name;
@@ -3506,8 +3506,517 @@ async function wiki(args2) {
   }
 }
 
+// src/commands/etl.ts
+var fs3 = __toESM(require("node:fs"));
+async function list3(flags) {
+  const service = createService("etl");
+  const threads = await service.get("threads");
+  output(threads || [], flags);
+}
+async function get2(id, flags) {
+  const service = createService("etl");
+  const thread = await service.get(`threads/${id}`);
+  output(thread, flags);
+}
+async function content(id, flags) {
+  const service = createService("etl");
+  const text = await service.get(`threadContent/${id}`, void 0, { parseResponse: false });
+  process.stdout.write(text || "");
+}
+async function exec2(id, flags) {
+  const service = createService("etl");
+  let body = void 0;
+  if (flags.file) {
+    body = fs3.readFileSync(flags.file, "utf-8");
+  } else if (flags.sql) {
+    body = flags.sql;
+  }
+  const result = await service.post(`exec/${id}`, body, { parseResponse: false });
+  process.stdout.write(result || "");
+}
+async function search2(query, flags) {
+  const service = createService("etl");
+  const results = await service.get("search", { q: query });
+  output(results || [], flags);
+}
+async function etl(args2) {
+  const { positional, flags } = parseArgs(args2);
+  const [subcommand, ...rest] = positional;
+  switch (subcommand) {
+    case "list":
+      return list3(flags);
+    case "get":
+      if (!rest[0]) {
+        console.error("Usage: rp etl get <id>");
+        process.exit(1);
+      }
+      return get2(rest[0], flags);
+    case "content":
+      if (!rest[0]) {
+        console.error("Usage: rp etl content <id>");
+        process.exit(1);
+      }
+      return content(rest[0], flags);
+    case "exec":
+      if (!rest[0]) {
+        console.error('Usage: rp etl exec <id> [--sql "..."] [--file path]');
+        process.exit(1);
+      }
+      return exec2(rest[0], flags);
+    case "search":
+      if (!rest[0]) {
+        console.error("Usage: rp etl search <query>");
+        process.exit(1);
+      }
+      return search2(rest[0], flags);
+    default:
+      console.log("Usage: rp etl <list|get|content|exec|search> [options]");
+      break;
+  }
+}
+
+// src/commands/jobs.ts
+async function list4(flags) {
+  const service = createService("jobs");
+  const jobs2 = await service.get("userJobs");
+  output(jobs2 || [], flags);
+}
+async function start(jobName, flags) {
+  const service = createService("jobs");
+  await service.get("start", { job_name: jobName });
+  console.log(`Job "${jobName}" started.`);
+}
+async function stop(jobName, flags) {
+  const service = createService("jobs");
+  await service.get("stop", { job_name: jobName });
+  console.log(`Job "${jobName}" stopped.`);
+}
+async function statusCmd(flags) {
+  const service = createService("jobs");
+  const statuses = await service.get("jobStatuses");
+  output(statuses || [], flags);
+}
+async function jobs(args2) {
+  const { positional, flags } = parseArgs(args2);
+  const [subcommand, ...rest] = positional;
+  switch (subcommand) {
+    case "list":
+      return list4(flags);
+    case "start":
+      if (!rest[0]) {
+        console.error("Usage: rp jobs start <job_name>");
+        process.exit(1);
+      }
+      return start(rest[0], flags);
+    case "stop":
+      if (!rest[0]) {
+        console.error("Usage: rp jobs stop <job_name>");
+        process.exit(1);
+      }
+      return stop(rest[0], flags);
+    case "status":
+      return statusCmd(flags);
+    default:
+      console.log("Usage: rp jobs <list|start|stop|status> [options]");
+      break;
+  }
+}
+
+// src/commands/analytics.ts
+async function contexts(flags) {
+  const service = createService("analytics");
+  const ctxs = await service.get("namedContext");
+  output(ctxs || [], flags);
+}
+async function getContext(id, flags) {
+  const service = createService("analytics");
+  const ctx = await service.get(`context/${id}`);
+  output(ctx, flags);
+}
+async function report(id, flags) {
+  const service = createService("analytics");
+  const index = flags.index || "0";
+  const result = await service.get(`report/${id}/${index}`, void 0, { parseResponse: false });
+  process.stdout.write(result || "");
+}
+async function dimensions(flags) {
+  const module2 = flags.module || flags.m;
+  if (!module2) {
+    console.error("Usage: rp analytics dimensions --module <module>");
+    process.exit(1);
+  }
+  const service = createService("definition");
+  const dims = await service.get(`visibleDimensions/${module2}`);
+  output(dims || [], flags);
+}
+async function periods(flags) {
+  const service = createService("analytics");
+  const tree = await service.get("years");
+  output(tree || [], flags);
+}
+async function analytics(args2) {
+  const { positional, flags } = parseArgs(args2);
+  const [subcommand, ...rest] = positional;
+  switch (subcommand) {
+    case "contexts":
+      return contexts(flags);
+    case "context":
+      if (!rest[0]) {
+        console.error("Usage: rp analytics context <id>");
+        process.exit(1);
+      }
+      return getContext(rest[0], flags);
+    case "report":
+      if (!rest[0]) {
+        console.error("Usage: rp analytics report <context_id> [--index N]");
+        process.exit(1);
+      }
+      return report(rest[0], flags);
+    case "dimensions":
+      return dimensions(flags);
+    case "years":
+      return periods(flags);
+    default:
+      console.log("Usage: rp analytics <contexts|context|report|dimensions|years> [options]");
+      break;
+  }
+}
+
+// src/commands/users.ts
+async function list5(flags) {
+  const service = createService("users");
+  const users2 = await service.get("allUsers");
+  output(users2 || [], flags);
+}
+async function get3(user, flags) {
+  const service = createService("users");
+  const result = await service.get(user);
+  output(result, flags);
+}
+async function rights(flags) {
+  const service = createService("users");
+  const result = await service.get("userRights");
+  output(result || [], flags);
+}
+async function roles(flags) {
+  const service = createService("users");
+  const result = await service.get("accessRoles");
+  output(result || [], flags);
+}
+async function users(args2) {
+  const { positional, flags } = parseArgs(args2);
+  const [subcommand, ...rest] = positional;
+  switch (subcommand) {
+    case "list":
+      return list5(flags);
+    case "get":
+      return get3(rest[0] || "me", flags);
+    case "me":
+      return get3("me", flags);
+    case "rights":
+      return rights(flags);
+    case "roles":
+      return roles(flags);
+    default:
+      console.log("Usage: rp users <list|get|me|rights|roles> [options]");
+      break;
+  }
+}
+
+// src/commands/def.ts
+async function statements(flags) {
+  const service = createService("definition");
+  const result = await service.get("finStatements");
+  output(result || [], flags);
+}
+async function statement(id, flags) {
+  const service = createService("definition");
+  const result = await service.get(`finStatement/${id}`);
+  output(result, flags);
+}
+async function dimensions2(flags) {
+  const module2 = flags.module || flags.m;
+  if (!module2) {
+    console.error("Usage: rp def dimensions --module <module>");
+    process.exit(1);
+  }
+  const service = createService("definition");
+  const result = await service.get(`dimensions/${module2}`);
+  output(result || [], flags);
+}
+async function modules(flags) {
+  const service = createService("definition");
+  const result = await service.get("modules");
+  output(result || [], flags);
+}
+async function scenarios(flags) {
+  const service = createService("definition");
+  const result = await service.get("scenarios");
+  output(result || [], flags);
+}
+async function fiscalYears(flags) {
+  const service = createService("definition");
+  const result = await service.get("fiscalYears");
+  output(result || [], flags);
+}
+async function def(args2) {
+  const { positional, flags } = parseArgs(args2);
+  const [subcommand, ...rest] = positional;
+  switch (subcommand) {
+    case "statements":
+      return statements(flags);
+    case "statement":
+      if (!rest[0]) {
+        console.error("Usage: rp def statement <id>");
+        process.exit(1);
+      }
+      return statement(rest[0], flags);
+    case "dimensions":
+      return dimensions2(flags);
+    case "modules":
+      return modules(flags);
+    case "scenarios":
+      return scenarios(flags);
+    case "fiscal-years":
+      return fiscalYears(flags);
+    default:
+      console.log("Usage: rp def <statements|statement|dimensions|modules|scenarios|fiscal-years> [options]");
+      break;
+  }
+}
+
+// src/commands/mdm.ts
+async function tables(flags) {
+  const service = createService("mdm");
+  const result = await service.get("tableDefinitions");
+  output(result || [], flags);
+}
+async function table(id, flags) {
+  const service = createService("mdm");
+  const result = await service.get(`tableDefinition/${id}`);
+  output(result, flags);
+}
+async function columns(id, flags) {
+  const service = createService("mdm");
+  const result = await service.get(`columnDefinitions/${id}`);
+  output(result || [], flags);
+}
+async function values(id, flags) {
+  const service = createService("mdm");
+  const result = await service.get(`values/${id}`);
+  output(result || [], flags);
+}
+async function exportCsv(id, flags) {
+  const service = createService("mdm");
+  const type = flags.type || "mdm";
+  const result = await service.get(`export/${id}/${type}`, void 0, { parseResponse: false });
+  process.stdout.write(result || "");
+}
+async function mdm(args2) {
+  const { positional, flags } = parseArgs(args2);
+  const [subcommand, ...rest] = positional;
+  switch (subcommand) {
+    case "tables":
+      return tables(flags);
+    case "table":
+      if (!rest[0]) {
+        console.error("Usage: rp mdm table <id>");
+        process.exit(1);
+      }
+      return table(rest[0], flags);
+    case "columns":
+      if (!rest[0]) {
+        console.error("Usage: rp mdm columns <id>");
+        process.exit(1);
+      }
+      return columns(rest[0], flags);
+    case "values":
+      if (!rest[0]) {
+        console.error("Usage: rp mdm values <id>");
+        process.exit(1);
+      }
+      return values(rest[0], flags);
+    case "export":
+      if (!rest[0]) {
+        console.error("Usage: rp mdm export <id> [--type mdm|sql]");
+        process.exit(1);
+      }
+      return exportCsv(rest[0], flags);
+    default:
+      console.log("Usage: rp mdm <tables|table|columns|values|export> [options]");
+      break;
+  }
+}
+
+// src/commands/helpdesk.ts
+async function list6(flags) {
+  const service = createService("helpdesk");
+  const tickets = await service.get("tickets");
+  output(tickets || [], flags);
+}
+async function get4(id, flags) {
+  const service = createService("helpdesk");
+  const ticket = await service.get(`ticket/${id}`);
+  output(ticket, flags);
+}
+async function messages(id, flags) {
+  const service = createService("helpdesk");
+  const msgs = await service.get(`messages/${id}`);
+  output(msgs || [], flags);
+}
+async function create(flags) {
+  const subject = flags.subject;
+  const text = flags.text;
+  if (!subject) {
+    console.error('Usage: rp helpdesk create --subject "..." [--text "..."] [--priority N]');
+    process.exit(1);
+  }
+  const service = createService("helpdesk");
+  const ticket = { subject };
+  if (flags.priority) ticket.priority = parseInt(flags.priority);
+  const result = await service.post("ticket", ticket);
+  if (text && result?.id_request) {
+    await service.post("message", { id_request: result.id_request, text });
+  }
+  output(result, flags);
+}
+async function helpdesk(args2) {
+  const { positional, flags } = parseArgs(args2);
+  const [subcommand, ...rest] = positional;
+  switch (subcommand) {
+    case "list":
+      return list6(flags);
+    case "get":
+      if (!rest[0]) {
+        console.error("Usage: rp helpdesk get <id>");
+        process.exit(1);
+      }
+      return get4(rest[0], flags);
+    case "messages":
+      if (!rest[0]) {
+        console.error("Usage: rp helpdesk messages <ticket_id>");
+        process.exit(1);
+      }
+      return messages(rest[0], flags);
+    case "create":
+      return create(flags);
+    default:
+      console.log("Usage: rp helpdesk <list|get|messages|create> [options]");
+      break;
+  }
+}
+
 // USAGE.md
-var USAGE_default = 'Reporting.bi CLI\n\nUsage: rp <command> [options]\n\nCommands:\n  login [domain] [--accounting <id>]    Login to a Reporting.bi instance (opens browser)\n  logout [domain]                       Logout and revoke tokens (default: active connection)\n  use <domain> [--accounting <id>]      Switch active connection and/or set accounting\n  status                                Show all connections and active status\n\nAccounting:\n  accounting list                       List available accountings\n\nWiki:\n  wiki list                             List all pages\n  wiki get <id> [--lang cs]             Get page metadata (JSON)\n  wiki read <id> [--lang cs]            Get page content (plain text)\n  wiki search <query>                   Search pages\n  wiki save [id] [--lang cs] [--name n] Save/create a page (content from --file, --content, or stdin)\n  wiki delete <id> [--lang cs]          Delete a page\n\nDefault domain: https://reporting.bi\nDefault language: cs\n\nExamples:\n  rp login http://localhost:3011 --accounting 100000\n  rp use https://reporting.bi --accounting 100000\n  rp status\n\n  rp wiki list\n  rp wiki read 42\n  rp wiki search "query"\n  rp wiki save 42 --file ./page.md\n  rp wiki save --name "New page" --content "Hello"\n  cat doc.md | rp wiki save 42\n  rp wiki delete 42\n';
+var USAGE_default = `Reporting.bi CLI
+
+Usage: rp <command> [options]
+
+Commands:
+  login [domain] [--accounting <id>]    Login to a Reporting.bi instance (opens browser)
+  logout [domain]                       Logout and revoke tokens (default: active connection)
+  use <domain> [--accounting <id>]      Switch active connection and/or set accounting
+  status                                Show all connections and active status
+
+Accounting:
+  accounting list                       List available accountings
+
+ETL:
+  etl list                              List all threads
+  etl get <id>                          Get thread metadata
+  etl content <id>                      Get thread SQL content (plain text)
+  etl exec <id> [--sql "..."|--file f]  Execute thread (optionally with custom SQL)
+  etl search <query>                    Search threads
+
+Jobs:
+  jobs list                             List available jobs
+  jobs start <job_name>                 Start a job
+  jobs stop <job_name>                  Stop a running job
+  jobs status                           Show status of all jobs
+
+Analytics:
+  analytics contexts                    List saved report contexts
+  analytics context <id>                Get report context details
+  analytics report <context_id>         Execute report and get results
+  analytics dimensions --module <m>     List dimensions for a module
+  analytics years                       List available years
+
+Users:
+  users list                            List all users
+  users get [username]                  Get user profile (default: me)
+  users me                              Get current user profile
+  users rights                          Show current user's access rights
+  users roles                           List access roles
+
+Definition:
+  def statements                        List all statements
+  def statement <id>                    Get statement definition
+  def dimensions --module <m>           List dimensions for a module
+  def modules                           List available modules
+  def scenarios                         List scenarios
+  def fiscal-years                      List fiscal years
+
+MDM:
+  mdm tables                            List MDM table definitions
+  mdm table <id>                        Get table definition
+  mdm columns <id>                      Get column definitions for a table
+  mdm values <id>                       Get table values
+  mdm export <id> [--type mdm|sql]      Export table as CSV
+
+Helpdesk:
+  helpdesk list                         List all tickets
+  helpdesk get <id>                     Get ticket details
+  helpdesk messages <ticket_id>         Get ticket messages
+  helpdesk create --subject "..." [--text "..."] [--priority N]  Create a ticket
+
+Wiki:
+  wiki list                             List all pages
+  wiki get <id> [--lang cs]             Get page metadata
+  wiki read <id> [--lang cs]            Get page content (plain text)
+  wiki search <query>                   Search pages
+  wiki save [id] [--lang cs] [--name n] Save/create a page (content from --file, --content, or stdin)
+  wiki delete <id> [--lang cs]          Delete a page
+
+Global options:
+  --json                                Output raw JSON instead of table format
+
+Default domain: https://reporting.bi
+Default language: cs
+
+Examples:
+  rp login http://localhost:3011 --accounting 100000
+  rp use https://reporting.bi --accounting 100000
+  rp status
+
+  rp etl list
+  rp etl exec 42
+  rp etl content 42
+
+  rp jobs list
+  rp jobs start "My Job"
+  rp jobs status
+
+  rp analytics contexts
+  rp analytics report 123
+
+  rp users me
+  rp users list --json
+
+  rp def statements
+  rp def modules
+
+  rp mdm tables
+  rp mdm values 5
+  rp mdm export 5 > data.csv
+
+  rp helpdesk list
+  rp helpdesk create --subject "Bug report" --text "Details here"
+
+  rp wiki list
+  rp wiki read 42
+  rp wiki search "query"
+  rp wiki save 42 --file ./page.md
+  cat doc.md | rp wiki save 42
+`;
 
 // src/index.ts
 var [command, ...args] = process.argv.slice(2);
@@ -3527,6 +4036,27 @@ switch (command) {
   case "accounting":
     accounting(args);
     break;
+  case "etl":
+    etl(args);
+    break;
+  case "jobs":
+    jobs(args);
+    break;
+  case "analytics":
+    analytics(args);
+    break;
+  case "users":
+    users(args);
+    break;
+  case "def":
+    def(args);
+    break;
+  case "mdm":
+    mdm(args);
+    break;
+  case "helpdesk":
+    helpdesk(args);
+    break;
   case "status":
     status();
     break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reporting-bi/cli",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "license": "UNLICENSED",
   "description": "Reporting.bi CLI — command-line interface for the Reporting.bi platform",
   "main": "./dist/index.js",
@@ -14,7 +14,7 @@
     "build": "yarn node build.mjs",
     "watch": "yarn build --watch",
     "deploy-installers": "cp install.sh ../rp-static/install-cli.sh && cp install.ps1 ../rp-static/install-cli.ps1",
-    "release": "yarn node -e \"const p=require('./package.json');const v=p.version.split('.');v[2]++;p.version=v.join('.');require('fs').writeFileSync('package.json',JSON.stringify(p,null,'\\t')+'\\n')\" && yarn build && git add package.json && git commit -m \"rp-cli v$(yarn node -p \"require('./package.json').version\")\" && yarn npm publish --access public"
+    "release": "yarn node -e \"const p=require('./package.json');const v=p.version.split('.');v[2]++;p.version=v.join('.');require('fs').writeFileSync('package.json',JSON.stringify(p,null,'\\t')+'\\n')\" && yarn build && git add package.json && git commit -m \"rp-cli v$(yarn node -p \"require('./package.json').version\")\" && git push && yarn npm publish --access public"
   },
   "dependencies": {},
   "devDependencies": {