TrakBridge Plugin SDK

Base classes and runtime contracts for building TrakBridge plugins.

from trakbridge_sdk import BaseGPSPlugin

class MyTracker(BaseGPSPlugin):
    @property
    def plugin_name(self) -> str:
        return "my_tracker"

    async def fetch_locations(self, session):
        ...

What's in the box

• BaseGPSPlugin — poll an external source, emit locations
• BaseOutputPlugin — receive CoT events, deliver them somewhere
• BaseInboundPlugin — accept pushed data (HTTP push / active connect)
• PluginConfigField / PluginConfigMixin — declarative config with UI generation and sensitive-field encryption
• trakbridge_sdk.configure(...) — runtime provider registry the host application uses to inject its services (encryption, plugin metadata, circuit breaker, CoT service)

See docs/plugin_contract.md for the full plugin contract and examples/ for working plugins of all three types.

Development

pip install -e ".[dev]"
pytest

Publishing checklist (deferred follow-ups)

• Move repository from git.emfour.net to GitHub (public release)
• Configure PyPI Trusted Publishing (OIDC from GitHub Actions), enable 2FA, no long-lived tokens
• Publish 1.0.0 to PyPI via a GitHub release (.github/workflows/publish.yml)
• Switch TrakBridge core dependency from the internal git URL to trakbridge-plugin-sdk==1.0.0 with --hash pinning

License

Apache-2.0