Adding proto changes and translation logic for handling TypedProperties

[O-sura]

Purpose

This PR adds the new TypedProperties mapping logic into python policy engine to stores additional properties which has complex structures which needs to be preserved in their original typed form (e.g. arrays or objects) preserving structure that Properties flattens to strings.

Related with:

• [Improvement]: JWT Auth Policy - Claim & Scope Matching Refactor #2746
• Add TypedProperties to sdk AuthContext #2840

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: a9bc9508-e815-4860-bfb2-2abfdafd3ab7

📥 Commits

Reviewing files that changed from the base of the PR and between 135a77d and 503f5c9.

⛔ Files ignored due to path filters (2)

• gateway/gateway-runtime/policy-engine/go.sum is excluded by !**/*.sum
• gateway/gateway-runtime/policy-engine/internal/pythonbridge/proto/python_executor.pb.go is excluded by !**/*.pb.go

📒 Files selected for processing (8)

• gateway/gateway-runtime/api/proto/python_executor.proto
• gateway/gateway-runtime/policy-engine/go.mod
• gateway/gateway-runtime/policy-engine/internal/pythonbridge/translator.go
• gateway/gateway-runtime/policy-engine/internal/pythonbridge/translator_test.go
• gateway/gateway-runtime/python-executor/executor/translator.py
• gateway/gateway-runtime/python-executor/proto/python_executor_pb2.py
• gateway/gateway-runtime/python-executor/tests/test_translator.py
• sdk-python/src/apip_sdk_core/policy/v1alpha2/types.py

---

📝 Walkthrough

Walkthrough

Changes

Structured AuthContext propagation

Layer / File(s)	Summary
AuthContext contract and generated schema gateway/gateway-runtime/api/proto/python_executor.proto, sdk-python/src/.../types.py, gateway/gateway-runtime/python-executor/proto/python_executor_pb2.py	Adds typed_properties to protobuf and SDK AuthContext models and regenerates the Python protobuf descriptor.
Go AuthContext serialization and validation gateway/gateway-runtime/policy-engine/...	Serializes structured properties, propagates nested conversion errors, and tests structured, numeric, and invalid values.
Python AuthContext deserialization and verification gateway/gateway-runtime/python-executor/executor/translator.py, gateway/gateway-runtime/python-executor/tests/test_translator.py	Converts protobuf typed properties into Python dictionaries and verifies arrays and scalar claims.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Sequence Diagram(s)

sequenceDiagram
  participant GoSharedContext
  participant GoTranslator
  participant PythonExecutorProto
  participant PythonTranslator
  participant PythonAuthContext
  GoSharedContext->>GoTranslator: ToProtoSharedContext
  GoTranslator->>PythonExecutorProto: serialize typed_properties
  PythonExecutorProto->>PythonTranslator: provide AuthContext Struct
  PythonTranslator->>PythonAuthContext: convert Struct to dict

Loading

Possibly related PRs

• wso2/api-platform#2840: Adds the corresponding structured AuthContext properties in the SDK.
• wso2/api-platform#2852: Contains closely related protobuf and translator changes for preserving typed AuthContext claims.

Suggested reviewers: chamilaadhi, malinthaprasan, pubudu538

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Description check	⚠️ Warning	The description only covers Purpose and omits most required template sections like Goals, Approach, tests, security, and test environment.	Add the missing template sections: Goals, Approach, User stories, Documentation, Automation tests, Security checks, Samples, Related PRs, and Test environment.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly summarizes the main change: proto updates and translation logic for TypedProperties.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/sdk-typedproperties

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

🔧 golangci-lint (2.12.2)

level=error msg="[linters_context] typechecking error: pattern ./...: directory prefix . does not contain modules listed in go.work or their selected dependencies"

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[github-actions]

Dependency Validation Results

⚠️ Please verify the scope of the dependencies usage is necessary

[O-sura]

@coderabbitai full review

[coderabbitai]

✅ Action performed

Full review finished.