/*
 * Copyright (c) 2010-2026 Contributors to the openHAB project
 *
 * See the NOTICE file(s) distributed with this work for additional
 * information.
 *
 * This program and the accompanying materials are made available under the
 * terms of the Eclipse Public License 2.0 which is available at
 * http://www.eclipse.org/legal/epl-2.0
 *
 * SPDX-License-Identifier: EPL-2.0
 */
package org.openhab.binding.powermax.internal.message;

import org.eclipse.jdt.annotation.NonNullByDefault;
import org.eclipse.jdt.annotation.Nullable;
import org.openhab.binding.powermax.internal.state.PowermaxState;
import org.openhab.core.util.HexUtils;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

/**
 * A base class for handling a message with the Visonic alarm system
 *
 * @author Laurent Garnier - Initial contribution
 */
@NonNullByDefault
public class PowermaxBaseMessage {

    private final Logger logger = LoggerFactory.getLogger(PowermaxBaseMessage.class);

    private final byte[] rawData;
    private int code;
    private @Nullable PowermaxSendType sendType;
    private @Nullable PowermaxReceiveType receiveType;
    private Object messageType;

    /**
     * Constructor.
     *
     * @param message the message as a buffer of bytes
     */
    public PowermaxBaseMessage(byte[] message) {
        this.rawData = message;
        this.messageType = "UNKNOWN";
        decodeMessage();
    }

    /**
     * Constructor.
     *
     * @param sendType the type of a message to be sent
     */
    public PowermaxBaseMessage(PowermaxSendType sendType) {
        this(sendType, null);
    }

    /**
     * Constructor.
     *
     * @param sendType the type of a message to be sent
     * @param param the dynamic part of a message to be sent; null if no dynamic part
     */
    public PowermaxBaseMessage(PowermaxSendType sendType, byte @Nullable [] param) {
        this.sendType = sendType;
        this.messageType = "UNKNOWN";
        this.rawData = new byte[sendType.getMessage().length + 3];
        int index = 0;
        rawData[index++] = 0x0D;
        for (int i = 0; i < sendType.getMessage().length; i++) {
            Integer paramPosition = sendType.getParamPosition();
            if ((param != null) && (paramPosition != null) && (i >= paramPosition)
                    && (i < (paramPosition + param.length))) {
                rawData[index++] = param[i - paramPosition];
            } else {
                rawData[index++] = sendType.getMessage()[i];
            }
        }
        rawData[index++] = 0x00;
        rawData[index++] = 0x0A;
        decodeMessage();
    }

    /**
     * Extract information from the buffer of bytes and set class attributes
     */
    private void decodeMessage() {
        code = rawData[1] & 0x000000FF;
        PowermaxReceiveType localReceiveType;
        try {
            localReceiveType = PowermaxReceiveType.fromCode((byte) code);
        } catch (IllegalArgumentException e) {
            localReceiveType = null;
        }
        receiveType = localReceiveType;

        PowermaxSendType localSendType = sendType;
        messageType = localSendType != null ? localSendType : localReceiveType != null ? localReceiveType : "UNKNOWN";
    }

    /**
     * Work to be done when receiving a message from the Visonic alarm system
     *
     * @return a new state containing all changes driven by the message
     */
    public final @Nullable PowermaxState handleMessage(@Nullable PowermaxCommManager commManager) {
        // Send an ACK if needed
        if (isAckRequired() && commManager != null) {
            commManager.sendAck(this, (byte) 0x02);
        }

        if (logger.isDebugEnabled()) {
            logger.debug("{}message will be handled by class {}:", (receiveType == null) ? "Unsupported " : "",
                    this.getClass().getSimpleName());

            debug("Raw data", rawData);
            debug("Message type", code, messageType.toString());
        }

        PowermaxState newState = handleMessageInternal(commManager);

        return newState;
    }

