Cannot destructure property 'environmentVariableSelector' of 'undefined' as it is undefined

[dotto95]

Checkboxes for prior research

• I've gone through Developer Guide and API reference
• I've checked AWS Forums and StackOverflow.
• I've searched for previous similar issues and didn't find any solution.

Describe the bug

I'm encountering a runtime error in a Next.js (v13+) API route that handles Stripe webhooks. The error occurs during the build/deployment process in AWS Amplify, and I can't pinpoint the exact cause.

TypeError: Cannot destructure property 'environmentVariableSelector' of 'undefined' as it is undefined.
at d (.next/server/chunks/5936.js:15:31351)
at eg (.next/server/chunks/5936.js:9:5315)
at new ex (.next/server/chunks/5936.js:9:6739)
at 11151 (.next/server/app/api/stripe/webhook/route.js:1:4571)

Regression Issue

• Select this option if this issue appears to be a regression.

SDK version number

@aws-sdk/client-cognito-identity-provider": "^3.654.0"

Which JavaScript Runtime is this issue in?

Node.js

Details of the browser/Node.js/ReactNative version

v21.1.0

Reproduction Steps

Stripe Webhook API Route: app/api/stripe/webhook/route.js

import { NextResponse } from "next/server";
import Stripe from "stripe";
import { updateUserGroupStripe } from "@/lib/actions/admin.action";

const stripe = new Stripe(process.env.STRIPE_SECRET_KEY);

export async function POST(req) {
  try {
    const text = await req.text();
    const sig = req.headers.get("stripe-signature");

    const event = stripe.webhooks.constructEvent(
      text,
      sig,
      process.env.STRIPE_WEBHOOK_SECRET
    );

    await updateUserGroupStripe(payload);

    return NextResponse.json({ received: true });
  } catch (err) {
    console.error(`❌ Error:`, err.message);
    return NextResponse.json({ error: err.message }, { status: 400 });
  }
}

updateUserGroupStripe function (uses Cognito SDK v3):

import {
  CognitoIdentityProviderClient,
  AdminUpdateUserAttributesCommand,
} from "@aws-sdk/client-cognito-identity-provider";

const client = new CognitoIdentityProviderClient({
  region: process.env.COGNITO_REGION,
  credentials: {
    accessKeyId: process.env.COGNITO_ACCESS_KEY_ID,
    secretAccessKey: process.env.COGNITO_ACCESS_SECRET,
  },
});

export async function updateUserGroupStripe({ username, ... }) {
  const command = new AdminUpdateUserAttributesCommand({
    UserPoolId: process.env.COGNITO_USER_POOL_ID,
    Username: username,
    UserAttributes: attributesToUpdate,
  });

  await client.send(command);
}

All required environment variables are configured correctly in AWS Amplify and are accessible locally.

Observed Behavior

-Error only occurs in Amplify build

• locally works fine with the same .env configuration
• seems like something internal in the SDK is relying on environmentVariableSelector, but it is undefined

Expected Behavior

Handle missing internal config defaults gracefully

Possible Solution

No response

Additional Information/Context

No response

[kuhe]

The only place I see a destructuring attempt on something containing environmentVariableSelector is the loadConfig function from @smithy/node-config-provider. This is used to load AWS SDK configuration from the typical sources, i.e. the equivalent environment variable and AWS configuration file variable, such as AWS_REGION (env) and region (config file).

Because this function is used to load many different configuration types, region being only one example, we would like to have your non-minified stack trace. As far as I can tell, the SDK does not call this function with an undefined input, and the type compilation step also helps prevent this.

Your package-lock.json or equivalent file would also be helpful, since version mismatch and nested duplicates may be the cause.

[dotto95]

Thank you @kuhe

This is the admin.action.js:

"use server";
import {
  CognitoIdentityProviderClient,
  AdminAddUserToGroupCommand,
  AdminRemoveUserFromGroupCommand,
  AdminListGroupsForUserCommand,
  AdminUpdateUserAttributesCommand,
} from "@aws-sdk/client-cognito-identity-provider";

import {
  SUBSCRIPTION_TIER_PRO,
  SUBSCRIPTION_TIER_FREE,
  SUBSCRIPTION_ACTION_DOWNGRADE,
  SUBSCRIPTION_ACTION_CANCEL,
  SUBSCRIPTION_ACTION_SUSPEND,
  SUBSCRIPTION_ACTION_UPGRADE,
  SUBSCRIPTION_ACTION_EXPIRATION,
  SUBSCRIPTION_TIER_PREMIUM,
} from "@/components/constants/subscriptionTiers";

const planLevelMapping = {
...............
};

