@qodalis/cli-server-plugin-aws 0.0.0-stage → 1.0.0-beta.14

package/dist/processors/sqs-processor.js

@@ -0,0 +1,191 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AwsSqsProcessor = void 0;
+const cli_server_abstractions_1 = require("@qodalis/cli-server-abstractions");
+const client_sqs_1 = require("@aws-sdk/client-sqs");
+const output_helpers_1 = require("../utils/output-helpers");
+/** Sub-processor that lists SQS queues. */
+class SqsListProcessor extends cli_server_abstractions_1.CliCommandProcessor {
+    credentialManager;
+    command = 'list';
+    description = 'List SQS queues';
+    parameters = [
+        new cli_server_abstractions_1.CliCommandParameterDescriptor('region', 'AWS region override', false, 'string', ['-r']),
+        new cli_server_abstractions_1.CliCommandParameterDescriptor('output', 'Output format (list|json|text)', false, 'string', ['-o'], 'list'),
+    ];
+    constructor(credentialManager) {
+        super();
+        this.credentialManager = credentialManager;
+    }
+    /** @inheritdoc */
+    async handleAsync() {
+        return '';
+    }
+    /** @inheritdoc */
+    async handleStructuredAsync(command) {
+        const client = this.credentialManager.getClient(client_sqs_1.SQSClient, {
+            region: command.args?.region ? String(command.args.region) : undefined,
+        });
+        try {
+            const response = await client.send(new client_sqs_1.ListQueuesCommand({}));
+            const queueUrls = response.QueueUrls ?? [];
+            if (queueUrls.length === 0) {
+                return (0, output_helpers_1.buildResponse)([{ type: 'text', value: 'No SQS queues found.', style: 'warning' }]);
+            }
+            const listOutput = (0, output_helpers_1.formatAsList)(queueUrls);
+            return (0, output_helpers_1.buildResponse)([(0, output_helpers_1.applyOutputFormat)(command, listOutput, queueUrls)]);
+        }
+        catch (err) {
+            return (0, output_helpers_1.buildErrorResponse)(`Failed to list SQS queues: ${err.message ?? err}`);
+        }
+    }
+}
+/** Sub-processor that sends a message to an SQS queue. */
+class SqsSendProcessor extends cli_server_abstractions_1.CliCommandProcessor {
+    credentialManager;
+    command = 'send';
+    description = 'Send a message to an SQS queue';
+    valueRequired = true;
+    parameters = [
+        new cli_server_abstractions_1.CliCommandParameterDescriptor('message', 'Message body to send', true, 'string', ['-m']),
+        new cli_server_abstractions_1.CliCommandParameterDescriptor('region', 'AWS region override', false, 'string', ['-r']),
+    ];
+    constructor(credentialManager) {
+        super();
+        this.credentialManager = credentialManager;
+    }
+    /** @inheritdoc */
+    async handleAsync() {
+        return '';
+    }
+    /** @inheritdoc */
+    async handleStructuredAsync(command) {
+        const queueUrl = (0, cli_server_abstractions_1.getPositionalText)(command);
+        if (!queueUrl) {
+            return (0, output_helpers_1.buildErrorResponse)('Queue URL is required. Usage: sqs send <queue-url> --message <body>');
+        }
+        const messageBody = command.args?.message;
+        if (!messageBody) {
+            return (0, output_helpers_1.buildErrorResponse)('--message is required. Usage: sqs send <queue-url> --message <body>');
+        }
+        const client = this.credentialManager.getClient(client_sqs_1.SQSClient, {
+            region: command.args?.region ? String(command.args.region) : undefined,
+        });
+        try {
+            const response = await client.send(new client_sqs_1.SendMessageCommand({
+                QueueUrl: queueUrl,
+                MessageBody: messageBody,
+            }));
+            return (0, output_helpers_1.buildSuccessResponse)(`Message sent successfully. MessageId: ${response.MessageId}`);
+        }
+        catch (err) {
+            return (0, output_helpers_1.buildErrorResponse)(`Failed to send message: ${err.message ?? err}`);
+        }
+    }
+}
+/** Sub-processor that receives messages from an SQS queue. */
+class SqsReceiveProcessor extends cli_server_abstractions_1.CliCommandProcessor {
+    credentialManager;
+    command = 'receive';
+    description = 'Receive messages from an SQS queue';
+    valueRequired = true;
+    parameters = [
+        new cli_server_abstractions_1.CliCommandParameterDescriptor('max', 'Maximum number of messages to receive (default: 1)', false, 'number', ['-n'], '1'),
+        new cli_server_abstractions_1.CliCommandParameterDescriptor('region', 'AWS region override', false, 'string', ['-r']),
+    ];
+    constructor(credentialManager) {
+        super();
+        this.credentialManager = credentialManager;
+    }
+    /** @inheritdoc */
+    async handleAsync() {
+        return '';
+    }
+    /** @inheritdoc */
+    async handleStructuredAsync(command) {
+        const queueUrl = (0, cli_server_abstractions_1.getPositionalText)(command);
+        if (!queueUrl) {
+            return (0, output_helpers_1.buildErrorResponse)('Queue URL is required. Usage: sqs receive <queue-url>');
+        }
+        const max = command.args?.max ? Number(command.args.max) : 1;
+        const client = this.credentialManager.getClient(client_sqs_1.SQSClient, {
+            region: command.args?.region ? String(command.args.region) : undefined,
+        });
+        try {
+            const response = await client.send(new client_sqs_1.ReceiveMessageCommand({
+                QueueUrl: queueUrl,
+                MaxNumberOfMessages: max,
+            }));
+            const messages = response.Messages ?? [];
+            if (messages.length === 0) {
+                return (0, output_helpers_1.buildResponse)([{ type: 'text', value: 'No messages available in the queue.', style: 'warning' }]);
+            }
+            return (0, output_helpers_1.buildResponse)([(0, output_helpers_1.formatAsJson)(messages)]);
+        }
+        catch (err) {
+            return (0, output_helpers_1.buildErrorResponse)(`Failed to receive messages: ${err.message ?? err}`);
+        }
+    }
+}
+/** Sub-processor that purges all messages from an SQS queue, with optional dry-run support. */
+class SqsPurgeProcessor extends cli_server_abstractions_1.CliCommandProcessor {
+    credentialManager;
+    command = 'purge';
+    description = 'Purge all messages from an SQS queue';
+    valueRequired = true;
+    parameters = [
+        new cli_server_abstractions_1.CliCommandParameterDescriptor('dry-run', 'Show what would be purged without actually purging', false, 'boolean', ['--dry-run']),
+        new cli_server_abstractions_1.CliCommandParameterDescriptor('region', 'AWS region override', false, 'string', ['-r']),
+    ];
+    constructor(credentialManager) {
+        super();
+        this.credentialManager = credentialManager;
+    }
+    /** @inheritdoc */
+    async handleAsync() {
+        return '';
+    }
+    /** @inheritdoc */
+    async handleStructuredAsync(command) {
+        const queueUrl = (0, cli_server_abstractions_1.getPositionalText)(command);
+        if (!queueUrl) {
+            return (0, output_helpers_1.buildErrorResponse)('Queue URL is required. Usage: sqs purge <queue-url>');
+        }
+        if ((0, output_helpers_1.isDryRun)(command)) {
+            return (0, output_helpers_1.buildResponse)([
+                { type: 'text', value: `[dry-run] Would purge all messages from queue: ${queueUrl}`, style: 'warning' },
+            ]);
+        }
+        const client = this.credentialManager.getClient(client_sqs_1.SQSClient, {
+            region: command.args?.region ? String(command.args.region) : undefined,
+        });
+        try {
+            await client.send(new client_sqs_1.PurgeQueueCommand({ QueueUrl: queueUrl }));
+            return (0, output_helpers_1.buildSuccessResponse)(`Queue purged successfully: ${queueUrl}`);
+        }
+        catch (err) {
+            return (0, output_helpers_1.buildErrorResponse)(`Failed to purge queue: ${err.message ?? err}`);
+        }
+    }
+}
+/** Parent processor for SQS sub-commands (list, send, receive, purge). */
+class AwsSqsProcessor extends cli_server_abstractions_1.CliCommandProcessor {
+    command = 'sqs';
+    description = 'AWS SQS operations — list, send, receive, purge';
+    processors;
+    constructor(credentialManager) {
+        super();
+        this.processors = [
+            new SqsListProcessor(credentialManager),
+            new SqsSendProcessor(credentialManager),
+            new SqsReceiveProcessor(credentialManager),
+            new SqsPurgeProcessor(credentialManager),
+        ];
+    }
+    /** @inheritdoc */
+    async handleAsync() {
+        return '';
+    }
+}
+exports.AwsSqsProcessor = AwsSqsProcessor;
+//# sourceMappingURL=sqs-processor.js.map

