@aderis-erp/cli 1.0.13 → 1.0.15

package/dist/commands/config/add.js

@@ -1,14 +1,22 @@
-import { confirm, input, select } from '@inquirer/prompts';
+import { confirm, input, password, select } from '@inquirer/prompts';
 import { Command, Flags } from '@oclif/core';
-import { addContext, DEFAULT_CLIENT_IDS, getContext } from '../../lib/config.js';
+import { addContext, DEFAULT_CLIENT_IDS, getContext, } from '../../lib/config.js';
 export default class ConfigAdd extends Command {
     static description = 'Add a new context configuration';
     static examples = [
         '<%= config.bin %> config add',
         '<%= config.bin %> config add --name my-client --environment live',
         '<%= config.bin %> config add --name dev-context --environment dev --client-id abc123',
+        '<%= config.bin %> config add --name ci --environment live --auth-type api-key --api-key <key>',
     ];
     static flags = {
+        'api-key': Flags.string({
+            description: 'API key to store (only with --auth-type api-key). Prompted for if omitted.',
+        }),
+        'auth-type': Flags.string({
+            description: 'How to authenticate: oauth2 (browser login) or api-key (x-api-key header)',
+            options: ['oauth2', 'api-key'],
+        }),
         'client-id': Flags.string({
             description: 'OAuth client ID (uses default if not specified)',
         }),
@@ -71,6 +79,35 @@ export default class ConfigAdd extends Command {
                 message: 'Environment:',
             }));
         }
