idea-aws 4.2.1 → 4.3.0

package/dist/src/attachments.d.ts

@@ -5,20 +5,17 @@ import { S3 } from './s3';
  * A custom class that takes advantage of DynamoDB and S3 to easily manage attachments.
  */
 export declare class Attachments {
-    /**
-     * The instance of DynamoDB.
-     */
-    protected dynamo: DynamoDB;
-    /**
-     * The instance of S3.
-     */
+    protected ddb: DynamoDB;
     protected s3: S3;
     /**
      * The bucket where from to retrieve the attachments. Fallback to IDEA's default one.
      */
     protected S3_ATTACHMENTS_BUCKET: string;
+    /**
+     * The prefix for attachment IDs. Fallback to IDEA's default one.
+     */
     protected IUID_ATTACHMENTS_PREFIX: string;
-    constructor();
+    constructor(ddb: DynamoDB, s3: S3);
     /**
      * Get a signedURL to put an attachment.
      */

package/dist/src/attachments.js

@@ -1,27 +1,28 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Attachments = void 0;
-const dynamoDB_1 = require("./dynamoDB");
-const s3_1 = require("./s3");
 /**
  * A custom class that takes advantage of DynamoDB and S3 to easily manage attachments.
  */
 class Attachments {
-    constructor() {
+    constructor(ddb, s3) {
+        this.ddb = ddb;
+        this.s3 = s3;
         /**
          * The bucket where from to retrieve the attachments. Fallback to IDEA's default one.
          */
-        this.S3_ATTACHMENTS_BUCKET = process.env['S3_ATTACHMENTS_BUCKET'] || 'idea-attachments';
-        this.IUID_ATTACHMENTS_PREFIX = process.env['IUID_ATTACHMENTS_PREFIX'] || 'ATT';
-        this.dynamo = new dynamoDB_1.DynamoDB();
-        this.s3 = new s3_1.S3();
+        this.S3_ATTACHMENTS_BUCKET = process.env.S3_ATTACHMENTS_BUCKET ?? 'idea-attachments';
+        /**
+         * The prefix for attachment IDs. Fallback to IDEA's default one.
+         */
+        this.IUID_ATTACHMENTS_PREFIX = process.env.IUID_ATTACHMENTS_PREFIX ?? 'ATT';
     }
     /**
      * Get a signedURL to put an attachment.
      */
     async put(project, teamId) {
-        const attachmentIdPrefix = this.IUID_ATTACHMENTS_PREFIX.concat('_').concat(project).concat('_').concat(teamId);
-        const attachmentId = await this.dynamo.IUNID(attachmentIdPrefix);
+        const attachmentIdPrefix = this.IUID_ATTACHMENTS_PREFIX.concat('_', project, '_', teamId);
+        const attachmentId = await this.ddb.IUNID(attachmentIdPrefix);
         const signedURL = await this.s3.signedURLPut(this.S3_ATTACHMENTS_BUCKET, attachmentId);
         signedURL.id = attachmentId;
         return signedURL;

package/dist/src/cognito.d.ts

@@ -5,7 +5,7 @@ import { CognitoUser } from 'idea-toolbox';
  */
 export declare class Cognito {
     protected cognito: CognitoIP.CognitoIdentityProviderClient;
-    constructor(params?: {
+    constructor(options?: {
         region?: string;
     });
     /**
@@ -27,15 +27,15 @@ export declare class Cognito {
     /**
      * Identify a user by its email address, returning its attributes.
      */
-    getUserByEmail(email: string, cognitoUserPoolId: string): Promise<CognitoUserGeneric>;
+    getUserByEmail(email: string, userPoolId: string): Promise<CognitoUserGeneric>;
     /**
      * Identify a user by its userId (sub), returning its attributes.
      */
-    getUserBySub(sub: string, cognitoUserPoolId: string): Promise<CognitoUserGeneric>;
+    getUserBySub(sub: string, userPoolId: string): Promise<CognitoUserGeneric>;
     /**
      * List all the users of the pool.
      */
-    listUsers(cognitoUserPoolId: string, options?: {
+    listUsers(userPoolId: string, options?: {
         pagination?: string;
         users: CognitoUser[];
     }): Promise<CognitoUser[]>;
@@ -48,89 +48,89 @@ export declare class Cognito {
      * Create a new user (by its email) in the pool specified.
      * @return userId of the new user
      */
-    createUser(cognitoUserOrEmail: CognitoUser | string, cognitoUserPoolId: string, options?: CreateUserOptions): Promise<string>;
+    createUser(cognitoUserOrEmail: CognitoUser | string, userPoolId: string, options?: CreateUserOptions): Promise<string>;
     /**
      * Resend the password to a user who never logged in.
      */
-    resendPassword(email: string, cognitoUserPoolId: string, options?: CreateUserOptions): Promise<void>;
+    resendPassword(email: string, userPoolId: string, options?: CreateUserOptions): Promise<void>;
     /**
      * Set a new password for a specific user identified by its email (admin-only).
      * If not specified, the password is generated randomly, and the user must change it at the first login.
      */
-    setPassword(email: string, cognitoUserPoolId: string, options?: {
+    setPassword(email: string, userPoolId: string, options?: {
         password?: string;
         permanent?: boolean;
     }): Promise<void>;
     /**
      * Delete a user by its email (username), in the pool specified.
      */
-    deleteUser(email: string, cognitoUserPoolId: string): Promise<void>;
+    deleteUser(email: string, userPoolId: string): Promise<void>;
     /**
      * Sign in a user of a specific pool through username and password.
      */
-    signIn(email: string, password: string, cognitoUserPoolId: string, cognitoUserPoolClientId: string): Promise<CognitoIP.AuthenticationResultType>;
+    signIn(email: string, password: string, userPoolId: string, userPoolClientId: string): Promise<CognitoIP.AuthenticationResultType>;
     /**
      * Given a username and a refresh token (and pool data), refresh the session and return the new tokens.
      */
-    refreshSession(email: string, refreshToken: string, cognitoUserPoolId: string, cognitoUserPoolClientId: string): Promise<CognitoIP.AuthenticationResultType>;
+    refreshSession(email: string, refreshToken: string, userPoolId: string, userPoolClientId: string): Promise<CognitoIP.AuthenticationResultType>;
     /**
      * Change the email address (== username) associated to a user.
      */
-    updateEmail(email: string, newEmail: string, cognitoUserPoolId: string): Promise<void>;
+    updateEmail(email: string, newEmail: string, userPoolId: string): Promise<void>;
     /**
      * Change the password to sign in for a user.
      */
-    updatePassword(email: string, oldPassword: string, newPassword: string, cognitoUserPoolId: string, cognitoUserPoolClientId: string): Promise<void>;
+    updatePassword(email: string, oldPassword: string, newPassword: string, userPoolId: string, userPoolClientId: string): Promise<void>;
     /**
      * Send to a user the instructions to change the password.
      */
-    forgotPassword(email: string, cognitoUserPoolClientId: string): Promise<CognitoIP.CodeDeliveryDetailsType>;
+    forgotPassword(email: string, userPoolClientId: string): Promise<CognitoIP.CodeDeliveryDetailsType>;
     /**
      * Complete the flow of a password forgot.
      */
-    confirmForgotPassword(email: string, newPassword: string, confirmationCode: string, cognitoUserPoolClientId: string): Promise<void>;
+    confirmForgotPassword(email: string, newPassword: string, confirmationCode: string, userPoolClientId: string): Promise<void>;
     /**
      * Update a (Cognito)User's attributes, excluding the attributes that require specific methods.
      */
-    updateUser(user: CognitoUser, cognitoUserPoolId: string): Promise<void>;
+    updateUser(user: CognitoUser, userPoolId: string): Promise<void>;
     /**
      * Sign out the user from all devices.
      */
-    globalSignOut(email: string, cognitoUserPoolId: string): Promise<void>;
+    globalSignOut(email: string, userPoolId: string): Promise<void>;
     /**
      * Confirm and conclude a registration, usign a confirmation code.
      */
-    confirmSignUp(email: string, confirmationCode: string, cognitoUserPoolClientId: string): Promise<void>;
+    confirmSignUp(email: string, confirmationCode: string, userPoolClientId: string): Promise<void>;
     /**
      * List the groups of the user pool.
      */
-    listGroups(cognitoUserPoolId: string, options?: {
+    listGroups(userPoolId: string, options?: {
         pagination?: string;
         groups: CognitoGroup[];
     }): Promise<CognitoGroup[]>;
     /**
      * Create a new group in the user pool.
      */
-    createGroup(groupName: string, cognitoUserPoolId: string): Promise<void>;
+    createGroup(groupName: string, userPoolId: string): Promise<void>;
     /**
      * Delete a group from the user pool.
      */
-    deleteGroup(groupName: string, cognitoUserPoolId: string): Promise<void>;
+    deleteGroup(groupName: string, userPoolId: string): Promise<void>;
     /**
      * List the users part of a group in the user pool.
      */
-    listUsersInGroup(group: string, cognitoUserPoolId: string, options?: {
+    listUsersInGroup(group: string, userPoolId: string, options?: {
         pagination?: string;
         users: CognitoUser[];
     }): Promise<CognitoUser[]>;
     /**
      * Add a user (by email) to a group in the user pool.
      */
-    addUserToGroup(email: string, group: string, cognitoUserPoolId: string): Promise<void>;
+    addUserToGroup(email: string, group: string, userPoolId: string): Promise<void>;
     /**
      * Remove a user (by email) from a group in the user pool.
      */
-    removeUserFromGroup(email: string, group: string, cognitoUserPoolId: string): Promise<void>;
+    removeUserFromGroup(email: string, group: string, userPoolId: string): Promise<void>;
 }
 /**
  * The attributes of a generic Cognito user of which we don't know the custom attributes.

package/dist/src/cognito.js

@@ -30,8 +30,7 @@ const idea_toolbox_1 = require("idea-toolbox");
  * A wrapper for AWS Cognito.
  */
 class Cognito {
-    constructor(params) {
-        const options = Object.assign({}, params);
+    constructor(options = {}) {
         this.cognito = new CognitoIP.CognitoIdentityProviderClient({ region: options.region });
     }
     /**
@@ -66,16 +65,19 @@ class Cognito {
      */
     mapCognitoUserAttributesAsPlainObject(user) {
         const userAttributes = {};
-        (user.Attributes || user.UserAttributes || []).forEach((a) => (userAttributes[a.Name] = a.Value));
+        (user.Attributes ?? user.UserAttributes ?? []).forEach((a) => (userAttributes[a.Name] = a.Value));
         if (!userAttributes.userId)
             userAttributes.userId = userAttributes.sub;
         return userAttributes;
     }
+    //
+    // ADMIN
+    //
     /**
      * Identify a user by its email address, returning its attributes.
      */
-    async getUserByEmail(email, cognitoUserPoolId) {
-        const command = new CognitoIP.AdminGetUserCommand({ UserPoolId: cognitoUserPoolId, Username: email });
+    async getUserByEmail(email, userPoolId) {
+        const command = new CognitoIP.AdminGetUserCommand({ UserPoolId: userPoolId, Username: email });
         try {
             const user = await this.cognito.send(command);
             return this.mapCognitoUserAttributesAsPlainObject(user);
@@ -89,30 +91,25 @@ class Cognito {
     /**
      * Identify a user by its userId (sub), returning its attributes.
      */
-    async getUserBySub(sub, cognitoUserPoolId) {
+    async getUserBySub(sub, userPoolId) {
         // as of today, there is no a direct way to find a user by its sub: we need to run a query against the users base
-        const command = new CognitoIP.ListUsersCommand({
-            UserPoolId: cognitoUserPoolId,
-            Filter: `sub = "${sub}"`,
-            Limit: 1
-        });
-        const usersList = await this.cognito.send(command);
-        const user = usersList?.Users[0];
-        if (!user)
+        const command = new CognitoIP.ListUsersCommand({ UserPoolId: userPoolId, Filter: `sub = "${sub}"`, Limit: 1 });
+        const { Users } = await this.cognito.send(command);
+        if (Users.length < 1)
             throw new Error('User not found');
-        return this.mapCognitoUserAttributesAsPlainObject(user);
+        return this.mapCognitoUserAttributesAsPlainObject(Users[0]);
     }
     /**
      * List all the users of the pool.
      */
-    async listUsers(cognitoUserPoolId, options = { users: [] }) {
-        const params = { UserPoolId: cognitoUserPoolId };
+    async listUsers(userPoolId, options = { users: [] }) {
+        const params = { UserPoolId: userPoolId };
         if (options.pagination)
             params.PaginationToken = options.pagination;
         const { Users, PaginationToken: pagination } = await this.cognito.send(new CognitoIP.ListUsersCommand(params));
         const users = options.users.concat(Users.map(u => new idea_toolbox_1.CognitoUser(this.mapCognitoUserAttributesAsPlainObject(u))));
         if (pagination)
-            return await this.listUsers(cognitoUserPoolId, { pagination, users });
+            return await this.listUsers(userPoolId, { pagination, users });
         else
             return users;
     }
@@ -141,7 +138,7 @@ class Cognito {
      * Create a new user (by its email) in the pool specified.
      * @return userId of the new user
      */
-    async createUser(cognitoUserOrEmail, cognitoUserPoolId, options = {}) {
+    async createUser(cognitoUserOrEmail, userPoolId, options = {}) {
         const email = typeof cognitoUserOrEmail === 'string'
             ? cognitoUserOrEmail
             : cognitoUserOrEmail.email;
@@ -157,11 +154,7 @@ class Cognito {
             UserAttributes.push({ Name: 'picture', Value: user.picture || '' });
             Object.keys(user.attributes).forEach(a => UserAttributes.push({ Name: 'custom:'.concat(a), Value: String(user.attributes[a]) }));
         }
-        const params = {
-            UserPoolId: cognitoUserPoolId,
-            Username: email,
-            UserAttributes
-        };
+        const params = { UserPoolId: userPoolId, Username: email, UserAttributes };
         if (options.skipNotification)
             params.MessageAction = 'SUPPRESS';
         if (options.temporaryPassword)
@@ -175,11 +168,11 @@ class Cognito {
     /**
      * Resend the password to a user who never logged in.
      */
-    async resendPassword(email, cognitoUserPoolId, options = {}) {
+    async resendPassword(email, userPoolId, options = {}) {
         if ((0, idea_toolbox_1.isEmpty)(email, 'email'))
             throw new Error('Invalid email');
         const params = {
-            UserPoolId: cognitoUserPoolId,
+            UserPoolId: userPoolId,
             Username: email,
             MessageAction: 'RESEND'
         };
@@ -191,7 +184,7 @@ class Cognito {
      * Set a new password for a specific user identified by its email (admin-only).
      * If not specified, the password is generated randomly, and the user must change it at the first login.
      */
-    async setPassword(email, cognitoUserPoolId, options = {}) {
+    async setPassword(email, userPoolId, options = {}) {
         if ((0, idea_toolbox_1.isEmpty)(email, 'email'))
             throw new Error('Invalid email');
         const RANDOM_PASSWORD_LENGTH = 8;
@@ -200,7 +193,7 @@ class Cognito {
                 .toString(36)
                 .slice(2, 2 + RANDOM_PASSWORD_LENGTH);
         const params = {
-            UserPoolId: cognitoUserPoolId,
+            UserPoolId: userPoolId,
             Username: email,
             Password: password,
             Permanent: options.permanent
@@ -210,19 +203,22 @@ class Cognito {
     /**
      * Delete a user by its email (username), in the pool specified.
      */
-    async deleteUser(email, cognitoUserPoolId) {
+    async deleteUser(email, userPoolId) {
         if ((0, idea_toolbox_1.isEmpty)(email, 'email'))
             throw new Error('Invalid email');
-        const command = new CognitoIP.AdminDeleteUserCommand({ UserPoolId: cognitoUserPoolId, Username: email });
+        const command = new CognitoIP.AdminDeleteUserCommand({ UserPoolId: userPoolId, Username: email });
         await this.cognito.send(command);
     }
+    //
+    // USER
+    //
     /**
      * Sign in a user of a specific pool through username and password.
      */
-    async signIn(email, password, cognitoUserPoolId, cognitoUserPoolClientId) {
+    async signIn(email, password, userPoolId, userPoolClientId) {
         const command = new CognitoIP.AdminInitiateAuthCommand({
-            UserPoolId: cognitoUserPoolId,
-            ClientId: cognitoUserPoolClientId,
+            UserPoolId: userPoolId,
+            ClientId: userPoolClientId,
             AuthFlow: 'ADMIN_NO_SRP_AUTH',
             AuthParameters: { USERNAME: email, PASSWORD: password }
         });
@@ -234,10 +230,10 @@ class Cognito {
     /**
      * Given a username and a refresh token (and pool data), refresh the session and return the new tokens.
      */
-    async refreshSession(email, refreshToken, cognitoUserPoolId, cognitoUserPoolClientId) {
+    async refreshSession(email, refreshToken, userPoolId, userPoolClientId) {
         const command = new CognitoIP.AdminInitiateAuthCommand({
-            UserPoolId: cognitoUserPoolId,
-            ClientId: cognitoUserPoolClientId,
+            UserPoolId: userPoolId,
+            ClientId: userPoolClientId,
             AuthFlow: 'REFRESH_TOKEN_AUTH',
             AuthParameters: { USERNAME: email, REFRESH_TOKEN: refreshToken }
         });
@@ -249,11 +245,11 @@ class Cognito {
     /**
      * Change the email address (== username) associated to a user.
      */
-    async updateEmail(email, newEmail, cognitoUserPoolId) {
+    async updateEmail(email, newEmail, userPoolId) {
         if ((0, idea_toolbox_1.isEmpty)(newEmail, 'email'))
             throw new Error('Invalid new email');
         const command = new CognitoIP.AdminUpdateUserAttributesCommand({
-            UserPoolId: cognitoUserPoolId,
+            UserPoolId: userPoolId,
             Username: email,
             UserAttributes: [
                 { Name: 'email', Value: newEmail },
@@ -262,15 +258,15 @@ class Cognito {
         });
         await this.cognito.send(command);
         // sign out the user from all its devices and resolve
-        await this.globalSignOut(newEmail, cognitoUserPoolId);
+        await this.globalSignOut(newEmail, userPoolId);
     }
     /**
      * Change the password to sign in for a user.
      */
-    async updatePassword(email, oldPassword, newPassword, cognitoUserPoolId, cognitoUserPoolClientId) {
+    async updatePassword(email, oldPassword, newPassword, userPoolId, userPoolClientId) {
         if (newPassword.length < 8)
             throw new Error('Invalid new password');
-        const tokensForPasswordChange = await this.signIn(email, oldPassword, cognitoUserPoolId, cognitoUserPoolClientId);
+        const tokensForPasswordChange = await this.signIn(email, oldPassword, userPoolId, userPoolClientId);
         const command = new CognitoIP.ChangePasswordCommand({
             AccessToken: tokensForPasswordChange.AccessToken,
             PreviousPassword: oldPassword,
@@ -281,17 +277,17 @@ class Cognito {
     /**
      * Send to a user the instructions to change the password.
      */
-    async forgotPassword(email, cognitoUserPoolClientId) {
-        const command = new CognitoIP.ForgotPasswordCommand({ Username: email, ClientId: cognitoUserPoolClientId });
+    async forgotPassword(email, userPoolClientId) {
+        const command = new CognitoIP.ForgotPasswordCommand({ Username: email, ClientId: userPoolClientId });
         const { CodeDeliveryDetails } = await this.cognito.send(command);
         return CodeDeliveryDetails;
     }
     /**
      * Complete the flow of a password forgot.
      */
-    async confirmForgotPassword(email, newPassword, confirmationCode, cognitoUserPoolClientId) {
+    async confirmForgotPassword(email, newPassword, confirmationCode, userPoolClientId) {
         const command = new CognitoIP.ConfirmForgotPasswordCommand({
-            ClientId: cognitoUserPoolClientId,
+            ClientId: userPoolClientId,
             Username: email,
             ConfirmationCode: confirmationCode,
             Password: newPassword
@@ -301,17 +297,17 @@ class Cognito {
     /**
      * Update a (Cognito)User's attributes, excluding the attributes that require specific methods.
      */
-    async updateUser(user, cognitoUserPoolId) {
+    async updateUser(user, userPoolId) {
         const UserAttributes = [
             { Name: 'name', Value: user.name },
-            { Name: 'picture', Value: user.picture || '' }
+            { Name: 'picture', Value: user.picture ?? '' }
         ];
         Object.keys(user.attributes).forEach(customAttribute => UserAttributes.push({
             Name: 'custom:'.concat(customAttribute),
             Value: String(user.attributes[customAttribute])
         }));
         const command = new CognitoIP.AdminUpdateUserAttributesCommand({
-            UserPoolId: cognitoUserPoolId,
+            UserPoolId: userPoolId,
             Username: user.email,
             UserAttributes
         });
@@ -320,62 +316,62 @@ class Cognito {
     /**
      * Sign out the user from all devices.
      */
-    async globalSignOut(email, cognitoUserPoolId) {
-        const command = new CognitoIP.AdminUserGlobalSignOutCommand({ Username: email, UserPoolId: cognitoUserPoolId });
+    async globalSignOut(email, userPoolId) {
+        const command = new CognitoIP.AdminUserGlobalSignOutCommand({ Username: email, UserPoolId: userPoolId });
         await this.cognito.send(command);
     }
     /**
      * Confirm and conclude a registration, usign a confirmation code.
      */
-    async confirmSignUp(email, confirmationCode, cognitoUserPoolClientId) {
+    async confirmSignUp(email, confirmationCode, userPoolClientId) {
         if (!email)
             throw new Error('Invalid email');
         if (!confirmationCode)
             throw new Error('Invalid confirmation code');
-        if (!cognitoUserPoolClientId)
+        if (!userPoolClientId)
             throw new Error('Invalid client ID');
         const command = new CognitoIP.ConfirmSignUpCommand({
             Username: email,
             ConfirmationCode: confirmationCode,
-            ClientId: cognitoUserPoolClientId
+            ClientId: userPoolClientId
         });
         await this.cognito.send(command);
     }
     /**
      * List the groups of the user pool.
      */
-    async listGroups(cognitoUserPoolId, options = { groups: [] }) {
-        const params = { UserPoolId: cognitoUserPoolId };
+    async listGroups(userPoolId, options = { groups: [] }) {
+        const params = { UserPoolId: userPoolId };
         if (options.pagination)
             params.NextToken = options.pagination;
         const res = await this.cognito.send(new CognitoIP.ListGroupsCommand(params));
         const pagination = res.NextToken;
         const groups = options.groups.concat(res.Groups.map(g => ({ name: g.GroupName, description: g.Description })));
         if (pagination)
-            return await this.listGroups(cognitoUserPoolId, { pagination, groups });
+            return await this.listGroups(userPoolId, { pagination, groups });
         else
             return groups;
     }
     /**
      * Create a new group in the user pool.
      */
-    async createGroup(groupName, cognitoUserPoolId) {
-        const command = new CognitoIP.CreateGroupCommand({ GroupName: groupName, UserPoolId: cognitoUserPoolId });
+    async createGroup(groupName, userPoolId) {
+        const command = new CognitoIP.CreateGroupCommand({ GroupName: groupName, UserPoolId: userPoolId });
         await this.cognito.send(command);
     }
     /**
      * Delete a group from the user pool.
      */
-    async deleteGroup(groupName, cognitoUserPoolId) {
-        const command = new CognitoIP.DeleteGroupCommand({ GroupName: groupName, UserPoolId: cognitoUserPoolId });
+    async deleteGroup(groupName, userPoolId) {
+        const command = new CognitoIP.DeleteGroupCommand({ GroupName: groupName, UserPoolId: userPoolId });
         await this.cognito.send(command);
     }
     /**
      * List the users part of a group in the user pool.
      */
-    async listUsersInGroup(group, cognitoUserPoolId, options = { users: [] }) {
+    async listUsersInGroup(group, userPoolId, options = { users: [] }) {
         const params = {
-            UserPoolId: cognitoUserPoolId,
+            UserPoolId: userPoolId,
             GroupName: group
         };
         if (options.pagination)
@@ -384,17 +380,17 @@ class Cognito {
         const pagination = res.NextToken;
         const users = options.users.concat(res.Users.map(u => new idea_toolbox_1.CognitoUser(this.mapCognitoUserAttributesAsPlainObject(u))));
         if (pagination)
-            return await this.listUsersInGroup(group, cognitoUserPoolId, { pagination, users });
+            return await this.listUsersInGroup(group, userPoolId, { pagination, users });
         else
             return users;
     }
     /**
      * Add a user (by email) to a group in the user pool.
      */
-    async addUserToGroup(email, group, cognitoUserPoolId) {
-        const user = new idea_toolbox_1.CognitoUser(await this.getUserByEmail(email, cognitoUserPoolId));
+    async addUserToGroup(email, group, userPoolId) {
+        const user = new idea_toolbox_1.CognitoUser(await this.getUserByEmail(email, userPoolId));
         const command = new CognitoIP.AdminAddUserToGroupCommand({
-            UserPoolId: cognitoUserPoolId,
+            UserPoolId: userPoolId,
             GroupName: group,
             Username: user.userId
         });
@@ -403,10 +399,10 @@ class Cognito {
     /**
      * Remove a user (by email) from a group in the user pool.
      */
-    async removeUserFromGroup(email, group, cognitoUserPoolId) {
-        const user = new idea_toolbox_1.CognitoUser(await this.getUserByEmail(email, cognitoUserPoolId));
+    async removeUserFromGroup(email, group, userPoolId) {
+        const user = new idea_toolbox_1.CognitoUser(await this.getUserByEmail(email, userPoolId));
         const command = new CognitoIP.AdminRemoveUserFromGroupCommand({
-            UserPoolId: cognitoUserPoolId,
+            UserPoolId: userPoolId,
             GroupName: group,
             Username: user.userId
         });

package/dist/src/comprehend.d.ts

@@ -4,11 +4,8 @@ import { Sentiment } from 'idea-toolbox';
  * A wrapper for Amazon Comprehend.
  */
 export declare class Comprehend {
-    /**
-     * The instance of Comprehend.
-     */
     protected comprehend: AmazonComprehend.ComprehendClient;
-    constructor(params?: {
+    constructor(options?: {
         region?: string;
     });
     /**

package/dist/src/comprehend.js

@@ -29,8 +29,7 @@ const AmazonComprehend = __importStar(require("@aws-sdk/client-comprehend"));
  * A wrapper for Amazon Comprehend.
  */
 class Comprehend {
-    constructor(params) {
-        const options = Object.assign({}, params);
+    constructor(options = {}) {
         this.comprehend = new AmazonComprehend.ComprehendClient({ region: options.region });
     }
     /**
@@ -40,8 +39,8 @@ class Comprehend {
         if (!params.language || !params.text)
             throw new Error('Missing some parameters');
         const command = new AmazonComprehend.DetectSentimentCommand({ LanguageCode: params.language, Text: params.text });
-        const result = await this.comprehend.send(command);
-        return result.Sentiment;
+        const { Sentiment } = await this.comprehend.send(command);
+        return Sentiment;
     }
     /**
      * Determines the dominant language of the input text.
@@ -50,10 +49,10 @@ class Comprehend {
         if (!params.text)
             throw new Error('Missing text');
         const command = new AmazonComprehend.DetectDominantLanguageCommand({ Text: params.text });
-        const result = await this.comprehend.send(command);
-        if (!result.Languages.length)
+        const { Languages } = await this.comprehend.send(command);
+        if (!Languages.length)
             throw new Error('Not found');
-        return result.Languages[0].LanguageCode;
+        return Languages[0].LanguageCode;
     }
 }
 exports.Comprehend = Comprehend;

package/dist/src/dynamoDB.d.ts

@@ -1,29 +1,17 @@
 import * as DDB from '@aws-sdk/lib-dynamodb';
 import * as DDBUtils from '@aws-sdk/util-dynamodb';
-import { Logger } from './logger';
 /**
  * A wrapper for AWS DynamoDB.
  */
 export declare class DynamoDB {
     protected dynamo: DDB.DynamoDBDocument;
-    logger: Logger;
-    constructor(params?: {
-        debug?: boolean;
-    });
+    constructor();
     /**
      * Convert a JSON object from DynamoDB format to simple JSON.
      * @data the data in DynamoDB's original format to convert in plain objects
      * @options the options to use to convert the data
      */
     unmarshall(data: Record<string, any>, options?: DDBUtils.unmarshallOptions): Record<string, any>;
-    /**
-     * Returns an IUID: IDEA's Unique IDentifier, which is an id unique through an IDEA's AWS account and region.
-     * Note: no need of an auth check for external uses: the permissions depend from the context in which it's executed.
-     * @deprecated use IUNID instead (nano version)
-     * @param project project code
-     * @return the IUID
-     */
-    IUID(project: string): Promise<string>;
     /**
      * Returns an IUNID: IDEA's Unique Nano IDentifier, which is an id unique through an IDEA's AWS account and region.
      * Note: no need of an auth check for external uses: the permissions depend from the context in which it's executed.
@@ -31,14 +19,7 @@ export declare class DynamoDB {
      * @return the IUNID
      */
     IUNID(project: string): Promise<string>;
-    /**
-     * Returns an ISID: IDEA's Short IDentifier, which is a short, unique id intended to be used in small namespaces.
-     * Note: no need of an auth check for external uses: the permissions depend from the context in which it's executed.
-     * @param project project code
-     * @return the ISID
-     */
-    ISID(project: string): Promise<string>;
-    protected identifiersGeneratorHelper(project: string, type: 'IUNID' | 'IUID' | 'ISID', attempt: number, maxAttempts: number): Promise<string>;
+    protected IUNIDHelper(project: string, attempt: number, maxAttempts: number): Promise<string>;
     /**
      * Manage atomic counters (atomic autoincrement values) in IDEA's projects.
      * They key of an atomic counter should be composed as the following: `DynamoDBTableName_uniqueKey`.
@@ -113,7 +94,7 @@ export declare class DynamoDB {
      */
     scanClassic(params: DDB.ScanCommandInput): Promise<DDB.ScanCommandOutput>;
     /**
-     * Execute a series of max 10 write operations in a single transaction.
+     * Execute a series of write operations in a single transaction.
      * @param ops the operations to execute in the transaction
      */
     transactWrites(ops: {