feat(frontier): add scope fields to preference messages (#441)

* feat(frontier): add scope fields to preference messages

Add scope_type and scope_id fields to support org-scoped user preferences:

- Preference message: add scope_type (field 6) and scope_id (field 7)
- PreferenceRequestBody message: add scope_type (field 4) and scope_id (field 5)
- ListCurrentUserPreferencesRequest message: add scope_type (field 1) and scope_id (field 2)

These fields enable users to have different preference values per organization context
while maintaining backward compatibility with global preferences (empty scope = global).

Related: raystack/frontier#1347

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* feat(frontier): add scope fields to ListUserPreferencesRequest

Add scope_type and scope_id fields to ListUserPreferencesRequest to
allow filtering user preferences by scope context.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

Author: whoAbhishekSah

raystack/frontier/v1beta1/frontier.proto

@@ -4115,6 +4115,14 @@ message CreateUserPreferencesResponse {
 
 message ListUserPreferencesRequest {
   string id = 1 [(validate.rules).string.min_len = 3];
+  // scope_type filters preferences by context type (e.g., "app/organization")
+  // If empty, returns all user preferences (global + all scoped)
+  // If set with scope_id, returns preferences for the specific scope,
+  // with trait defaults for any unset preferences
+  string scope_type = 2;
+  // scope_id filters preferences by scope identifier (e.g., organization ID)
+  // Only applicable when scope_type is set
+  string scope_id = 3;
 }
 
 message ListUserPreferencesResponse {
@@ -4129,7 +4137,16 @@ message CreateCurrentUserPreferencesResponse {
   repeated Preference preferences = 1;
 }
 
-message ListCurrentUserPreferencesRequest {}
+message ListCurrentUserPreferencesRequest {
+  // scope_type filters preferences by context type (e.g., "app/organization")
+  // If empty, returns all user preferences (global + all scoped)
+  // If set with scope_id, returns global preferences + preferences for the specific scope,
+  // with trait defaults for any unset preferences
+  string scope_type = 1;
+  // scope_id filters preferences by scope identifier (e.g., organization ID)
+  // Only applicable when scope_type is set
+  string scope_id = 2;
+}
 
 message ListCurrentUserPreferencesResponse {
   repeated Preference preferences = 1;

raystack/frontier/v1beta1/models.proto

@@ -555,6 +555,12 @@ message Preference {
   string value = 3;
   string resource_id = 4;
   string resource_type = 5;
+  // scope_type defines the context type for scoped preferences (e.g., "app/organization")
+  // If empty, the preference is global (not scoped to any context)
+  string scope_type = 6;
+  // scope_id is the identifier of the scope context (e.g., organization ID)
+  // Only applicable when scope_type is set
+  string scope_id = 7;
 
   google.protobuf.Timestamp created_at = 10 [(grpc.gateway.protoc_gen_openapiv2.options.openapiv2_field) = {
     description: "The time when the preference was created.",
@@ -947,6 +953,12 @@ message PreferenceRequestBody {
     pattern: "^[A-Za-z0-9-_]+$"
   }];
   string value = 3;
+  // scope_type defines the context type for scoped preferences (e.g., "app/organization")
+  // If empty, the preference is global (not scoped to any context)
+  string scope_type = 4;
+  // scope_id is the identifier of the scope context (e.g., organization ID)
+  // Only applicable when scope_type is set
+  string scope_id = 5;
 }
 
 message CheckoutSubscriptionBody {