package/dist/processors/sqs-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqs-processor.js","sourceRoot":"","sources":["../../src/processors/sqs-processor.ts"],"names":[],"mappings":"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"}

package/dist/services/aws-config-service.d.ts

@@ -0,0 +1,50 @@
+/** Summary of the current AWS configuration with secrets masked. */
+export interface AwsConfigSummary {
+    accessKeyId?: string;
+    secretAccessKey?: string;
+    region?: string;
+    profile?: string;
+}
+/** Manages in-memory AWS configuration (credentials, region, profile). */
+export declare class AwsConfigService {
+    private _accessKeyId?;
+    private _secretAccessKey?;
+    private _region?;
+    private _profile?;
+    /** Returns the configured AWS access key ID, or undefined if not set. */
+    getAccessKeyId(): string | undefined;
+    /** Returns the configured AWS secret access key, or undefined if not set. */
+    getSecretAccessKey(): string | undefined;
+    /** Returns the configured AWS region, or undefined if not set. */
+    getRegion(): string | undefined;
+    /** Returns the configured AWS profile name, or undefined if not set. */
+    getProfile(): string | undefined;
+    /**
+     * Sets the AWS access key ID and secret access key.
+     * @param accessKeyId - The AWS access key ID.
+     * @param secretAccessKey - The AWS secret access key.
+     */
+    setCredentials(accessKeyId: string, secretAccessKey: string): void;
+    /**
+     * Sets the AWS region.
+     * @param region - The AWS region identifier (e.g., 'us-east-1').
+     */
+    setRegion(region: string): void;
+    /**
+     * Sets the AWS profile name.
+     * @param profile - The profile name from ~/.aws/credentials or ~/.aws/config.
+     */
+    setProfile(profile: string): void;
+    /**
+     * Returns a summary of the current configuration with secrets masked.
+     * @returns An {@link AwsConfigSummary} with the access key partially masked and the secret fully masked.
+     */
+    getConfigSummary(): AwsConfigSummary;
+    /**
+     * Masks a key string, showing only the first 4 and last 5 characters.
+     * @param key - The key string to mask.
+     * @returns The masked key string.
+     */
+    private maskKey;
+}
+//# sourceMappingURL=aws-config-service.d.ts.map

package/dist/services/aws-config-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aws-config-service.d.ts","sourceRoot":"","sources":["../../src/services/aws-config-service.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,MAAM,WAAW,gBAAgB;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,0EAA0E;AAC1E,qBAAa,gBAAgB;IACzB,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,gBAAgB,CAAC,CAAS;IAClC,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,CAAS;IAE1B,yEAAyE;IACzE,cAAc,IAAI,MAAM,GAAG,SAAS;IAEpC,6EAA6E;IAC7E,kBAAkB,IAAI,MAAM,GAAG,SAAS;IAExC,kEAAkE;IAClE,SAAS,IAAI,MAAM,GAAG,SAAS;IAE/B,wEAAwE;IACxE,UAAU,IAAI,MAAM,GAAG,SAAS;IAEhC;;;;OAIG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI;IAKlE;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAE/B;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAEjC;;;OAGG;IACH,gBAAgB,IAAI,gBAAgB;IASpC;;;;OAIG;IACH,OAAO,CAAC,OAAO;CAIlB"}

package/dist/services/aws-config-service.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AwsConfigService = void 0;
+/** Manages in-memory AWS configuration (credentials, region, profile). */
+class AwsConfigService {
+    _accessKeyId;
+    _secretAccessKey;
+    _region;
+    _profile;
+    /** Returns the configured AWS access key ID, or undefined if not set. */
+    getAccessKeyId() { return this._accessKeyId; }
+    /** Returns the configured AWS secret access key, or undefined if not set. */
+    getSecretAccessKey() { return this._secretAccessKey; }
+    /** Returns the configured AWS region, or undefined if not set. */
+    getRegion() { return this._region; }
+    /** Returns the configured AWS profile name, or undefined if not set. */
+    getProfile() { return this._profile; }
+    /**
+     * Sets the AWS access key ID and secret access key.
+     * @param accessKeyId - The AWS access key ID.
+     * @param secretAccessKey - The AWS secret access key.
+     */
+    setCredentials(accessKeyId, secretAccessKey) {
+        this._accessKeyId = accessKeyId;
+        this._secretAccessKey = secretAccessKey;
+    }
+    /**
+     * Sets the AWS region.
+     * @param region - The AWS region identifier (e.g., 'us-east-1').
+     */
+    setRegion(region) { this._region = region; }
+    /**
+     * Sets the AWS profile name.
+     * @param profile - The profile name from ~/.aws/credentials or ~/.aws/config.
+     */
+    setProfile(profile) { this._profile = profile; }
+    /**
+     * Returns a summary of the current configuration with secrets masked.
+     * @returns An {@link AwsConfigSummary} with the access key partially masked and the secret fully masked.
+     */
+    getConfigSummary() {
+        return {
+            accessKeyId: this._accessKeyId ? this.maskKey(this._accessKeyId) : undefined,
+            secretAccessKey: this._secretAccessKey ? '****' : undefined,
+            region: this._region,
+            profile: this._profile,
+        };
+    }
+    /**
+     * Masks a key string, showing only the first 4 and last 5 characters.
+     * @param key - The key string to mask.
+     * @returns The masked key string.
+     */
+    maskKey(key) {
+        if (key.length <= 8)
+            return '****';
+        return key.slice(0, 4) + '***' + key.slice(-5);
+    }
+}
+exports.AwsConfigService = AwsConfigService;
+//# sourceMappingURL=aws-config-service.js.map

