incwo-cli 0.1.0

package/src/resources.ts

@@ -0,0 +1,560 @@
+export interface ColumnDef {
+  key: string;
+  label: string;
+  width?: number;
+}
+
+export interface ResourceDef {
+  /** CLI command name — matches the API endpoint */
+  command: string;
+  /** Short description */
+  description: string;
+  /** REST endpoint (always matches command) */
+  endpoint: string;
+  /** Columns to display in list output */
+  columns: ColumnDef[];
+  /** Fixed params appended to every list request */
+  defaultParams?: Record<string, string>;
+  /** Whether to expose --from / --to date filters */
+  hasDateFilter?: boolean;
+  /** Whether to expose --sheet-type filter (proposal_sheets only) */
+  hasSheetType?: boolean;
+}
+
+export const RESOURCES: ResourceDef[] = [
+
+  // ── CRM ──────────────────────────────────────────────────────────────────
+
+  {
+    command: 'contacts',
+    description: 'Contacts (people)',
+    endpoint: 'contacts',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'first_name', label: 'First name', width: 16 },
+      { key: 'last_name', label: 'Last name', width: 18 },
+      { key: 'firm_name', label: 'Company name', width: 24 },
+      { key: 'job_title', label: 'Job title', width: 22 },
+      { key: 'created_at', label: 'Created', width: 12 },
+    ],
+  },
+
+  {
+    command: 'firms',
+    description: 'Companies / organisations',
+    endpoint: 'firms',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'name', label: 'Name', width: 32 },
+      { key: 'siren', label: 'Siren', width: 14 },
+      { key: 'reference', label: 'Reference', width: 16 },
+      { key: 'created_at', label: 'Created', width: 12 },
+    ],
+  },
+
+  {
+    command: 'leads',
+    description: 'Sales opportunities',
+    endpoint: 'leads',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'reference', label: 'Reference', width: 16 },
+      { key: 'contact_id', label: 'Contact ID', width: 12 },
+      { key: 'firm_id', label: 'Firm ID', width: 10 },
+      { key: 'status_id', label: 'Status', width: 10 },
+      { key: 'step_id', label: 'Progress', width: 10 },
+      { key: 'value', label: 'Value', width: 12 },
+      { key: 'value_date', label: 'Est. sign. date', width: 14 },
+      { key: 'confidence_pct', label: 'Confidence %', width: 12 },
+    ],
+    hasDateFilter: true,
+  },
+
+  {
+    command: 'contact_items',
+    description: 'Contact details (emails, phones…)',
+    endpoint: 'contact_items',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'type_id', label: 'Type', width: 14 },
+      { key: 'value', label: 'Value', width: 34 },
+      { key: 'contact_id', label: 'Contact ID', width: 12 },
+      { key: 'is_default', label: 'Default', width: 8 },
+    ],
+  },
+
+  {
+    command: 'contact_addresses',
+    description: 'Contact addresses',
+    endpoint: 'contact_addresses',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'contact_id', label: 'Contact ID', width: 12 },
+      { key: 'street_address', label: 'Address', width: 30 },
+      { key: 'zip_code', label: 'ZIP', width: 8 },
+      { key: 'city', label: 'City', width: 18 },
+      { key: 'country', label: 'Country', width: 12 },
+    ],
+  },
+
+  {
+    command: 'contact_lists',
+    description: 'Contact lists',
+    endpoint: 'contact_lists',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'name', label: 'Name', width: 36 },
+      { key: 'description', label: 'Description', width: 30 },
+      { key: 'created_at', label: 'Created', width: 12 },
+    ],
+  },
+
+  {
+    command: 'missions',
+    description: 'Missions',
+    endpoint: 'missions',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'kind', label: 'Kind', width: 14 },
+      { key: 'title', label: 'Title', width: 32 },
+      { key: 'status_id', label: 'Status', width: 10 },
+      { key: 'progress', label: 'Progress', width: 12 },
+      { key: 'created_at', label: 'Created', width: 12 },
+    ],
+  },
+
+  // ── SALES ─────────────────────────────────────────────────────────────────
+
+  {
+    command: 'proposal_sheets',
+    description: 'Proposal sheets (quotes, orders, delivery notes…)',
+    endpoint: 'proposal_sheets',
+    hasSheetType: true,
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'reference', label: 'Reference', width: 16 },
+      { key: 'sheet_type', label: 'Type', width: 14 },
+      { key: 'title', label: 'Title', width: 24 },
+      { key: 'billing_date', label: 'Billing date', width: 12 },
+      { key: 'firm_name', label: 'Company', width: 22 },
+      { key: 'vat_exl_total', label: 'Total excl. VAT', width: 14 },
+      { key: 'vat_inc_total', label: 'Total incl. VAT', width: 14 },
+      { key: 'status_id', label: 'Status', width: 10 },
+      { key: 'sent', label: 'Sent', width: 8 },
+    ],
+    hasDateFilter: true,
+  },
+
+  {
+    command: 'bill_sheets',
+    description: 'Customer invoices',
+    endpoint: 'bill_sheets',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'reference', label: 'Reference', width: 16 },
+      { key: 'sheet_type', label: 'Type', width: 12 },
+      { key: 'title', label: 'Title', width: 24 },
+      { key: 'billing_date', label: 'Billing date', width: 12 },
+      { key: 'firm_name', label: 'Company', width: 22 },
+      { key: 'vat_exl_total', label: 'Total excl. VAT', width: 14 },
+      { key: 'vat_inc_total', label: 'Total incl. VAT', width: 14 },
+      { key: 'payed_amount', label: 'Paid amount', width: 12 },
+      { key: 'sent', label: 'Sent', width: 8 },
+    ],
+    hasDateFilter: true,
+  },
+
+  {
+    command: 'emitted_payments',
+    description: 'Vendor bills / purchase invoices',
+    endpoint: 'emitted_payments',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'reference', label: 'Reference', width: 16 },
+      { key: 'kind', label: 'Kind', width: 12 },
+      { key: 'title', label: 'Title', width: 24 },
+      { key: 'payment_date', label: 'Payment date', width: 12 },
+      { key: 'amount', label: 'Amount', width: 12 },
+      { key: 'status_id', label: 'Status', width: 10 },
+    ],
+    hasDateFilter: true,
+  },
+
+  {
+    command: 'customer_products',
+    description: 'Product / service catalog',
+    endpoint: 'customer_products',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'reference', label: 'Ref.', width: 14 },
+      { key: 'name', label: 'Name', width: 30 },
+      { key: 'price', label: 'Price', width: 10 },
+      { key: 'unit', label: 'Unit', width: 8 },
+      { key: 'vat_id', label: 'VAT', width: 8 },
+      { key: 'is_active', label: 'Active', width: 8 },
+    ],
+  },
+
+  {
+    command: 'customer_product_categories',
+    description: 'Product categories',
+    endpoint: 'customer_product_categories',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'name', label: 'Name', width: 30 },
+      { key: 'parent_id', label: 'Parent ID', width: 10 },
+      { key: 'accounting_ref', label: 'Accounting ref', width: 16 },
+      { key: 'created_at', label: 'Created', width: 12 },
+    ],
+  },
+
+  {
+    command: 'customer_pricings',
+    description: 'Customer pricing rules',
+    endpoint: 'customer_pricings',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'customer_product_id', label: 'Product ID', width: 12 },
+      { key: 'name', label: 'Name', width: 26 },
+      { key: 'price_ht', label: 'Price excl. VAT', width: 14 },
+      { key: 'reduction_percent', label: 'Discount %', width: 12 },
+      { key: 'supplier_ref', label: 'Supplier ref', width: 16 },
+    ],
+  },
+
+  {
+    command: 'vendor_pricings',
+    description: 'Vendor pricing rules',
+    endpoint: 'vendor_pricings',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'customer_product_id', label: 'Product ID', width: 12 },
+      { key: 'name', label: 'Name', width: 26 },
+      { key: 'price_ht', label: 'Price excl. VAT', width: 14 },
+      { key: 'reduction_percent', label: 'Discount %', width: 12 },
+      { key: 'supplier_ref', label: 'Supplier ref', width: 16 },
+    ],
+  },
+
+  {
+    command: 'bank_accounts',
+    description: 'Bank accounts',
+    endpoint: 'bank_accounts',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'name', label: 'Name', width: 28 },
+      { key: 'city', label: 'City', width: 18 },
+      { key: 'accounting_ref', label: 'Accounting ref', width: 18 },
+      { key: 'created_at', label: 'Created', width: 12 },
+    ],
+  },
+
+  {
+    command: 'campaigns',
+    description: 'Marketing campaigns',
+    endpoint: 'campaigns',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'title', label: 'Title', width: 30 },
+      { key: 'reference', label: 'Reference', width: 16 },
+      { key: 'begins_at', label: 'Begins at', width: 12 },
+      { key: 'ends_at', label: 'Ends at', width: 12 },
+    ],
+    hasDateFilter: true,
+  },
+
+  // ── INVENTORY ─────────────────────────────────────────────────────────────
+
+  {
+    command: 'stock_movements',
+    description: 'Stock movements',
+    endpoint: 'stock_movements',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'customer_product_id', label: 'Product ID', width: 12 },
+      { key: 'direction', label: 'Direction', width: 10 },
+      { key: 'quantity', label: 'Qty', width: 8 },
+      { key: 'origin_warehouse_id', label: 'Origin WH', width: 12 },
+      { key: 'destination_warehouse_id', label: 'Dest. WH', width: 12 },
+      { key: 'moved_at', label: 'Moved at', width: 14 },
+    ],
+    hasDateFilter: true,
+  },
+
+  {
+    command: 'serial_numbers',
+    description: 'Serial numbers',
+    endpoint: 'serial_numbers',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'batch', label: 'Batch', width: 20 },
+      { key: 'barcode', label: 'Barcode', width: 18 },
+      { key: 'customer_product_id', label: 'Product ID', width: 12 },
+      { key: 'warehouse_id', label: 'Warehouse ID', width: 14 },
+      { key: 'quantity', label: 'Qty', width: 8 },
+      { key: 'moved_at', label: 'Moved at', width: 14 },
+    ],
+  },
+
+  {
+    command: 'serial_lots',
+    description: 'Serial lot numbers',
+    endpoint: 'serial_lots',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'batch', label: 'Batch', width: 20 },
+      { key: 'barcode', label: 'Barcode', width: 18 },
+      { key: 'customer_product_id', label: 'Product ID', width: 12 },
+      { key: 'warehouse_id', label: 'Warehouse ID', width: 14 },
+      { key: 'quantity', label: 'Qty', width: 8 },
+      { key: 'moved_at', label: 'Moved at', width: 14 },
+    ],
+  },
+
+  {
+    command: 'warehouses',
+    description: 'Warehouses / depots',
+    endpoint: 'warehouses',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'name', label: 'Name', width: 28 },
+      { key: 'city', label: 'City', width: 16 },
+      { key: 'zip_code', label: 'ZIP', width: 8 },
+      { key: 'country', label: 'Country', width: 12 },
+      { key: 'street_address', label: 'Address', width: 24 },
+    ],
+  },
+
+  // ── PROJECTS / TIME ───────────────────────────────────────────────────────
+
+  {
+    command: 'projects',
+    description: 'Projects',
+    endpoint: 'projects',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'name', label: 'Name', width: 28 },
+      { key: 'reference', label: 'Reference', width: 14 },
+      { key: 'status_id', label: 'Status', width: 10 },
+      { key: 'start_date', label: 'Start', width: 12 },
+      { key: 'end_date', label: 'End', width: 12 },
+    ],
+    hasDateFilter: true,
+  },
+
+  {
+    command: 'tasks',
+    description: 'Tasks',
+    endpoint: 'tasks',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'title', label: 'Title', width: 30 },
+      { key: 'status_id', label: 'Status', width: 10 },
+      { key: 'due_at', label: 'Due at', width: 12 },
+      { key: 'assigned_user_id', label: 'Assigned user', width: 14 },
+      { key: 'completion_percent', label: '% done', width: 8 },
+    ],
+    hasDateFilter: true,
+  },
+
+  {
+    command: 'timesheets',
+    description: 'Timesheets',
+    endpoint: 'timesheets',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'title', label: 'Title', width: 28 },
+      { key: 'period', label: 'Month', width: 10 },
+      { key: 'user_id', label: 'User ID', width: 10 },
+      { key: 'status_id', label: 'Status', width: 10 },
+      { key: 'sheet_type', label: 'Sheet type', width: 14 },
+    ],
+    hasDateFilter: true,
+  },
+
+  // ── HR ────────────────────────────────────────────────────────────────────
+
+  {
+    command: 'staff_members',
+    description: 'Staff members',
+    endpoint: 'staff_members',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'first_name', label: 'First name', width: 16 },
+      { key: 'last_name', label: 'Last name', width: 18 },
+      { key: 'job_label', label: 'Job', width: 20 },
+      { key: 'email', label: 'Email', width: 26 },
+      { key: 'status_id', label: 'Status', width: 10 },
+    ],
+  },
+
+  {
+    command: 'expense_sheets',
+    description: 'Expense reports',
+    endpoint: 'expense_sheets',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'staff_member_id', label: 'Staff member', width: 14 },
+      { key: 'period', label: 'Month', width: 10 },
+      { key: 'status_id', label: 'Status', width: 10 },
+      { key: 'payed_amount', label: 'Paid amount', width: 12 },
+      { key: 'submission_date', label: 'Submitted', width: 14 },
+    ],
+    hasDateFilter: true,
+  },
+
+  {
+    command: 'vacation_requests',
+    description: 'Vacation requests',
+    endpoint: 'vacation_requests',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'staff_member_id', label: 'Staff member', width: 14 },
+      { key: 'vacation_type_id', label: 'Type', width: 10 },
+      { key: 'start_date', label: 'Start', width: 14 },
+      { key: 'stop_date', label: 'End', width: 14 },
+      { key: 'duration', label: 'Duration', width: 10 },
+      { key: 'status_id', label: 'Status', width: 10 },
+    ],
+    hasDateFilter: true,
+  },
+
+  {
+    command: 'salary_campaigns',
+    description: 'Salary campaigns',
+    endpoint: 'salary_campaigns',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'period', label: 'Period', width: 14 },
+      { key: 'status_id', label: 'Status', width: 10 },
+      { key: 'created_at', label: 'Created', width: 12 },
+    ],
+  },
+
+  {
+    command: 'contracts',
+    description: 'Contracts',
+    endpoint: 'contracts',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'title', label: 'Title', width: 30 },
+      { key: 'reference', label: 'Reference', width: 16 },
+      { key: 'begin_date', label: 'Start', width: 12 },
+      { key: 'end_date', label: 'End', width: 12 },
+      { key: 'is_active', label: 'Active', width: 8 },
+    ],
+    hasDateFilter: true,
+  },
+
+  {
+    command: 'interviews',
+    description: 'HR interviews',
+    endpoint: 'interviews',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'job_candidate_id', label: 'Candidate ID', width: 14 },
+      { key: 'staff_member_id', label: 'Staff member', width: 14 },
+      { key: 'status_id', label: 'Status', width: 10 },
+      { key: 'comments', label: 'Comments', width: 30 },
+      { key: 'created_at', label: 'Created', width: 12 },
+    ],
+    hasDateFilter: true,
+  },
+
+  // ── MISC ──────────────────────────────────────────────────────────────────
+
+  {
+    command: 'notes',
+    description: 'Notes',
+    endpoint: 'notes',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'title', label: 'Title', width: 32 },
+      { key: 'type_id', label: 'Type', width: 10 },
+      { key: 'object_name', label: 'Support object', width: 16 },
+      { key: 'created_at', label: 'Created', width: 14 },
+    ],
+    hasDateFilter: true,
+  },
+
+  {
+    command: 'upload_files',
+    description: 'Files / attachments',
+    endpoint: 'upload_files',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'object_zname', label: 'Support object', width: 20 },
+      { key: 'object_zid', label: 'Object ID', width: 12 },
+      { key: 'shared_with_party', label: 'Shared', width: 8 },
+      { key: 'created_at', label: 'Created', width: 14 },
+    ],
+    hasDateFilter: true,
+  },
+
+  {
+    command: 'custom_labels',
+    description: 'Custom labels',
+    endpoint: 'custom_labels',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'label_type', label: 'Label type', width: 16 },
+      { key: 'long_label', label: 'Label', width: 28 },
+      { key: 'short_label', label: 'Short label', width: 16 },
+      { key: 'color', label: 'Color', width: 10 },
+    ],
+  },
+
+  {
+    command: 'conversations',
+    description: 'Conversations / messaging',
+    endpoint: 'conversations',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'title', label: 'Title', width: 34 },
+      { key: 'type_id', label: 'Type', width: 10 },
+      { key: 'status_id', label: 'Status', width: 10 },
+      { key: 'created_at', label: 'Created', width: 14 },
+    ],
+    hasDateFilter: true,
+  },
+
+  {
+    command: 'webhooks',
+    description: 'Configured webhooks',
+    endpoint: 'webhooks',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'object_zname', label: 'Object', width: 20 },
+      { key: 'object_zfield', label: 'Field', width: 20 },
+      { key: 'turl', label: 'URL', width: 36 },
+      { key: 'active', label: 'Active', width: 8 },
+    ],
+  },
+
+  {
+    command: 'bookables',
+    description: 'Bookable resources',
+    endpoint: 'bookables',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'kind', label: 'Kind', width: 16 },
+      { key: 'title', label: 'Title', width: 30 },
+      { key: 'price', label: 'Price', width: 12 },
+      { key: 'created_at', label: 'Created', width: 12 },
+    ],
+  },
+
+  {
+    command: 'fleets',
+    description: 'Vehicle fleets',
+    endpoint: 'fleets',
+    columns: [
+      { key: 'id', label: 'ID', width: 8 },
+      { key: 'kind', label: 'Kind', width: 16 },
+      { key: 'title', label: 'Title', width: 30 },
+      { key: 'contact_id', label: 'Contact ID', width: 12 },
+      { key: 'created_at', label: 'Created', width: 12 },
+    ],
+  },
+
+];

