@aderis-erp/cli 1.1.0 → 1.1.2

package/dist/commands/saved-views.js

@@ -39,6 +39,7 @@ export default class SavedViews extends Command {
         query: Flags.string({ description: 'Additional query params as JSON' }),
         fields: Flags.string({ description: 'Comma-separated list of fields to return, applied by the API (e.g. --fields=id,name,status)' }),
         sanitize: Flags.boolean({ description: 'Remove null values, audit fields, and duplicate UUIDs from output' }),
+        meta: Flags.boolean({ description: 'Keep the API envelope in JSON output: data plus page, totals and sums' }),
         'show-http-request': Flags.boolean({ description: 'Show HTTP request details (method, URL, body)' }),
     };
     async run() {
@@ -331,9 +332,15 @@ export default class SavedViews extends Command {
                 }
                 catch { /* keep as string */ }
             }
-            // Extract data array from paginated wrapper (e.g., { data: [...], total: 3 })
+            // A paginated answer is { data, meta, links, totals }. The records are
+            // unwrapped for output, but what the API said about the page is kept:
+            // dropping it silently let a script read one page as the whole result
+            // (AderisERP/product#61).
+            let envelope;
             if (output && typeof output === 'object' && !Array.isArray(output) && 'data' in output && Array.isArray(output.data)) {
-                output = output.data;
+                const page = output;
+                envelope = page;
+                output = page.data;
             }
             // For table/csv on non-array responses, auto-extract the primary array
             // e.g., { payments: [...], total: 3 } → extract payments array
@@ -350,12 +357,24 @@ export default class SavedViews extends Command {
                 output = this.sanitizeOutput(output);
             }
             const fieldList = flags.fields?.split(',').map(f => f.trim());