package/dist/services/aws-config-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aws-config-service.js","sourceRoot":"","sources":["../../src/services/aws-config-service.ts"],"names":[],"mappings":";;;AAQA,0EAA0E;AAC1E,MAAa,gBAAgB;IACjB,YAAY,CAAU;IACtB,gBAAgB,CAAU;IAC1B,OAAO,CAAU;IACjB,QAAQ,CAAU;IAE1B,yEAAyE;IACzE,cAAc,KAAyB,OAAO,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;IAElE,6EAA6E;IAC7E,kBAAkB,KAAyB,OAAO,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAE1E,kEAAkE;IAClE,SAAS,KAAyB,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAExD,wEAAwE;IACxE,UAAU,KAAyB,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE1D;;;;OAIG;IACH,cAAc,CAAC,WAAmB,EAAE,eAAuB;QACvD,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAChC,IAAI,CAAC,gBAAgB,GAAG,eAAe,CAAC;IAC5C,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,MAAc,IAAU,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC;IAE1D;;;OAGG;IACH,UAAU,CAAC,OAAe,IAAU,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC;IAE9D;;;OAGG;IACH,gBAAgB;QACZ,OAAO;YACH,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS;YAC5E,eAAe,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;YAC3D,MAAM,EAAE,IAAI,CAAC,OAAO;YACpB,OAAO,EAAE,IAAI,CAAC,QAAQ;SACzB,CAAC;IACN,CAAC;IAED;;;;OAIG;IACK,OAAO,CAAC,GAAW;QACvB,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC;YAAE,OAAO,MAAM,CAAC;QACnC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACnD,CAAC;CACJ;AA9DD,4CA8DC"}

