@aws-cdk/aws-elasticache-alpha 2.218.0-alpha.0

package/lib/user-base.d.ts

@@ -0,0 +1,148 @@
+import { Construct } from 'constructs';
+import { UserEngine } from './common';
+import { IResource, Resource } from 'aws-cdk-lib/core';
+/**
+ * Access control configuration for ElastiCache users.
+ */
+export declare abstract class AccessControl {
+    /**
+     * Create access control from an access string.
+     *
+     * @param accessString The access string defining user permissions.
+     */
+    static fromAccessString(accessString: string): AccessControl;
+    /**
+     * The access string that defines user's permissions.
+     */
+    abstract readonly accessString: string;
+}
+/**
+ * Properties for defining an ElastiCache base user.
+ */
+export interface UserBaseProps {
+    /**
+     * The engine type for the user.
+     * Enum options: UserEngine.VALKEY, UserEngine.REDIS.
+     *
+     * @default UserEngine.VALKEY.
+     */
+    readonly engine?: UserEngine;
+    /**
+     * The ID of the user.
+     */
+    readonly userId: string;
+    /**
+     * Access control configuration for the user.
+     */
+    readonly accessControl: AccessControl;
+}
+/**
+ * Represents an ElastiCache base user.
+ */
+export interface IUser extends IResource {
+    /**
+     * The user's ID.
+     *
+     * @attribute
+     */
+    readonly userId: string;
+    /**
+     * The engine for the user.
+     */
+    readonly engine?: UserEngine;
+    /**
+     * The user's name.
+     *
+     * @attribute
+     */
+    readonly userName?: string;
+    /**
+     * The user's ARN.
+     *
+     * @attribute
+     */
+    readonly userArn: string;
+}
+/**
+ * Attributes for importing an existing ElastiCache user.
+ */
+export interface UserBaseAttributes {
+    /**
+     * The ID of the user.
+     * One of `userId` or `userArn` is required.
+     *
+     * @default - derived from userArn.
+     */
+    readonly userId?: string;
+    /**
+     * The engine type for the user.
+     *
+     * @default - engine type is unknown.
+     */
+    readonly engine?: UserEngine;
+    /**
+     * The user's name.
+     *
+     * @default - name is unknown.
+     */
+    readonly userName?: string;
+    /**
+     * The ARN of the user.
+     *
+     * One of `userId` or `userArn` is required.
+     *
+     * @default - derived from userId.
+     */
+    readonly userArn?: string;
+}
+/**
+ * Base class for ElastiCache users.
+ */
+export declare abstract class UserBase extends Resource implements IUser {
+    /**
+     * Import an existing user by ID.
+     *
+     * @param scope The parent creating construct (usually `this`).
+     * @param id The construct's name.
+     * @param userId The ID of the existing user.
+     */
+    static fromUserId(scope: Construct, id: string, userId: string): IUser;
+    /**
+     * Import an existing user by ARN.
+     *
+     * @param scope The parent creating construct (usually `this`).
+     * @param id The construct's name.
+     * @param userArn The ARN of the existing user.
+     */
+    static fromUserArn(scope: Construct, id: string, userArn: string): IUser;
+    /**
+     * Import an existing user using attributes.
+     *
+     * @param scope The parent creating construct (usually `this`).
+     * @param id The construct's name.
+     * @param attrs A `UserBaseAttributes` object.
+     */
+    static fromUserAttributes(scope: Construct, id: string, attrs: UserBaseAttributes): IUser;
+    /**
+     * The user's ID.
+     *
+     * @attribute
+     */
+    abstract readonly userId: string;
+    /**
+     * The engine for the user.
+     */
+    abstract readonly engine?: UserEngine;
+    /**
+     * The user's name.
+     *
+     * @attribute
+     */
+    abstract readonly userName?: string;
+    /**
+     * The user's ARN.
+     *
+     * @attribute
+     */
+    abstract readonly userArn: string;
+}

package/lib/user-base.js

