MPT-24265 add notifications directories, footers and webhooks services

[jentyk]

🤖 AI-generated PR — Please review carefully.

📚 Bottom of a two-PR stack. #389 (MPT-24266, templates and template variants) is stacked on this branch and will retarget to main once this merges. Merge this one first.

What

Adds sync and async services for three notifications collection endpoints that had no service class and were therefore unreachable from MPTClient / AsyncMPTClient:

Endpoint	Service	Mixins (per OpenAPI spec)
/public/v1/notifications/directories	DirectoriesService / AsyncDirectoriesService	GetMixin, CollectionMixin — spec documents only GET collection and GET {id}
/public/v1/notifications/footers	FootersService / AsyncFootersService	ManagedResourceMixin, CollectionMixin — GET/POST collection, GET/PUT/DELETE {id}
/public/v1/notifications/webhooks	WebhooksService / AsyncWebhooksService	EnableMixin, DisableMixin, ManagedResourceMixin, CollectionMixin — managed plus POST {id}/enable and POST {id}/disable

Each module follows the existing notifications/contacts.py shape: a Model subclass carrying the resource attributes documented in the spec, a <Name>ServiceConfig, and the sync/async service pair. All three are registered as properties on both Notifications and AsyncNotifications.

Why the pyproject.toml change

Notifications sat at exactly 7 methods, which is wemake-python-styleguide's max_methods default, and mpt_api_client/resources/notifications/* was absent from [tool.flake8] per-file-ignores. Adding any service to the group trips WPS214, so the group now carries the same ignore every other 8+ method group (Catalog, Billing, Helpdesk, Accounts) already has.

The new entry is mpt_api_client/resources/notifications/*.py: WPS110 WPS214 WPS215:

• WPS214 — the max-methods threshold described above.
• WPS215 — previously inherited from the broader mpt_api_client/resources/* entry. A more specific per-file-ignores pattern replaces the broader one rather than extending it, so WPS215 has to be repeated or the pre-existing services in the group start failing. This matches how the accounts/billing/catalog entries are written.
• WPS110 — for Footer.content, an API-mandated field name on the Footer model.

Scope

• Streaming support for these endpoints is not in scope; it is tracked separately in MPT-24241.
• No e2e tests, per the subtask scope.
• Docs were deliberately not touched. docs/usage.md has no service list, and docs/architecture.md's resource tree is group-granular with ellipses (notifications/ # Messages, Batches, Subscribers, …), so new services are already absorbed by the existing text. Appending to that line would collide with sibling branches working on other resource groups for no reader benefit.

Testing

• New unit test modules: tests/unit/resources/notifications/test_directories.py, test_footers.py, test_webhooks.py — endpoint paths, mixin presence (and absence of write mixins on the read-only directories service), model field mapping, and the webhook enable/disable actions for both sync and async.
• All three services added to the parametrized property lists in tests/unit/resources/notifications/test_notifications.py.
• make check-all passes (ruff format, ruff, flake8/WPS, mypy, uv lock --check, 2416 unit tests).
• Reachability verified against a constructed client: every new property resolves and build_path() returns the expected /public/v1/... path, checked against the MPT OpenAPI spec.

MPT-24265

[coderabbitai]

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

• Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

---

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

[github-actions]

✅ Found Jira issue key in the title: MPT-24265

Generated by 🚫 dangerJS against b0e0c42

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
100.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud