@aderis-erp/cli 1.0.0

package/README.md

@@ -0,0 +1,244 @@
+# Aderis CLI
+
+Command-line interface for Aderis Finance ERP. Manage your Aderis account, execute API operations, and automate workflows from the terminal.
+
+## Features
+
+- **OAuth Authentication** - Secure login with PKCE flow
+- **Multi-Environment Support** - Switch between dev, test, and production environments
+- **Multi-Client Support** - Manage multiple clients with named contexts
+- **Multi-Tenant Support** - Switch between tenants within a single login
+- **Full API Access** - Execute all Aderis API endpoints from the command line
+- **Auto-Generated Commands** - Commands generated directly from OpenAPI spec
+
+## Installation
+
+```bash
+npm install -g aderis-cli
+aderis --help
+```
+
+Or link locally for development:
+
+```bash
+npm link
+aderis --help
+```
+
+## Quick Start
+
+### 1. Login to Aderis
+
+```bash
+# Create a new context and login
+aderis auth login --new
+
+# Follow the prompts to:
+# - Name your context (e.g., "acme-prod")
+# - Select environment (dev, test, live)
+# - Enter your OAuth client ID
+# - Complete authentication in browser
+```
+
+### 2. Check Authentication Status
+
+```bash
+aderis auth status
+```
+
+### 3. Make API Calls
+
+```bash
+# List accounts
+aderis accounts list
+
+# Get a specific account
+aderis accounts get --id <account-id>
+
+# Create a new business partner
+aderis business-partners create --data '{"name": "Acme Corp", "type": "customer"}'
+
+# List invoices with pagination
+aderis sales-invoices list --page 1 --limit 20
+
+# Use table output for better readability
+aderis accounts list --output table
+```
+
+## Managing Contexts
+
+Contexts allow you to manage multiple Aderis clients and environments.
+
+```bash
+# List all contexts
+aderis config list
+
+# Switch to a different context
+aderis config use my-other-client
+
+# Show current context
+aderis config current
+
+# Delete a context
+aderis config delete old-context
+```
+
+## Authentication
+
+### Login
+
+```bash
+# Login with current context
+aderis auth login
+
+# Login with a specific context
+aderis auth login --context my-client
+
+# Create a new context and login
+aderis auth login --new --name my-client --environment dev --client-id YOUR_CLIENT_ID
+```
+
+### Logout
+
+```bash
+# Logout from current context
+aderis auth logout
+
+# Logout from all contexts
+aderis auth logout --all
+```
+
+### Tenant Management
+
+If your account has access to multiple tenants, you can switch between them:
+
+```bash
+# Show current tenant
+aderis auth tenant show
+
+# List all available tenants
+aderis auth tenant list
+
+# Interactive tenant selection
+aderis auth tenant
+
+# Switch to a specific tenant
+aderis auth tenant switch <tenant-id>
+
+# Output as JSON
+aderis auth tenant list --json
+```
+
+## API Commands
+
+All API endpoints from the Aderis OpenAPI spec are available as CLI commands.
+
+### Command Structure
+
+```bash
+aderis <resource> <action> [flags]
+```
+
+### Available Resources
+
+- `accounts` - Chart of accounts
+- `account-transactions` - Account transactions
+- `bank-accounts` - Bank account management
+- `business-partners` - Customers and vendors
+- `credit-card-accounts` - Credit card accounts
+- `employees` - Employee management
+- `files` - File uploads and downloads
+- `items` - Product/service items
+- `item-categories` - Item categorization
+- `journals` - Journal entries
+- `ledgers` - General ledger
+- `office-locations` - Office locations
+- `payment-methods` - Payment methods
+- `payment-runs` - Payment batches
+- `payment-terms` - Payment terms
+- `price-lists` - Pricing
+- `sales-invoices` - Sales invoices
+- `sales-orders` - Sales orders
+- `tags` - Tagging system
+- `tax-codes` - Tax codes
+- `tax-matrix` - Tax matrix
+- `tenants` - Tenant management
+- `vendor-invoices` - Vendor invoices
+- `webhooks` - Webhook configuration
+- `workflows` - Workflow management
+
+### Common Flags
+
+| Flag | Description |
+|------|-------------|
+| `-c, --context` | Use a specific context |
+| `-o, --output` | Output format: `json` (default) or `table` |
+| `-d, --data` | JSON data for request body |
+| `-f, --file` | Read request body from file |
+| `--page` | Page number for pagination |
+| `--limit` | Items per page |
+| `--include` | Relations to include |
+| `--search` | Search term |
+| `--sort-by` | Sort field and direction |
+| `--query` | Additional query params as JSON |
+
+### Examples
+
+```bash
+# List sales invoices with filters
+aderis sales-invoices list --search "ACME" --limit 50
+
+# Create an invoice from a file
+aderis sales-invoices create --file invoice.json
+
+# Approve a sales invoice
+aderis sales-invoices approve --id INV-001
+
+# Get invoice with related data
+aderis sales-invoices get --id INV-001 --include "customer,lineItems"
+
+# Delete an item
+aderis items delete --id ITEM-123
+
+# Use advanced query filters
+aderis accounts list --query '{"filter.type": "$eq:asset"}'
+```
+
+## Configuration
+
+Configuration is stored in `~/.aderis/config.json`.
+
+### Environments
+
+| Environment | Auth URL | API URL |
+|-------------|----------|---------|
+| dev | https://auth-dev.aderis.com | https://api-dev.aderis.com |
+| test | https://auth-test.aderis.com | https://api-test.aderis.com |
+| live | https://auth.aderis.com | https://api.aderis.com |
+
+## Development
+
+### Generate API Commands
+
+When the OpenAPI spec is updated, regenerate commands:
+
+```bash
+npm run generate
+npm run build
+```
+
+### Build
+
+```bash
+npm run build
+```
+
+### Run Locally
+
+```bash
+./bin/dev.js --help
+```
+
+## License
+
+MIT

package/bin/dev.cmd

@@ -0,0 +1,3 @@
+@echo off
+
+node --loader ts-node/esm --no-warnings=ExperimentalWarning "%~dp0\dev" %*

package/bin/dev.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env -S node --loader ts-node/esm --disable-warning=ExperimentalWarning
+
+import {execute} from '@oclif/core'
+
+await execute({development: true, dir: import.meta.url})

package/bin/run.cmd

@@ -0,0 +1,3 @@
+@echo off
+
+node "%~dp0\run" %*

package/bin/run.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import {execute} from '@oclif/core'
+
+await execute({dir: import.meta.url})

package/dist/commands/access-groups.d.ts

@@ -0,0 +1,39 @@
+import { Command } from '@oclif/core';
+export default class AccessGroups extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        action: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        id: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        context: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        table: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        data: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        set: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        page: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        limit: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        include: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        search: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'sort-by': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        filter: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        query: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        fields: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        sanitize: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'show-http-request': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private runImport;
+    private runExport;
+    private runCamt053Import;
+    private runNestedImport;
+    private filterFields;
+    private sanitizeOutput;
+    private getColumns;
+    private getValue;
+    private printTable;
+    private printCsv;
+}