@@ -0,0 +1,114 @@
+"use strict";
+var _a, _b;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserBase = exports.AccessControl = void 0;
+const jsiiDeprecationWarnings = require("../.warnings.jsii.js");
+const JSII_RTTI_SYMBOL_1 = Symbol.for("jsii.rtti");
+const core_1 = require("aws-cdk-lib/core");
+/**
+ * Access control configuration for ElastiCache users.
+ */
+class AccessControl {
+    /**
+     * Create access control from an access string.
+     *
+     * @param accessString The access string defining user permissions.
+     */
+    static fromAccessString(accessString) {
+        return new AccessControlString(accessString);
+    }
+}
+exports.AccessControl = AccessControl;
+_a = JSII_RTTI_SYMBOL_1;
+AccessControl[_a] = { fqn: "@aws-cdk/aws-elasticache-alpha.AccessControl", version: "2.218.0-alpha.0" };
+/**
+ * Access control implementation using a raw access string.
+ */
+class AccessControlString extends AccessControl {
+    constructor(accessString) {
+        super();
+        this.accessString = accessString;
+    }
+}
+/**
+ * Base class for ElastiCache users.
+ */
+class UserBase extends core_1.Resource {
+    /**
+     * Import an existing user by ID.
+     *
+     * @param scope The parent creating construct (usually `this`).
+     * @param id The construct's name.
+     * @param userId The ID of the existing user.
+     */
+    static fromUserId(scope, id, userId) {
+        return UserBase.fromUserAttributes(scope, id, { userId });
+    }
+    /**
+     * Import an existing user by ARN.
+     *
+     * @param scope The parent creating construct (usually `this`).
+     * @param id The construct's name.
+     * @param userArn The ARN of the existing user.
+     */
+    static fromUserArn(scope, id, userArn) {
+        return UserBase.fromUserAttributes(scope, id, { userArn });
+    }
+    /**
+     * Import an existing user using attributes.
+     *
+     * @param scope The parent creating construct (usually `this`).
+     * @param id The construct's name.
+     * @param attrs A `UserBaseAttributes` object.
+     */
+    static fromUserAttributes(scope, id, attrs) {
+        try {
+            jsiiDeprecationWarnings._aws_cdk_aws_elasticache_alpha_UserBaseAttributes(attrs);
+        }
+        catch (error) {
+            if (process.env.JSII_DEBUG !== "1" && error.name === "DeprecationError") {
+                Error.captureStackTrace(error, this.fromUserAttributes);
+            }
+            throw error;
+        }
+        let userId;
+        let userArn;
+        const stack = core_1.Stack.of(scope);
+        if (attrs.userArn && attrs.userId) {
+            throw new core_1.ValidationError('Only one of userArn or userId can be provided.', scope);
+        }
+        if (attrs.userArn) {
+            userArn = attrs.userArn;
+            const extractedUserId = stack.splitArn(attrs.userArn, core_1.ArnFormat.SLASH_RESOURCE_NAME).resourceName;
+            if (!extractedUserId) {
+                throw new core_1.ValidationError('Unable to extract user id from ARN.', scope);
+            }
+            userId = extractedUserId;
+        }
+        else if (attrs.userId) {
+            userId = attrs.userId;
+            userArn = stack.formatArn({
+                service: 'elasticache',
+                resource: 'user',
+                resourceName: attrs.userId,
+            });
+        }
+        else {
+            throw new core_1.ValidationError('One of userId or userArn is required.', scope);
+        }
+        class Import extends core_1.Resource {
+            constructor(_userArn, _userId) {
+                super(scope, id);
+                this.userArn = _userArn;
+                this.userId = _userId;
+                this.engine = attrs.engine;
+                this.userName = attrs.userName;
+            }
+        }
+        return new Import(userArn, userId);
+    }
+}
+exports.UserBase = UserBase;
+_b = JSII_RTTI_SYMBOL_1;
+UserBase[_b] = { fqn: "@aws-cdk/aws-elasticache-alpha.UserBase", version: "2.218.0-alpha.0" };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXNlci1iYXNlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsidXNlci1iYXNlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7OztBQUVBLDJDQUEwRjtBQUUxRjs7R0FFRztBQUNILE1BQXNCLGFBQWE7SUFDakM7Ozs7T0FJRztJQUNJLE1BQU0sQ0FBQyxnQkFBZ0IsQ0FBQyxZQUFvQjtRQUNqRCxPQUFPLElBQUksbUJBQW1CLENBQUMsWUFBWSxDQUFDLENBQUM7S0FDOUM7O0FBUkgsc0NBY0M7OztBQUVEOztHQUVHO0FBQ0gsTUFBTSxtQkFBb0IsU0FBUSxhQUFhO0lBTTdDLFlBQVksWUFBb0I7UUFDOUIsS0FBSyxFQUFFLENBQUM7UUFDUixJQUFJLENBQUMsWUFBWSxHQUFHLFlBQVksQ0FBQztLQUNsQztDQUNGO0FBb0ZEOztHQUVHO0FBQ0gsTUFBc0IsUUFBUyxTQUFRLGVBQVE7SUFDN0M7Ozs7OztPQU1HO0lBQ0ksTUFBTSxDQUFDLFVBQVUsQ0FBQyxLQUFnQixFQUFFLEVBQVUsRUFBRSxNQUFjO1FBQ25FLE9BQU8sUUFBUSxDQUFDLGtCQUFrQixDQUFDLEtBQUssRUFBRSxFQUFFLEVBQUUsRUFBRSxNQUFNLEVBQUUsQ0FBQyxDQUFDO0tBQzNEO0lBRUQ7Ozs7OztPQU1HO0lBQ0ksTUFBTSxDQUFDLFdBQVcsQ0FBQyxLQUFnQixFQUFFLEVBQVUsRUFBRSxPQUFlO1FBQ3JFLE9BQU8sUUFBUSxDQUFDLGtCQUFrQixDQUFDLEtBQUssRUFBRSxFQUFFLEVBQUUsRUFBRSxPQUFPLEVBQUUsQ0FBQyxDQUFDO0tBQzVEO0lBRUQ7Ozs7OztPQU1HO0lBQ0ksTUFBTSxDQUFDLGtCQUFrQixDQUFDLEtBQWdCLEVBQUUsRUFBVSxFQUFFLEtBQXlCOzs7Ozs7Ozs7O1FBQ3RGLElBQUksTUFBYyxDQUFDO1FBQ25CLElBQUksT0FBZSxDQUFDO1FBQ3BCLE1BQU0sS0FBSyxHQUFHLFlBQUssQ0FBQyxFQUFFLENBQUMsS0FBSyxDQUFDLENBQUM7UUFFOUIsSUFBSSxLQUFLLENBQUMsT0FBTyxJQUFJLEtBQUssQ0FBQyxNQUFNLEVBQUUsQ0FBQztZQUNsQyxNQUFNLElBQUksc0JBQWUsQ0FBQyxnREFBZ0QsRUFBRSxLQUFLLENBQUMsQ0FBQztRQUNyRixDQUFDO1FBRUQsSUFBSSxLQUFLLENBQUMsT0FBTyxFQUFFLENBQUM7WUFDbEIsT0FBTyxHQUFHLEtBQUssQ0FBQyxPQUFPLENBQUM7WUFDeEIsTUFBTSxlQUFlLEdBQUcsS0FBSyxDQUFDLFFBQVEsQ0FBQyxLQUFLLENBQUMsT0FBTyxFQUFFLGdCQUFTLENBQUMsbUJBQW1CLENBQUMsQ0FBQyxZQUFZLENBQUM7WUFDbEcsSUFBSSxDQUFDLGVBQWUsRUFBRSxDQUFDO2dCQUNyQixNQUFNLElBQUksc0JBQWUsQ0FBQyxxQ0FBcUMsRUFBRSxLQUFLLENBQUMsQ0FBQztZQUMxRSxDQUFDO1lBQ0QsTUFBTSxHQUFHLGVBQWUsQ0FBQztRQUMzQixDQUFDO2FBQU0sSUFBSSxLQUFLLENBQUMsTUFBTSxFQUFFLENBQUM7WUFDeEIsTUFBTSxHQUFHLEtBQUssQ0FBQyxNQUFNLENBQUM7WUFDdEIsT0FBTyxHQUFHLEtBQUssQ0FBQyxTQUFTLENBQUM7Z0JBQ3hCLE9BQU8sRUFBRSxhQUFhO2dCQUN0QixRQUFRLEVBQUUsTUFBTTtnQkFDaEIsWUFBWSxFQUFFLEtBQUssQ0FBQyxNQUFNO2FBQzNCLENBQUMsQ0FBQztRQUNMLENBQUM7YUFBTSxDQUFDO1lBQ04sTUFBTSxJQUFJLHNCQUFlLENBQUMsdUNBQXVDLEVBQUUsS0FBSyxDQUFDLENBQUM7UUFDNUUsQ0FBQztRQUVELE1BQU0sTUFBTyxTQUFRLGVBQVE7WUFNM0IsWUFBWSxRQUFnQixFQUFFLE9BQWU7Z0JBQzNDLEtBQUssQ0FBQyxLQUFLLEVBQUUsRUFBRSxDQUFDLENBQUM7Z0JBQ2pCLElBQUksQ0FBQyxPQUFPLEdBQUcsUUFBUSxDQUFDO2dCQUN4QixJQUFJLENBQUMsTUFBTSxHQUFHLE9BQU8sQ0FBQztnQkFDdEIsSUFBSSxDQUFDLE1BQU0sR0FBRyxLQUFLLENBQUMsTUFBTSxDQUFDO2dCQUMzQixJQUFJLENBQUMsUUFBUSxHQUFHLEtBQUssQ0FBQyxRQUFRLENBQUM7WUFDakMsQ0FBQztTQUNGO1FBRUQsT0FBTyxJQUFJLE1BQU0sQ0FBQyxPQUFPLEVBQUUsTUFBTSxDQUFDLENBQUM7S0FDcEM7O0FBekVILDRCQWlHQyIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IENvbnN0cnVjdCB9IGZyb20gJ2NvbnN0cnVjdHMnO1xuaW1wb3J0IHsgVXNlckVuZ2luZSB9IGZyb20gJy4vY29tbW9uJztcbmltcG9ydCB7IElSZXNvdXJjZSwgUmVzb3VyY2UsIEFybkZvcm1hdCwgU3RhY2ssIFZhbGlkYXRpb25FcnJvciB9IGZyb20gJ2F3cy1jZGstbGliL2NvcmUnO1xuXG4vKipcbiAqIEFjY2VzcyBjb250cm9sIGNvbmZpZ3VyYXRpb24gZm9yIEVsYXN0aUNhY2hlIHVzZXJzLlxuICovXG5leHBvcnQgYWJzdHJhY3QgY2xhc3MgQWNjZXNzQ29udHJvbCB7XG4gIC8qKlxuICAgKiBDcmVhdGUgYWNjZXNzIGNvbnRyb2wgZnJvbSBhbiBhY2Nlc3Mgc3RyaW5nLlxuICAgKlxuICAgKiBAcGFyYW0gYWNjZXNzU3RyaW5nIFRoZSBhY2Nlc3Mgc3RyaW5nIGRlZmluaW5nIHVzZXIgcGVybWlzc2lvbnMuXG4gICAqL1xuICBwdWJsaWMgc3RhdGljIGZyb21BY2Nlc3NTdHJpbmcoYWNjZXNzU3RyaW5nOiBzdHJpbmcpOiBBY2Nlc3NDb250cm9sIHtcbiAgICByZXR1cm4gbmV3IEFjY2Vzc0NvbnRyb2xTdHJpbmcoYWNjZXNzU3RyaW5nKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBUaGUgYWNjZXNzIHN0cmluZyB0aGF0IGRlZmluZXMgdXNlcidzIHBlcm1pc3Npb25zLlxuICAgKi9cbiAgcHVibGljIGFic3RyYWN0IHJlYWRvbmx5IGFjY2Vzc1N0cmluZzogc3RyaW5nO1xufVxuXG4vKipcbiAqIEFjY2VzcyBjb250cm9sIGltcGxlbWVudGF0aW9uIHVzaW5nIGEgcmF3IGFjY2VzcyBzdHJpbmcuXG4gKi9cbmNsYXNzIEFjY2Vzc0NvbnRyb2xTdHJpbmcgZXh0ZW5kcyBBY2Nlc3NDb250cm9sIHtcbiAgLyoqXG4gICAqIFRoZSBhY2Nlc3Mgc3RyaW5nIHRoYXQgZGVmaW5lcyB1c2VyJ3MgcGVybWlzc2lvbnMuXG4gICAqL1xuICBwdWJsaWMgcmVhZG9ubHkgYWNjZXNzU3RyaW5nOiBzdHJpbmc7XG5cbiAgY29uc3RydWN0b3IoYWNjZXNzU3RyaW5nOiBzdHJpbmcpIHtcbiAgICBzdXBlcigpO1xuICAgIHRoaXMuYWNjZXNzU3RyaW5nID0gYWNjZXNzU3RyaW5nO1xuICB9XG59XG5cbi8qKlxuICogUHJvcGVydGllcyBmb3IgZGVmaW5pbmcgYW4gRWxhc3RpQ2FjaGUgYmFzZSB1c2VyLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIFVzZXJCYXNlUHJvcHMge1xuICAvKipcbiAgICogVGhlIGVuZ2luZSB0eXBlIGZvciB0aGUgdXNlci5cbiAgICogRW51bSBvcHRpb25zOiBVc2VyRW5naW5lLlZBTEtFWSwgVXNlckVuZ2luZS5SRURJUy5cbiAgICpcbiAgICogQGRlZmF1bHQgVXNlckVuZ2luZS5WQUxLRVkuXG4gICAqL1xuICByZWFkb25seSBlbmdpbmU/OiBVc2VyRW5naW5lO1xuICAvKipcbiAgICogVGhlIElEIG9mIHRoZSB1c2VyLlxuICAgKi9cbiAgcmVhZG9ubHkgdXNlcklkOiBzdHJpbmc7XG4gIC8qKlxuICAgKiBBY2Nlc3MgY29udHJvbCBjb25maWd1cmF0aW9uIGZvciB0aGUgdXNlci5cbiAgICovXG4gIHJlYWRvbmx5IGFjY2Vzc0NvbnRyb2w6IEFjY2Vzc0NvbnRyb2w7XG59XG5cbi8qKlxuICogUmVwcmVzZW50cyBhbiBFbGFzdGlDYWNoZSBiYXNlIHVzZXIuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgSVVzZXIgZXh0ZW5kcyBJUmVzb3VyY2Uge1xuICAvKipcbiAgICogVGhlIHVzZXIncyBJRC5cbiAgICpcbiAgICogQGF0dHJpYnV0ZVxuICAgKi9cbiAgcmVhZG9ubHkgdXNlcklkOiBzdHJpbmc7XG4gIC8qKlxuICAgKiBUaGUgZW5naW5lIGZvciB0aGUgdXNlci5cbiAgICovXG4gIHJlYWRvbmx5IGVuZ2luZT86IFVzZXJFbmdpbmU7XG4gIC8qKlxuICAgKiBUaGUgdXNlcidzIG5hbWUuXG4gICAqXG4gICAqIEBhdHRyaWJ1dGVcbiAgICovXG4gIHJlYWRvbmx5IHVzZXJOYW1lPzogc3RyaW5nO1xuICAvKipcbiAgICogVGhlIHVzZXIncyBBUk4uXG4gICAqXG4gICAqIEBhdHRyaWJ1dGVcbiAgICovXG4gIHJlYWRvbmx5IHVzZXJBcm46IHN0cmluZztcbn1cblxuLyoqXG4gKiBBdHRyaWJ1dGVzIGZvciBpbXBvcnRpbmcgYW4gZXhpc3RpbmcgRWxhc3RpQ2FjaGUgdXNlci5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBVc2VyQmFzZUF0dHJpYnV0ZXMge1xuICAvKipcbiAgICogVGhlIElEIG9mIHRoZSB1c2VyLlxuICAgKiBPbmUgb2YgYHVzZXJJZGAgb3IgYHVzZXJBcm5gIGlzIHJlcXVpcmVkLlxuICAgKlxuICAgKiBAZGVmYXVsdCAtIGRlcml2ZWQgZnJvbSB1c2VyQXJuLlxuICAgKi9cbiAgcmVhZG9ubHkgdXNlcklkPzogc3RyaW5nO1xuICAvKipcbiAgICogVGhlIGVuZ2luZSB0eXBlIGZvciB0aGUgdXNlci5cbiAgICpcbiAgICogQGRlZmF1bHQgLSBlbmdpbmUgdHlwZSBpcyB1bmtub3duLlxuICAgKi9cbiAgcmVhZG9ubHkgZW5naW5lPzogVXNlckVuZ2luZTtcbiAgLyoqXG4gICAqIFRoZSB1c2VyJ3MgbmFtZS5cbiAgICpcbiAgICogQGRlZmF1bHQgLSBuYW1lIGlzIHVua25vd24uXG4gICAqL1xuICByZWFkb25seSB1c2VyTmFtZT86IHN0cmluZztcbiAgLyoqXG4gICAqIFRoZSBBUk4gb2YgdGhlIHVzZXIuXG4gICAqXG4gICAqIE9uZSBvZiBgdXNlcklkYCBvciBgdXNlckFybmAgaXMgcmVxdWlyZWQuXG4gICAqXG4gICAqIEBkZWZhdWx0IC0gZGVyaXZlZCBmcm9tIHVzZXJJZC5cbiAgICovXG4gIHJlYWRvbmx5IHVzZXJBcm4/OiBzdHJpbmc7XG59XG5cbi8qKlxuICogQmFzZSBjbGFzcyBmb3IgRWxhc3RpQ2FjaGUgdXNlcnMuXG4gKi9cbmV4cG9ydCBhYnN0cmFjdCBjbGFzcyBVc2VyQmFzZSBleHRlbmRzIFJlc291cmNlIGltcGxlbWVudHMgSVVzZXIge1xuICAvKipcbiAgICogSW1wb3J0IGFuIGV4aXN0aW5nIHVzZXIgYnkgSUQuXG4gICAqXG4gICAqIEBwYXJhbSBzY29wZSBUaGUgcGFyZW50IGNyZWF0aW5nIGNvbnN0cnVjdCAodXN1YWxseSBgdGhpc2ApLlxuICAgKiBAcGFyYW0gaWQgVGhlIGNvbnN0cnVjdCdzIG5hbWUuXG4gICAqIEBwYXJhbSB1c2VySWQgVGhlIElEIG9mIHRoZSBleGlzdGluZyB1c2VyLlxuICAgKi9cbiAgcHVibGljIHN0YXRpYyBmcm9tVXNlcklkKHNjb3BlOiBDb25zdHJ1Y3QsIGlkOiBzdHJpbmcsIHVzZXJJZDogc3RyaW5nKTogSVVzZXIge1xuICAgIHJldHVybiBVc2VyQmFzZS5mcm9tVXNlckF0dHJpYnV0ZXMoc2NvcGUsIGlkLCB7IHVzZXJJZCB9KTtcbiAgfVxuXG4gIC8qKlxuICAgKiBJbXBvcnQgYW4gZXhpc3RpbmcgdXNlciBieSBBUk4uXG4gICAqXG4gICAqIEBwYXJhbSBzY29wZSBUaGUgcGFyZW50IGNyZWF0aW5nIGNvbnN0cnVjdCAodXN1YWxseSBgdGhpc2ApLlxuICAgKiBAcGFyYW0gaWQgVGhlIGNvbnN0cnVjdCdzIG5hbWUuXG4gICAqIEBwYXJhbSB1c2VyQXJuIFRoZSBBUk4gb2YgdGhlIGV4aXN0aW5nIHVzZXIuXG4gICAqL1xuICBwdWJsaWMgc3RhdGljIGZyb21Vc2VyQXJuKHNjb3BlOiBDb25zdHJ1Y3QsIGlkOiBzdHJpbmcsIHVzZXJBcm46IHN0cmluZyk6IElVc2VyIHtcbiAgICByZXR1cm4gVXNlckJhc2UuZnJvbVVzZXJBdHRyaWJ1dGVzKHNjb3BlLCBpZCwgeyB1c2VyQXJuIH0pO1xuICB9XG5cbiAgLyoqXG4gICAqIEltcG9ydCBhbiBleGlzdGluZyB1c2VyIHVzaW5nIGF0dHJpYnV0ZXMuXG4gICAqXG4gICAqIEBwYXJhbSBzY29wZSBUaGUgcGFyZW50IGNyZWF0aW5nIGNvbnN0cnVjdCAodXN1YWxseSBgdGhpc2ApLlxuICAgKiBAcGFyYW0gaWQgVGhlIGNvbnN0cnVjdCdzIG5hbWUuXG4gICAqIEBwYXJhbSBhdHRycyBBIGBVc2VyQmFzZUF0dHJpYnV0ZXNgIG9iamVjdC5cbiAgICovXG4gIHB1YmxpYyBzdGF0aWMgZnJvbVVzZXJBdHRyaWJ1dGVzKHNjb3BlOiBDb25zdHJ1Y3QsIGlkOiBzdHJpbmcsIGF0dHJzOiBVc2VyQmFzZUF0dHJpYnV0ZXMpOiBJVXNlciB7XG4gICAgbGV0IHVzZXJJZDogc3RyaW5nO1xuICAgIGxldCB1c2VyQXJuOiBzdHJpbmc7XG4gICAgY29uc3Qgc3RhY2sgPSBTdGFjay5vZihzY29wZSk7XG5cbiAgICBpZiAoYXR0cnMudXNlckFybiAmJiBhdHRycy51c2VySWQpIHtcbiAgICAgIHRocm93IG5ldyBWYWxpZGF0aW9uRXJyb3IoJ09ubHkgb25lIG9mIHVzZXJBcm4gb3IgdXNlcklkIGNhbiBiZSBwcm92aWRlZC4nLCBzY29wZSk7XG4gICAgfVxuXG4gICAgaWYgKGF0dHJzLnVzZXJBcm4pIHtcbiAgICAgIHVzZXJBcm4gPSBhdHRycy51c2VyQXJuO1xuICAgICAgY29uc3QgZXh0cmFjdGVkVXNlcklkID0gc3RhY2suc3BsaXRBcm4oYXR0cnMudXNlckFybiwgQXJuRm9ybWF0LlNMQVNIX1JFU09VUkNFX05BTUUpLnJlc291cmNlTmFtZTtcbiAgICAgIGlmICghZXh0cmFjdGVkVXNlcklkKSB7XG4gICAgICAgIHRocm93IG5ldyBWYWxpZGF0aW9uRXJyb3IoJ1VuYWJsZSB0byBleHRyYWN0IHVzZXIgaWQgZnJvbSBBUk4uJywgc2NvcGUpO1xuICAgICAgfVxuICAgICAgdXNlcklkID0gZXh0cmFjdGVkVXNlcklkO1xuICAgIH0gZWxzZSBpZiAoYXR0cnMudXNlcklkKSB7XG4gICAgICB1c2VySWQgPSBhdHRycy51c2VySWQ7XG4gICAgICB1c2VyQXJuID0gc3RhY2suZm9ybWF0QXJuKHtcbiAgICAgICAgc2VydmljZTogJ2VsYXN0aWNhY2hlJyxcbiAgICAgICAgcmVzb3VyY2U6ICd1c2VyJyxcbiAgICAgICAgcmVzb3VyY2VOYW1lOiBhdHRycy51c2VySWQsXG4gICAgICB9KTtcbiAgICB9IGVsc2Uge1xuICAgICAgdGhyb3cgbmV3IFZhbGlkYXRpb25FcnJvcignT25lIG9mIHVzZXJJZCBvciB1c2VyQXJuIGlzIHJlcXVpcmVkLicsIHNjb3BlKTtcbiAgICB9XG5cbiAgICBjbGFzcyBJbXBvcnQgZXh0ZW5kcyBSZXNvdXJjZSBpbXBsZW1lbnRzIElVc2VyIHtcbiAgICAgIHB1YmxpYyByZWFkb25seSBlbmdpbmU/OiBVc2VyRW5naW5lO1xuICAgICAgcHVibGljIHJlYWRvbmx5IHVzZXJJZDogc3RyaW5nO1xuICAgICAgcHVibGljIHJlYWRvbmx5IHVzZXJBcm46IHN0cmluZztcbiAgICAgIHJlYWRvbmx5IHVzZXJOYW1lPzogc3RyaW5nO1xuXG4gICAgICBjb25zdHJ1Y3RvcihfdXNlckFybjogc3RyaW5nLCBfdXNlcklkOiBzdHJpbmcpIHtcbiAgICAgICAgc3VwZXIoc2NvcGUsIGlkKTtcbiAgICAgICAgdGhpcy51c2VyQXJuID0gX3VzZXJBcm47XG4gICAgICAgIHRoaXMudXNlcklkID0gX3VzZXJJZDtcbiAgICAgICAgdGhpcy5lbmdpbmUgPSBhdHRycy5lbmdpbmU7XG4gICAgICAgIHRoaXMudXNlck5hbWUgPSBhdHRycy51c2VyTmFtZTtcbiAgICAgIH1cbiAgICB9XG5cbiAgICByZXR1cm4gbmV3IEltcG9ydCh1c2VyQXJuLCB1c2VySWQpO1xuICB9XG5cbiAgLyoqXG4gICAqIFRoZSB1c2VyJ3MgSUQuXG4gICAqXG4gICAqIEBhdHRyaWJ1dGVcbiAgICovXG4gIHB1YmxpYyBhYnN0cmFjdCByZWFkb25seSB1c2VySWQ6IHN0cmluZztcbiAgLyoqXG4gICAqIFRoZSBlbmdpbmUgZm9yIHRoZSB1c2VyLlxuICAgKi9cbiAgcHVibGljIGFic3RyYWN0IHJlYWRvbmx5IGVuZ2luZT86IFVzZXJFbmdpbmU7XG4gIC8qKlxuICAgKiBUaGUgdXNlcidzIG5hbWUuXG4gICAqXG4gICAqIEBhdHRyaWJ1dGVcbiAgICovXG4gIHB1YmxpYyBhYnN0cmFjdCByZWFkb25seSB1c2VyTmFtZT86IHN0cmluZztcbiAgLyoqXG4gICAqIFRoZSB1c2VyJ3MgQVJOLlxuICAgKlxuICAgKiBAYXR0cmlidXRlXG4gICAqL1xuICBwdWJsaWMgYWJzdHJhY3QgcmVhZG9ubHkgdXNlckFybjogc3RyaW5nO1xufVxuIl19

