@unchainedshop/api 4.0.0-rc.9 → 4.0.1

package/src/mcp/tools/users/handlers/enrollUser.ts

@@ -0,0 +1,19 @@
+import { Context } from '../../../../context.js';
+import { Params } from '../schemas.js';
+import { getNormalizedUserDetails } from '../../../utils/getNormalizedUserDetails.js';
+
+export default async function enrollUser(context: Context, params: Params<'ENROLL'>) {
+  const { modules } = context;
+  const { email, profile, password } = params;
+
+  const userId = await modules.users.createUser({
+    email,
+    password: password || null,
+    ...profile,
+  });
+
+  if (!password) {
+    await modules.users.sendResetPasswordEmail(userId, email, true);
+  }
+  return { user: await getNormalizedUserDetails(userId, context) };
+}

package/src/mcp/tools/users/handlers/getCurrentUser.ts

@@ -0,0 +1,7 @@
+import { Context } from '../../../../context.js';
+import { getNormalizedUserDetails } from '../../../utils/getNormalizedUserDetails.js';
+
+export default async function getCurrentUser(context: Context) {
+  const { userId } = context;
+  return { user: await getNormalizedUserDetails(userId!, context) };
+}

package/src/mcp/tools/users/handlers/getUser.ts

@@ -0,0 +1,13 @@
+import { Context } from '../../../../context.js';
+import { Params } from '../schemas.js';
+import { getNormalizedUserDetails } from '../../../utils/getNormalizedUserDetails.js';
+
+export default async function getUser(context: Context, params: Params<'GET'>) {
+  const { userId } = params;
+
+  if (!userId) {
+    return { user: null };
+  }
+  const user = await getNormalizedUserDetails(userId, context);
+  return { user };
+}

package/src/mcp/tools/users/handlers/getUserAvatar.ts

@@ -0,0 +1,18 @@
+import { Context } from '../../../../context.js';
+import normalizeMediaUrl from '../../../utils/normalizeMediaUrl.js';
+import { Params } from '../schemas.js';
+
+export default async function getUserAvatar(context: Context, params: Params<'GET_AVATAR'>) {
+  const { modules, loaders } = context;
+  const { userId } = params;
+  const user = await modules.users.findUserById(userId);
+  if (!user?.avatarId) {
+    return null;
+  }
+
+  const avatar = await loaders.fileLoader.load({
+    fileId: user.avatarId,
+  });
+
+  return { avatar: await normalizeMediaUrl([{ mediaId: avatar._id as string } as any], context) };
+}

package/src/mcp/tools/users/handlers/getUserBookmarks.ts

@@ -0,0 +1,16 @@
+import { Context } from '../../../../context.js';
+import { getNormalizedProductDetails } from '../../../utils/getNormalizedProductDetails.js';
+import { Params } from '../schemas.js';
+
+export default async function getUserBookmarks(context: Context, params: Params<'GET_BOOKMARKS'>) {
+  const { modules } = context;
+  const { userId } = params;
+  const bookmarks = await modules.bookmarks.findBookmarksByUserId(userId);
+  const normalizedBookmarks = await Promise.all(
+    bookmarks.map(async ({ productId, ...bookmark }) => ({
+      ...(await getNormalizedProductDetails(productId, context)),
+      ...bookmark,
+    })),
+  );
+  return { bookmarks: normalizedBookmarks };
+}

package/src/mcp/tools/users/handlers/getUserEnrollments.ts

@@ -0,0 +1,25 @@
+import { Context } from '../../../../context.js';
+import { getNormalizedProductDetails } from '../../../utils/getNormalizedProductDetails.js';
+import { Params } from '../schemas.js';
+
+export default async function getUserEnrollments(context: Context, params: Params<'GET_ENROLLMENTS'>) {
+  const { modules } = context;
+  const { userId, sort, queryString, status, limit = 10, offset = 0 } = params;
+
+  const enrollments = await modules.enrollments.findEnrollments({
+    userId,
+    queryString,
+    status,
+    offset,
+    limit,
+    sort,
+  } as any);
+
+  const normalizedEnrollments = await Promise.all(
+    enrollments.map(async ({ productId, ...enrollment }) => ({
+      ...(await getNormalizedProductDetails(productId, context)),
+      ...enrollment,
+    })),
+  );
+  return { enrollments: normalizedEnrollments };
+}

package/src/mcp/tools/users/handlers/getUserOrders.ts

