@modyo/mcp 0.1.0

package/build/tools/customers/users/BulkManageUsers.js

@@ -0,0 +1,253 @@
+import { RealmsRepository } from "../../../repositories/customers/realms/RealmsRepository.js";
+import { UsersRepository } from "../../../repositories/customers/users/UsersRepository.js";
+import { cleanObject, ToolBase } from "../../../shared/index.js";
+import { z } from "zod";
+const customFieldSchema = z.object({
+    user_custom_field_id: z.number().min(1).describe("Custom field ID"),
+    value: z
+        .union([
+        z.string(),
+        z.number(),
+        z.boolean(),
+    ])
+        .describe("Custom field value"),
+});
+const userSchema = z.object({
+    email: z.string().email().describe("Email (used as lookup key)"),
+    username: z
+        .string()
+        .min(1)
+        .max(100)
+        .optional()
+        .describe("Username (required for new users)"),
+    first_name: z.string().min(1).optional().describe("First name"),
+    last_name: z.string().min(1).optional().describe("Last name"),
+    second_last_name: z.string().min(1).optional().describe("Second last name"),
+    password: z
+        .string()
+        .min(8)
+        .optional()
+        .describe("Password (required for new users, min 8 chars)"),
+    birth_at: z.string().optional().describe("Birth date (YYYY-MM-DD)"),
+    sex: z
+        .enum([
+        "0",
+        "1",
+        "2",
+        "3",
+        "4",
+    ])
+        .optional()
+        .describe("0=male 1=female 2=non_binary 3=other 4=prefer_not_to_say"),
+    external_id: z.string().optional().describe("External integration ID"),
+    tag_list: z.string().optional().describe("Comma-separated tags"),
+    activate: z.boolean().optional().describe("Activate or deactivate user"),
+    custom_fields: z
+        .array(customFieldSchema)
+        .optional()
+        .describe("Array of custom field values"),
+    time_zone: z.string().optional().describe("User time zone"),
+    locale: z.string().optional().describe("Locale (e.g., 'en', 'es')"),
+});
+const paramsSchema = z.object({
+    realmUid: z.string().min(2).max(100).describe("Realm UID"),
+    users: z.array(userSchema).min(1).describe("Users to create or update"),
+    continueOnError: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe("Continue on failure (default: true)"),
+    parallel: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe("Parallel processing (default: true)"),
+    verify: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("Refetch to verify (default: false)"),
+});
+class BulkManageRealmUsersTool extends ToolBase {
+    config = {
+        name: "customers-users-bulk",
+        description: `Bulk create/update users by email. Each user idempotent by email; supports parallel processing.
+📚 modyo://docs/tools/customers-users-bulk`,
+        annotations: {
+            title: "Bulk Customer Users",
+            readOnlyHint: false,
+            idempotentHint: true,
+            destructiveHint: false,
+        },
+        isPublic: false,
+    };
+    getParamsSchema() {
+        return paramsSchema;
+    }
+    /**
+     * Process a single user: search, then create or update
+     */
+    async processUser(realmUid, user, usersRepo, realmsRepo, verify) {
+        try {
+            // Step 1: Search for existing user by email
+            this.debug("Processing user", {
+                email: user.email,
+            });
+            const existingUsers = await realmsRepo.getAllRealmUsers(realmUid, {
+                query: user.email,
+            });
+            // Filter to exact email match
+            const existingUser = existingUsers.find((u) => u.email.toLowerCase() === user.email.toLowerCase());
+            // Convert sex from string to number if provided
+            const processedFields = {
+                ...user,
+                sex: user.sex ? Number.parseInt(user.sex, 10) : undefined,
+            };
+            if (existingUser) {
+                // Step 2a: Update existing user
+                const { email, username, password, ...updateFields } = processedFields;
+                const cleanedFields = cleanObject(updateFields);
+                this.debug("Updating existing user", {
+                    email: user.email,
+                    userId: existingUser.id,
+                });
+                const updatedUser = await usersRepo.updateUser(realmUid, existingUser.id, cleanedFields);
+                // Optional verification
+                if (verify) {
+                    const verifiedUser = await usersRepo.getUser(realmUid, updatedUser.id);
+                    return {
+                        email: user.email,
+                        status: "success",
+                        action: "updated",
+                        id: verifiedUser.id,
+                        uuid: verifiedUser.uuid,
+                        username: verifiedUser.username,
+                    };
+                }
+                return {
+                    email: user.email,
+                    status: "success",
+                    action: "updated",
+                    id: updatedUser.id,
+                    uuid: updatedUser.uuid,
+                    username: updatedUser.username,
+                };
+            }
+            // Step 2b: Create new user
+            // Validate required fields for creation
+            if (!user.username) {
+                return {
+                    email: user.email,
+                    status: "failed",
+                    error: "username is required when creating a new user",
+                };
+            }
+            if (!user.password) {
+                return {
+                    email: user.email,
+                    status: "failed",
+                    error: "password is required when creating a new user",
+                };
+            }
+            const cleanedFields = cleanObject(processedFields);
+            this.debug("Creating new user", {
+                email: user.email,
+            });
+            const newUser = await usersRepo.createUser(realmUid, cleanedFields);
+            // Optional verification
+            if (verify) {
+                const verifiedUser = await usersRepo.getUser(realmUid, newUser.id);
+                return {
+                    email: user.email,
+                    status: "success",
+                    action: "created",
+                    id: verifiedUser.id,
+                    uuid: verifiedUser.uuid,
+                    username: verifiedUser.username,
+                };
+            }
+            return {
+                email: user.email,
+                status: "success",
+                action: "created",
+                id: newUser.id,
+                uuid: newUser.uuid,
+                username: newUser.username,
+            };
+        }
+        catch (error) {
+            // Capture error for this user
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.debug("Failed to process user", {
+                email: user.email,
+                error: errorMessage,
+            });
+            return {
+                email: user.email,
+                status: "failed",
+                error: errorMessage,
+            };
+        }
+    }
+    async execute(params) {
+        const { realmUid, users, continueOnError, parallel, verify } = params;
+        const usersRepo = await this.getRepository(UsersRepository);
+        const realmsRepo = await this.getRepository(RealmsRepository);
+        const startTime = Date.now();
+        this.debug("Starting bulk user management", {
+            realmUid,
+            totalUsers: users.length,
+            parallel,
+            continueOnError,
+        });
+        let results;
+        if (parallel) {
+            // Process all users in parallel
+            results = await Promise.all(users.map((user) => this.processUser(realmUid, user, usersRepo, realmsRepo, verify)));
+        }
+        else {
+            // Process users sequentially
+            results = [];
+            for (const user of users) {
+                const result = await this.processUser(realmUid, user, usersRepo, realmsRepo, verify);
+                results.push(result);
+                // Stop on first error if continueOnError is false
+                if (!continueOnError && result.status === "failed") {
+                    this.debug("Stopping bulk operation on first error", {
+                        email: user.email,
+                        error: result.error,
+                    });
+                    break;
+                }
+            }
+        }
+        const duration = Date.now() - startTime;
+        // Calculate summary statistics
+        const successful = results.filter((r) => r.status === "success").length;
+        const failed = results.filter((r) => r.status === "failed").length;
+        const created = results.filter((r) => r.action === "created").length;
+        const updated = results.filter((r) => r.action === "updated").length;
+        this.logger("Completed bulk user management", {
+            realmUid,
+            total: results.length,
+            successful,
+            failed,
+            created,
+            updated,
+            duration_ms: duration,
+        });
+        return this.success({
+            summary: {
+                total: results.length,
+                successful,
+                failed,
+                created,
+                updated,
+                duration_ms: duration,
+            },
+            results,
+        });
+    }
+}
+export const BulkManageUsers = new BulkManageRealmUsersTool();
+//# sourceMappingURL=BulkManageUsers.js.map