package/lib/user-group.d.ts

@@ -0,0 +1,199 @@
+import { Construct } from 'constructs';
+import { UserEngine } from './common';
+import { IUser } from './user-base';
+import { IResource, Resource } from 'aws-cdk-lib/core';
+/**
+ * Properties for defining an ElastiCache UserGroup
+ */
+export interface UserGroupProps {
+    /**
+     * Enforces a particular physical user group name.
+     * @default <generated>
+     */
+    readonly userGroupName?: string;
+    /**
+     * The engine type for the user group
+     * Enum options: UserEngine.VALKEY, UserEngine.REDIS
+     *
+     * @default UserEngine.VALKEY
+     */
+    readonly engine?: UserEngine;
+    /**
+     * List of users inside the user group
+     *
+     * @default - no users
+     */
+    readonly users?: IUser[];
+}
+/**
+ * Represents an ElastiCache UserGroup
+ */
+export interface IUserGroup extends IResource {
+    /**
+     * The name of the user group
+     *
+     * @attribute
+     */
+    readonly userGroupName: string;
+    /**
+     * The engine type for the user group
+     */
+    readonly engine?: UserEngine;
+    /**
+     * List of users in the user group
+     */
+    readonly users?: IUser[];
+    /**
+     * The ARN of the user group
+     *
+     * @attribute
+     */
+    readonly userGroupArn: string;
+    /**
+     * Add a user to this user group
+     *
+     * @param user The user to add
+     */
+    addUser(user: IUser): void;
+}
+/**
+ * Base class for UserGroup constructs
+ */
+export declare abstract class UserGroupBase extends Resource implements IUserGroup {
+    /**
+     * The name of the user group
+     *
+     * @attribute
+     */
+    abstract readonly userGroupName: string;
+    /**
+     * The engine type for the user group
+     */
+    abstract readonly engine?: UserEngine;
+    /**
+     * List of users in the user group
+     */
+    abstract readonly users?: IUser[];
+    /**
+     * The ARN of the user group
+     * @attribute
+     */
+    abstract readonly userGroupArn: string;
+    /**
+     * Add a user to this user group
+     *
+     * @param _user The user to add
+     */
+    addUser(_user: IUser): void;
+}
+/**
+ * Attributes that can be specified when importing a UserGroup
+ */
+export interface UserGroupAttributes {
+    /**
+     * The name of the user group
+     *
+     * One of `userGroupName` or `userGroupArn` is required.
+     *
+     * @default - derived from userGroupArn
+     */
+    readonly userGroupName?: string;
+    /**
+     * The engine type for the user group
+     *
+     * @default - engine type is unknown
+     */
+    readonly engine?: UserEngine;
+    /**
+     * List of users in the user group
+     *
+     * @default - users are unknown
+     */
+    readonly users?: IUser[];
+    /**
+     * The ARN of the user group
+     *
+     * One of `userGroupName` or `userGroupArn` is required.
+     *
+     * @default - derived from userGroupName
+     */
+    readonly userGroupArn?: string;
+}
+/**
+ * An ElastiCache UserGroup
+ *
+ * @resource AWS::ElastiCache::UserGroup
+ */
+export declare class UserGroup extends UserGroupBase {
+    /**
+     * Uniquely identifies this class
+     */
+    static readonly PROPERTY_INJECTION_ID: string;
+    /**
+     * Return whether the given object is a `UserGroup`
+     */
+    static isUserGroup(x: any): x is UserGroup;
+    /**
+     * Import an existing user group by name
+     *
+     * @param scope The parent creating construct (usually `this`)
+     * @param id The construct's name
+     * @param userGroupName The name of the existing user group
+     */
+    static fromUserGroupName(scope: Construct, id: string, userGroupName: string): IUserGroup;
+    /**
+     * Import an existing user group by ARN
+     *
+     * @param scope The parent creating construct (usually `this`)
+     * @param id The construct's name
+     * @param userGroupArn The ARN of the existing user group
+     */
+    static fromUserGroupArn(scope: Construct, id: string, userGroupArn: string): IUserGroup;
+    /**
+     * Import an existing user group using attributes
+     *
+     * @param scope The parent creating construct (usually `this`)
+     * @param id The construct's name
+     * @param attrs A `UserGroupAttributes` object
+     */
+    static fromUserGroupAttributes(scope: Construct, id: string, attrs: UserGroupAttributes): IUserGroup;
+    readonly engine?: UserEngine;
+    readonly userGroupName: string;
+    private readonly _users;
+    /**
+     * The ARN of the user group
+     *
+     * @attribute
+     */
+    readonly userGroupArn: string;
+    /**
+     * The status of the user group
+     * Can be 'creating', 'active', 'modifying', 'deleting'
+     *
+     * @attribute
+     */
+    readonly userGroupStatus: string;
+    private readonly resource;
+    constructor(scope: Construct, id: string, props?: UserGroupProps);
+    /**
+     * Add a CloudFormation dependency on the user resource to ensure proper creation order.
+     */
+    private addUserDependency;
+    /**
+     * Array of users in the user group
+     *
+     * Do not push directly to this array.
+     * Use addUser() instead to ensure proper validation and dependency management.
+     */
+    get users(): IUser[] | undefined;
+    /**
+     * Validates users in the user group for duplicate usernames and Redis-specific requirements.
+     */
+    private validateUsers;
+    /**
+     * Add a user to this user group
+     *
+     * @param user The user to add to the group
+     */
+    addUser(user: IUser): void;
+}