}
        }
    }

    /**
     * Concatenates kind arrays, avoiding duplicates.
     * @param kinds The initial kind array.
     * @param newKinds The new kind array to add.
     * @return The concatenated kind array.
     */
    protected static Kind[] concatKinds(final Kind[] kinds, final Kind... newKinds) {
        if (kinds == null) {
            return newKinds;
        }

    @Test
    public void testConcatKinds() {
        // Test static concatKinds method
        SuggestItem.Kind[] kinds1 = { SuggestItem.Kind.QUERY };
        SuggestItem.Kind[] kinds2 = { SuggestItem.Kind.DOCUMENT, SuggestItem.Kind.QUERY };

        SuggestItem.Kind[] result = SuggestItem.concatKinds(kinds1, kinds2);

        assertNotNull(result);
        assertEquals(2, result.length); // Should not have duplicates

     */
    public void addField(final String field) {
        fields.add(field);
    }

    /**
     * Adds a kind to filter by.
     * @param kind The kind.
     */
    public void addKind(final String kind) {
        kinds.add(kind);
    }

    /**
     * Sets whether to return detailed suggestion information.

        final SuggestItem.Kind[] itemKinds = new SuggestItem.Kind[kinds.size()];
        for (int i = 0; i < kinds.size(); i++) {
            final String kind = kinds.get(i);
            if (kind.equals(SuggestItem.Kind.DOCUMENT.toString())) {
                itemKinds[i] = SuggestItem.Kind.DOCUMENT;
            } else if (kind.equals(SuggestItem.Kind.QUERY.toString())) {

        SuggestItem.Kind[] kinds1 = { SuggestItem.Kind.QUERY };
        SuggestItem.Kind[] kinds2 = { SuggestItem.Kind.QUERY, SuggestItem.Kind.DOCUMENT };

        SuggestItem.Kind[] result = SuggestItem.concatKinds(kinds1, kinds2);

        // Should have QUERY from first, and only DOCUMENT added from second (QUERY already exists)
        assertEquals(2, result.length);
    }

with Java.

We spent a lot of time and energy on retaining strict compatibility with OkHttp 3.x. We’re even
keeping the package name the same: `okhttp3`!

There are three kinds of compatibility we’re tracking:

 * **Binary compatibility** is the ability to compile a program against OkHttp 3.x, and then to run
   it against OkHttp 4.x. We’re using the excellent [japicmp][japicmp] library via its

     *
     * https://github.com/google/guava/issues/2254
     *
     * Other kinds of Errors are possible:
     *
     * - OutOfMemoryError from allocations in setFuture(): The calculus here is similar to
     * StackOverflowError: We can't reliably call setException(error).
     *
     * - Any kind of Error from a listener. Even if we could distinguish that case (by exposing some

        // Check kind
        assertNotNull(suggestItem.getKinds());
        // The kinds array structure might be different
        boolean hasUserKind = false;
        for (SuggestItem.Kind kind : suggestItem.getKinds()) {
            if (kind == SuggestItem.Kind.USER) {
                hasUserKind = true;
                break;
            }
        }

        secondLine.put("score", (item.getQueryFreq() + item.getDocFreq()) * item.getUserBoost());
        secondLine.put("tags", item.getTags());
        secondLine.put("roles", item.getRoles());
        secondLine.put("kinds", Arrays.toString(item.getKinds()));
        secondLine.put("@timestamp", item.getTimestamp());

        try (OutputStream out1 = getXContentOutputStream(firstLineMap); OutputStream out2 = getXContentOutputStream(secondLine)) {

 of this license document, but changing it is not allowed.

                            Preamble

  The GNU Affero General Public License is a free, copyleft license for
software and other kinds of works, specifically designed to ensure
cooperation with the community in the case of network server software.

  The licenses for most software and other practical works are designed