import { z } from "zod";
import { withAuth, getSessionCredentials } from "../../auth/index.js";
import { handleApiResponse, handleToolError, validateRequired } from "../helpers/errorHandler.js";
import { AcaiHttpClient } from "../helpers/acaiHttpClient.js";
import { withAuthParams } from "../helpers/authSchema.js";
import { canAccessTable } from "../helpers/accessControl.js";

export function registerAddModuleToRecordTool(server) {
    server.tool(
        "add_module_to_record",
        `Adds a builder module to a specific record at the desired position. Returns the generated sectionId — use it directly with set_module_config_vars without needing to call list_page_modules.

Required params:
- tableName (string) without 'cms_' prefix
- recordNum (number) record primary key ('num' field, never 'id')
- moduleId (string) module identifier
Optional:
- modulePosition (number) insertion index (0-based, default 0)

Response includes: sectionId, moduleId, position, totalModules`,
        withAuthParams({
            tableName: z.string().describe("Table name without cms_ prefix, e.g. 'apartados'"),
            recordNum: z.union([z.string(), z.number()]).describe("Record num (ID) where the module will be inserted"),
            moduleId: z.string().describe("Module ID to insert"),
            modulePosition: z.number().optional().describe("Position in the builder array (0-based). Default 0.")
        }),
        { readOnlyHint: false, destructiveHint: false },
        withAuth(async ({ tableName, recordNum, moduleId, modulePosition }, extra) => {
            try {
                const validationError = validateRequired({ tableName, recordNum, moduleId }, ['tableName', 'recordNum', 'moduleId'], 'add_module_to_record');
                if (validationError) return validationError;

                // Check table access
                const accessCheck = canAccessTable(tableName);
                if (!accessCheck.allowed) {
                    return { content: [{ type: "text", text: JSON.stringify({ success: false, error: accessCheck.error }) }], isError: true };
                }

                const sessionId = extra.sessionId;
                const credentials = await getSessionCredentials(sessionId);
                const payload = {
                    tableName,
                    recordNum,
                    moduleId,
                    modulePosition: modulePosition ?? 0
                };

                // Same endpoint pattern as create_or_update_record: cmsApi subaction
                const response = await AcaiHttpClient.addModuleToRecord(
                    credentials,
                    credentials.token,
                    credentials.tokenHash,
                    payload
                );

                const apiError = handleApiResponse(response.data, 'add_module_to_record');
                if (apiError) return apiError;

                const result = response.data || {}
                return {
                    content: [{
                        type: "text",
                        text: JSON.stringify({
                            success: true,
                            action: 'add_module_to_record',
                            tableName,
                            recordNum,
                            moduleId,
                            sectionId: result.sectionId,
                            position: result.position ?? (modulePosition ?? 0),
                            totalModules: result.totalModules,
                        }, null, 2)
                    }]
                };
            } catch (error) {
                return handleToolError(error, 'add_module_to_record', { tableName, recordNum, moduleId });
            }
        })
    );
}