Implements the GET /work_packages/:id/wiki_page_links endpoint

COPYRIGHT

@@ -58,4 +58,4 @@ GNU General Public License for more details.
 
 You should have received a copy of the GNU General Public License
 along with this program; if not, write to the Free Software
-Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

COPYRIGHT_short

@@ -20,6 +20,6 @@ GNU General Public License for more details.
 
 You should have received a copy of the GNU General Public License
 along with this program; if not, write to the Free Software
-Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 
 See COPYRIGHT and LICENSE files for more details.

modules/backlogs/app/contracts/backlog_buckets/base_contract.rb

@@ -23,7 +23,7 @@
 #
 # You should have received a copy of the GNU General Public License
 # along with this program; if not, write to the Free Software
-# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 #
 # See COPYRIGHT and LICENSE files for more details.
 #++

modules/wikis/app/models/queries/wikis/page_links/filter/provider_filter.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+#-- copyright
+# OpenProject is an open source project management software.
+# Copyright (C) the OpenProject GmbH
+#
+# This program is free software; you can redistribute it and/or
+# modify it under the terms of the GNU General Public License version 3.
+#
+# OpenProject is a fork of ChiliProject, which is a fork of Redmine. The copyright follows:
+# Copyright (C) 2006-2013 Jean-Philippe Lang
+# Copyright (C) 2010-2013 the ChiliProject Team
+#
+# This program is free software; you can redistribute it and/or
+# modify it under the terms of the GNU General Public License
+# as published by the Free Software Foundation; either version 2
+# of the License, or (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+#
+# See COPYRIGHT and LICENSE files for more details.
+#++
+
+module Queries
+  module Wikis
+    module PageLinks
+      module Filter
+        class ProviderFilter < Filters::Base
+          self.model = ::Wikis::PageLink
+
+          def type = :list
+
+          def human_name
+            ::Wikis::PageLink.human_attribute_name(name)
+          end
+
+          def allowed_values
+            ::Wikis::Provider.enabled.pluck(:universal_identifier).map { |uid| [uid, uid] }
+          end
+
+          def left_outer_joins = :provider
+
+          def where
+            operator_strategy.sql_for_field(values, ::Wikis::Provider.table_name, "universal_identifier")
+          end
+        end
+      end
+    end
+  end
+end

modules/wikis/app/models/queries/wikis/page_links/page_link_query.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+#-- copyright
+# OpenProject is an open source project management software.
+# Copyright (C) the OpenProject GmbH
+#
+# This program is free software; you can redistribute it and/or
+# modify it under the terms of the GNU General Public License version 3.
+#
+# OpenProject is a fork of ChiliProject, which is a fork of Redmine. The copyright follows:
+# Copyright (C) 2006-2013 Jean-Philippe Lang
+# Copyright (C) 2010-2013 the ChiliProject Team
+#
+# This program is free software; you can redistribute it and/or
+# modify it under the terms of the GNU General Public License
+# as published by the Free Software Foundation; either version 2
+# of the License, or (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+#
+# See COPYRIGHT and LICENSE files for more details.
+#++
+
+module Queries
+  module Wikis
+    module PageLinks
+      class PageLinkQuery
+        include BaseQuery
+        include UnpersistedQuery
+
+        def self.model
+          @model ||= ::Wikis::PageLink
+        end
+
+        def default_scope
+          ::Wikis::PageLink.includes(:provider).all
+        end
+      end
+    end
+  end
+end

