incwo-cli 0.1.0

package/src/api.ts

@@ -0,0 +1,93 @@
+import axios, { AxiosInstance } from 'axios';
+import { parseStringPromise, Builder } from 'xml2js';
+import { IncwoConfig, baseUrl } from './config';
+
+export class IncwoClient {
+  private http: AxiosInstance;
+  private base: string;
+
+  constructor(config: IncwoConfig) {
+    this.base = baseUrl(config);
+    this.http = axios.create({
+      baseURL: this.base,
+      auth: { username: config.login, password: config.password },
+      headers: { 'Content-Type': 'application/xml', 'Accept': 'application/xml' },
+      timeout: 15000,
+    });
+  }
+
+  // GET /{resource}.xml with optional query params
+  async list(resource: string, params: Record<string, string> = {}): Promise<any[]> {
+    const response = await this.http.get(`/${resource}.xml`, { params });
+    return parseXmlList(response.data);
+  }
+
+  // GET /{resource}/{id}.xml
+  async get(resource: string, id: string): Promise<any> {
+    const response = await this.http.get(`/${resource}/${id}.xml`);
+    const parsed = await parseXmlList(response.data);
+    return parsed[0] ?? null;
+  }
+
+  // POST /{resource}.xml — accepts a plain JS object, converts to XML
+  async create(resource: string, data: Record<string, any>): Promise<any> {
+    const singularResource = toSingular(resource);
+    const xml = jsonToXml(singularResource, data);
+    const response = await this.http.post(`/${resource}.xml`, xml);
+    const parsed = await parseXmlList(response.data);
+    return parsed[0] ?? null;
+  }
+
+  // PUT /{resource}/{id}.xml — accepts a plain JS object, converts to XML
+  async update(resource: string, id: string, data: Record<string, any>): Promise<any> {
+    const singularResource = toSingular(resource);
+    const xml = jsonToXml(singularResource, data);
+    const response = await this.http.put(`/${resource}/${id}.xml`, xml);
+    const parsed = await parseXmlList(response.data);
+    return parsed[0] ?? null;
+  }
+
+  // DELETE /{resource}/{id}.xml
+  async destroy(resource: string, id: string): Promise<void> {
+    await this.http.delete(`/${resource}/${id}.xml`);
+  }
+}
+
+// Converts a flat JS object to an XML string with the given root element
+// e.g. jsonToXml('contact', { first_name: 'Bob' }) → <contact><first_name>Bob</first_name></contact>
+function jsonToXml(rootElement: string, data: Record<string, any>): string {
+  const builder = new Builder({ rootName: rootElement, headless: true });
+  return builder.buildObject(data);
+}
+
+// Naive singularization: bill_sheets → bill_sheet, contacts → contact
+function toSingular(resource: string): string {
+  if (resource.endsWith('ies')) return resource.slice(0, -3) + 'y';
+  if (resource.endsWith('s')) return resource.slice(0, -1);
+  return resource;
+}
+
+async function parseXmlList(xml: string): Promise<any[]> {
+  const parsed = await parseStringPromise(xml, {
+    explicitArray: false,
+    ignoreAttrs: true,
+    trim: true,
+  });
+
+  if (!parsed) return [];
+
+  const rootKey = Object.keys(parsed)[0];
+  const root = parsed[rootKey];
+
+  if (!root) return [];
+
+  const childKey = Object.keys(root)[0];
+  if (childKey && Array.isArray(root[childKey])) {
+    return root[childKey];
+  }
+  if (childKey && typeof root[childKey] === 'object') {
+    return [root[childKey]];
+  }
+
+  return [root];
+}

package/src/commands/generic.ts

