@aderis-erp/cli 1.0.4 → 1.0.8

package/dist/commands/{webhooks 3.js → vat-declaration.js}

@@ -6,25 +6,30 @@ const HAS_IMPORT = true;
 const HAS_EXPORT = true;
 const HAS_CAMT053 = false;
 const NESTED_IMPORTS = [];
-const SUBCOMMANDS = [...["list", "create", "events", "events-relations", "get", "update", "delete"], ...(HAS_IMPORT ? ['import'] : []), ...(HAS_EXPORT ? ['export'] : []), ...NESTED_IMPORTS.map(n => `import-${n}`)];
+const SUBCOMMANDS = [...["list", "create", "preview", "get", "update", "regenerate", "replace", "fields-contributions", "fields-contributions-export", "approve", "mark-as-filed", "xml"], ...(HAS_IMPORT ? ['import'] : []), ...(HAS_EXPORT ? ['export'] : []), ...NESTED_IMPORTS.map(n => `import-${n}`)];
 const ENDPOINTS = {
-    'list': { method: 'GET', path: '/v1/webhooks', summary: 'List all webhook subscriptions', pathParams: [], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
-    'create': { method: 'POST', path: '/v1/webhooks', summary: 'Create a new webhook subscription', pathParams: [], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: ['tenantIds'] },
-    'events': { method: 'GET', path: '/v1/webhooks/events', summary: 'Get available event types', pathParams: [], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
-    'events-relations': { method: 'GET', path: '/v1/webhooks/events/{eventType}/relations', summary: 'Get valid relations for an event type', pathParams: ['eventType'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
-    'get': { method: 'GET', path: '/v1/webhooks/{id}', summary: 'Get a webhook subscription by ID', pathParams: ['id'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
-    'update': { method: 'PATCH', path: '/v1/webhooks/{id}', summary: 'Update a webhook subscription', pathParams: ['id'], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: ['tenantIds'] },
-    'delete': { method: 'DELETE', path: '/v1/webhooks/{id}', summary: 'Delete a webhook subscription', pathParams: ['id'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
+    'list': { method: 'GET', path: '/v1/vat-declaration', summary: 'List VAT reports (paginated)', pathParams: [], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
+    'create': { method: 'POST', path: '/v1/vat-declaration', summary: 'Create a VAT declaration report (always async-accepted)', pathParams: [], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
+    'preview': { method: 'GET', path: '/v1/vat-declaration/preview', summary: 'Preview the in-scope counts and late entries for a candidate period', pathParams: [], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
+    'get': { method: 'GET', path: '/v1/vat-declaration/{id}', summary: 'Get a VAT report by id (this is the polling endpoint for async generation)', pathParams: ['id'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
+    'update': { method: 'PATCH', path: '/v1/vat-declaration/{id}', summary: 'Update manualAdjustments and/or generalInfo on a DRAFT report', pathParams: ['id'], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: ['manualAdjustments'] },
+    'regenerate': { method: 'POST', path: '/v1/vat-declaration/{id}/regenerate', summary: 'Re-run the full generation pipeline on a DRAFT report', pathParams: ['id'], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
+    'replace': { method: 'POST', path: '/v1/vat-declaration/{id}/replace', summary: 'Create a corrective DRAFT (Berichtigungsabrechnung) from a FILED report', pathParams: ['id'], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
+    'fields-contributions': { method: 'GET', path: '/v1/vat-declaration/{id}/fields/{fieldId}/contributions', summary: 'Drill into the contributions for a single Ziffer', pathParams: ['id', 'fieldId'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
+    'fields-contributions-export': { method: 'GET', path: '/v1/vat-declaration/{id}/fields/{fieldId}/contributions/export', summary: 'Export the drill-down result set as an Excel workbook', pathParams: ['id', 'fieldId'], hasBody: false, isMultipart: false, isBinaryResponse: true, bodyArrayFields: [] },
+    'approve': { method: 'POST', path: '/v1/vat-declaration/{id}/approve', summary: 'Approve a VAT report and produce the eCH-0217 XML submission file.', pathParams: ['id'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
+    'mark-as-filed': { method: 'POST', path: '/v1/vat-declaration/{id}/mark-as-filed', summary: 'Record the ESTV filing reference for a FINALIZED VAT report.', pathParams: ['id'], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
+    'xml': { method: 'GET', path: '/v1/vat-declaration/{id}/xml', summary: 'Download the eCH-0217 XML submission file for a FINALIZED or FILED VAT report.', pathParams: ['id'], hasBody: false, isMultipart: false, isBinaryResponse: true, bodyArrayFields: [] },
 };
-export default class Webhooks extends Command {
-    static description = 'Manage webhooks';
+export default class VatDeclaration extends Command {
+    static description = 'Manage vat declaration';
     static examples = [
-        '<%= config.bin %> webhooks list',
-        '<%= config.bin %> webhooks get <id>',
-        '<%= config.bin %> webhooks create --data \'{...}\'',
-        '<%= config.bin %> webhooks update <id> --set field=value',
-        '<%= config.bin %> webhooks import --file data.json',
-        '<%= config.bin %> webhooks export --csv > webhooks.csv',
+        '<%= config.bin %> vat-declaration list',
+        '<%= config.bin %> vat-declaration get <id>',
+        '<%= config.bin %> vat-declaration create --data \'{...}\'',
+        '<%= config.bin %> vat-declaration update <id> --set field=value',
+        '<%= config.bin %> vat-declaration import --file data.json',
+        '<%= config.bin %> vat-declaration export --csv > vat-declaration.csv',
     ];
     static args = {
         action: Args.string({ description: 'Action: ' + SUBCOMMANDS.join(', '), required: true }),
@@ -38,6 +43,7 @@ export default class Webhooks extends Command {
         data: Flags.string({ char: 'd', description: 'JSON data for request body' }),
         file: Flags.string({ char: 'f', description: 'Read request body from file' }),
         set: Flags.string({ char: 's', description: 'Set individual field (e.g. --set firstName=John)', multiple: true }),
+        'field-id': Flags.string({ description: 'Path param: fieldId' }),
         page: Flags.string({ description: 'Page number' }),
         limit: Flags.string({ description: 'Items per page' }),
         include: Flags.string({ description: 'Relations to include' }),
@@ -50,7 +56,7 @@ export default class Webhooks extends Command {
         'show-http-request': Flags.boolean({ description: 'Show HTTP request details (method, URL, body)' }),
     };
     async run() {
-        const { args, flags } = await this.parse(Webhooks);
+        const { args, flags } = await this.parse(VatDeclaration);
         // Handle import action specially
         if (args.action === 'import') {
             if (!HAS_IMPORT)
@@ -83,11 +89,6 @@ export default class Webhooks extends Command {
         const endpoint = ENDPOINTS[args.action];
         if (!endpoint)
             this.error(`Unknown action: ${args.action}. Available: ${SUBCOMMANDS.join(', ')}`);
-        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');
         let apiPath = endpoint.path;
         for (let i = 0; i < endpoint.pathParams.length; i++) {
             const param = endpoint.pathParams[i];
@@ -96,7 +97,7 @@ export default class Webhooks extends Command {
                 // First path param always comes from positional argument
                 value = args.id;
                 if (!value)
-                    this.error('Missing required argument: id. Usage: aderis webhooks <action> <id>');
+                    this.error('Missing required argument: id. Usage: aderis vat-declaration <action> <id>');
             }
             else {
                 const flagName = param.replace(/\./g, '-').replace(/([A-Z])/g, '-$1').toLowerCase().replace(/^-/, '');
@@ -106,6 +107,11 @@ export default class Webhooks extends Command {
             }
             apiPath = apiPath.replace(`{${param}}`, String(value));
         }
+        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');
         const queryParams = {};
         if (flags.page)
             queryParams.page = flags.page;
@@ -165,7 +171,9 @@ export default class Webhooks extends Command {
             data = form;
         }
         else if (endpoint.hasBody) {
-            if (flags.file) {
+            // For binary-response endpoints, --file is the output path, not a JSON
+            // input file — skip the read-as-body branch.
+            if (flags.file && !endpoint.isBinaryResponse) {
                 const fsModule = await import('node:fs');
                 try {
                     data = JSON.parse(fsModule.readFileSync(flags.file, 'utf-8'));
@@ -688,7 +696,7 @@ export default class Webhooks extends Command {
     }
     async runNestedImport(suffix, parentId, flags) {
         if (!parentId) {
-            this.error(`Missing required argument: id. Usage: aderis webhooks import-${suffix} <parent-id> --file data.json`);
+            this.error(`Missing required argument: id. Usage: aderis vat-declaration import-${suffix} <parent-id> --file data.json`);
         }
         const context = flags.context ? getContext(flags.context) : getCurrentContext();
         if (!context)

package/dist/commands/vendor-invoices.js

@@ -114,11 +114,6 @@ export default class VendorInvoices extends Command {
         const endpoint = ENDPOINTS[args.action];
         if (!endpoint)
             this.error(`Unknown action: ${args.action}. Available: ${SUBCOMMANDS.join(', ')}`);
-        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');
         let apiPath = endpoint.path;
         for (let i = 0; i < endpoint.pathParams.length; i++) {
             const param = endpoint.pathParams[i];
@@ -137,6 +132,11 @@ export default class VendorInvoices extends Command {
             }
             apiPath = apiPath.replace(`{${param}}`, String(value));
         }
+        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');
         const queryParams = {};
         if (flags.page)
             queryParams.page = flags.page;

package/dist/commands/webhooks.js

@@ -83,11 +83,6 @@ export default class Webhooks extends Command {
         const endpoint = ENDPOINTS[args.action];
         if (!endpoint)
             this.error(`Unknown action: ${args.action}. Available: ${SUBCOMMANDS.join(', ')}`);
-        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');
         let apiPath = endpoint.path;
         for (let i = 0; i < endpoint.pathParams.length; i++) {
             const param = endpoint.pathParams[i];
@@ -106,6 +101,11 @@ export default class Webhooks extends Command {
             }
             apiPath = apiPath.replace(`{${param}}`, String(value));
         }
+        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');
         const queryParams = {};
         if (flags.page)
             queryParams.page = flags.page;

package/dist/commands/workflows.js

@@ -75,11 +75,6 @@ export default class Workflows extends Command {
         const endpoint = ENDPOINTS[args.action];
         if (!endpoint)
             this.error(`Unknown action: ${args.action}. Available: ${SUBCOMMANDS.join(', ')}`);
-        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');
         let apiPath = endpoint.path;
         for (let i = 0; i < endpoint.pathParams.length; i++) {
             const param = endpoint.pathParams[i];
@@ -98,6 +93,11 @@ export default class Workflows extends Command {
             }
             apiPath = apiPath.replace(`{${param}}`, String(value));
         }
+        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');
         const queryParams = {};
         if (flags.page)
             queryParams.page = flags.page;

package/dist/lib/api-client.d.ts

@@ -25,10 +25,10 @@ export declare class ApiError extends Error {
     data?: unknown | undefined;
     constructor(message: string, status: number, data?: unknown | undefined);
 }
-export declare function createApiClient(contextName?: string, options?: {
+export declare function createApiClient(contextName?: string, options?: boolean | {
     acceptAny?: boolean;
     binary?: boolean;
-} | boolean): Promise<AxiosInstance>;
+}): Promise<AxiosInstance>;
 export declare function apiRequest<T = unknown>(method: string, path: string, options?: {
     acceptAny?: boolean;
     binary?: boolean;
@@ -36,6 +36,7 @@ export declare function apiRequest<T = unknown>(method: string, path: string, op
     contextName?: string;
     data?: unknown;
     params?: Record<string, unknown>;
+    responseType?: 'arraybuffer' | 'json' | 'stream' | 'text';
 }): Promise<ApiResponse<T>>;
 export declare function apiGet<T = unknown>(path: string, params?: Record<string, unknown>, contextName?: string): Promise<ApiResponse<T>>;
 export declare function apiPost<T = unknown>(path: string, data?: unknown, contextName?: string): Promise<ApiResponse<T>>;

package/dist/lib/api-client.js

@@ -109,6 +109,10 @@ export async function apiRequest(method, path, options = {}) {
     if (options.contentType) {
         config.headers = { ...config.headers, 'Content-Type': options.contentType };
     }
+    // Override responseType if specified (takes precedence over client-level default)
+    if (options.responseType) {
+        config.responseType = options.responseType;
+    }
     const response = await client.request(config);
     return {
         data: response.data,

package/dist/lib/auth.js

@@ -160,6 +160,7 @@ export async function login(context, options = {}) {
     const authorizationUrl = buildAuthorizeUrl(context, pkce, state, options);
     return new Promise((resolve, reject) => {
         const connections = new Set();
+        // eslint-disable-next-line prefer-const -- assigned after server creation; closure captures the reference safely
         let timeoutId;
         const server = http.createServer(async (req, res) => {
             const url = new URL(req.url || '', `http://localhost:${CALLBACK_PORT}`);