const getSubscriptionTier = (planId) => {
  return planLevelMapping[planId] || "UNKNOWN_TIER";
};

// Funzione per costruire attributi utente
function buildUserAttributes(
  subscriptionId,
  subscriptionPlanId,
  subscriptionNextBillingTime,
  customer_id
) {
  const userAttributes = [];

  if (subscriptionId) {
    userAttributes.push({
      Name: "custom:subscription-id",
      Value: subscriptionId,
    });
  }

  if (subscriptionPlanId) {
    userAttributes.push({
      Name: "custom:subscription-plan-id",
      Value: subscriptionPlanId,
    });
  }

  if (subscriptionNextBillingTime) {
    userAttributes.push({
      Name: "custom:subscription-enddate",
      Value: subscriptionNextBillingTime,
    });
  }

  if (customer_id) {
    userAttributes.push({
      Name: "custom:stripe-customer",
      Value: customer_id,
    });
  }

  return userAttributes;
}

// Funzione principale per aggiornare i gruppi utente e attributi
export async function updateUserGroup({
  username,
  subscription_id,
  subscription_plan_id,
  subscription_next_billing_time,
  action,
}) {
  console.log(
    username,
    subscription_id,
    subscription_plan_id,
    subscription_next_billing_time,
    action
  );

  // Verifica che l'azione sia valida
  const validActions = [
    SUBSCRIPTION_ACTION_DOWNGRADE,
    SUBSCRIPTION_ACTION_UPGRADE,
    SUBSCRIPTION_ACTION_SUSPEND,
    SUBSCRIPTION_ACTION_CANCEL,
    SUBSCRIPTION_ACTION_EXPIRATION,
  ];

  if (!action || !validActions.includes(action)) {
    console.error("Azione non valida: ", action);
    return { success: false, error: "Azione non valida" };
  }

  const client = new CognitoIdentityProviderClient({
    region: process.env.COGNITO_REGION,
    credentials: {
      accessKeyId: process.env.COGNITO_ACCESS_KEY_ID,
      secretAccessKey: process.env.COGNITO_ACCESS_SECRET,
    },
  });

  const userPoolId = process.env.COGNITO_USERPOOL_ID;

  const group = getSubscriptionTier(subscription_plan_id);
  console.log("GRUPPO: ", group);

  // Definiamo comandi di default
  let removeCommand = null;
  let addCommand = null;

  // Logica per aggiornare il gruppo utente in base all'azione
  switch (action) {
    case SUBSCRIPTION_ACTION_UPGRADE:
      // Upgrade: da FREE a PRO
      removeCommand = new AdminRemoveUserFromGroupCommand({
        UserPoolId: userPoolId,
        Username: username,
        GroupName: SUBSCRIPTION_TIER_FREE,
      });
      addCommand = new AdminAddUserToGroupCommand({
        UserPoolId: userPoolId,
        Username: username,
        GroupName: group,
      });
      break;

    case SUBSCRIPTION_ACTION_DOWNGRADE:
    case SUBSCRIPTION_ACTION_CANCEL:
      break;
    case SUBSCRIPTION_ACTION_SUSPEND:
    case SUBSCRIPTION_ACTION_EXPIRATION:
      // expiration: rimuove utente dal gruppo PRO, aggiunge al FREE
      removeCommand = new AdminRemoveUserFromGroupCommand({
        UserPoolId: userPoolId,
        Username: username,
        GroupName: group,
      });

      addCommand = new AdminAddUserToGroupCommand({
        UserPoolId: userPoolId,
        Username: username,
        GroupName: SUBSCRIPTION_TIER_FREE,
      });

      break;

    default:
      console.error("Azione non gestita: ", action);
      return { success: false, error: "Azione non gestita" };
  }

  // Costruisce gli attributi da aggiornare
  const attributesToUpdate = buildUserAttributes(
    subscription_id,
    subscription_plan_id,
    subscription_next_billing_time
  );

  const updateAttributesCommand = new AdminUpdateUserAttributesCommand({
    UserPoolId: userPoolId,
    Username: username,
    UserAttributes: attributesToUpdate,
  });

  try {
    // Esegui il comando di rimozione gruppo
    if (removeCommand) {
      await client.send(removeCommand);
      console.log(`Utente rimosso dal gruppo: ${action}`);
    }

    // Esegui il comando di aggiunta gruppo (se necessario)
    if (addCommand) {
      await client.send(addCommand);
      console.log(`Utente aggiunto al nuovo gruppo: ${action}`);
    }

    // Aggiorna gli attributi dell'utente
    await client.send(updateAttributesCommand);
    console.log("Attributi utente aggiornati con successo");

    return { success: true };
  } catch (error) {
    console.error("Errore durante l'aggiornamento: ", error);
    return { success: false, error };
  }
}