modules/wikis/app/services/wikis/page_link_metadata_service.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+#-- copyright
+# OpenProject is an open source project management software.
+# Copyright (C) the OpenProject GmbH
+#
+# This program is free software; you can redistribute it and/or
+# modify it under the terms of the GNU General Public License version 3.
+#
+# OpenProject is a fork of ChiliProject, which is a fork of Redmine. The copyright follows:
+# Copyright (C) 2006-2013 Jean-Philippe Lang
+# Copyright (C) 2010-2013 the ChiliProject Team
+#
+# This program is free software; you can redistribute it and/or
+# modify it under the terms of the GNU General Public License
+# as published by the Free Software Foundation; either version 2
+# of the License, or (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+#
+# See COPYRIGHT and LICENSE files for more details.
+#++
+
+module Wikis
+  class PageLinkMetadataService
+    # @param page_links [ActiveRecord::Relation<Wikis::PageLink>]
+    def initialize(page_links)
+      @result = ServiceResult.success(errors: ActiveModel::Errors.new(self))
+      @relation = page_links
+    end
+
+    # @return [ServiceResult<ActiveRecord::Relation<Wikis::PageLink>]
+    def call
+      metadata = relation.group_by(&:provider).flat_map do |provider, page_links|
+        build_inputs(page_links).filter_map do |input_data|
+          provider.resolve("queries.page_info").call(input_data).value_or(nil)
+        end
+      end
+
+      @result.result = enrich_models(metadata)
+      @result
+    end
+
+    private
+
+    attr_reader :relation
+
+    def build_inputs(page_links)
+      page_links.filter_map do |page_link|
+        Adapters::Input::PageInfo.build(identifier: page_link.identifier).value_or(nil)
+      end
+    end
+
+    def enrich_models(metadata)
+      identifier_title_map = metadata.map { [it.identifier, it.title, it.provider.id] }
+      variable_placeholders = Array.new(identifier_title_map.size, "(?,?,?)").join(",")
+      join_string = <<~SQL.squish
+        LEFT JOIN (VALUES #{variable_placeholders}) AS metadata(identifier, title, provider_id)
+          ON metadata.identifier = wiki_page_links.identifier AND metadata.provider_id = wiki_page_links.provider_id
+      SQL
+
+      join_expression = ActiveRecord::Base.sanitize_sql_array([join_string, *identifier_title_map.flatten])
+
+      relation.joins(join_expression).select("wiki_page_links.*, metadata.title as title")
+    end
+  end
+end

modules/wikis/app/services/wikis/page_link_service.rb

@@ -23,7 +23,7 @@
 #
 # You should have received a copy of the GNU General Public License
 # along with this program; if not, write to the Free Software
-# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 #
 # See COPYRIGHT and LICENSE files for more details.
 #++

modules/wikis/config/locales/en.yml

@@ -2,6 +2,8 @@
 en:
   activerecord:
     attributes:
+      wikis/page_link:
+        provider: Wiki Provider
       wikis/xwiki_provider:
         authentication_method: Authentication method
         authentication_methods:

modules/wikis/lib/api/v3/page_links/page_link_collection_representer.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+#-- copyright
+# OpenProject is an open source project management software.
+# Copyright (C) the OpenProject GmbH
+#
+# This program is free software; you can redistribute it and/or
+# modify it under the terms of the GNU General Public License version 3.
+#
+# OpenProject is a fork of ChiliProject, which is a fork of Redmine. The copyright follows:
+# Copyright (C) 2006-2013 Jean-Philippe Lang
+# Copyright (C) 2010-2013 the ChiliProject Team
+#
+# This program is free software; you can redistribute it and/or
+# modify it under the terms of the GNU General Public License
+# as published by the Free Software Foundation; either version 2
+# of the License, or (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+#
+# See COPYRIGHT and LICENSE files for more details.
+#++
+
+module API
+  module V3
+    module PageLinks
+      class PageLinkCollectionRepresenter < Decorators::OffsetPaginatedCollection
+        def _type = "WikiPageLinkCollection"
+      end
+    end
+  end
+end

modules/wikis/lib/api/v3/page_links/page_link_representer.rb

@@ -31,13 +31,22 @@
 module API
   module V3
     module PageLinks
+      URN_INLINE_PAGE_LINK = "#{URN_PREFIX}wikiPageLinks:Inline".freeze
+      URN_RELATION_PAGE_LINK = "#{URN_PREFIX}wikiPageLinks:Relation".freeze
+
+      URN_PAGE_LINK_TYPE = {
+        "Wikis::RelationPageLink" => URN_RELATION_PAGE_LINK,
+        "Wikis::InlinePageLink" => URN_INLINE_PAGE_LINK
+      }.freeze
+
       class PageLinkRepresenter < Decorators::Single
         include Decorators::LinkedResource
         include Decorators::DateProperty
         include Caching::CachedRepresenter
 
         property :id
         property :identifier
+        property :wiki_page_link_type, exec_context: :decorator
 
         date_time_property :created_at
         date_time_property :updated_at
@@ -61,15 +70,19 @@ class PageLinkRepresenter < Decorators::Single
           }
         end
 