@@ -0,0 +1,31 @@
+import { Context } from '../../../../context.js';
+import { getNormalizedOrderDetails } from '../../../utils/getNormalizedOrderDetails.js';
+import { Params } from '../schemas.js';
+
+export default async function getUserOrders(context: Context, params: Params<'GET_ORDERS'>) {
+  const { modules } = context;
+  const { userId, includeCarts = false, sort, queryString, status, limit = 10, offset = 0 } = params;
+
+  const orders = await modules.orders.findOrders(
+    {
+      userId,
+      includeCarts,
+      queryString,
+      status,
+    } as any,
+    {
+      skip: offset,
+      limit,
+      sort: sort?.reduce((acc, s) => {
+        acc[s.key] = s.value;
+        return acc;
+      }, {} as any),
+    },
+  );
+
+  return {
+    orders: await Promise.all(
+      orders.map(async ({ _id }) => getNormalizedOrderDetails({ orderId: _id }, context)),
+    ),
+  };
+}

package/src/mcp/tools/users/handlers/getUserPaymentCredentials.ts

@@ -0,0 +1,20 @@
+import { Context } from '../../../../context.js';
+import { Params } from '../schemas.js';
+
+export default async function getUserPaymentCredentials(
+  context: Context,
+  params: Params<'GET_PAYMENT_CREDENTIALS'>,
+) {
+  const { modules } = context;
+  const { userId } = params;
+  const credentials = await modules.payment.paymentCredentials.findPaymentCredentials(
+    { userId },
+    {
+      sort: {
+        created: -1,
+      },
+    },
+  );
+
+  return { credentials };
+}

package/src/mcp/tools/users/handlers/getUserQuotations.ts

@@ -0,0 +1,32 @@
+import { Context } from '../../../../context.js';
+import { getNormalizedProductDetails } from '../../../utils/getNormalizedProductDetails.js';
+import { Params } from '../schemas.js';
+
+export default async function getUserQuotations(context: Context, params: Params<'GET_QUOTATIONS'>) {
+  const { modules } = context;
+  const { userId, sort, queryString, limit = 10, offset = 0 } = params;
+
+  const quotations = await modules.quotations.findQuotations(
+    {
+      userId,
+      queryString,
+    },
+    {
+      skip: offset,
+      limit,
+      sort: sort?.reduce((acc, s) => {
+        acc[s.key] = s.value;
+        return acc;
+      }, {} as any),
+    },
+  );
+
+  const normalizedQuotations = await Promise.all(
+    quotations.map(async ({ productId, ...quotation }) => ({
+      ...(await getNormalizedProductDetails(productId, context)),
+      ...quotation,
+    })),
+  );
+
+  return { quotations: normalizedQuotations };
+}

package/src/mcp/tools/users/handlers/getUserReviews.ts

@@ -0,0 +1,22 @@
+import { Context } from '../../../../context.js';
+import { getNormalizedProductDetails } from '../../../utils/getNormalizedProductDetails.js';
+import { Params } from '../schemas.js';
+
+export default async function getUserReviews(context: Context, params: Params<'GET_REVIEWS'>) {
+  const { modules } = context;
+  const { userId, sort, limit = 10, offset = 0 } = params;
+
+  const reviews = await modules.products.reviews.findProductReviews({
+    authorId: userId,
+    offset,
+    limit,
+    sort,
+  } as any);
+  const normalizedReviews = await Promise.all(
+    reviews.map(async ({ productId, ...review }) => ({
+      ...(await getNormalizedProductDetails(productId, context)),
+      ...review,
+    })),
+  );
+  return { reviews: normalizedReviews };
+}

package/src/mcp/tools/users/handlers/getUserReviewsCount.ts

@@ -0,0 +1,15 @@
+import { Context } from '../../../../context.js';
+import { Params } from '../schemas.js';
+
+export default async function getUserReviewsCount(
+  context: Context,
+  params: Params<'GET_REVIEWS_COUNT'>,
+) {
+  const { modules } = context;
+  const { userId } = params;
+  const count = await modules.products.reviews.count({
+    authorId: userId,
+  });
+
+  return { count };
+}

package/src/mcp/tools/users/handlers/index.ts

