[Core] Store Static examples (#2945)

# Description

Store Static raw data example so we can show it in the UI

## Type of change

Please leave one option from the following and delete the rest:

- [ ] Bug fix (non-breaking change which fixes an issue)
- [X] New feature (non-breaking change which adds functionality)
- [ ] New Integration (non-breaking change which adds a new integration)
- [ ] Breaking change (fix or feature that would cause existing
functionality to not work as expected)
- [ ] Non-breaking change (fix of existing functionality that will not
change current behavior)
- [ ] Documentation (added/updated documentation)

<h4> All tests should be run against the port production
environment(using a testing org). </h4>

### Core testing checklist

- [ ] Integration able to create all default resources from scratch
- [ ] Resync finishes successfully
- [ ] Resync able to create entities
- [ ] Resync able to update entities
- [ ] Resync able to detect and delete entities
- [ ] Scheduled resync able to abort existing resync and start a new one
- [ ] Tested with at least 2 integrations from scratch
- [ ] Tested with Kafka and Polling event listeners
- [ ] Tested deletion of entities that don't pass the selector


### Integration testing checklist

- [ ] Integration able to create all default resources from scratch
- [ ] Completed a full resync from a freshly installed integration and
it completed successfully
- [ ] Resync able to create entities
- [ ] Resync able to update entities
- [ ] Resync able to detect and delete entities
- [ ] Resync finishes successfully
- [ ] If new resource kind is added or updated in the integration, add
example raw data, mapping and expected result to the `examples` folder
in the integration directory.
- [ ] If resource kind is updated, run the integration with the example
data and check if the expected result is achieved
- [ ] If new resource kind is added or updated, validate that
live-events for that resource are working as expected
- [ ] Docs PR link [here](#)

### Preflight checklist

- [ ] Handled rate limiting
- [ ] Handled pagination
- [ ] Implemented the code in async
- [ ] Support Multi account

## Screenshots

Include screenshots from your environment showing how the resources of
the integration will look.

## API Documentation

Provide links to the API documentation used for this integration.

Author: omby8888

.github/workflows/release-integrations.yml

@@ -288,6 +288,8 @@ jobs:
               port_app_config_ui_schema_dest="$version_folder/$port_app_config_ui_schema"
               port_app_config_ui_schema_latest_dest="$integration_folder/$port_app_config_ui_schema"
 
+              static_examples_folder_dest="$integration_folder/examples/"
+
               # Convert YAML to JSON
               yq -o json "$file" >"$temp_file"
 
@@ -330,6 +332,12 @@ jobs:
                     # Upload global index file to s3
                     aws s3 cp "$index_file" "s3://$aws_s3_bucket/$index_file"
                     echo "Successfully uploaded $index_file to s3 bucket."
+
+                    # Upload Static Examples to s3
+                    if [[ -d "$integration_dir/examples" ]]; then
+                        aws s3 cp "$integration_dir/examples" "s3://$aws_s3_bucket/$static_examples_folder_dest" --recursive
+                        echo "Successfully uploaded $type/examples/ to s3 bucket."
+                    fi
                   fi
 
                   SCHEMA_CLI_COMMANDS=(

CHANGELOG.md

@@ -7,6 +7,13 @@ this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 <!-- towncrier release notes start -->
 
+## 0.38.18 (2026-03-16)
+
+### Improvements
+
+- UI schema normalization: single-schema `allOf` is now flattened into the parent object when generating port-app-config UI schema.
+- Release workflow: upload integration `.port/examples/` to the registry bucket.
+
 ## 0.38.17 (2026-03-16)
 
 ### Improvements

port_ocean/cli/commands/port_app_config.py

@@ -50,13 +50,34 @@ def _load_integration_class(path: str) -> Type[BaseIntegration]:
             sys.path.remove(path)
 
 
-def _dereference_schema(result: dict[str, Any]) -> dict[str, Any]:
-    """Dereference all $ref in the UI schema and remove definitions. Uses jsonref."""
+def _flatten_single_allof(obj: Any) -> Any:
+    if isinstance(obj, list):
+        return [_flatten_single_allof(x) for x in obj]
+    if not isinstance(obj, dict):
+        return obj
+    out = {
+        k: _flatten_single_allof(v) if isinstance(v, (dict, list)) else v
+        for k, v in obj.items()
+        if k != "allOf"
+    }
+    allof = obj.get("allOf")
+    if isinstance(allof, list) and len(allof) == 1 and isinstance(allof[0], dict):
+        return {**_flatten_single_allof(allof[0]), **out}
+    if allof is not None:
+        out["allOf"] = _flatten_single_allof(allof)
+    return out
+
+
+def _normalize_schema(result: dict[str, Any]) -> dict[str, Any]:
+    """Normalize the UI schema: resolve $refs, drop definitions, flatten single allOf."""
     for kind_data in result.get("kinds", {}).values():
         selectors = kind_data.get("selectors")
-        if isinstance(selectors, dict) and "definitions" in selectors:
+        if not isinstance(selectors, dict):
+            continue
+        if "definitions" in selectors:
             kind_data["selectors"] = replace_refs(selectors, proxies=False)
             kind_data["selectors"].pop("definitions", None)
+        kind_data["selectors"] = _flatten_single_allof(kind_data["selectors"])
     return result
 
 
@@ -134,7 +155,7 @@ def port_app_config_schema(
             result = config_class.schema()
         case "ui":
             result = validate_and_get_config_schema(config_class)
-            result = _dereference_schema(result)
+            result = _normalize_schema(result)
         case _:
             click.echo(f"Invalid format: {format}", err=True)
             sys.exit(1)

pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "port-ocean"
-version = "0.38.17"
+version = "0.38.18"
 description = "Port Ocean is a CLI tool for managing your Port projects."
 readme = "README.md"
 homepage = "https://app.getport.io"