package/dist/services/aws-credential-manager.d.ts

@@ -0,0 +1,29 @@
+import { AwsConfigService } from './aws-config-service';
+/** Options for overriding region or profile when creating AWS SDK clients. */
+export interface AwsClientOptions {
+    region?: string;
+    profile?: string;
+}
+/** Manages AWS SDK client instantiation and caching based on the current configuration. */
+export declare class AwsCredentialManager {
+    private readonly config;
+    private readonly _clientCache;
+    /** @param config - The AWS configuration service providing credentials and region. */
+    constructor(config: AwsConfigService);
+    /**
+     * Builds an AWS SDK client configuration object from the current settings and overrides.
+     * @param overrides - Optional region/profile overrides.
+     * @returns A configuration record suitable for passing to an AWS SDK client constructor.
+     */
+    getClientConfig(overrides?: AwsClientOptions): Record<string, any>;
+    /**
+     * Returns a cached AWS SDK client instance, creating one if necessary.
+     * @param ClientClass - The AWS SDK client class to instantiate.
+     * @param overrides - Optional region/profile overrides for client configuration.
+     * @returns A cached instance of the requested client class.
+     */
+    getClient<T>(ClientClass: new (config: Record<string, any>) => T, overrides?: AwsClientOptions): T;
+    /** Clears the cached AWS SDK client instances, forcing re-creation on next access. */
+    clearCache(): void;
+}
+//# sourceMappingURL=aws-credential-manager.d.ts.map

package/dist/services/aws-credential-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aws-credential-manager.d.ts","sourceRoot":"","sources":["../../src/services/aws-credential-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,8EAA8E;AAC9E,MAAM,WAAW,gBAAgB;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,2FAA2F;AAC3F,qBAAa,oBAAoB;IAIjB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA0B;IAEvD,sFAAsF;gBACzD,MAAM,EAAE,gBAAgB;IAErD;;;;OAIG;IACH,eAAe,CAAC,SAAS,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAYlE;;;;;OAKG;IACH,SAAS,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,EAAE,gBAAgB,GAAG,CAAC;IAUlG,sFAAsF;IACtF,UAAU,IAAI,IAAI;CAGrB"}

package/dist/services/aws-credential-manager.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AwsCredentialManager = void 0;
+/** Manages AWS SDK client instantiation and caching based on the current configuration. */
+class AwsCredentialManager {
+    config;
+    _clientCache = new Map();
+    /** @param config - The AWS configuration service providing credentials and region. */
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Builds an AWS SDK client configuration object from the current settings and overrides.
+     * @param overrides - Optional region/profile overrides.
+     * @returns A configuration record suitable for passing to an AWS SDK client constructor.
+     */
+    getClientConfig(overrides) {
+        const config = {};
+        const region = overrides?.region ?? this.config.getRegion() ?? process.env.AWS_REGION ?? process.env.AWS_DEFAULT_REGION;
+        if (region)
+            config.region = region;
+        const accessKeyId = this.config.getAccessKeyId() ?? process.env.AWS_ACCESS_KEY_ID;
+        const secretAccessKey = this.config.getSecretAccessKey() ?? process.env.AWS_SECRET_ACCESS_KEY;
+        if (accessKeyId && secretAccessKey) {
+            config.credentials = { accessKeyId, secretAccessKey };
+        }
+        return config;
+    }
+    /**
+     * Returns a cached AWS SDK client instance, creating one if necessary.
+     * @param ClientClass - The AWS SDK client class to instantiate.
+     * @param overrides - Optional region/profile overrides for client configuration.
+     * @returns A cached instance of the requested client class.
+     */
+    getClient(ClientClass, overrides) {
+        const region = overrides?.region ?? this.config.getRegion() ?? 'default';
+        const profile = overrides?.profile ?? this.config.getProfile() ?? 'default';
+        const key = `${ClientClass.name}:${region}:${profile}`;
+        if (!this._clientCache.has(key)) {
+            this._clientCache.set(key, new ClientClass(this.getClientConfig(overrides)));
+        }
+        return this._clientCache.get(key);
+    }
+    /** Clears the cached AWS SDK client instances, forcing re-creation on next access. */
+    clearCache() {
+        this._clientCache.clear();
+    }
+}
+exports.AwsCredentialManager = AwsCredentialManager;
+//# sourceMappingURL=aws-credential-manager.js.map