    protected @Nullable PowermaxState handleMessageInternal(@Nullable PowermaxCommManager commManager) {
        return null;
    }

    /**
     * @return the raw data of the message (buffer of bytes)
     */
    public byte[] getRawData() {
        return rawData;
    }

    /**
     * @return the identifying code of the message (second byte in the buffer)
     */
    public int getCode() {
        return code;
    }

    /**
     * @return the type of the message to be sent
     */
    public @Nullable PowermaxSendType getSendType() {
        return sendType;
    }

    public void setSendType(@Nullable PowermaxSendType sendType) {
        this.sendType = sendType;
    }

    /**
     * @return the type of the received message
     */
    public @Nullable PowermaxReceiveType getReceiveType() {
        return receiveType;
    }

    /**
     * @return true if the received message requires the sending of an ACK
     */
    public boolean isAckRequired() {
        PowermaxReceiveType localReceiveType = receiveType;
        return localReceiveType == null || localReceiveType.isAckRequired();
    }

    // Debugging helpers

    public void debug(String name, String info, @Nullable String decoded) {
        if (!logger.isDebugEnabled()) {
            return;
        }

        String decodedStr = "";

        if (decoded != null && !decoded.isBlank()) {
            decodedStr = " - " + decoded;
        }

        logger.debug("| {} = {}{}", name, info, decodedStr);
    }

    public void debug(String name, String info) {
        debug(name, info, null);
    }

    public void debug(String name, byte[] data, @Nullable String decoded) {
        String hex = "0x" + HexUtils.bytesToHex(data);
        debug(name, hex, decoded);
    }

    public void debug(String name, byte[] data) {
        debug(name, data, null);
    }

    public void debug(String name, int data, @Nullable String decoded) {
        String hex = String.format("0x%02X", data);
        debug(name, hex, decoded);
    }

    public void debug(String name, int data) {
        debug(name, data, null);
    }

    /**
     * Instantiate a class for handling a received message The class depends on the message.
     *
     * @param message the received message as a buffer of bytes
     *
     * @return a new class instance
     */
    public static PowermaxBaseMessage getMessageHandler(byte[] message) {
        PowermaxBaseMessage msgHandler;
        try {
            PowermaxReceiveType msgType = PowermaxReceiveType.fromCode(message[1]);
            switch (msgType) {
                case ACK:
                    msgHandler = new PowermaxAckMessage(message);
                    break;
                case TIMEOUT:
                    msgHandler = new PowermaxTimeoutMessage(message);
                    break;
                case DENIED:
                    msgHandler = new PowermaxDeniedMessage(message);
                    break;
                case DOWNLOAD_RETRY:
                    msgHandler = new PowermaxDownloadRetryMessage(message);
                    break;
                case SETTINGS:
                case SETTINGS_ITEM:
                    msgHandler = new PowermaxSettingsMessage(message);
                    break;
                case INFO:
                    msgHandler = new PowermaxInfoMessage(message);
                    break;
                case EVENT_LOG:
                    msgHandler = new PowermaxEventLogMessage(message);
                    break;
                case ZONESNAME:
                    msgHandler = new PowermaxZonesNameMessage(message);
                    break;
                case STATUS:
                    msgHandler = new PowermaxStatusMessage(message);
                    break;
                case ZONESTYPE:
                    msgHandler = new PowermaxZonesTypeMessage(message);
                    break;
                case PANEL:
                    msgHandler = new PowermaxPanelMessage(message);
                    break;
                case POWERLINK:
                    msgHandler = new PowermaxPowerlinkMessage(message);
                    break;
                case POWERMASTER:
                    msgHandler = new PowermaxPowerMasterMessage(message);
                    break;
                default:
                    msgHandler = new PowermaxBaseMessage(message);
                    break;
            }
        } catch (IllegalArgumentException e) {
            msgHandler = new PowermaxBaseMessage(message);
        }
        return msgHandler;
    }
}