@@ -0,0 +1,156 @@
+import { Command } from 'commander';
+import ora from 'ora';
+import { loadConfig } from '../config';
+import { IncwoClient } from '../api';
+import { printTable, printObject, error, success } from '../ui';
+import { ResourceDef } from '../resources';
+
+export function makeCommand(res: ResourceDef): Command {
+  const cmd = new Command(res.command).description(res.description);
+
+  // ── list ──────────────────────────────────────────────────────────────────
+  const listCmd = cmd
+    .command('list')
+    .description(`List ${res.description.toLowerCase()}`)
+    .option('--page <n>', 'Page number', '1')
+    .option('--search <q>', 'Full-text search')
+    .option('--filter <json>', 'ufilters JSON (e.g. \'{"status":{"eq":"active"}}\')');
+
+  if (res.hasSheetType) {
+    listCmd.option('--sheet-type <type>', 'Filter by sheet type (proposal, sale_order, delivery_note, purchase_order…)');
+  }
+
+  if (res.hasDateFilter) {
+    listCmd
+      .option('--from <date>', 'Start date (YYYY-MM-DD)')
+      .option('--to <date>', 'End date (YYYY-MM-DD)');
+  }
+
+  listCmd.action(async (opts) => {
+    const config = loadConfig();
+    if (!config) return error('No configuration found. Run: incwo config');
+
+    const spinner = ora('Loading…').start();
+    try {
+      const params: Record<string, string> = {
+        page: opts.page,
+        ...res.defaultParams,
+      };
+      if (opts.search) params['search'] = opts.search;
+      if (opts.filter) params['ufilters'] = opts.filter;
+      if (opts.sheetType) params['sheet_type'] = opts.sheetType;
+      if (opts.from) params['filter_from_date'] = opts.from;
+      if (opts.to) params['filter_to_date'] = opts.to;
+
+      const client = new IncwoClient(config);
+      const rows = await client.list(res.endpoint, params);
+      spinner.stop();
+      printTable(rows, res.columns);
+    } catch (e: any) {
+      spinner.stop();
+      error(e.response?.data ?? e.message);
+    }
+  });
+
+  // ── get ───────────────────────────────────────────────────────────────────
+  cmd
+    .command('get <id>')
+    .description(`Show a ${res.description.toLowerCase()} by ID`)
+    .action(async (id) => {
+      const config = loadConfig();
+      if (!config) return error('No configuration found. Run: incwo config');
+
+      const spinner = ora('Loading…').start();
+      try {
+        const client = new IncwoClient(config);
+        const obj = await client.get(res.endpoint, id);
+        spinner.stop();
+        if (!obj) return error(`${res.command} #${id} not found`);
+        printObject(obj, `${res.command} #${id}`);
+      } catch (e: any) {
+        spinner.stop();
+        error(e.response?.data ?? e.message);
+      }
+    });
+
+  // ── create ────────────────────────────────────────────────────────────────
+  cmd
+    .command('create')
+    .description(`Create a new ${res.description.toLowerCase()}`)
+    .requiredOption('--data <json>', 'Fields as JSON (e.g. \'{"first_name":"Bob","last_name":"Smith"}\')')
+    .action(async (opts) => {
+      const config = loadConfig();
+      if (!config) return error('No configuration found. Run: incwo config');
+
+      let data: Record<string, any>;
+      try {
+        data = JSON.parse(opts.data);
+      } catch {
+        return error('Invalid JSON in --data');
+      }
+
+      const spinner = ora('Creating…').start();
+      try {
+        const client = new IncwoClient(config);
+        const obj = await client.create(res.endpoint, data);
+        spinner.stop();
+        if (!obj) return error('Created but no response returned');
+        success(`${res.command} created (id: ${obj.id ?? '?'})`);
+        printObject(obj);
+      } catch (e: any) {
+        spinner.stop();
+        error(e.response?.data ?? e.message);
+      }
+    });
+
+  // ── update ────────────────────────────────────────────────────────────────
+  cmd
+    .command('update <id>')
+    .description(`Update a ${res.description.toLowerCase()}`)
+    .requiredOption('--data <json>', 'Fields to update as JSON (e.g. \'{"first_name":"Bob"}\')')
+    .action(async (id, opts) => {
+      const config = loadConfig();
+      if (!config) return error('No configuration found. Run: incwo config');
+
+      let data: Record<string, any>;
+      try {
+        data = JSON.parse(opts.data);
+      } catch {
+        return error('Invalid JSON in --data');
+      }
+
+      const spinner = ora('Updating…').start();
+      try {
+        const client = new IncwoClient(config);
+        const obj = await client.update(res.endpoint, id, data);
+        spinner.stop();
+        success(`${res.command} #${id} updated`);
+        if (obj) printObject(obj);
+      } catch (e: any) {
+        spinner.stop();
+        error(e.response?.data ?? e.message);
+      }
+    });
+
+  // ── delete ────────────────────────────────────────────────────────────────
+  cmd
+    .command('delete <id>')
+    .description(`Delete a ${res.description.toLowerCase()}`)
+    .action(async (id) => {
+      const config = loadConfig();
+      if (!config) return error('No configuration found. Run: incwo config');
+
+      const spinner = ora('Deleting…').start();
+      try {
+        const client = new IncwoClient(config);
+        await client.destroy(res.endpoint, id);
+        spinner.stop();
+        success(`${res.command} #${id} deleted`);
+      } catch (e: any) {
+        spinner.stop();
+        error(e.response?.data ?? e.message);
+      }
+    });
+
+  return cmd;
+}