async function removeUserFromAllGroups(client, userPoolId, username) {
  const listCmd = new AdminListGroupsForUserCommand({
    Username: username,
    UserPoolId: userPoolId,
  });

  const { Groups } = await client.send(listCmd);

  if (!Groups || Groups.length === 0) return;

  for (const group of Groups) {
    await client.send(
      new AdminRemoveUserFromGroupCommand({
        Username: username,
        UserPoolId: userPoolId,
        GroupName: group.GroupName,
      })
    );
  }
}

export async function updateUserGroupStripe({
  username,
  subscription_id,
  subscription_plan_id,
  subscription_next_billing_time,
  customer_id,
  action,
  group,
}) {
  console.log("[updateUserGroupStripe] START", {
    username,
    subscription_id,
    subscription_plan_id,
    subscription_next_billing_time,
    customer_id,
    action,
    group,
  });

  const validActions = [
    SUBSCRIPTION_ACTION_DOWNGRADE,
    SUBSCRIPTION_ACTION_UPGRADE,
    SUBSCRIPTION_ACTION_SUSPEND,
    SUBSCRIPTION_ACTION_CANCEL,
    SUBSCRIPTION_ACTION_EXPIRATION,
  ];

  if (!action || !validActions.includes(action)) {
    const errorMsg = `Azione non valida: ${action}`;
    console.error(errorMsg);
    return { success: false, error: errorMsg };
  }

  const client = new CognitoIdentityProviderClient({
    region: process.env.COGNITO_REGION,
    credentials: {
      accessKeyId: process.env.COGNITO_ACCESS_KEY_ID,
      secretAccessKey: process.env.COGNITO_ACCESS_SECRET,
    },
  });

  const userPoolId = process.env.COGNITO_USERPOOL_ID;

  try {
    // Rimuovi sempre da tutti i gruppi per evitare conflitti
    await removeUserFromAllGroups(client, userPoolId, username);

    let groupToAdd = null;

    switch (action) {
      case SUBSCRIPTION_ACTION_UPGRADE:
        groupToAdd = group;
        break;

      case SUBSCRIPTION_ACTION_SUSPEND:
      case SUBSCRIPTION_ACTION_EXPIRATION:
        groupToAdd = SUBSCRIPTION_TIER_FREE;
        break;

      case SUBSCRIPTION_ACTION_DOWNGRADE:
      case SUBSCRIPTION_ACTION_CANCEL:
        // Nessuna aggiunta a nuovi gruppi
        break;

      default:
        const errorMsg = `Azione non gestita: ${action}`;
        console.error(errorMsg);
        return { success: false, error: errorMsg };
    }

    if (groupToAdd) {
      await client.send(
        new AdminAddUserToGroupCommand({
          UserPoolId: userPoolId,
          Username: username,
          GroupName: groupToAdd,
        })
      );
      console.log(`Utente ${username} aggiunto al gruppo ${groupToAdd}`);
    }

    const attributesToUpdate = buildUserAttributes(
      subscription_id,
      subscription_plan_id,
      subscription_next_billing_time,
      customer_id
    );

    await client.send(
      new AdminUpdateUserAttributesCommand({
        UserPoolId: userPoolId,
        Username: username,
        UserAttributes: attributesToUpdate,
      })
    );

    console.log("Attributi aggiornati con successo");

    return { success: true };
  } catch (err) {
    console.error("Errore durante l'aggiornamento utente:", err);
    return { success: false, error: err.message || "Errore generico" };
  }
}

my package.json:

{
  "name": "app-ui",
  "version": "0.1.0",
  "license": "UNLICENSED",
  "private": true,
  "scripts": {
    "dev": "next dev --turbopack",
    "build": "next build",
    "start": "next start",
    "lint": "next lint",
    "format": "prettier --check --ignore-path .gitignore .",
    "format:fix": "prettier --write --ignore-path .gitignore .",
    "precommit": "yarn format:fix && yarn lint && yarn build",
    "prepare": "husky",
    "expose": "ngrok http 3000"
  },
  "dependencies": {
    "@aws-amplify/adapter-nextjs": "1.3.0",
    "@aws-sdk/client-cognito-identity-provider": "^3.654.0",
    "@aws-sdk/client-ses": "^3.699.0",
    "@hookform/resolvers": "^3.6.0",
    "@next/third-parties": "15.3.1",
    "@nivo/core": "^0.93.0",
    "@nivo/line": "^0.93.0",
    "@radix-ui/react-accordion": "^1.2.1",
    "@radix-ui/react-alert-dialog": "^1.1.1",
    "@radix-ui/react-avatar": "^1.1.1",
    "@radix-ui/react-checkbox": "^1.0.4",
    "@radix-ui/react-collapsible": "^1.0.3",
    "@radix-ui/react-dialog": "^1.1.2",
    "@radix-ui/react-dropdown-menu": "^2.0.6",
    "@radix-ui/react-hover-card": "^1.1.1",
    "@radix-ui/react-icons": "^1.3.0",
    "@radix-ui/react-label": "^2.1.0",
    "@radix-ui/react-navigation-menu": "^1.2.1",
    "@radix-ui/react-popover": "^1.1.2",
    "@radix-ui/react-progress": "^1.1.2",
    "@radix-ui/react-radio-group": "^1.2.0",
    "@radix-ui/react-scroll-area": "^1.1.0",
    "@radix-ui/react-select": "^2.1.1",
    "@radix-ui/react-separator": "^1.1.0",
    "@radix-ui/react-slider": "^1.2.0",
    "@radix-ui/react-slot": "^1.1.0",
    "@radix-ui/react-switch": "^1.1.0",
    "@radix-ui/react-tabs": "^1.0.4",
    "@radix-ui/react-toast": "^1.1.5",
    "@radix-ui/react-toggle": "^1.1.0",
    "@radix-ui/react-toggle-group": "^1.1.0",
    "@radix-ui/react-tooltip": "^1.1.4",
    "@stripe/react-stripe-js": "^3.6.0",
    "@stripe/stripe-js": "^7.1.0",
    "@tailwindcss/typography": "^0.5.15",
    "@tanstack/react-table": "^8.19.3",
    "@typescript-eslint/parser": "^7.9.0",
    "apexcharts": "^3.49.2",
    "autoprefixer": "^10.4.19",
    "aws-amplify": "6.10.3",
    "buffer": "^6.0.3",
    "class-variance-authority": "^0.7.1",
    "clsx": "^2.1.1",
    "cmdk": "1.0.0",
    "date-fns": "^3.6.0",
    "embla-carousel-react": "^8.2.0",
    "framer-motion": "^12.0.6",
    "lightweight-charts": "^4.1.4",
    "lucide-react": "^0.462.0",
    "next": "15.3.1",
    "next-intl": "^4.1.0",
    "next-themes": "^0.3.0",
    "nodemailer": "^6.9.16",
    "pako": "^2.1.0",
    "query-string": "^9.1.1",
    "react": "19.1.0",
    "react-country-flag": "^3.1.0",
    "react-day-picker": "^8.10.1",
    "react-dom": "19.1.0",
    "react-hook-form": "^7.51.5",
    "react-intersection-observer": "^9.16.0",
    "react-wrap-balancer": "^1.1.1",
    "rechart": "^0.0.1",
    "recharts": "^2.15.3",
    "shadcn-ui": "^0.8.0",
    "stripe": "^18.0.0",
    "tailwind-merge": "^2.3.0",
    "tailwindcss-animate": "^1.0.7",
    "typescript": "^5.4.5",
    "zod": "^3.23.8",
    "zustand": "^4.5.2"
  },
  "devDependencies": {
    "@next/eslint-plugin-next": "15.3.1",
    "@types/node": "20.14.2",
    "eslint": "^8.41.0",
    "eslint-config-next": "15.3.1",
    "eslint-config-prettier": "^9.1.0",
    "husky": "^9.0.11",
    "ngrok": "^5.0.0-beta.2",
    "postcss": "^8",
    "prettier": "^3.2.5",
    "prettier-plugin-tailwindcss": "0.5.14",
    "tailwindcss": "^3.4.1"
  }
}

Attached yarn.lock

yarn.lock.txt

[kuhe]

Thanks, I see the amplify packages are using @aws-sdk/client-* packages with version 3.621.0 and you have a later version in direct use.

Could you find a non-minified stack trace of the error?

Another thing to try, and I'm mostly guessing here, is to change your own SDK clients to the same version as used by Amplify, to see if the issue is caused by node_modules nesting.

    "@aws-sdk/client-cognito-identity-provider": "<=3.621.0",
    "@aws-sdk/client-ses": "<=3.621.0",

[dotto95]

Solved using the SDK version suggested:

   "@aws-sdk/client-cognito-identity-provider": "<=3.621.0",
    "@aws-sdk/client-ses": "<=3.621.0",

Thank you @kuhe

[github-actions]

This issue is now closed. Comments on closed issues are hard for our team to see.
If you need more assistance, please open a new issue that references this one.

[github-actions]

This thread has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related bugs and link to relevant comments in this thread.