package/dist/services/aws-credential-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aws-credential-manager.js","sourceRoot":"","sources":["../../src/services/aws-credential-manager.ts"],"names":[],"mappings":";;;AAQA,2FAA2F;AAC3F,MAAa,oBAAoB;IAIA;IAHZ,YAAY,GAAG,IAAI,GAAG,EAAe,CAAC;IAEvD,sFAAsF;IACtF,YAA6B,MAAwB;QAAxB,WAAM,GAAN,MAAM,CAAkB;IAAG,CAAC;IAEzD;;;;OAIG;IACH,eAAe,CAAC,SAA4B;QACxC,MAAM,MAAM,GAAwB,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,SAAS,EAAE,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;QACxH,IAAI,MAAM;YAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;QACnC,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;QAClF,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;QAC9F,IAAI,WAAW,IAAI,eAAe,EAAE,CAAC;YACjC,MAAM,CAAC,WAAW,GAAG,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC;QAC1D,CAAC;QACD,OAAO,MAAM,CAAC;IAClB,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAI,WAAmD,EAAE,SAA4B;QAC1F,MAAM,MAAM,GAAG,SAAS,EAAE,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,SAAS,CAAC;QACzE,MAAM,OAAO,GAAG,SAAS,EAAE,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,SAAS,CAAC;QAC5E,MAAM,GAAG,GAAG,GAAG,WAAW,CAAC,IAAI,IAAI,MAAM,IAAI,OAAO,EAAE,CAAC;QACvD,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,WAAW,CAAC,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QACjF,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAM,CAAC;IAC3C,CAAC;IAED,sFAAsF;IACtF,UAAU;QACN,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;CACJ;AA3CD,oDA2CC"}

package/dist/utils/output-helpers.d.ts

@@ -0,0 +1,68 @@
+import { CliProcessCommand, CliStructuredResponse, CliStructuredOutput } from '@qodalis/cli-server-abstractions';
+/** Supported output format identifiers. */
+export type OutputFormat = 'table' | 'json' | 'text';
+/**
+ * Extracts the output format from a command's `--output` argument.
+ * @param command - The parsed CLI command.
+ * @returns The requested output format, defaulting to `'table'`.
+ */
+export declare function getOutputFormat(command: CliProcessCommand): OutputFormat;
+/**
+ * Checks whether the `--dry-run` flag is set on a command.
+ * @param command - The parsed CLI command.
+ * @returns `true` if dry-run mode is enabled.
+ */
+export declare function isDryRun(command: CliProcessCommand): boolean;
+/**
+ * Builds a structured response with the given outputs and exit code.
+ * @param outputs - The structured output items to include.
+ * @param exitCode - Process exit code, defaults to 0.
+ * @returns A CLI structured response.
+ */
+export declare function buildResponse(outputs: CliStructuredOutput[], exitCode?: number): CliStructuredResponse;
+/**
+ * Builds an error response with exit code 1 and the given message.
+ * @param message - The error message to display.
+ * @returns A CLI structured response styled as an error.
+ */
+export declare function buildErrorResponse(message: string): CliStructuredResponse;
+/**
+ * Builds a success response with exit code 0 and the given message.
+ * @param message - The success message to display.
+ * @returns A CLI structured response styled as a success.
+ */
+export declare function buildSuccessResponse(message: string): CliStructuredResponse;
+/**
+ * Wraps arbitrary data as a JSON structured output.
+ * @param data - The data to serialize as JSON.
+ * @returns A CLI structured output of type `'json'`.
+ */
+export declare function formatAsJson(data: any): CliStructuredOutput;
+/**
+ * Formats tabular data with headers and rows.
+ * @param headers - Column header labels.
+ * @param rows - Two-dimensional array of cell values.
+ * @returns A CLI structured output of type `'table'`.
+ */
+export declare function formatAsTable(headers: string[], rows: string[][]): CliStructuredOutput;
+/**
+ * Formats a record of key-value pairs for display.
+ * @param entries - An object whose keys and values will be displayed.
+ * @returns A CLI structured output of type `'key-value'`.
+ */
+export declare function formatAsKeyValue(entries: Record<string, string>): CliStructuredOutput;
+/**
+ * Formats an array of strings as a list output.
+ * @param items - The list items to display.
+ * @returns A CLI structured output of type `'list'`.
+ */
+export declare function formatAsList(items: string[]): CliStructuredOutput;
+/**
+ * Converts the default output to the format requested by the command's `--output` argument.
+ * @param command - The parsed CLI command containing format preferences.
+ * @param defaultOutput - The default structured output (typically a table or list).
+ * @param rawData - The raw data to use when JSON format is requested.
+ * @returns The structured output in the requested format.
+ */
+export declare function applyOutputFormat(command: CliProcessCommand, defaultOutput: CliStructuredOutput, rawData: any): CliStructuredOutput;
+//# sourceMappingURL=output-helpers.d.ts.map