+        // Get auth type. The flag uses the hyphenated `api-key` spelling; the stored
+        // value is the `api_key` AuthType. Only prompt when nothing in the invocation
+        // implies an answer, so existing non-interactive usage keeps working.
+        const authType = await this.resolveAuthType(flags);
+        if (authType === 'api_key') {
+            if (flags['client-id'] || flags['client-secret']) {
+                this.error('--client-id and --client-secret only apply to OAuth contexts; omit them with --auth-type api-key.');
+            }
+            const apiKey = flags['api-key'] ??
+                (await password({
+                    mask: true,
+                    message: 'API key:',
+                    validate: (value) => (value.trim() ? true : 'API key is required'),
+                }));
+            if (!apiKey.trim()) {
+                this.error('API key is required');
+            }
+            addContext({
+                api_key: apiKey.trim(),
+                auth_type: 'api_key',
+                environment,
+                name,
+            });
+            this.log(`\nContext "${name}" created successfully.`);
+            this.log(`Environment: ${environment}`);
+            this.log(`Auth: API key (sent as x-api-key)`);
+            this.log(`\nNo login needed — the CLI is ready to use.`);
+            return;
+        }
         // Get client ID
         let clientId = flags['client-id'];
         if (!clientId) {
@@ -107,6 +144,7 @@ export default class ConfigAdd extends Command {
         }
         // Create the context
         addContext({
+            auth_type: 'oauth2',
             client_id: clientId,
             client_secret: clientSecret,
             environment,
@@ -117,4 +155,28 @@ export default class ConfigAdd extends Command {
         this.log(`Client ID: ${clientId}`);
         this.log(`\nTo authenticate, run: aderis auth login`);
     }
+    /**
+     * Decide the auth type from flags, falling back to a prompt only when the
+     * invocation leaves it genuinely open. `--client-id`/`--client-secret` imply
+     * OAuth, and a non-TTY stdin means we must not block on a prompt — both keep
+     * scripted `config add` calls working exactly as before API-key support.
+     */
+    async resolveAuthType(flags) {
+        if (flags['auth-type']) {
+            return flags['auth-type'] === 'api-key' ? 'api_key' : 'oauth2';
+        }
+        // A key without --auth-type unambiguously means API-key auth.
+        if (flags['api-key'])
+            return 'api_key';
+        // OAuth-only flags, or a non-interactive shell: keep the historical default.
+        if (flags['client-id'] || flags['client-secret'] || !process.stdin.isTTY)
+            return 'oauth2';
+        return select({
+            choices: [
+                { description: 'Browser login via OAuth2 (PKCE)', name: 'oauth2', value: 'oauth2' },
+                { description: 'Long-lived API key, sent as the x-api-key header', name: 'api-key', value: 'api_key' },
+            ],
+            message: 'Authentication method:',
+        });
+    }
 }

package/dist/commands/config/current.js

@@ -1,5 +1,5 @@
 import { Command, Flags } from '@oclif/core';
-import { getCurrentContext } from '../../lib/config.js';
+import { getAuthType, getCurrentContext, hasCredentials } from '../../lib/config.js';
 export default class ConfigCurrent extends Command {
     static description = 'Show the current context';
     static examples = ['<%= config.bin %> config current', '<%= config.bin %> config current --json'];
@@ -24,7 +24,8 @@ export default class ConfigCurrent extends Command {
         }
         if (flags.json) {
             this.log(JSON.stringify({
-                authenticated: Boolean(context.tokens),
+                auth_type: getAuthType(context),
+                authenticated: hasCredentials(context),
                 client_id: context.client_id,
                 environment: context.environment,
                 name: context.name,
@@ -32,12 +33,16 @@ export default class ConfigCurrent extends Command {
             }, null, 2));
             return;
         }
+        const authType = getAuthType(context);
         this.log(`Current context: ${context.name}`);
         this.log(`Environment: ${context.environment}`);
-        this.log(`Client ID: ${context.client_id}`);
+        this.log(`Auth: ${authType === 'api_key' ? 'API key (x-api-key)' : 'oauth2'}`);
+        if (authType === 'oauth2') {
+            this.log(`Client ID: ${context.client_id ?? 'N/A'}`);
+        }
         if (context.tenant_id) {
             this.log(`Tenant ID: ${context.tenant_id}`);
         }
-        this.log(`Authenticated: ${context.tokens ? 'Yes' : 'No'}`);
+        this.log(`Authenticated: ${hasCredentials(context) ? 'Yes' : 'No'}`);
     }
 }

package/dist/commands/config/list.js

@@ -1,5 +1,5 @@
 import { Command, Flags } from '@oclif/core';
-import { getCurrentContext, listContexts } from '../../lib/config.js';
+import { getAuthType, getCurrentContext, hasCredentials, listContexts } from '../../lib/config.js';
 export default class ConfigList extends Command {
     static description = 'List all configured contexts';
     static examples = ['<%= config.bin %> config list', '<%= config.bin %> config list --json'];
@@ -16,7 +16,8 @@ export default class ConfigList extends Command {
         if (flags.json) {
             this.log(JSON.stringify({
                 contexts: contexts.map((c) => ({
-                    authenticated: Boolean(c.tokens),
+                    auth_type: getAuthType(c),
+                    authenticated: hasCredentials(c),
                     client_id: c.client_id,
                     environment: c.environment,
                     name: c.name,
@@ -35,10 +36,14 @@ export default class ConfigList extends Command {
         for (const ctx of contexts) {
             const isCurrent = current?.name === ctx.name;
             const marker = isCurrent ? '*' : ' ';
-            const auth = ctx.tokens ? '✓' : '✗';
+            const auth = hasCredentials(ctx) ? '✓' : '✗';
+            const authType = getAuthType(ctx);
             this.log(`${marker} ${ctx.name}`);
             this.log(`    Environment: ${ctx.environment}`);
-            this.log(`    Client ID: ${ctx.client_id}`);
+            this.log(`    Auth: ${authType === 'api_key' ? 'API key (x-api-key)' : 'oauth2'}`);
+            if (authType === 'oauth2') {
+                this.log(`    Client ID: ${ctx.client_id ?? 'N/A'}`);
+            }
             this.log(`    Authenticated: ${auth}`);
             if (ctx.tenant_id) {
                 this.log(`    Tenant ID: ${ctx.tenant_id}`);

package/dist/commands/config/set-api-key.d.ts

@@ -0,0 +1,10 @@
+import { Command } from '@oclif/core';
+export default class ConfigSetApiKey extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        context: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/config/set-api-key.js

@@ -0,0 +1,49 @@
+import { password } from '@inquirer/prompts';
+import { Command, Flags } from '@oclif/core';
+import { getAuthType, getContext, getCurrentContext, maskApiKey, saveApiKey } from '../../lib/config.js';
+export default class ConfigSetApiKey extends Command {
+    static description = 'Set or rotate the API key for a context (switches it to api-key auth)';
+    static examples = [
+        '<%= config.bin %> config set-api-key',
+        '<%= config.bin %> config set-api-key --context ci',
+        '<%= config.bin %> config set-api-key --context ci --api-key <key>',
+    ];
+    static flags = {
+        'api-key': Flags.string({
+            description: 'The API key. Prompted for (hidden) if omitted.',
+        }),
+        context: Flags.string({
+            aliases: ['config'],
+            char: 'c',
+            description: 'Context to update, overriding the current context (alias: --config)',
+            env: 'ADERIS_CONTEXT',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(ConfigSetApiKey);
+        const contextName = flags.context ?? getCurrentContext()?.name;
+        if (!contextName) {
+            this.error('No context configured. Run: aderis config add');
+        }
+        const context = getContext(contextName);
+        if (!context) {
+            this.error(`Context "${contextName}" not found.`);
+        }
+        const apiKey = flags['api-key'] ??
+            (await password({
+                mask: true,
+                message: `API key for "${contextName}":`,
+                validate: (value) => (value.trim() ? true : 'API key is required'),
+            }));
+        if (!apiKey.trim()) {
+            this.error('API key is required');
+        }
+        const wasOAuth = getAuthType(context) === 'oauth2';
+        saveApiKey(contextName, apiKey.trim());
+        this.log(`API key set for context "${contextName}" (${maskApiKey(apiKey.trim())})`);
+        if (wasOAuth) {
+            this.log('Auth method switched from oauth2 to api-key; requests now send the x-api-key header.');
+            this.log(`Any stored OAuth tokens are kept but unused. Remove them with: aderis auth logout --context ${contextName}`);
+        }
+    }
+}

package/dist/commands/config/use.js

@@ -1,6 +1,6 @@
 import { select } from '@inquirer/prompts';
 import { Args, Command } from '@oclif/core';
-import { getContext, listContexts, setCurrentContext } from '../../lib/config.js';
+import { getContext, hasCredentials, listContexts, missingCredentialsMessage, setCurrentContext, } from '../../lib/config.js';
 export default class ConfigUse extends Command {
     static args = {
         name: Args.string({
@@ -32,9 +32,8 @@ export default class ConfigUse extends Command {
         }
         setCurrentContext(contextName);
         this.log(`Switched to context "${contextName}" (${context.environment})`);
-        if (!context.tokens) {
-            this.log(`\nNote: You are not logged in to this context.`);
-            this.log(`Run: aderis auth login`);
+        if (!hasCredentials(context)) {
+            this.log(`\nNote: ${missingCredentialsMessage(context)}`);
         }
     }
 }

package/dist/commands/credit-card-accounts.js

@@ -1,6 +1,6 @@
 import { Command, Args, Flags } from '@oclif/core';
-import { apiRequest, ApiError } from '../lib/api-client.js';
-import { getCurrentContext, getContext, getBaseUrls } from '../lib/config.js';
+import { apiRequest, ApiError, normalizeSortBy } from '../lib/api-client.js';
+import { getCurrentContext, getContext, getBaseUrls, hasCredentials, missingCredentialsMessage } from '../lib/config.js';
 // Add 'import' action if both create and update exist
 const HAS_IMPORT = true;
 const HAS_EXPORT = true;
@@ -39,7 +39,7 @@ export default class CreditCardAccounts extends Command {
         id: Args.string({ description: 'Resource ID (for get, update, delete operations)', required: false }),
     };
     static flags = {
-        context: Flags.string({ char: 'c', description: 'Context to use' }),
+        context: Flags.string({ char: 'c', aliases: ['config'], env: 'ADERIS_CONTEXT', description: 'Context to use for this command, overriding the current context (alias: --config)' }),
         output: Flags.string({ char: 'o', description: 'Output format (default: table for import, json for other commands)', options: ['json', 'table', 'csv'] }),
         table: Flags.boolean({ char: 't', description: 'Output as table (shortcut for --output table)' }),
         csv: Flags.boolean({ description: 'Output as CSV (shortcut for --output csv)' }),
@@ -52,7 +52,7 @@ export default class CreditCardAccounts extends Command {
         limit: Flags.string({ description: 'Items per page' }),
         include: Flags.string({ description: 'Relations to include' }),
         search: Flags.string({ description: 'Search term' }),
-        'sort-by': Flags.string({ description: 'Sort field' }),
+        'sort-by': Flags.string({ description: 'Sort field(s), comma-separated. Direction (:ASC/:DESC) is optional; date-like fields default to DESC, others to ASC.' }),
         filter: Flags.string({ description: 'Filter (e.g. --filter status=ACTIVE). Operators: in:A,B, like:%, gt:, lt:, null:', multiple: true }),
         query: Flags.string({ description: 'Additional query params as JSON' }),
         fields: Flags.string({ description: 'Comma-separated list of fields to show (e.g. --fields=id,name,status)' }),
@@ -113,9 +113,9 @@ export default class CreditCardAccounts extends Command {
         }
         const context = flags.context ? getContext(flags.context) : getCurrentContext();
         if (!context)
-            this.error('No context configured. Run: aderis auth login --new');
-        if (!context.tokens)
-            this.error('Not logged in. Run: aderis auth login');
+            this.error(flags.context ? `Context "${flags.context}" not found. List contexts with: aderis config list` : 'No context configured. Run: aderis auth login --new');
+        if (!hasCredentials(context))
+            this.error(missingCredentialsMessage(context));
         const queryParams = {};
         if (flags.page)
             queryParams.page = flags.page;
@@ -126,7 +126,7 @@ export default class CreditCardAccounts extends Command {
         if (flags.search)
             queryParams.search = flags.search;
         if (flags['sort-by'])
-            queryParams.sortBy = flags['sort-by'];
+            queryParams.sortBy = normalizeSortBy(flags['sort-by']);
         if (flags.query) {
             try {
                 Object.assign(queryParams, JSON.parse(flags.query));
@@ -358,9 +358,9 @@ export default class CreditCardAccounts extends Command {
     async runImport(flags) {
         const context = flags.context ? getContext(flags.context) : getCurrentContext();
         if (!context)
-            this.error('No context configured. Run: aderis auth login --new');
-        if (!context.tokens)
-            this.error('Not logged in. Run: aderis auth login');
+            this.error(flags.context ? `Context "${flags.context}" not found. List contexts with: aderis config list` : 'No context configured. Run: aderis auth login --new');
+        if (!hasCredentials(context))
+            this.error(missingCredentialsMessage(context));
         // Get data from file, --data, or --set flags
         let items = [];
         if (flags.file) {
@@ -570,9 +570,9 @@ export default class CreditCardAccounts extends Command {
     async runExport(flags) {
         const context = flags.context ? getContext(flags.context) : getCurrentContext();
         if (!context)
-            this.error('No context configured. Run: aderis auth login --new');
-        if (!context.tokens)
-            this.error('Not logged in. Run: aderis auth login');
+            this.error(flags.context ? `Context "${flags.context}" not found. List contexts with: aderis config list` : 'No context configured. Run: aderis auth login --new');
+        if (!hasCredentials(context))
+            this.error(missingCredentialsMessage(context));
         const listEndpoint = ENDPOINTS['list'];
         if (!listEndpoint)
             this.error('Export requires a list endpoint');
@@ -585,7 +585,7 @@ export default class CreditCardAccounts extends Command {
         if (flags.search)
             baseParams.search = flags.search;
         if (flags['sort-by'])
-            baseParams.sortBy = flags['sort-by'];
+            baseParams.sortBy = normalizeSortBy(flags['sort-by']);
         if (flags.include)
             baseParams.include = flags.include;
         if (flags.query) {
@@ -664,9 +664,9 @@ export default class CreditCardAccounts extends Command {
     async runCamt053Import(flags) {
         const context = flags.context ? getContext(flags.context) : getCurrentContext();
         if (!context)
-            this.error('No context configured. Run: aderis auth login --new');
-        if (!context.tokens)
-            this.error('Not logged in. Run: aderis auth login');
+            this.error(flags.context ? `Context "${flags.context}" not found. List contexts with: aderis config list` : 'No context configured. Run: aderis auth login --new');
+        if (!hasCredentials(context))
+            this.error(missingCredentialsMessage(context));
         if (!flags.file) {
             this.error('CAMT.053 import requires --file (-f) flag with path to XML file');
         }
@@ -754,9 +754,9 @@ export default class CreditCardAccounts extends Command {
         }
         const context = flags.context ? getContext(flags.context) : getCurrentContext();
         if (!context)
-            this.error('No context configured. Run: aderis auth login --new');
-        if (!context.tokens)
-            this.error('Not logged in. Run: aderis auth login');
+            this.error(flags.context ? `Context "${flags.context}" not found. List contexts with: aderis config list` : 'No context configured. Run: aderis auth login --new');
+        if (!hasCredentials(context))
+            this.error(missingCredentialsMessage(context));
         // Get data from file, --data, or --set flags
         let items = [];
         if (flags.file) {

package/dist/commands/delivery-notes.js

@@ -1,26 +1,29 @@
 import { Command, Args, Flags } from '@oclif/core';
-import { apiRequest, ApiError } from '../lib/api-client.js';
-import { getCurrentContext, getContext, getBaseUrls } from '../lib/config.js';
+import { apiRequest, ApiError, normalizeSortBy } from '../lib/api-client.js';
+import { getCurrentContext, getContext, getBaseUrls, hasCredentials, missingCredentialsMessage } from '../lib/config.js';
 // Add 'import' action if both create and update exist
 const HAS_IMPORT = true;
 const HAS_EXPORT = true;
 const HAS_CAMT053 = false;
 const NESTED_IMPORTS = ["line-items", "notes", "files"];
-const SUBCOMMANDS = [...["list", "create", "create-from-orders", "create-from-invoice", "get", "update", "delete", "pdf", "submit", "approve", "cancel", "deliver", "ship", "create-line-items", "update-line-items-reorder", "update-line-items", "delete-line-items", "list-notes", "create-notes", "get-notes", "update-notes", "delete-notes", "list-files", "create-files", "get-files", "update-files", "delete-files", "files-download"], ...(HAS_IMPORT ? ['import'] : []), ...(HAS_EXPORT ? ['export'] : []), ...NESTED_IMPORTS.map(n => `import-${n}`)];
+const SUBCOMMANDS = [...["list", "create", "create-from-orders", "create-from-invoice", "create-invoice", "get", "update", "delete", "pdf", "submit", "approve", "cancel", "replace", "deliver", "ship", "send", "create-line-items", "update-line-items-reorder", "update-line-items", "delete-line-items", "list-notes", "create-notes", "get-notes", "update-notes", "delete-notes", "list-files", "create-files", "get-files", "update-files", "delete-files", "files-download"], ...(HAS_IMPORT ? ['import'] : []), ...(HAS_EXPORT ? ['export'] : []), ...NESTED_IMPORTS.map(n => `import-${n}`)];
 const ENDPOINTS = {
     'list': { method: 'GET', path: '/v1/delivery-notes', summary: 'Get all delivery notes with pagination', pathParams: [], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
-    'create': { method: 'POST', path: '/v1/delivery-notes', summary: 'Create a new delivery note', pathParams: [], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: ['files', 'notes', 'tagIds', 'lineItems'] },
+    'create': { method: 'POST', path: '/v1/delivery-notes', summary: 'Create a new delivery note', pathParams: [], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: ['files', 'notes', 'tagIds', 'tagCodes', 'lineItems'] },
     'create-from-orders': { method: 'POST', path: '/v1/delivery-notes/create-from-orders', summary: 'Create a DRAFT delivery note from several sales orders', pathParams: [], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: ['salesOrderIds'] },
     'create-from-invoice': { method: 'POST', path: '/v1/delivery-notes/create-from-invoice', summary: 'Create a DRAFT delivery note from a sales invoice', pathParams: [], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
+    'create-invoice': { method: 'POST', path: '/v1/delivery-notes/create-invoice', summary: 'Create ONE draft sales invoice from several delivery notes (same customer)', pathParams: [], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: ['deliveryNoteIds'] },
     'get': { method: 'GET', path: '/v1/delivery-notes/{id}', summary: 'Get a delivery note by ID', pathParams: ['id'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
-    'update': { method: 'PATCH', path: '/v1/delivery-notes/{id}', summary: 'Update a delivery note', pathParams: ['id'], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: ['files', 'notes', 'tagIds', 'removeFileIds'] },
+    'update': { method: 'PATCH', path: '/v1/delivery-notes/{id}', summary: 'Update a delivery note', pathParams: ['id'], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: ['files', 'notes', 'tagIds', 'tagCodes', 'removeFileIds'] },
     'delete': { method: 'DELETE', path: '/v1/delivery-notes/{id}', summary: 'Delete a delivery note', pathParams: ['id'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
     'pdf': { method: 'GET', path: '/v1/delivery-notes/{id}/pdf', summary: 'Render a delivery note PDF using the configured PDF processor', pathParams: ['id'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
     'submit': { method: 'POST', path: '/v1/delivery-notes/{id}/submit', summary: 'Submit a delivery note for approval (DRAFT → PENDING_APPROVAL)', pathParams: ['id'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
     'approve': { method: 'POST', path: '/v1/delivery-notes/{id}/approve', summary: 'Approve a delivery note (DRAFT or PENDING_APPROVAL → APPROVED)', pathParams: ['id'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
-    'cancel': { method: 'POST', path: '/v1/delivery-notes/{id}/cancel', summary: 'Cancel a delivery note (DRAFT / PENDING_APPROVAL / APPROVED → CANCELLED)', pathParams: ['id'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
+    'cancel': { method: 'POST', path: '/v1/delivery-notes/{id}/cancel', summary: 'Cancel a delivery note (DRAFT / PENDING_APPROVAL / APPROVED / SHIPPED / DELIVERED → CANCELLED)', pathParams: ['id'], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
+    'replace': { method: 'POST', path: '/v1/delivery-notes/{id}/replace', summary: 'Replace a delivery note (APPROVED / SHIPPED / DELIVERED / CANCELLED → REPLACED)', pathParams: ['id'], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
     'deliver': { method: 'POST', path: '/v1/delivery-notes/{id}/deliver', summary: 'Mark a delivery note as delivered (SHIPPED → DELIVERED)', pathParams: ['id'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
     'ship': { method: 'POST', path: '/v1/delivery-notes/{id}/ship', summary: 'Ship a delivery note (APPROVED → SHIPPED)', pathParams: ['id'], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: ['lineItems'] },
+    'send': { method: 'POST', path: '/v1/delivery-notes/{id}/send', summary: 'Send a delivery note to its recipient by email', pathParams: ['id'], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: ['emailCc', 'emailBcc'] },
     'create-line-items': { method: 'POST', path: '/v1/delivery-notes/{noteId}/line-items', summary: 'Add a line item to a delivery note', pathParams: ['noteId'], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: ['salesOrderLineItems'] },
     'update-line-items-reorder': { method: 'PATCH', path: '/v1/delivery-notes/{noteId}/line-items/reorder', summary: 'Bulk reorder line items (drag-and-drop)', pathParams: ['noteId'], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: ['items'] },
     'update-line-items': { method: 'PATCH', path: '/v1/delivery-notes/{noteId}/line-items/{lineItemId}', summary: 'Update a line item on a delivery note', pathParams: ['noteId', 'lineItemId'], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: ['salesOrderLineItems'] },
@@ -52,7 +55,7 @@ export default class DeliveryNotes extends Command {
         id: Args.string({ description: 'Resource ID (for get, update, delete operations)', required: false }),
     };
     static flags = {
-        context: Flags.string({ char: 'c', description: 'Context to use' }),
+        context: Flags.string({ char: 'c', aliases: ['config'], env: 'ADERIS_CONTEXT', description: 'Context to use for this command, overriding the current context (alias: --config)' }),
         output: Flags.string({ char: 'o', description: 'Output format (default: table for import, json for other commands)', options: ['json', 'table', 'csv'] }),
         table: Flags.boolean({ char: 't', description: 'Output as table (shortcut for --output table)' }),
         csv: Flags.boolean({ description: 'Output as CSV (shortcut for --output csv)' }),
@@ -66,7 +69,7 @@ export default class DeliveryNotes extends Command {
         limit: Flags.string({ description: 'Items per page' }),
         include: Flags.string({ description: 'Relations to include' }),
         search: Flags.string({ description: 'Search term' }),
-        'sort-by': Flags.string({ description: 'Sort field' }),
+        'sort-by': Flags.string({ description: 'Sort field(s), comma-separated. Direction (:ASC/:DESC) is optional; date-like fields default to DESC, others to ASC.' }),
         filter: Flags.string({ description: 'Filter (e.g. --filter status=ACTIVE). Operators: in:A,B, like:%, gt:, lt:, null:', multiple: true }),
         query: Flags.string({ description: 'Additional query params as JSON' }),
         fields: Flags.string({ description: 'Comma-separated list of fields to show (e.g. --fields=id,name,status)' }),
@@ -127,9 +130,9 @@ export default class DeliveryNotes extends Command {
         }
         const context = flags.context ? getContext(flags.context) : getCurrentContext();
         if (!context)
-            this.error('No context configured. Run: aderis auth login --new');
-        if (!context.tokens)
-            this.error('Not logged in. Run: aderis auth login');
+            this.error(flags.context ? `Context "${flags.context}" not found. List contexts with: aderis config list` : 'No context configured. Run: aderis auth login --new');
+        if (!hasCredentials(context))
+            this.error(missingCredentialsMessage(context));
         const queryParams = {};
         if (flags.page)
             queryParams.page = flags.page;
@@ -140,7 +143,7 @@ export default class DeliveryNotes extends Command {
         if (flags.search)
             queryParams.search = flags.search;
         if (flags['sort-by'])
-            queryParams.sortBy = flags['sort-by'];
+            queryParams.sortBy = normalizeSortBy(flags['sort-by']);
         if (flags.query) {
             try {
                 Object.assign(queryParams, JSON.parse(flags.query));
@@ -372,9 +375,9 @@ export default class DeliveryNotes extends Command {
     async runImport(flags) {
         const context = flags.context ? getContext(flags.context) : getCurrentContext();
         if (!context)
-            this.error('No context configured. Run: aderis auth login --new');
-        if (!context.tokens)
-            this.error('Not logged in. Run: aderis auth login');
+            this.error(flags.context ? `Context "${flags.context}" not found. List contexts with: aderis config list` : 'No context configured. Run: aderis auth login --new');
+        if (!hasCredentials(context))
+            this.error(missingCredentialsMessage(context));
         // Get data from file, --data, or --set flags
         let items = [];
         if (flags.file) {
@@ -584,9 +587,9 @@ export default class DeliveryNotes extends Command {
     async runExport(flags) {
         const context = flags.context ? getContext(flags.context) : getCurrentContext();
         if (!context)
-            this.error('No context configured. Run: aderis auth login --new');
-        if (!context.tokens)
-            this.error('Not logged in. Run: aderis auth login');
+            this.error(flags.context ? `Context "${flags.context}" not found. List contexts with: aderis config list` : 'No context configured. Run: aderis auth login --new');
+        if (!hasCredentials(context))
+            this.error(missingCredentialsMessage(context));
         const listEndpoint = ENDPOINTS['list'];
         if (!listEndpoint)
             this.error('Export requires a list endpoint');
@@ -599,7 +602,7 @@ export default class DeliveryNotes extends Command {
         if (flags.search)
             baseParams.search = flags.search;
         if (flags['sort-by'])
-            baseParams.sortBy = flags['sort-by'];
+            baseParams.sortBy = normalizeSortBy(flags['sort-by']);
         if (flags.include)
             baseParams.include = flags.include;
         if (flags.query) {
@@ -678,9 +681,9 @@ export default class DeliveryNotes extends Command {
     async runCamt053Import(flags) {
         const context = flags.context ? getContext(flags.context) : getCurrentContext();
         if (!context)
-            this.error('No context configured. Run: aderis auth login --new');
-        if (!context.tokens)
-            this.error('Not logged in. Run: aderis auth login');
+            this.error(flags.context ? `Context "${flags.context}" not found. List contexts with: aderis config list` : 'No context configured. Run: aderis auth login --new');
+        if (!hasCredentials(context))
+            this.error(missingCredentialsMessage(context));
         if (!flags.file) {
             this.error('CAMT.053 import requires --file (-f) flag with path to XML file');
         }
@@ -768,9 +771,9 @@ export default class DeliveryNotes extends Command {
         }
         const context = flags.context ? getContext(flags.context) : getCurrentContext();
         if (!context)
-            this.error('No context configured. Run: aderis auth login --new');
-        if (!context.tokens)
-            this.error('Not logged in. Run: aderis auth login');
+            this.error(flags.context ? `Context "${flags.context}" not found. List contexts with: aderis config list` : 'No context configured. Run: aderis auth login --new');
+        if (!hasCredentials(context))
+            this.error(missingCredentialsMessage(context));
         // Get data from file, --data, or --set flags
         let items = [];
         if (flags.file) {

package/dist/commands/dunning-configs.js

@@ -1,6 +1,6 @@
 import { Command, Args, Flags } from '@oclif/core';
-import { apiRequest, ApiError } from '../lib/api-client.js';
-import { getCurrentContext, getContext, getBaseUrls } from '../lib/config.js';
+import { apiRequest, ApiError, normalizeSortBy } from '../lib/api-client.js';
+import { getCurrentContext, getContext, getBaseUrls, hasCredentials, missingCredentialsMessage } from '../lib/config.js';
 // Add 'import' action if both create and update exist
 const HAS_IMPORT = true;
 const HAS_EXPORT = true;
@@ -29,7 +29,7 @@ export default class DunningConfigs extends Command {
         id: Args.string({ description: 'Resource ID (for get, update, delete operations)', required: false }),
     };
     static flags = {
-        context: Flags.string({ char: 'c', description: 'Context to use' }),
+        context: Flags.string({ char: 'c', aliases: ['config'], env: 'ADERIS_CONTEXT', description: 'Context to use for this command, overriding the current context (alias: --config)' }),
         output: Flags.string({ char: 'o', description: 'Output format (default: table for import, json for other commands)', options: ['json', 'table', 'csv'] }),
         table: Flags.boolean({ char: 't', description: 'Output as table (shortcut for --output table)' }),
         csv: Flags.boolean({ description: 'Output as CSV (shortcut for --output csv)' }),
@@ -40,7 +40,7 @@ export default class DunningConfigs extends Command {
         limit: Flags.string({ description: 'Items per page' }),
         include: Flags.string({ description: 'Relations to include' }),
         search: Flags.string({ description: 'Search term' }),
-        'sort-by': Flags.string({ description: 'Sort field' }),
+        'sort-by': Flags.string({ description: 'Sort field(s), comma-separated. Direction (:ASC/:DESC) is optional; date-like fields default to DESC, others to ASC.' }),
         filter: Flags.string({ description: 'Filter (e.g. --filter status=ACTIVE). Operators: in:A,B, like:%, gt:, lt:, null:', multiple: true }),
         query: Flags.string({ description: 'Additional query params as JSON' }),
         fields: Flags.string({ description: 'Comma-separated list of fields to show (e.g. --fields=id,name,status)' }),
@@ -101,9 +101,9 @@ export default class DunningConfigs extends Command {
         }
         const context = flags.context ? getContext(flags.context) : getCurrentContext();
         if (!context)
-            this.error('No context configured. Run: aderis auth login --new');
-        if (!context.tokens)
-            this.error('Not logged in. Run: aderis auth login');
+            this.error(flags.context ? `Context "${flags.context}" not found. List contexts with: aderis config list` : 'No context configured. Run: aderis auth login --new');
+        if (!hasCredentials(context))
+            this.error(missingCredentialsMessage(context));
         const queryParams = {};
         if (flags.page)
             queryParams.page = flags.page;
@@ -114,7 +114,7 @@ export default class DunningConfigs extends Command {
         if (flags.search)
             queryParams.search = flags.search;
         if (flags['sort-by'])
-            queryParams.sortBy = flags['sort-by'];
+            queryParams.sortBy = normalizeSortBy(flags['sort-by']);
         if (flags.query) {
             try {
                 Object.assign(queryParams, JSON.parse(flags.query));
@@ -346,9 +346,9 @@ export default class DunningConfigs extends Command {
     async runImport(flags) {
         const context = flags.context ? getContext(flags.context) : getCurrentContext();
         if (!context)
-            this.error('No context configured. Run: aderis auth login --new');
-        if (!context.tokens)
-            this.error('Not logged in. Run: aderis auth login');
+            this.error(flags.context ? `Context "${flags.context}" not found. List contexts with: aderis config list` : 'No context configured. Run: aderis auth login --new');
+        if (!hasCredentials(context))
+            this.error(missingCredentialsMessage(context));
         // Get data from file, --data, or --set flags
         let items = [];
         if (flags.file) {
@@ -558,9 +558,9 @@ export default class DunningConfigs extends Command {
     async runExport(flags) {
         const context = flags.context ? getContext(flags.context) : getCurrentContext();
         if (!context)
-            this.error('No context configured. Run: aderis auth login --new');
-        if (!context.tokens)
-            this.error('Not logged in. Run: aderis auth login');
+            this.error(flags.context ? `Context "${flags.context}" not found. List contexts with: aderis config list` : 'No context configured. Run: aderis auth login --new');
+        if (!hasCredentials(context))
+            this.error(missingCredentialsMessage(context));
         const listEndpoint = ENDPOINTS['list'];
         if (!listEndpoint)
             this.error('Export requires a list endpoint');
@@ -573,7 +573,7 @@ export default class DunningConfigs extends Command {
         if (flags.search)
             baseParams.search = flags.search;
         if (flags['sort-by'])
-            baseParams.sortBy = flags['sort-by'];
+            baseParams.sortBy = normalizeSortBy(flags['sort-by']);
         if (flags.include)
             baseParams.include = flags.include;
         if (flags.query) {
@@ -652,9 +652,9 @@ export default class DunningConfigs extends Command {
     async runCamt053Import(flags) {
         const context = flags.context ? getContext(flags.context) : getCurrentContext();
         if (!context)
-            this.error('No context configured. Run: aderis auth login --new');
-        if (!context.tokens)
-            this.error('Not logged in. Run: aderis auth login');
+            this.error(flags.context ? `Context "${flags.context}" not found. List contexts with: aderis config list` : 'No context configured. Run: aderis auth login --new');
+        if (!hasCredentials(context))
+            this.error(missingCredentialsMessage(context));
         if (!flags.file) {
             this.error('CAMT.053 import requires --file (-f) flag with path to XML file');
         }
@@ -742,9 +742,9 @@ export default class DunningConfigs extends Command {
         }
         const context = flags.context ? getContext(flags.context) : getCurrentContext();
         if (!context)
-            this.error('No context configured. Run: aderis auth login --new');
-        if (!context.tokens)
-            this.error('Not logged in. Run: aderis auth login');
+            this.error(flags.context ? `Context "${flags.context}" not found. List contexts with: aderis config list` : 'No context configured. Run: aderis auth login --new');
+        if (!hasCredentials(context))
+            this.error(missingCredentialsMessage(context));
         // Get data from file, --data, or --set flags
         let items = [];
         if (flags.file) {