[integration][BitbucketServer] Added File and Folder kind support

[azeezport]

User description

Description

What - Updated the bitbucket server integration to enable file and folder kind support. The integration supports:

File kind folder kind

Why - To enable users using Bitbucket server to automatically sync their resources to Port

How -

Type of change

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

• [ ] Bug fix (non-breaking change which fixes an issue)
• [ ] 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)

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

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.

---

PR Type

Enhancement

---

Description

• Added file and folder kind support to Bitbucket Server integration

• Implemented pattern-based file and folder discovery with glob matching

• Added webhook processors for real-time file and folder updates

• Enhanced client with directory browsing and raw content fetching capabilities

---

Diagram Walkthrough

flowchart LR
  client["BitbucketClient"] -- "browse & list" --> helpers["File/Folder Helpers"]
  helpers -- "pattern matching" --> resync["Resync Handlers"]
  webhooks["Webhook Processors"] -- "live updates" --> resync
  resync -- "entities" --> port["Port"]

File Walkthrough

	Relevant files
Enhancement	8 files client.py Added file/folder browsing and content fetching methods    +106/-0  file.py Implemented file pattern matching and processing logic      +323/-0  folder.py Implemented folder pattern matching and recursive directory listing +259/-0  integration.py Added file and folder resource config models                          +59/-2    main.py Added resync handlers and webhook processors registration +31/-1    __init__.py Exported new file and folder webhook processors                    +4/-0      file_pattern_webhook_processor.py Created webhook processor for file pattern events                +105/-0  folder_pattern_webhook_processor.py Created webhook processor for folder pattern events            +100/-0
Configuration changes	3 files blueprints.json Removed default blueprint definitions from repository        +0/-245  port-app-config.yml Removed default port app configuration file                            +0/-73    spec.yaml Added file and folder kinds to integration spec                    +2/-0
Additional files	1 files __init__.py [link]

---