package/dist/utils/output-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/output-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAEjH,2CAA2C;AAC3C,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAErD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,YAAY,CAIxE;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAE5D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,mBAAmB,EAAE,EAAE,QAAQ,SAAI,GAAG,qBAAqB,CAEjG;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,CAEzE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,CAE3E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,GAAG,GAAG,mBAAmB,CAE3D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,mBAAmB,CAEtF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,mBAAmB,CAErF;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,mBAAmB,CAEjE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,mBAAmB,EAAE,OAAO,EAAE,GAAG,GAAG,mBAAmB,CAQnI"}

package/dist/utils/output-helpers.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getOutputFormat = getOutputFormat;
+exports.isDryRun = isDryRun;
+exports.buildResponse = buildResponse;
+exports.buildErrorResponse = buildErrorResponse;
+exports.buildSuccessResponse = buildSuccessResponse;
+exports.formatAsJson = formatAsJson;
+exports.formatAsTable = formatAsTable;
+exports.formatAsKeyValue = formatAsKeyValue;
+exports.formatAsList = formatAsList;
+exports.applyOutputFormat = applyOutputFormat;
+/**
+ * Extracts the output format from a command's `--output` argument.
+ * @param command - The parsed CLI command.
+ * @returns The requested output format, defaulting to `'table'`.
+ */
+function getOutputFormat(command) {
+    const format = command.args?.output;
+    if (format === 'json' || format === 'table' || format === 'text')
+        return format;
+    return 'table';
+}
+/**
+ * Checks whether the `--dry-run` flag is set on a command.
+ * @param command - The parsed CLI command.
+ * @returns `true` if dry-run mode is enabled.
+ */
+function isDryRun(command) {
+    return command.args?.['dry-run'] === true || command.args?.dryRun === true;
+}
+/**
+ * Builds a structured response with the given outputs and exit code.
+ * @param outputs - The structured output items to include.
+ * @param exitCode - Process exit code, defaults to 0.
+ * @returns A CLI structured response.
+ */
+function buildResponse(outputs, exitCode = 0) {
+    return { exitCode, outputs };
+}
+/**
+ * Builds an error response with exit code 1 and the given message.
+ * @param message - The error message to display.
+ * @returns A CLI structured response styled as an error.
+ */
+function buildErrorResponse(message) {
+    return { exitCode: 1, outputs: [{ type: 'text', value: message, style: 'error' }] };
+}
+/**
+ * Builds a success response with exit code 0 and the given message.
+ * @param message - The success message to display.
+ * @returns A CLI structured response styled as a success.
+ */
+function buildSuccessResponse(message) {
+    return { exitCode: 0, outputs: [{ type: 'text', value: message, style: 'success' }] };
+}
+/**
+ * Wraps arbitrary data as a JSON structured output.
+ * @param data - The data to serialize as JSON.
+ * @returns A CLI structured output of type `'json'`.
+ */
+function formatAsJson(data) {
+    return { type: 'json', value: data };
+}
+/**
+ * Formats tabular data with headers and rows.
+ * @param headers - Column header labels.
+ * @param rows - Two-dimensional array of cell values.
+ * @returns A CLI structured output of type `'table'`.
+ */
+function formatAsTable(headers, rows) {
+    return { type: 'table', headers, rows };
+}
+/**
+ * Formats a record of key-value pairs for display.
+ * @param entries - An object whose keys and values will be displayed.
+ * @returns A CLI structured output of type `'key-value'`.
+ */
+function formatAsKeyValue(entries) {
+    return { type: 'key-value', entries: Object.entries(entries).map(([key, value]) => ({ key, value })) };
+}
+/**
+ * Formats an array of strings as a list output.
+ * @param items - The list items to display.
+ * @returns A CLI structured output of type `'list'`.
+ */
+function formatAsList(items) {
+    return { type: 'list', items };
+}
+/**
+ * Converts the default output to the format requested by the command's `--output` argument.
+ * @param command - The parsed CLI command containing format preferences.
+ * @param defaultOutput - The default structured output (typically a table or list).
+ * @param rawData - The raw data to use when JSON format is requested.
+ * @returns The structured output in the requested format.
+ */
+function applyOutputFormat(command, defaultOutput, rawData) {
+    const format = getOutputFormat(command);
+    if (format === 'json')
+        return formatAsJson(rawData);
+    if (format === 'text' && defaultOutput.type === 'table') {
+        const table = defaultOutput;
+        return { type: 'text', value: table.rows.map((row) => row.join('\t')).join('\n') };
+    }
+    return defaultOutput;
+}
+//# sourceMappingURL=output-helpers.js.map

