// Copyright (C) 2026 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only

#include "qcontactcollection.h"
#include "qcontactcollection_p.h"

#ifndef QT_NO_DATASTREAM
#include <QtCore/qdatastream.h>
#endif
#ifndef QT_NO_DEBUG_STREAM
#include <QtCore/qdebug.h>
#endif

QT_BEGIN_NAMESPACE_CONTACTS

/*!
    \class QContactCollection
    \brief The QContactCollection class represents a collection of contacts in a manager.
    \inmodule QtContacts
    \ingroup contacts-main

    A collection has an ID and optionally some metadata, and contains zero or more contacts.
    Each different manager will have different requirements before a collection may be saved
    in it.  Some managers do not allow collections to be saved at all, while others may require
    a collection to have some minimal amount of metadata defined in it prior to save.
    For example, most managers require a valid value for the QContactCollection::KeyName
    meta data key to be set prior to save.

    Every QContact is contained within a collection when stored in a manager.
    To save an contact in a collection, the client should call QContact::setCollectionId()
    on the contact, passing in the ID of the destination collection as the argument, and then
    save the contact in the manager.  To move an contact from one collection to another, the client
    must fetch the contact from the manager, set the collection ID in the contact to the ID of the
    collection to which the client wishes the contact to be moved, and then resave the contact in the
    manager.  That is, the collection which a contact is part of is treated as a property of the
    contact.
 */

/*!
    \enum QContactCollection::MetaDataKey

    This enumeration describes the key of the contact collection metadata.

    \value KeyName         This metadata describes the name of the collection.
    \value KeyDescription  This metadata gives a description of the collection.
    \value KeyColor        This metadata describes the color of the collection.
    \value KeySecondaryColor  This metadata describes the secondary color of the collection.
    \value KeyImage        This metadata describes the image of the collection.
    \value KeyExtended     This is an extened metadata, which is stored as a QVariantMap.
 */

/*!
    Constructs a new collection.
 */
QContactCollection::QContactCollection()
    : d(new QContactCollectionPrivate)
{
}

/*!
    Cleans up any memory in use by the collection.
 */
QContactCollection::~QContactCollection()
{
}

/*!
    Constructs a new copy of the \a other collection.
 */
QContactCollection::QContactCollection(const QContactCollection &other)
    : d(other.d)
{
}

/*!
    Assigns this collection to be equal to the \a other collection.
 */
QContactCollection &QContactCollection::operator=(const QContactCollection &other)
{
    d = other.d;
    return *this;
}

/*!
    Returns true if the collection is the same as that of the \a other collection, false if either
    the ID or any of the stored metadata are not the same.
 */
bool QContactCollection::operator==(const QContactCollection &other) const
{
    if (d == other.d)
        return true;

    if (d->m_id != other.d->m_id
        || d->m_metaData.size() != other.d->m_metaData.size()) {
        return false;
    }

    QMap<QContactCollection::MetaDataKey, QVariant>::const_iterator i = d->m_metaData.constBegin();
    while (i != d->m_metaData.constEnd()) {
        if (i.value() != other.d->m_metaData.value(i.key()))
            return false;
        ++i;
    }

    return true;
}

/*!
    \fn QContactCollection::operator!=(const QContactCollection &other) const

    Returns true if the collection is not the same as the \a other collection.
 */

/*!
    Returns the ID of the collection.
 */
QContactCollectionId QContactCollection::id() const
{
    return d->m_id;
}

/*!
    Sets the ID of the collection to \a id.

    If the ID is set to a null (default-constructed) ID, saving the collection will cause the manager
    to save the collection as a new collection.
 */
void QContactCollection::setId(const QContactCollectionId &id)
{
    d->m_id = id;
}

/*!
    Sets the metadata of the collection to be \a metaData.
 */
void QContactCollection::setMetaData(const QMap<QContactCollection::MetaDataKey, QVariant> &metaData)
{
    d->m_metaData = metaData;
}

/*!
    Returns the meta data of the collection.
 */
QMap<QContactCollection::MetaDataKey, QVariant> QContactCollection::metaData() const
{
    return d->m_metaData;
}