-        associated_resource :provider, v3_path: :wiki_provider
+        associated_resource :provider, v3_path: :wiki_provider, link: ->(*) {
+          { href: api_v3_paths.wiki_provider(represented.provider.universal_identifier), title: represented.provider.name }
+        }
 
         # TODO: Make this truly polymorphic - @mereghost 2026-04-13
         associated_resource :linkable,
                             v3_path: :work_package,
                             representer: ::API::V3::WorkPackages::WorkPackageRepresenter,
                             skip_render: ->(*) { represented.linkable_id.nil? || represented.linkable_type != "WorkPackage" }
 
-        def _type = represented.class.name.demodulize
+        def _type = "WikiPageLink"
+
+        def wiki_page_link_type = URN_PAGE_LINK_TYPE[represented.class.name]
 
         private
 

modules/wikis/lib/api/v3/page_links/work_package_wiki_page_links_api.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+#-- copyright
+# OpenProject is an open source project management software.
+# Copyright (C) the OpenProject GmbH
+#
+# This program is free software; you can redistribute it and/or
+# modify it under the terms of the GNU General Public License version 3.
+#
+# OpenProject is a fork of ChiliProject, which is a fork of Redmine. The copyright follows:
+# Copyright (C) 2006-2013 Jean-Philippe Lang
+# Copyright (C) 2010-2013 the ChiliProject Team
+#
+# This program is free software; you can redistribute it and/or
+# modify it under the terms of the GNU General Public License
+# as published by the Free Software Foundation; either version 2
+# of the License, or (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+#
+# See COPYRIGHT and LICENSE files for more details.
+#++
+
+module API
+  module V3
+    module PageLinks
+      class WorkPackageWikiPageLinksAPI < OpenProjectAPI
+        helpers do
+          def enrich_models_with_wiki_metadata(relation)
+            Wikis::PageLinkMetadataService.new(relation).call
+          end
+        end
+
+        resources :wiki_page_links do
+          get do
+            query = ParamsToQueryService.new(
+              ::Wikis::PageLink,
+              current_user,
+              query_class: ::Queries::Wikis::PageLinks::PageLinkQuery
+            ).call(params)
+
+            unless query.valid?
+              message = I18n.t("api_v3.errors.missing_or_malformed_parameter", parameter: "filters")
+              raise ::API::Errors::InvalidQuery.new(message)
+            end
+
+            relation = query.results.where(linkable: @work_package)
+
+            PageLinkCollectionRepresenter.new(
+              enrich_models_with_wiki_metadata(relation).result,
+              per_page: params[:pageSize],
+              self_link: api_v3_paths.work_package_page_links(@work_package.id),
+              current_user:
+            )
+          end
+        end
+      end
+    end
+  end
+end

modules/wikis/lib/api/v3/providers/provider_representer.rb

@@ -35,13 +35,13 @@ class ProviderRepresenter < Decorators::Single
         include Decorators::LinkedResource
         include Decorators::DateProperty
 
-        property :id
+        property :universal_identifier
         property :name
 
         date_time_property :created_at
         date_time_property :updated_at
 
-        self_link(path: :wiki_provider)
+        self_link(path: :wiki_provider, id_attribute: :universal_identifier)
       end
     end
   end