@@ -0,0 +1,49 @@
+import listUsers from './listUsers.js';
+import countUsers from './countUsers.js';
+import getUser from './getUser.js';
+import createUser from './createUser.js';
+import updateUser from './updateUser.js';
+import removeUser from './removeUser.js';
+import enrollUser from './enrollUser.js';
+import setUserTags from './setUserTags.js';
+import setUserUsername from './setUserUsername.js';
+import addUserEmail from './addUserEmail.js';
+import removeUserEmail from './removeUserEmail.js';
+import sendEnrollmentEmail from './sendEnrollmentEmail.js';
+import sendVerificationEmail from './sendVerificationEmail.js';
+import removeProductReviews from './removeProductReviews.js';
+import getUserOrders from './getUserOrders.js';
+import getUserEnrollments from './getUserEnrollments.js';
+import getUserQuotations from './getUserQuotations.js';
+import getUserBookmarks from './getUserBookmarks.js';
+import getUserPaymentCredentials from './getUserPaymentCredentials.js';
+import getUserAvatar from './getUserAvatar.js';
+import getUserReviews from './getUserReviews.js';
+import getUserReviewsCount from './getUserReviewsCount.js';
+import getCurrentUser from './getCurrentUser.js';
+
+export default {
+  LIST: listUsers,
+  COUNT: countUsers,
+  GET: getUser,
+  CREATE: createUser,
+  UPDATE: updateUser,
+  REMOVE: removeUser,
+  ENROLL: enrollUser,
+  SET_TAGS: setUserTags,
+  SET_USERNAME: setUserUsername,
+  ADD_EMAIL: addUserEmail,
+  REMOVE_EMAIL: removeUserEmail,
+  SEND_ENROLLMENT_EMAIL: sendEnrollmentEmail,
+  SEND_VERIFICATION_EMAIL: sendVerificationEmail,
+  REMOVE_PRODUCT_REVIEWS: removeProductReviews,
+  GET_ORDERS: getUserOrders,
+  GET_ENROLLMENTS: getUserEnrollments,
+  GET_QUOTATIONS: getUserQuotations,
+  GET_BOOKMARKS: getUserBookmarks,
+  GET_PAYMENT_CREDENTIALS: getUserPaymentCredentials,
+  GET_AVATAR: getUserAvatar,
+  GET_REVIEWS: getUserReviews,
+  GET_REVIEWS_COUNT: getUserReviewsCount,
+  GET_CURRENT_USER: getCurrentUser,
+};

package/src/mcp/tools/users/handlers/listUsers.ts

@@ -0,0 +1,29 @@
+import { Context } from '../../../../context.js';
+import { Params } from '../schemas.js';
+import { getNormalizedUserDetails } from '../../../utils/getNormalizedUserDetails.js';
+
+export default async function listUsers(context: Context, params: Params<'LIST'>) {
+  const { modules } = context;
+  const {
+    limit = 20,
+    offset = 0,
+    includeGuests = false,
+    queryString,
+    sort,
+    emailVerified,
+    lastLogin,
+  } = params;
+
+  const users = await modules.users.findUsers({
+    includeGuests,
+    queryString,
+    emailVerified,
+    lastLogin,
+    limit,
+    offset,
+    sort,
+  } as any);
+  return {
+    users: await Promise.all(users.map(async ({ _id }) => getNormalizedUserDetails(_id, context))),
+  };
+}

package/src/mcp/tools/users/handlers/removeProductReviews.ts

@@ -0,0 +1,12 @@
+import { Context } from '../../../../context.js';
+import { Params } from '../schemas.js';
+
+export default async function removeProductReviews(
+  context: Context,
+  params: Params<'REMOVE_PRODUCT_REVIEWS'>,
+) {
+  const { modules } = context;
+  const { userId } = params;
+  await modules.products.reviews.deleteMany({ authorId: userId });
+  return { success: true };
+}

package/src/mcp/tools/users/handlers/removeUser.ts

@@ -0,0 +1,17 @@
+import { Context } from '../../../../context.js';
+import { Params } from '../schemas.js';
+
+export default async function removeUser(context: Context, params: Params<'REMOVE'>) {
+  const { modules } = context;
+  const { userId, removeUserReviews } = params;
+
+  if (!userId) {
+    throw new Error('userId is required');
+  }
+  if (removeUserReviews) {
+    await modules.products.reviews.deleteMany({ authorId: userId });
+  }
+  await modules.users.markDeleted(userId);
+  await modules.users.findUserById(userId);
+  return { success: true };
+}

package/src/mcp/tools/users/handlers/removeUserEmail.ts

@@ -0,0 +1,11 @@
+import { Context } from '../../../../context.js';
+import { Params } from '../schemas.js';
+
+export default async function removeUserEmail(context: Context, params: Params<'REMOVE_EMAIL'>) {
+  const { modules } = context;
+  const { userId, email } = params;
+
+  await modules.users.removeEmail(userId!, email);
+  await modules.users.findUserById(userId!);
+  return { success: true };
+}

package/src/mcp/tools/users/handlers/sendEnrollmentEmail.ts

