Introduce Resource Sharing Policy Management Component

[BimsaraBodaragama]

This PR adds a new component to manage resource-sharing policies between organizations in the WSO2 Identity Server. It enables defining, storing, and retrieving resource-sharing policies for users, applications, and identity providers.

Purpose

This feature addresses the need for a structured and scalable solution to manage resource-sharing policies across organizational hierarchies. It resolves the following issues:

• Introduce a Centralized Resource Sharing Policy Management Service #21815

Goals

• Provide a unified interface for managing resource-sharing policies.
• Enable consistent policy definitions across resource types.
• Support dynamic and hierarchical sharing options, such as sharing with all current and future organizations or selected organizational hierarchies.

Approach

• Created a new component for resource-sharing policy management.
• Developed a core service with DAO and utility classes for CRUD operations.
• Defined constants and enums for resource types and sharing policies.
• Implemented robust exception handling mechanisms.

Release note

Introduced a centralized resource-sharing policy management service to unify and streamline sharing policies across all resource types.

Documentation

N/A (Documentation updates will be tracked separately.)

Test environment

• JDK 11
• macOS 15.1.1 (24B91)
• H2 Database

---

Related Issue

Introduce a Centralized Resource Sharing Policy Management Service #21815

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 48.57%. Comparing base (021650f) to head (c30c9d5).

Additional details and impacted files

@@             Coverage Diff              @@
##               main     #416      +/-   ##
============================================
+ Coverage     47.13%   48.57%   +1.44%     
- Complexity     1024     1080      +56     
============================================
  Files           112      115       +3     
  Lines          6710     6898     +188     
  Branches        802      810       +8     
============================================
+ Hits           3163     3351     +188     
  Misses         3259     3259              
  Partials        288      288              

Flag	Coverage Δ
unit	32.18% <100.00%> (+3.07%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[AnuradhaSK]

Suggested change

	throws ResourceSharingPolicyMgtException, DataAccessException;
	throws ResourceSharingPolicyMgtException;

[AnuradhaSK]

shall we make this a void method?
Otherwise invoker needs to handle false / exception cases specifically or we need to mention in which scenario we return false, in which scenarios it will throw an exception

[AnuradhaSK]

Fix in all other delete operations

[AnuradhaSK]

Why do we need sharingPolicyInitiatedOrgId as a separate param? Shall we extract it from resourceSharingPolicy
for impl usages

[AnuradhaSK]

Suggested change

	private static final Log LOG = LogFactory.getLog(ResourceSharingPolicyHandlerService.class);
	private static final Log LOG = LogFactory.getLog(ResourceSharingPolicyHandlerServiceImpl.class);

[AnuradhaSK]

If the service will anyway construct a Map, not need to make it Optional.
Check other service which return Map

[AnuradhaSK]

Suggested change

	private boolean isInvalidId(String id) {
	return id == null || id.isEmpty();
	private boolean isInvalidId(String id) {
	return id == null || id.isEmpty();