zammad/spec/requests/tag_spec.rb

# Copyright (C) 2012-2024 Zammad Foundation, https://zammad-foundation.org/

require 'rails_helper'

RSpec.describe Tag, type: :request do

  describe 'request handling', authenticated_as: :agent do

    let(:ticket)  { Ticket.first }
    let(:agent)   { create(:agent, groups: [ticket.group]) }
    let(:payload) { { object: ticket.class.name, item: 'bar', o_id: ticket.id } }

    context 'tag adding' do
      it 'returns created' do
        post '/api/v1/tags/add', params: payload

        expect(response).to have_http_status(:created)
      end

      it 'deletes tag' do
        post '/api/v1/tags/add', params: payload

        expect(described_class.tag_list(payload)).to be_present
      end
    end

    context 'tag removal', authenticated_as: :agent do
      before do
        described_class.tag_add(**payload, created_by_id: 1)
      end

      it 'returns ok' do
        delete '/api/v1/tags/remove', params: payload

        expect(response).to have_http_status(:ok)
      end

      it 'deletes tag' do
        delete '/api/v1/tags/remove', params: payload

        expect(described_class.tag_list(payload)).to be_empty
      end
    end

    context 'tag search' do
      let!(:tags) do
        [
          Tag::Item.lookup_by_name_and_create('foobar'),
          Tag::Item.lookup_by_name_and_create('xxxxxxxxx_DUMMY_VALUE1'),
          Tag::Item.lookup_by_name_and_create('121212121_DUMMY_VALUE2'),
          Tag::Item.lookup_by_name_and_create('oxoxoxoxo_DUMMY_VALUE3'),
        ]
      end

      let(:foobar_tag) { tags.first }

      shared_examples 'foobar tag found using' do |search_term:|
        it "found 1 tag using search term '#{search_term}'" do
          get '/api/v1/tag_search', params: { term: search_term }
          expect(response).to have_http_status(:ok)
          expect(json_response).to contain_exactly('id' => foobar_tag.id, 'value' => foobar_tag.name)
        end
      end

      shared_examples 'no tag found using' do |search_term:|
        it "found 0 tags using search term '#{search_term}'" do
          get '/api/v1/tag_search', params: { term: search_term }
          expect(response).to have_http_status(:ok)
          expect(json_response).to be_empty
        end
      end

      shared_examples 'all tags found using' do |search_term:|
        it "found all tags using search term '#{search_term}'" do
          get '/api/v1/tag_search', params: { term: search_term }
          expect(response).to have_http_status(:ok)
          expect(json_response.size).to eq(Tag::Item.count)
        end
      end

      describe 'using prefix search' do
        include_examples 'foobar tag found using', search_term: 'foobar'
        include_examples 'foobar tag found using', search_term: 'foo'
        include_examples 'foobar tag found using', search_term: 'f'
      end

      describe 'using substring search (added via Enhancement #2569 - Enhance tag search to use fulltext search)' do
        include_examples 'foobar tag found using', search_term: 'bar'
        include_examples 'foobar tag found using', search_term: 'ar'
        include_examples 'foobar tag found using', search_term: 'oo'
      end

      describe 'using wildcard search' do
        include_examples 'all tags found using', search_term: ' '
        include_examples 'all tags found using', search_term: '    '
      end

      describe 'using invalid search terms' do
        include_examples 'no tag found using', search_term: 'WRONG_VALUE'
        include_examples 'no tag found using', search_term: '-'
        include_examples 'no tag found using', search_term: 'fooar'
        include_examples 'no tag found using', search_term: '1foobar'
        include_examples 'no tag found using', search_term: 'foobar2'
      end

      context 'without search term' do
        before do
          create_list(:tag, 2, tag_item: tags.last)
          create_list(:tag, 1, tag_item: tags.first)
        end

        it 'most used is on first place without search term' do
          get '/api/v1/tag_search', params: { term: '' }
          expect(json_response.first['value']).to eq(tags.last.name)
        end
      end
    end
  end

  describe 'Agents can create new tags even if prohibited by the settings #3501', authenticated_as: :agent do
    let(:tag)     { SecureRandom.hex(4) }
    let(:ticket)  { Ticket.first }
    let(:agent)   { create(:agent, groups: [ticket.group]) }
    let(:payload) { { object: ticket.class.name, item: 'bar', o_id: ticket.id } }

    before do
      Setting.set('tag_new', false)
    end

    it 'does not add tags to the ticket' do
      post '/api/v1/tags/add', params: payload
      expect(response).to have_http_status(:forbidden)
    end
  end
end