package/src/ui.ts

@@ -0,0 +1,57 @@
+import chalk from 'chalk';
+import figlet from 'figlet';
+
+export function printBanner(): void {
+  const banner = figlet.textSync('incwo CLI', {
+    font: 'ANSI Shadow',
+    horizontalLayout: 'default',
+  });
+  console.log(chalk.cyan(banner));
+  console.log(chalk.dim('  Your CRM/ERP · incwo.com\n'));
+}
+
+export function printTable(rows: any[], columns: { key: string; label: string; width?: number }[]): void {
+  if (!rows || rows.length === 0) {
+    console.log(chalk.yellow('  No results.'));
+    return;
+  }
+
+  const widths = columns.map(col => {
+    const max = Math.max(col.label.length, ...rows.map(r => String(r[col.key] ?? '').length));
+    return col.width ?? Math.min(max, 40);
+  });
+
+  const header = columns.map((col, i) => col.label.padEnd(widths[i])).join('  ');
+  const separator = widths.map(w => '─'.repeat(w)).join('  ');
+
+  console.log(chalk.bold('  ' + header));
+  console.log(chalk.dim('  ' + separator));
+
+  for (const row of rows) {
+    const line = columns.map((col, i) => {
+      const val = String(row[col.key] ?? '');
+      return val.length > widths[i] ? val.substring(0, widths[i] - 1) + '…' : val.padEnd(widths[i]);
+    }).join('  ');
+    console.log('  ' + line);
+  }
+
+  console.log(chalk.dim(`\n  ${rows.length} result(s)`));
+}
+
+export function printObject(obj: any, title?: string): void {
+  if (title) console.log(chalk.bold(`\n  ${title}\n`));
+  for (const [key, value] of Object.entries(obj)) {
+    if (value !== null && value !== undefined && value !== '') {
+      console.log(`  ${chalk.dim(key.padEnd(28))} ${value}`);
+    }
+  }
+  console.log();
+}
+
+export function error(msg: string): void {
+  console.error(chalk.red(`\n  ✗ ${msg}\n`));
+}
+
+export function success(msg: string): void {
+  console.log(chalk.green(`\n  ✓ ${msg}\n`));
+}

package/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}