package/src/config.ts

@@ -0,0 +1,118 @@
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import inquirer from 'inquirer';
+
+export interface IncwoConfig {
+  server: string; // e.g. "mycompany.incwo.com" or "www.incwo.com"
+  business_file_id: string;
+  login: string;
+  password: string;
+}
+
+const CONFIG_DIR = path.join(os.homedir(), '.incwo');
+const CONFIG_PATH = path.join(CONFIG_DIR, 'config.json');
+
+export function loadConfig(): IncwoConfig | null {
+  if (!fs.existsSync(CONFIG_PATH)) return null;
+  try {
+    const raw = fs.readFileSync(CONFIG_PATH, 'utf-8');
+    return JSON.parse(raw) as IncwoConfig;
+  } catch {
+    return null;
+  }
+}
+
+export function saveConfig(config: IncwoConfig): void {
+  if (!fs.existsSync(CONFIG_DIR)) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  }
+  fs.writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2), 'utf-8');
+}
+
+export function baseUrl(config: IncwoConfig): string {
+  return `https://${config.server}/${config.business_file_id}`;
+}
+
+export async function runConfigWizard(): Promise<void> {
+  const chalk = (await import('chalk')).default;
+
+  console.log(chalk.bold('\nincwo CLI — Configuration\n'));
+
+  const { inputMode } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'inputMode',
+      message: 'How would you like to configure the server?',
+      choices: [
+        { name: 'Enter the full endpoint URL  (e.g. mycompany.incwo.com/12345)', value: 'url' },
+        { name: 'Enter the shard and business file ID separately', value: 'manual' },
+      ],
+    },
+  ]);
+
+  let server: string;
+  let business_file_id: string;
+
+  if (inputMode === 'url') {
+    const { endpoint } = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'endpoint',
+        message: 'Endpoint URL (e.g. mycompany.incwo.com/12345 or www.incwo.com/12345):',
+        validate: (v: string) => {
+          const clean = v.replace(/^https?:\/\//, '').replace(/\/$/, '');
+          const parts = clean.split('/');
+          if (parts.length < 2 || !parts[0] || !parts[1]) {
+            return 'Expected format: shard.incwo.com/business_file_id';
+          }
+          return true;
+        },
+      },
+    ]);
+    const clean = endpoint.replace(/^https?:\/\//, '').replace(/\/$/, '');
+    const slashIdx = clean.indexOf('/');
+    server = clean.substring(0, slashIdx);
+    business_file_id = clean.substring(slashIdx + 1).split('/')[0];
+  } else {
+    const answers = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'shard',
+        message: 'Shard (leave empty if no shard → www.incwo.com):',
+      },
+      {
+        type: 'input',
+        name: 'business_file_id',
+        message: 'Business file ID:',
+        validate: (v: string) => v.trim() !== '' || 'Required',
+      },
+    ]);
+    server = answers.shard.trim()
+      ? `${answers.shard.trim()}.incwo.com`
+      : 'www.incwo.com';
+    business_file_id = answers.business_file_id.trim();
+  }
+
+  const { login, password } = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'login',
+      message: 'Login:',
+      validate: (v: string) => v.trim() !== '' || 'Required',
+    },
+    {
+      type: 'password',
+      name: 'password',
+      message: 'Password:',
+      mask: '*',
+      validate: (v: string) => v.trim() !== '' || 'Required',
+    },
+  ]);
+
+  const config: IncwoConfig = { server, business_file_id, login, password };
+  saveConfig(config);
+
+  console.log(chalk.green(`\n✓ Configuration saved to ${CONFIG_PATH}`));
+  console.log(chalk.dim(`  Endpoint: https://${server}/${business_file_id}\n`));
+}

package/src/index.ts

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { printBanner } from './ui';
+import { runConfigWizard } from './config';
+import { makeCommand } from './commands/generic';
+import { RESOURCES } from './resources';
+
+const program = new Command();
+
+program
+  .name('incwo')
+  .description('CLI for incwo CRM/ERP')
+  .version('0.1.0');
+
+// Banner sur --help global ou sans arguments
+if (process.argv.length <= 2 || process.argv[2] === '--help' || process.argv[2] === '-h') {
+  printBanner();
+}
+
+// incwo config
+program
+  .command('config')
+  .description('Configure incwo access (server, credentials)')
+  .action(async () => {
+    await runConfigWizard();
+  });
+
+// Toutes les ressources via le factory générique
+for (const resource of RESOURCES) {
+  program.addCommand(makeCommand(resource));
+}
+
+program.parse(process.argv);