package/build/tools/customers/users/BulkManageUsers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BulkManageUsers.js","sourceRoot":"","sources":["../../../../src/tools/customers/users/BulkManageUsers.ts"],"names":[],"mappings":"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"}

package/build/tools/customers/users/ListRealmUsers.d.ts

@@ -0,0 +1,19 @@
+import { z } from "zod";
+declare const paramsSchema: z.ZodObject<{
+    realmUid: z.ZodString;
+    query: z.ZodOptional<z.ZodString>;
+    active: z.ZodOptional<z.ZodEnum<{
+        0: "0";
+        1: "1";
+    }>>;
+    verified: z.ZodOptional<z.ZodEnum<{
+        0: "0";
+        1: "1";
+    }>>;
+    page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    per_page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>;
+export type ParamsSchema = z.infer<typeof paramsSchema>;
+export declare const ListRealmUsers: Tool;
+export {};
+//# sourceMappingURL=ListRealmUsers.d.ts.map

package/build/tools/customers/users/ListRealmUsers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListRealmUsers.d.ts","sourceRoot":"","sources":["../../../../src/tools/customers/users/ListRealmUsers.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,QAAA,MAAM,YAAY;;;;;;;;;;;;;iBAqChB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAyExD,eAAO,MAAM,cAAc,EAAE,IAA+B,CAAC"}

package/build/tools/customers/users/ListRealmUsers.js

@@ -0,0 +1,109 @@
+import { RealmsRepository } from "../../../repositories/customers/realms/RealmsRepository.js";
+import { ToolBase } from "../../../shared/index.js";
+import { z } from "zod";
+const paramsSchema = z.object({
+    realmUid: z
+        .string()
+        .min(2)
+        .max(100)
+        .describe("The realm UID (slug) to list users from"),
+    query: z
+        .string()
+        .optional()
+        .describe("Search query to filter users by name, email, or username"),
+    active: z
+        .enum([
+        "0",
+        "1",
+    ])
+        .optional()
+        .describe("Filter by active status: 1=active, 0=inactive"),
+    verified: z
+        .enum([
+        "0",
+        "1",
+    ])
+        .optional()
+        .describe("Filter by verified status: 1=verified, 0=unverified"),
+    page: z
+        .number()
+        .min(1)
+        .optional()
+        .default(1)
+        .describe("Page number (default: 1)"),
+    per_page: z
+        .number()
+        .min(1)
+        .max(100)
+        .optional()
+        .default(30)
+        .describe("Results per page (default: 30, max: 100)"),
+});
+class ListRealmUsersTool extends ToolBase {
+    config = {
+        name: "customers-users-list",
+        description: `List users in a realm with optional filtering and pagination.
+
+**Params**: realmUid (required), query, active (0|1), verified (0|1), page, per_page
+
+**Response**: {users: [{id, uuid, username, email, name, active, created_at, last_login_at, login_count, tags}], total, page, per_page, total_pages}
+
+📚 modyo://mcp-customers/tools/customers-users-list | HTTP: /docs/tools/customers-users-list`,
+        annotations: {
+            title: "List Customer Users",
+            readOnlyHint: true,
+            idempotentHint: true,
+            destructiveHint: false,
+        },
+        isPublic: false,
+    };
+    getParamsSchema() {
+        return paramsSchema;
+    }
+    async execute(params) {
+        const { realmUid, page, per_page, ...filters } = params;
+        const realmsRepo = await this.getRepository(RealmsRepository);
+        this.debug("Listing realm users", {
+            realmUid,
+            page,
+            per_page,
+            ...filters,
+        });
+        const queryParams = {
+            page,
+            per_page,
+        };
+        if (filters.query)
+            queryParams.query = filters.query;
+        if (filters.active)
+            queryParams.active = filters.active;
+        if (filters.verified)
+            queryParams.verified = filters.verified;
+        const response = await realmsRepo.getRealmUsers(realmUid, queryParams);
+        this.logger("Listed realm users", {
+            realmUid,
+            total: response.meta.total_entries,
+            page: response.meta.current_page,
+        });
+        return this.success({
+            users: response.users.map((u) => ({
+                id: u.id,
+                uuid: u.uuid,
+                username: u.username,
+                email: u.email,
+                name: u.name,
+                active: u.active,
+                created_at: u.created_at,
+                last_login_at: u.last_login_at,
+                login_count: u.login_count,
+                tags: u.tags,
+            })),
+            total: response.meta.total_entries,
+            page: response.meta.current_page,
+            per_page: response.meta.per_page,
+            total_pages: response.meta.total_pages,
+        });
+    }
+}
+export const ListRealmUsers = new ListRealmUsersTool();
+//# sourceMappingURL=ListRealmUsers.js.map

package/build/tools/customers/users/ListRealmUsers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListRealmUsers.js","sourceRoot":"","sources":["../../../../src/tools/customers/users/ListRealmUsers.ts"],"names":[],"mappings":"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"}

package/build/tools/customers/users/ManageUser.d.ts

@@ -0,0 +1,33 @@
+import { z } from "zod";
+declare const paramsSchema: z.ZodObject<{
+    realmUid: z.ZodString;
+    userId: z.ZodOptional<z.ZodNumber>;
+    email: z.ZodOptional<z.ZodString>;
+    username: z.ZodOptional<z.ZodString>;
+    first_name: z.ZodOptional<z.ZodString>;
+    last_name: z.ZodOptional<z.ZodString>;
+    second_last_name: z.ZodOptional<z.ZodString>;
+    password: z.ZodOptional<z.ZodString>;
+    birth_at: z.ZodOptional<z.ZodString>;
+    sex: z.ZodOptional<z.ZodEnum<{
+        0: "0";
+        1: "1";
+        2: "2";
+        3: "3";
+        4: "4";
+    }>>;
+    external_id: z.ZodOptional<z.ZodString>;
+    tag_list: z.ZodOptional<z.ZodString>;
+    activate: z.ZodOptional<z.ZodBoolean>;
+    custom_fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        user_custom_field_id: z.ZodNumber;
+        value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
+    }, z.core.$strip>>>;
+    time_zone: z.ZodOptional<z.ZodString>;
+    locale: z.ZodOptional<z.ZodString>;
+    verify: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
+export type ParamsSchema = z.infer<typeof paramsSchema>;
+export declare const ManageUser: Tool;
+export {};
+//# sourceMappingURL=ManageUser.d.ts.map

package/build/tools/customers/users/ManageUser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManageUser.d.ts","sourceRoot":"","sources":["../../../../src/tools/customers/users/ManageUser.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkDd,CAAC;AAEL,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAmTxD,eAAO,MAAM,UAAU,EAAE,IAAgC,CAAC"}