/*!
    Sets the meta data of the collection for the given \a key to the given \a value.
 */
void QContactCollection::setMetaData(MetaDataKey key, const QVariant &value)
{
    d->m_metaData.insert(key, value);
}

/*!
    Sets the value of the extended metadata with the given \a key to \a value.
 */
void QContactCollection::setExtendedMetaData(const QString &key, const QVariant &value)
{
    QVariantMap variantMap = d->m_metaData.value(QContactCollection::KeyExtended).toMap();
    variantMap.insert(key, value);
    d->m_metaData.insert(QContactCollection::KeyExtended, variantMap);
}

/*!
    Returns the value of extended metadata with the given \a key.
 */
QVariant QContactCollection::extendedMetaData(const QString &key) const
{
    return d->m_metaData.value(QContactCollection::KeyExtended).toMap().value(key);
}

/*!
    Returns the meta data of the collection for the given \a key.
 */
QVariant QContactCollection::metaData(MetaDataKey key) const
{
    return d->m_metaData.value(key);
}

/*!
    \relates QContactCollection
    Returns the hash value for \a key.
 */
Q_CONTACTS_EXPORT uint qHash(const QContactCollection &key)
{
    uint hash = qHash(key.id());
    QMap<QContactCollection::MetaDataKey, QVariant>::const_iterator i = key.d->m_metaData.constBegin();
    while (i != key.d->m_metaData.constEnd()) {
        if (i.key() == QContactCollection::KeyExtended) {
            QVariantMap variantMap = i.value().toMap();
            QVariantMap::const_iterator j = variantMap.constBegin();
            while (j != variantMap.constEnd()) {
                hash += QT_PREPEND_NAMESPACE(qHash)(j.key()) + QT_PREPEND_NAMESPACE(qHash)(j.value().toString());
                ++j;
            }
        } else {
            hash += QT_PREPEND_NAMESPACE(qHash)(i.key()) + QT_PREPEND_NAMESPACE(qHash)(i.value().toString());
        }
        ++i;
    }
    return hash;
}

#ifndef QT_NO_DEBUG_STREAM
/*!
    \relates QContactCollection
    Streams the \a collection to the given debug stream \a dbg, and returns the stream.
 */
QDebug operator<<(QDebug dbg, const QContactCollection& collection)
{
    dbg.nospace() << "QContactCollection(id=" << collection.id();

    QMap<QContactCollection::MetaDataKey, QVariant> metaData = collection.metaData();
    QMap<QContactCollection::MetaDataKey, QVariant>::const_iterator i = metaData.constBegin();
    while (i != metaData.constEnd()) {
        dbg.nospace() << ", " << i.key() << '=' << i.value();
        ++i;
    }
    dbg.nospace() << ')';
    return dbg.maybeSpace();
}
#endif // QT_NO_DEBUG_STREAM

#ifndef QT_NO_DATASTREAM
/*!
    \relates QContactCollection
    Writes \a collection to the stream \a out.
 */
QDataStream &operator<<(QDataStream &out, const QContactCollection &collection)
{
    quint8 formatVersion = 1;
    return out << formatVersion
               << collection.id().toString()
               << collection.metaData();
}

/*!
    \relates QContactCollection
    Reads a contact collection from stream \a in into \a collection.
 */
QDataStream &operator>>(QDataStream &in, QContactCollection &collection)
{
    quint8 formatVersion;
    in >> formatVersion;
    if (formatVersion == 1) {
        QString idString;
        QMap<int, QVariant> values;
        in >> idString >> values;

        collection = QContactCollection();
        collection.setId(QContactCollectionId::fromString(idString));

        QMap<int, QVariant>::const_iterator i = values.constBegin();
        while (i != values.constEnd()) {
            collection.setMetaData(static_cast<QContactCollection::MetaDataKey>(i.key()), i.value());
            ++i;
        }
    } else {
        in.setStatus(QDataStream::ReadCorruptData);
    }
    return in;
}
#endif // QT_NO_DATASTREAM

QT_END_NAMESPACE_CONTACTS
