dm-driver-cognito v1.6.0

Welcome to dm-driver-cognito 👋

A Data Migration driver to query/modify a cognito user pool.

Configuration

Parameters

The DynamoDB driver accepts the following parameters as part of its configuration:

Example

The following configuration creates a Cognito driver that connects to a user pool in the us-east-1 stack some-stack-name.

module.exports = {
  defaultStage: "prod",
  migrationDirectory: "migrations",
  stages: {
    prod: {
      defaultParams: {
        region: "us-east-1",
      },
      drivers: {
        users: {
          driver: require("dm-driver-cognito"),
          params: {
            userPoolDriver: {
              // Use this processor to get values from CloudFormation
              processor: require("dm-processor-cf"),
              params: {
                stack: "some-stack-name",
                output: "SomeOutputName",
              },
            },
          },
        },
      },
    },
  },
};

Methods

addUser

Creates a new user in the user pool

Arguments

Example

This example creates a new user for "Bill Lumbergh"

async up(context: ScriptContext, log: Logger) {
  const userPool = await context.getDriver<UserPoolDriver>("userPoolDriver");
  await userPool.addUser("blumbergh", "password", { UserAttributes: [
    Name: "email",
    Value: "blumbergh@initech.com"
  ]});
}

getUser

Queries for a user based on their username

Arguments

Example

Look for the previously created user blumberg

async up(context: ScriptContext, log: Logger) {
  const userPool = await context.getDriver<UserPoolDriver>("userPoolDriver");
  const user = await userPool.getUser("blumbergh");
}

deleteUser

Removes the given username from the user pool

Arguments

Example

Delete the previously created user blumberg

async up(context: ScriptContext, log: Logger) {
  const userPool = await context.getDriver<UserPoolDriver>("userPoolDriver");
  const user = await userPool.deleteUser("blumbergh");
}