@@ -0,0 +1,15 @@
+import { Context } from '../../../../context.js';
+import { Params } from '../schemas.js';
+
+export default async function sendEnrollmentEmail(
+  context: Context,
+  params: Params<'SEND_ENROLLMENT_EMAIL'>,
+) {
+  const { modules } = context;
+  const { email } = params;
+  const user = await modules.users.findUserByEmail(email);
+  if (user) {
+    await modules.users.sendResetPasswordEmail(user._id, email, true);
+  }
+  return { success: !!user };
+}

package/src/mcp/tools/users/handlers/sendVerificationEmail.ts

@@ -0,0 +1,19 @@
+import { Context } from '../../../../context.js';
+import { Params } from '../schemas.js';
+
+export default async function sendVerificationEmail(
+  context: Context,
+  params: Params<'SEND_VERIFICATION_EMAIL'>,
+) {
+  const { modules } = context;
+  const { email } = params;
+  const targetEmail = email || context.user?.emails?.[0]?.address;
+  if (!targetEmail) {
+    throw new Error('No email provided or user has no email');
+  }
+  const user = await modules.users.findUserByEmail(targetEmail);
+  if (user) {
+    await modules.users.sendVerificationEmail(user._id, targetEmail);
+  }
+  return { success: !!user };
+}

package/src/mcp/tools/users/handlers/setUserTags.ts

@@ -0,0 +1,11 @@
+import { Context } from '../../../../context.js';
+import { Params } from '../schemas.js';
+import { getNormalizedUserDetails } from '../../../utils/getNormalizedUserDetails.js';
+
+export default async function setUserTags(context: Context, params: Params<'SET_TAGS'>) {
+  const { modules } = context;
+  const { userId, tags } = params;
+
+  await modules.users.updateTags(userId, tags);
+  return { user: await getNormalizedUserDetails(userId, context) };
+}

package/src/mcp/tools/users/handlers/setUserUsername.ts

@@ -0,0 +1,11 @@
+import { Context } from '../../../../context.js';
+import { Params } from '../schemas.js';
+import { getNormalizedUserDetails } from '../../../utils/getNormalizedUserDetails.js';
+
+export default async function setUserUsername(context: Context, params: Params<'SET_USERNAME'>) {
+  const { modules } = context;
+  const { userId, username } = params;
+
+  await modules.users.setUsername(userId, username);
+  return { user: await getNormalizedUserDetails(userId, context) };
+}

package/src/mcp/tools/users/handlers/updateUser.ts

@@ -0,0 +1,11 @@
+import { Context } from '../../../../context.js';
+import { Params } from '../schemas.js';
+import { getNormalizedUserDetails } from '../../../utils/getNormalizedUserDetails.js';
+
+export default async function updateUser(context: Context, params: Params<'UPDATE'>) {
+  const { modules } = context;
+  const { userId, profile, meta } = params;
+
+  await modules.users.updateProfile(userId, { profile, meta } as any);
+  return { user: await getNormalizedUserDetails(userId, context) };
+}

package/src/mcp/tools/users/index.ts

@@ -0,0 +1,12 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { Context } from '../../../context.js';
+import { usersManagement, UsersManagementSchema } from './usersManagement.js';
+
+export const registerUsersTools = (server: McpServer, context: Context) => {
+  server.tool(
+    'users_management',
+    'Comprehensive user management system for Unchained e-commerce platform. Core operations: LIST (paginated user listing with filters for guests, email verification, last login dates), COUNT (user count with same filters), GET (retrieve user by ID), CREATE (new user with optional profile), UPDATE (profile/metadata updates), REMOVE (soft delete with optional review cleanup), ENROLL (create user + send enrollment email). User administration: SET_ROLES (assign admin/editor roles), SET_TAGS (categorization tags), SET_PASSWORD (admin password reset), SET_USERNAME (username changes). Email management: ADD_EMAIL/REMOVE_EMAIL (multi-email support), SEND_ENROLLMENT_EMAIL (trigger enrollment), SEND_VERIFICATION_EMAIL (email verification). Data access: GET_ORDERS (user order history with cart inclusion), GET_ENROLLMENTS (subscription enrollments), GET_QUOTATIONS (price quotes), GET_BOOKMARKS (saved products), GET_CART (active user cart), GET_PAYMENT_CREDENTIALS (stored payment methods), GET_AVATAR (profile image), GET_REVIEWS/GET_REVIEWS_COUNT (product reviews), REMOVE_PRODUCT_REVIEWS (bulk review cleanup), GET_CURRENT_USER (current session logged in user). Supports pagination, sorting, filtering, date ranges, and proper validation for all operations.',
+    UsersManagementSchema,
+    async (params) => usersManagement(context, params),
+  );
+};