package/dist/utils/output-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-helpers.js","sourceRoot":"","sources":["../../src/utils/output-helpers.ts"],"names":[],"mappings":"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"}

package/dist/utils/pagination.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Collects items from an async paginator into a single array.
+ * @param paginator - The async iterable paginator returned by an AWS SDK paginate function.
+ * @param extract - A function that extracts the relevant items array from each page.
+ * @param maxResults - Optional cap on the total number of items to return.
+ * @returns A flat array of all extracted items, truncated to maxResults if specified.
+ */
+export declare function paginateAll<T>(paginator: AsyncIterable<T>, extract: (page: T) => any[], maxResults?: number): Promise<any[]>;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/utils/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/utils/pagination.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAC/B,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,EAC3B,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,GAAG,EAAE,EAC3B,UAAU,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,GAAG,EAAE,CAAC,CAShB"}

package/dist/utils/pagination.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.paginateAll = paginateAll;
+/**
+ * Collects items from an async paginator into a single array.
+ * @param paginator - The async iterable paginator returned by an AWS SDK paginate function.
+ * @param extract - A function that extracts the relevant items array from each page.
+ * @param maxResults - Optional cap on the total number of items to return.
+ * @returns A flat array of all extracted items, truncated to maxResults if specified.
+ */
+async function paginateAll(paginator, extract, maxResults) {
+    const results = [];
+    for await (const page of paginator) {
+        results.push(...extract(page));
+        if (maxResults && results.length >= maxResults) {
+            return results.slice(0, maxResults);
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=pagination.js.map

package/dist/utils/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../src/utils/pagination.ts"],"names":[],"mappings":";;AAOA,kCAaC;AApBD;;;;;;GAMG;AACI,KAAK,UAAU,WAAW,CAC7B,SAA2B,EAC3B,OAA2B,EAC3B,UAAmB;IAEnB,MAAM,OAAO,GAAU,EAAE,CAAC;IAC1B,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QACjC,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/B,IAAI,UAAU,IAAI,OAAO,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC;YAC7C,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QACxC,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC;AACnB,CAAC"}