-            if (flags.csv || flags.output === 'csv')
+            if (envelope)
+                this.warnShortPage(envelope, flags.limit);
+            if (flags.csv || flags.output === 'csv') {
                 this.printCsv(output, fieldList);
-            else if (flags.table || flags.output === 'table')
+            }
+            else if (flags.table || flags.output === 'table') {
                 this.printTable(output, fieldList);
-            else
+                if (envelope)
+                    this.printPageSummary(envelope);
+            }
+            else if (envelope && flags.meta) {
+                // The whole envelope, for a caller that asked for it; the default stays
+                // a bare array so existing scripts are unaffected.
+                this.log(JSON.stringify({ ...envelope, data: output }, null, 2));
+            }
+            else {
                 this.log(JSON.stringify(output, null, 2));
+            }
         }
         catch (error) {
             if (error instanceof ApiError) {
@@ -984,6 +1003,34 @@ export default class SavedViews extends Command {
             return `\$${op}`;
         return opRe.test(rest) ? `\$${op}:${this.parseFilterValue(rest)}` : `\$${op}:${rest}`;
     }
+    /** The page line under a table: which page, how many, and any sums the API returned. */
+    printPageSummary(envelope) {
+        const meta = envelope.meta;
+        if (meta && typeof meta.currentPage === 'number' && typeof meta.totalPages === 'number') {
+            const shown = Array.isArray(envelope.data) ? envelope.data.length : 0;
+            this.log(`
+Page ${meta.currentPage}/${meta.totalPages} — ${shown} of ${meta.totalItems ?? '?'} records`);
+        }
+        for (const total of envelope.totals ?? []) {
+            const { currency, ...sums } = total;
+            const parts = Object.entries(sums).map(([column, value]) => `${column} ${value}`).join(', ');
+            this.log(`Total ${currency ?? ''}: ${parts}`.trim());
+        }
+    }
+    /**
+     * The API caps how many records a page may hold. Asking for more and getting
+     * fewer looks like "that is everything" unless it is said out loud.
+     */
+    warnShortPage(envelope, requestedLimit) {
+        const asked = requestedLimit === undefined ? undefined : Number(requestedLimit);
+        const perPage = envelope.meta?.itemsPerPage;
+        if (asked === undefined || Number.isNaN(asked) || typeof perPage !== 'number' || perPage >= asked)
+            return;
+        const pages = envelope.meta?.totalPages;
+        const more = typeof pages === 'number' && pages > 1 ? ` Use --page, or the export action for every page.` : '';
+        process.stderr.write(`! Asked for ${asked} records per page; the API returned at most ${perPage}.${more}
+`);
+    }
     sanitizeOutput(data) {
         const auditFields = ['_type', 'tenantId', 'createdAt', 'updatedAt', 'createdBy', 'updatedBy'];
         const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;

package/dist/commands/scheduled-processor-mappings.d.ts

@@ -23,6 +23,7 @@ export default class ScheduledProcessorMappings extends Command {
         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>;
+        meta: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'show-http-request': import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
@@ -31,6 +32,13 @@ export default class ScheduledProcessorMappings extends Command {
     private runCamt053Import;
     private runNestedImport;
     private parseFilterValue;
+    /** The page line under a table: which page, how many, and any sums the API returned. */
+    private printPageSummary;
+    /**
+     * The API caps how many records a page may hold. Asking for more and getting
+     * fewer looks like "that is everything" unless it is said out loud.
+     */
+    private warnShortPage;
     private sanitizeOutput;
     private getColumns;
     private getValue;

package/dist/commands/scheduled-processor-mappings.js

@@ -45,6 +45,7 @@ export default class ScheduledProcessorMappings extends Command {
         query: Flags.string({ description: 'Additional query params as JSON' }),
         fields: Flags.string({ description: 'Comma-separated list of fields to return, applied by the API (e.g. --fields=id,name,status)' }),
         sanitize: Flags.boolean({ description: 'Remove null values, audit fields, and duplicate UUIDs from output' }),
+        meta: Flags.boolean({ description: 'Keep the API envelope in JSON output: data plus page, totals and sums' }),
         'show-http-request': Flags.boolean({ description: 'Show HTTP request details (method, URL, body)' }),
     };
     async run() {
@@ -337,9 +338,15 @@ export default class ScheduledProcessorMappings extends Command {
                 }
                 catch { /* keep as string */ }
             }
-            // Extract data array from paginated wrapper (e.g., { data: [...], total: 3 })
+            // A paginated answer is { data, meta, links, totals }. The records are
+            // unwrapped for output, but what the API said about the page is kept:
+            // dropping it silently let a script read one page as the whole result
+            // (AderisERP/product#61).
+            let envelope;
             if (output && typeof output === 'object' && !Array.isArray(output) && 'data' in output && Array.isArray(output.data)) {
-                output = output.data;
+                const page = output;
+                envelope = page;
+                output = page.data;
             }
             // For table/csv on non-array responses, auto-extract the primary array
             // e.g., { payments: [...], total: 3 } → extract payments array
@@ -356,12 +363,24 @@ export default class ScheduledProcessorMappings extends Command {
                 output = this.sanitizeOutput(output);
             }
             const fieldList = flags.fields?.split(',').map(f => f.trim());
-            if (flags.csv || flags.output === 'csv')
+            if (envelope)
+                this.warnShortPage(envelope, flags.limit);
+            if (flags.csv || flags.output === 'csv') {
                 this.printCsv(output, fieldList);
-            else if (flags.table || flags.output === 'table')
+            }
+            else if (flags.table || flags.output === 'table') {
                 this.printTable(output, fieldList);
-            else
+                if (envelope)
+                    this.printPageSummary(envelope);
+            }
+            else if (envelope && flags.meta) {
+                // The whole envelope, for a caller that asked for it; the default stays
+                // a bare array so existing scripts are unaffected.
+                this.log(JSON.stringify({ ...envelope, data: output }, null, 2));
+            }
+            else {
                 this.log(JSON.stringify(output, null, 2));
+            }
         }
         catch (error) {
             if (error instanceof ApiError) {
@@ -990,6 +1009,34 @@ export default class ScheduledProcessorMappings extends Command {
             return `\$${op}`;
         return opRe.test(rest) ? `\$${op}:${this.parseFilterValue(rest)}` : `\$${op}:${rest}`;
     }
+    /** The page line under a table: which page, how many, and any sums the API returned. */
+    printPageSummary(envelope) {
+        const meta = envelope.meta;
+        if (meta && typeof meta.currentPage === 'number' && typeof meta.totalPages === 'number') {
+            const shown = Array.isArray(envelope.data) ? envelope.data.length : 0;
+            this.log(`
+Page ${meta.currentPage}/${meta.totalPages} — ${shown} of ${meta.totalItems ?? '?'} records`);
+        }
+        for (const total of envelope.totals ?? []) {
+            const { currency, ...sums } = total;
+            const parts = Object.entries(sums).map(([column, value]) => `${column} ${value}`).join(', ');
+            this.log(`Total ${currency ?? ''}: ${parts}`.trim());
+        }
+    }
+    /**
+     * The API caps how many records a page may hold. Asking for more and getting
+     * fewer looks like "that is everything" unless it is said out loud.
+     */
+    warnShortPage(envelope, requestedLimit) {
+        const asked = requestedLimit === undefined ? undefined : Number(requestedLimit);
+        const perPage = envelope.meta?.itemsPerPage;
+        if (asked === undefined || Number.isNaN(asked) || typeof perPage !== 'number' || perPage >= asked)
+            return;
+        const pages = envelope.meta?.totalPages;
+        const more = typeof pages === 'number' && pages > 1 ? ` Use --page, or the export action for every page.` : '';
+        process.stderr.write(`! Asked for ${asked} records per page; the API returned at most ${perPage}.${more}
+`);
+    }
     sanitizeOutput(data) {
         const auditFields = ['_type', 'tenantId', 'createdAt', 'updatedAt', 'createdBy', 'updatedBy'];
         const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;

package/dist/commands/schedules.d.ts

@@ -23,6 +23,7 @@ export default class Schedules extends Command {
         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>;
+        meta: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'show-http-request': import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
@@ -31,6 +32,13 @@ export default class Schedules extends Command {
     private runCamt053Import;
     private runNestedImport;
     private parseFilterValue;
+    /** The page line under a table: which page, how many, and any sums the API returned. */
+    private printPageSummary;
+    /**
+     * The API caps how many records a page may hold. Asking for more and getting
+     * fewer looks like "that is everything" unless it is said out loud.
+     */
+    private warnShortPage;
     private sanitizeOutput;
     private getColumns;
     private getValue;

package/dist/commands/schedules.js

@@ -49,6 +49,7 @@ export default class Schedules extends Command {
         query: Flags.string({ description: 'Additional query params as JSON' }),
         fields: Flags.string({ description: 'Comma-separated list of fields to return, applied by the API (e.g. --fields=id,name,status)' }),
         sanitize: Flags.boolean({ description: 'Remove null values, audit fields, and duplicate UUIDs from output' }),
+        meta: Flags.boolean({ description: 'Keep the API envelope in JSON output: data plus page, totals and sums' }),
         'show-http-request': Flags.boolean({ description: 'Show HTTP request details (method, URL, body)' }),
     };
     async run() {
@@ -341,9 +342,15 @@ export default class Schedules extends Command {
                 }
                 catch { /* keep as string */ }
             }
-            // Extract data array from paginated wrapper (e.g., { data: [...], total: 3 })
+            // A paginated answer is { data, meta, links, totals }. The records are
+            // unwrapped for output, but what the API said about the page is kept:
+            // dropping it silently let a script read one page as the whole result
+            // (AderisERP/product#61).
+            let envelope;
             if (output && typeof output === 'object' && !Array.isArray(output) && 'data' in output && Array.isArray(output.data)) {
-                output = output.data;
+                const page = output;
+                envelope = page;
+                output = page.data;
             }
             // For table/csv on non-array responses, auto-extract the primary array
             // e.g., { payments: [...], total: 3 } → extract payments array
@@ -360,12 +367,24 @@ export default class Schedules extends Command {
                 output = this.sanitizeOutput(output);
             }
             const fieldList = flags.fields?.split(',').map(f => f.trim());
-            if (flags.csv || flags.output === 'csv')
+            if (envelope)
+                this.warnShortPage(envelope, flags.limit);
+            if (flags.csv || flags.output === 'csv') {
                 this.printCsv(output, fieldList);
-            else if (flags.table || flags.output === 'table')
+            }
+            else if (flags.table || flags.output === 'table') {
                 this.printTable(output, fieldList);
-            else
+                if (envelope)
+                    this.printPageSummary(envelope);
+            }
+            else if (envelope && flags.meta) {
+                // The whole envelope, for a caller that asked for it; the default stays
+                // a bare array so existing scripts are unaffected.
+                this.log(JSON.stringify({ ...envelope, data: output }, null, 2));
+            }
+            else {
                 this.log(JSON.stringify(output, null, 2));
+            }
         }
         catch (error) {
             if (error instanceof ApiError) {
@@ -994,6 +1013,34 @@ export default class Schedules extends Command {
             return `\$${op}`;
         return opRe.test(rest) ? `\$${op}:${this.parseFilterValue(rest)}` : `\$${op}:${rest}`;
     }
+    /** The page line under a table: which page, how many, and any sums the API returned. */
+    printPageSummary(envelope) {
+        const meta = envelope.meta;
+        if (meta && typeof meta.currentPage === 'number' && typeof meta.totalPages === 'number') {
+            const shown = Array.isArray(envelope.data) ? envelope.data.length : 0;
+            this.log(`
+Page ${meta.currentPage}/${meta.totalPages} — ${shown} of ${meta.totalItems ?? '?'} records`);
+        }
+        for (const total of envelope.totals ?? []) {
+            const { currency, ...sums } = total;
+            const parts = Object.entries(sums).map(([column, value]) => `${column} ${value}`).join(', ');
+            this.log(`Total ${currency ?? ''}: ${parts}`.trim());
+        }
+    }
+    /**
+     * The API caps how many records a page may hold. Asking for more and getting
+     * fewer looks like "that is everything" unless it is said out loud.
+     */
+    warnShortPage(envelope, requestedLimit) {
+        const asked = requestedLimit === undefined ? undefined : Number(requestedLimit);
+        const perPage = envelope.meta?.itemsPerPage;
+        if (asked === undefined || Number.isNaN(asked) || typeof perPage !== 'number' || perPage >= asked)
+            return;
+        const pages = envelope.meta?.totalPages;
+        const more = typeof pages === 'number' && pages > 1 ? ` Use --page, or the export action for every page.` : '';
+        process.stderr.write(`! Asked for ${asked} records per page; the API returned at most ${perPage}.${more}
+`);
+    }
     sanitizeOutput(data) {
         const auditFields = ['_type', 'tenantId', 'createdAt', 'updatedAt', 'createdBy', 'updatedBy'];
         const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;

package/dist/commands/support/end.d.ts

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

package/dist/commands/support/end.js

@@ -0,0 +1,29 @@
+import { Command, Flags } from '@oclif/core';
+import { endSupportSession } from '../../lib/auth/index.js';
+import { getCurrentContext } from '../../lib/config.js';
+export default class SupportEnd extends Command {
+    static description = 'Stop acting as Aderis Support and return to your own account';
+    static examples = ['<%= config.bin %> support end', '<%= config.bin %> support end --context prod'];
+    static flags = {
+        context: Flags.string({
+            aliases: ['config'],
+            char: 'c',
+            description: 'Context to use, overriding the current context (alias: --config)',
+            env: 'ADERIS_CONTEXT',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(SupportEnd);
+        const contextName = flags.context ?? getCurrentContext()?.name;
+        if (!contextName) {
+            this.error('No context configured. Run: aderis auth login --new');
+        }
+        const ended = await endSupportSession(contextName);
+        if (!ended) {
+            this.log(`Context ${contextName} was not acting as Aderis Support.`);
+            return;
+        }
+        this.log(`Stopped acting as Aderis Support in ${ended.tenant_name}.`);
+        this.log(`Context ${contextName} is your own account again; no new login was needed.`);
+    }
+}

package/dist/commands/support/start.d.ts

@@ -0,0 +1,14 @@
+import { Command } from '@oclif/core';
+export default class SupportStart extends Command {
+    static args: {
+        tenantId: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        context: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    /** Without a tenant id, offer the customers Keycloak says this operator may act for. */
+    private chooseTenant;
+}

package/dist/commands/support/start.js

@@ -0,0 +1,50 @@
+import { select } from '@inquirer/prompts';
+import { Args, Command, Flags } from '@oclif/core';
+import { listSupportTenants, startSupportSession, tenantLabel } from '../../lib/auth/index.js';
+import { getCurrentContext } from '../../lib/config.js';
+export default class SupportStart extends Command {
+    static args = {
+        tenantId: Args.string({ description: 'Customer to act for; prompted for if omitted', required: false }),
+    };
+    static description = 'Act as Aderis Support in a customer tenant';
+    static examples = [
+        '<%= config.bin %> support start',
+        '<%= config.bin %> support start 11839c8b-7ec3-4cc1-9dae-396ced09b928',
+        '<%= config.bin %> support start <tenant-id> --context prod',
+    ];
+    static flags = {
+        context: Flags.string({
+            aliases: ['config'],
+            char: 'c',
+            description: 'Context to use, overriding the current context (alias: --config)',
+            env: 'ADERIS_CONTEXT',
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(SupportStart);
+        const contextName = flags.context ?? getCurrentContext()?.name;
+        if (!contextName) {
+            this.error('No context configured. Run: aderis auth login --new');
+        }
+        const tenantId = args.tenantId ?? (await this.chooseTenant(contextName));
+        const support = await startSupportSession(contextName, tenantId);
+        this.log(`Acting as Aderis Support in ${support.tenant_name} (${support.tenant_id})`);
+        this.log(`Context: ${contextName}`);
+        this.warn('Every call from this context now goes out as Aderis Support, and every write is recorded against you. ' +
+            'End with: aderis support end');
+    }
+    /** Without a tenant id, offer the customers Keycloak says this operator may act for. */
+    async chooseTenant(contextName) {
+        const tenants = await listSupportTenants(contextName);
+        if (tenants.length === 0) {
+            this.error('There are no customers you may act for.');
+        }
+        if (!process.stdin.isTTY) {
+            this.error(`Name the customer to act for. List them with: aderis support tenants --context ${contextName}`);
+        }
+        return select({
+            choices: tenants.map((t) => ({ name: tenantLabel(t), value: t.tenantId })),
+            message: 'Act as Aderis Support in which customer?',
+        });
+    }
+}

package/dist/commands/support/status.d.ts

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

package/dist/commands/support/status.js

@@ -0,0 +1,45 @@
+import { Command, Flags } from '@oclif/core';
+import { getContext, getCurrentContext, getSupportSession } from '../../lib/config.js';
+export default class SupportStatus extends Command {
+    static description = 'Show whether this context is acting as Aderis Support';
+    static examples = ['<%= config.bin %> support status', '<%= config.bin %> support status --context prod'];
+    static flags = {
+        context: Flags.string({
+            aliases: ['config'],
+            char: 'c',
+            description: 'Context to check, overriding the current context (alias: --config)',
+            env: 'ADERIS_CONTEXT',
+        }),
+        json: Flags.boolean({ default: false, description: 'Output as JSON' }),
+    };
+    async run() {
+        const { flags } = await this.parse(SupportStatus);
+        const contextName = flags.context ?? getCurrentContext()?.name;
+        if (!contextName) {
+            this.error('No context configured. Run: aderis auth login --new');
+        }
+        const context = getContext(contextName);
+        if (!context) {
+            this.error(`Context "${contextName}" not found.`);
+        }
+        const support = getSupportSession(context);
+        if (flags.json) {
+            this.log(JSON.stringify({ context: contextName, supportSession: support ? supportJson(support) : null }, null, 2));
+            return;
+        }
+        if (!support) {
+            this.log(`Context ${contextName} is acting as yourself.`);
+            return;
+        }
+        this.log(`Acting as Aderis Support in ${support.tenant_name} (${support.tenant_id})`);
+        this.log(`Context: ${contextName}`);
+        if (support.tokens.expires_at) {
+            const expires = new Date(support.tokens.expires_at);
+            this.log(`Token expires: ${expires.toLocaleString()}${expires < new Date() ? ' (refreshes on next call)' : ''}`);
+        }
+        this.log('\nEverything you do is recorded against you. End with: aderis support end');
+    }
+}
+function supportJson(support) {
+    return { expiresAt: support.tokens.expires_at ?? null, tenantId: support.tenant_id, tenantName: support.tenant_name };
+}

package/dist/commands/support/tenants.d.ts

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

package/dist/commands/support/tenants.js

@@ -0,0 +1,39 @@
+import { Command, Flags } from '@oclif/core';
+import { listSupportTenants, tenantLabel } from '../../lib/auth/index.js';
+import { getCurrentContext } from '../../lib/config.js';
+export default class SupportTenants extends Command {
+    static description = 'List the customers you may act for as Aderis Support';
+    static examples = [
+        '<%= config.bin %> support tenants',
+        '<%= config.bin %> support tenants --context prod --json',
+    ];
+    static flags = {
+        context: Flags.string({
+            aliases: ['config'],
+            char: 'c',
+            description: 'Context to use, overriding the current context (alias: --config)',
+            env: 'ADERIS_CONTEXT',
+        }),
+        json: Flags.boolean({ default: false, description: 'Output as JSON' }),
+    };
+    async run() {
+        const { flags } = await this.parse(SupportTenants);
+        const contextName = flags.context ?? getCurrentContext()?.name;
+        if (!contextName) {
+            this.error('No context configured. Run: aderis auth login --new');
+        }
+        const tenants = await listSupportTenants(contextName);
+        if (flags.json) {
+            this.log(JSON.stringify(tenants, null, 2));
+            return;
+        }
+        if (tenants.length === 0) {
+            this.log('No customers available to act for.');
+            return;
+        }
+        this.log('Customers you may act for:\n');
+        for (const tenant of tenants)
+            this.log(`  ${tenantLabel(tenant)}`);
+        this.log(`\nStart with: aderis support start <tenant-id> --context ${contextName}`);
+    }
+}

package/dist/commands/tags.d.ts

@@ -23,6 +23,7 @@ export default class Tags extends Command {
         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>;
+        meta: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'show-http-request': import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
@@ -31,6 +32,13 @@ export default class Tags extends Command {
     private runCamt053Import;
     private runNestedImport;
     private parseFilterValue;
+    /** The page line under a table: which page, how many, and any sums the API returned. */
+    private printPageSummary;
+    /**
+     * The API caps how many records a page may hold. Asking for more and getting
+     * fewer looks like "that is everything" unless it is said out loud.
+     */
+    private warnShortPage;
     private sanitizeOutput;
     private getColumns;
     private getValue;