getstream 3.3.4__tar.gz → 3.4.0__tar.gz

getstream-3.4.0/.github/workflows/release.yml

@@ -0,0 +1,219 @@
+name: Release
+
+on:
+  workflow_dispatch:
+    inputs:
+      version_bump:
+        description: 'Version bump type for manual release'
+        required: true
+        default: 'patch'
+        type: choice
+        options:
+          - patch
+          - minor
+          - major
+      use_current_version:
+        description: 'Skip version bump and publish the version already set in pyproject.toml'
+        required: false
+        default: false
+        type: boolean
+  pull_request:
+    types: [closed]
+    branches:
+      - main
+
+concurrency:
+  group: release-${{ github.event.pull_request.base.ref || github.ref_name }}
+  cancel-in-progress: false
+
+permissions:
+  contents: read
+
+jobs:
+  prepare:
+    name: Prepare release
+    if: github.event_name == 'workflow_dispatch' || github.event.pull_request.merged == true
+    runs-on: ubuntu-latest
+    outputs:
+      should_release: ${{ steps.release_meta_final.outputs.should_release }}
+      bump: ${{ steps.release_meta_final.outputs.bump }}
+      previous_version: ${{ steps.release_meta_final.outputs.previous_version }}
+      version: ${{ steps.release_meta_final.outputs.version }}
+      tag: ${{ steps.release_meta_final.outputs.tag }}
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+          ref: ${{ github.event_name == 'pull_request' && github.event.pull_request.base.ref || github.ref_name }}
+
+      - name: Skip when PR is already released
+        id: already_released
+        run: |
+          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
+            echo "value=false" >> "$GITHUB_OUTPUT"
+          else
+            if git log --oneline --grep="(pr #${{ github.event.pull_request.number }})" -n 1 | grep -q "chore(release):"; then
+              echo "value=true" >> "$GITHUB_OUTPUT"
+            else
+              echo "value=false" >> "$GITHUB_OUTPUT"
+            fi
+          fi
+
+      - name: Determine version bump (from PR metadata)
+        id: release_meta
+        if: github.event_name == 'pull_request' && steps.already_released.outputs.value != 'true'
+        env:
+          PR_TITLE: ${{ github.event.pull_request.title }}
+          PR_BODY: ${{ github.event.pull_request.body }}
+        run: |
+          PR_BODY_FILE=$(mktemp)
+          printf '%s' "$PR_BODY" > "$PR_BODY_FILE"
+          python3 scripts/release/bump_version.py \
+            --title "$PR_TITLE" \
+            --body-file "$PR_BODY_FILE" \
+            --output "$GITHUB_OUTPUT"
+
+      - name: Determine version bump (manual)
+        id: release_meta_manual
+        if: github.event_name == 'workflow_dispatch'
+        run: |
+          python3 scripts/release/bump_version.py \
+            --manual-bump "${{ github.event.inputs.version_bump }}" \
+            --use-current-version "${{ github.event.inputs.use_current_version }}" \
+            --output "$GITHUB_OUTPUT"
+
+      - name: Consolidate release metadata
+        id: release_meta_final
+        run: |
+          if [ "${{ steps.already_released.outputs.value }}" = "true" ]; then
+            echo "should_release=false" >> "$GITHUB_OUTPUT"
+            echo "bump=none" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
+            echo "should_release=${{ steps.release_meta_manual.outputs.should_release }}" >> "$GITHUB_OUTPUT"
+            echo "bump=${{ steps.release_meta_manual.outputs.bump }}" >> "$GITHUB_OUTPUT"
+            echo "previous_version=${{ steps.release_meta_manual.outputs.previous_version }}" >> "$GITHUB_OUTPUT"
+            echo "version=${{ steps.release_meta_manual.outputs.version }}" >> "$GITHUB_OUTPUT"
+            echo "tag=${{ steps.release_meta_manual.outputs.tag }}" >> "$GITHUB_OUTPUT"
+          else
+            echo "should_release=${{ steps.release_meta.outputs.should_release }}" >> "$GITHUB_OUTPUT"
+            echo "bump=${{ steps.release_meta.outputs.bump }}" >> "$GITHUB_OUTPUT"
+            echo "previous_version=${{ steps.release_meta.outputs.previous_version }}" >> "$GITHUB_OUTPUT"
+            echo "version=${{ steps.release_meta.outputs.version }}" >> "$GITHUB_OUTPUT"
+            echo "tag=${{ steps.release_meta.outputs.tag }}" >> "$GITHUB_OUTPUT"
+          fi
+
+  test-unit:
+    name: Test (unit)
+    needs: prepare
+    if: needs.prepare.outputs.should_release == 'true'
+    uses: ./.github/workflows/run_tests.yml
+    with:
+      marker: 'not integration'
+    secrets: inherit
+
+  test-integration:
+    name: Test (integration)
+    needs: prepare
+    if: needs.prepare.outputs.should_release == 'true'
+    uses: ./.github/workflows/run_tests.yml
+    with:
+      marker: 'integration'
+    secrets: inherit
+
+  release:
+    name: 🚀 Release
+    needs: [prepare, test-unit, test-integration]
+    if: needs.prepare.outputs.should_release == 'true'
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      contents: write
+      id-token: write
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+          ref: ${{ github.event_name == 'pull_request' && github.event.pull_request.base.ref || github.ref_name }}
+
+      - uses: ./.github/actions/python-uv-setup
+
+      - name: Apply version bump
+        env:
+          VERSION: ${{ needs.prepare.outputs.version }}
+        run: |
+          python3 - <<'PY'
+          import os, re
+          from pathlib import Path
+          version = os.environ['VERSION']
+          path = Path('pyproject.toml')
+          text = path.read_text(encoding='utf-8')
+          pattern = re.compile(r'^version\s*=\s*"\d+\.\d+\.\d+"\s*$', re.MULTILINE)
+          new_text, count = pattern.subn(f'version = "{version}"', text, count=1)
+          if count == 0:
+              raise SystemExit('Could not update version line in pyproject.toml')
+          path.write_text(new_text, encoding='utf-8')
+          PY
+
+      - name: Commit version bump
+        env:
+          VERSION: ${{ needs.prepare.outputs.version }}
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add pyproject.toml
+          if git diff --cached --quiet; then
+            echo "No version changes to commit."
+            exit 0
+          fi
+          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
+            git commit -m "chore(release): v${VERSION} (manual)"
+            git push origin "HEAD:${{ github.ref_name }}"
+          else
+            git commit -m "chore(release): v${VERSION} (pr #${{ github.event.pull_request.number }})"
+            git push origin "HEAD:${{ github.event.pull_request.base.ref }}"
+          fi
+
+      - name: Create release tag
+        env:
+          TAG: ${{ needs.prepare.outputs.tag }}
+        run: |
+          if git rev-parse -q --verify "refs/tags/${TAG}" >/dev/null; then
+            echo "Tag ${TAG} already exists; skipping tag creation."
+            exit 0
+          fi
+          git tag "${TAG}"
+          git push origin "${TAG}"
+
+      - name: Clean dist directory
+        run: rm -rf dist
+
+      - name: Build distributions
+        run: uv build
+
+      - name: Publish to PyPI (Trusted Publishing)
+        run: uv publish
+
+      - name: Create release on GitHub
+        uses: ncipollo/release-action@v1
+        with:
+          tag: ${{ needs.prepare.outputs.tag }}
+          token: ${{ secrets.GITHUB_TOKEN }}
+          skipIfReleaseExists: true
+          body: |
+            Release v${{ needs.prepare.outputs.version }}
+
+            - Bump type: `${{ needs.prepare.outputs.bump }}`
+            - Previous: `${{ needs.prepare.outputs.previous_version }}`
+            - Next: `${{ needs.prepare.outputs.version }}`
+            - Trigger: `${{ github.event_name }}`
+
+            Install with: `pip install getstream==${{ needs.prepare.outputs.version }}`
+
+      - name: Verify pip install
+        env:
+          UV_NO_SOURCES: "1"
+        run: |
+          uv pip install "getstream==${{ needs.prepare.outputs.version }}" || \
+            echo "WARNING: pip install verification failed (PyPI index may need a moment to propagate)"

{getstream-3.3.4 → getstream-3.4.0}/.github/workflows/run_tests.yml

@@ -8,7 +8,7 @@ on:
         type: string
     secrets: { }
 concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
+  group: ${{ github.workflow }}-${{ github.ref }}-${{ inputs.marker }}
   cancel-in-progress: true
 
 env:
@@ -49,7 +49,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
     timeout-minutes: 30
     steps:
       - name: Checkout
@@ -75,7 +75,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
     timeout-minutes: 30
     steps:
       - name: Checkout

{getstream-3.3.4 → getstream-3.4.0}/CHANGELOG.md

@@ -5,6 +5,41 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+### Added
+
+- Webhook handling spec helpers (CHA-2961): `UnknownEvent` dataclass for
+  forward-compat; `gunzip_payload`, `decode_sqs_payload`, `decode_sns_payload`
+  primitives; `parse_event` (returns typed event or `UnknownEvent` for
+  unrecognized discriminators); `verify_signature` canonical alias of
+  `verify_webhook_signature`; `verify_and_parse_webhook` HTTP composite
+  (gunzip + verify + parse); `parse_sqs` and `parse_sns` queue composites
+  (no signature parameter — queue transports are authenticated by AWS IAM,
+  so the backend emits no HMAC for queue messages today). Transparent gzip
+  via magic-byte detection.
+- New instance methods on `Stream` and `AsyncStream`:
+  `verify_signature(body, signature)` and
+  `verify_and_parse_webhook(body, signature)` — drop the api_secret parameter
+  in favor of the client's stored secret. Dual API: the module-level functions
+  in `getstream.webhook` remain available for callers who want explicit
+  secret control.
+- New instance methods on `Stream` / `AsyncStream`: `parse_sqs(message_body)`,
+  `parse_sns(notification_body)` (no signature; AWS IAM).
+- `InvalidWebhookError` exception type covering both signature mismatches and
+  malformed payloads. Distinguish failure modes via the exception message or
+  `__cause__` chain.
+- Conformance fixture suite under `tests/fixtures/webhooks/` (13 happy-path
+  event directories + 8 negative cases) for SDK conformance testing across
+  language ports.
+
+### Changed
+
+- No breaking changes. All existing webhook helpers (`verify_webhook_signature`,
+  `parse_webhook_event`, `get_event_type`, event type constants) are preserved.
+
+[Spec](https://www.notion.so/stream-wiki/Server-Side-SDK-Webhook-Handling-Spec-34b6a5d7f9f681e78003c443f227493c)
+
 ## [3.0.0b1] - 2026-02-27
 
 ### Breaking Changes

{getstream-3.3.4 → getstream-3.4.0}/Makefile

@@ -56,11 +56,13 @@ TY_EXCLUDES := \
 
 ## Run non-video tests (chat, feeds, moderation, etc.)
 test:
-	uv run pytest -m "$(MARKER)" tests/ getstream/ $(VIDEO_IGNORE) $(MANUAL_IGNORE)
+	@uv run pytest -m "$(MARKER)" tests/ getstream/ $(VIDEO_IGNORE) $(MANUAL_IGNORE); \
+	ec=$$?; if [ $$ec -eq 5 ]; then echo "No tests matched marker '$(MARKER)' — treating as success."; exit 0; else exit $$ec; fi
 
 ## Run video/WebRTC tests only
 test-video:
-	uv run pytest -m "$(MARKER)" $(VIDEO_PATHS)
+	@uv run pytest -m "$(MARKER)" $(VIDEO_PATHS); \
+	ec=$$?; if [ $$ec -eq 5 ]; then echo "No tests matched marker '$(MARKER)' — treating as success."; exit 0; else exit $$ec; fi
 
 ## Run all tests (non-video + video), excluding manual tests
 test-all:

{getstream-3.3.4 → getstream-3.4.0}/PKG-INFO

@@ -1,15 +1,15 @@
 Metadata-Version: 2.4
 Name: getstream
-Version: 3.3.4
+Version: 3.4.0
 Summary: GetStream Python SDK - Build scalable activity feeds, chat, and video calling applications
 Author-email: sachaarbonel <sacha.arbonel@hotmail.fr>, tbarbugli <tbarbugli@gmail.com>
 License-File: LICENSE.md
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Requires-Python: <4.0.0,>=3.10
 Requires-Dist: dataclasses-json<0.7,>=0.6.0
 Requires-Dist: httpx>=0.28.1
@@ -31,13 +31,15 @@ Provides-Extra: webrtc
 Requires-Dist: aiohttp<4,>=3.13.2; extra == 'webrtc'
 Requires-Dist: aiortc<1.15.0,>=1.14.0; extra == 'webrtc'
 Requires-Dist: av<17,>=14.2.0; extra == 'webrtc'
-Requires-Dist: numpy<2.3,>=2.2.6; extra == 'webrtc'
+Requires-Dist: numpy<2.3,>=2.2.6; (python_version < '3.14') and extra == 'webrtc'
+Requires-Dist: numpy<2.4,>=2.3.2; (python_version >= '3.14') and extra == 'webrtc'
 Requires-Dist: numpy>=2.2.6; extra == 'webrtc'
 Requires-Dist: ping3>=4.0.8; extra == 'webrtc'
 Requires-Dist: protobuf>=4.25.1; extra == 'webrtc'
 Requires-Dist: protobuf>=6.31.1; extra == 'webrtc'
 Requires-Dist: python-dateutil>=2.8.2; extra == 'webrtc'
-Requires-Dist: scipy<1.16,>=1.15.3; extra == 'webrtc'
+Requires-Dist: scipy<1.16,>=1.15.3; (python_version < '3.14') and extra == 'webrtc'
+Requires-Dist: scipy<1.17,>=1.16.1; (python_version >= '3.14') and extra == 'webrtc'
 Requires-Dist: scipy>=1.15.3; extra == 'webrtc'
 Requires-Dist: soundfile>=0.13.1; extra == 'webrtc'
 Requires-Dist: structlog<24; extra == 'webrtc'
@@ -175,7 +177,7 @@ We use [uv](https://github.com/astral-sh/uv) to manage dependencies and run test
 ### 🚀 Quick Start
 
 **Prerequisites:**
-- Python 3.9+ (recommended: 3.12.2)
+- Python 3.10+ (recommended: 3.12.2)
 - [uv](https://github.com/astral-sh/uv) package manager
 
 **Setup:**
@@ -280,6 +282,23 @@ uv run pytest -v -s
 uv run pytest tests/test_video.py::test_specific_function -v
 ```
 
+## Releases
+
+Releases use two paths:
+
+- **Default**: automatic release when a PR is merged to `main`. The PR title (and body) drives the semver bump.
+- **Fallback**: manual release via the `Release` workflow's `workflow_dispatch` (admin use). Select a `version_bump` (`patch`/`minor`/`major`). `use_current_version=true` skips the bump and publishes whatever is already in `pyproject.toml`.
+
+Automatic semver bump rules:
+
+- `feat:` -> minor
+- `fix:` (or `bug:`) -> patch
+- `feat!:`, `<type>(scope)!:`, or `BREAKING CHANGE` in the PR body/title -> major
+
+PRs with any other prefix do not trigger a release.
+
+The release pipeline runs lint, type-check, and the full test matrix (unit + integration, across all supported Python versions) on the merged commit before publishing to PyPI via Trusted Publishing (OIDC). Each step in the publish job is idempotent: a failed run can be re-dispatched from the Actions UI.
+
 ## License
 
 This project is licensed under the [MIT License](LICENSE).

{getstream-3.3.4 → getstream-3.4.0}/README.md

@@ -125,7 +125,7 @@ We use [uv](https://github.com/astral-sh/uv) to manage dependencies and run test
 ### 🚀 Quick Start
 
 **Prerequisites:**
-- Python 3.9+ (recommended: 3.12.2)
+- Python 3.10+ (recommended: 3.12.2)
 - [uv](https://github.com/astral-sh/uv) package manager
 
 **Setup:**
@@ -230,6 +230,23 @@ uv run pytest -v -s
 uv run pytest tests/test_video.py::test_specific_function -v
 ```
 
+## Releases
+
+Releases use two paths:
+
+- **Default**: automatic release when a PR is merged to `main`. The PR title (and body) drives the semver bump.
+- **Fallback**: manual release via the `Release` workflow's `workflow_dispatch` (admin use). Select a `version_bump` (`patch`/`minor`/`major`). `use_current_version=true` skips the bump and publishes whatever is already in `pyproject.toml`.
+
+Automatic semver bump rules:
+
+- `feat:` -> minor
+- `fix:` (or `bug:`) -> patch
+- `feat!:`, `<type>(scope)!:`, or `BREAKING CHANGE` in the PR body/title -> major
+
+PRs with any other prefix do not trigger a release.
+
+The release pipeline runs lint, type-check, and the full test matrix (unit + integration, across all supported Python versions) on the merged commit before publishing to PyPI via Trusted Publishing (OIDC). Each step in the publish job is idempotent: a failed run can be re-dispatched from the Actions UI.
+
 ## License
 
 This project is licensed under the [MIT License](LICENSE).

{getstream-3.3.4 → getstream-3.4.0}/generate.sh

@@ -17,7 +17,10 @@ fi
 set -ex
 
 # cd in API repo, generate new spec and then generate code from it
-( cd $SOURCE_PATH ; make openapi ; go run ./cmd/chat-manager openapi generate-client --language python --spec ./releases/v2/serverside-api.yaml --output ../stream-py/getstream/ )
+( cd $SOURCE_PATH ; make openapi ; ./build/chat-manager openapi generate-client --language python --spec ./releases/v2/serverside-api.yaml --output ../stream-py/getstream/ )
+
+# Regenerate webhook conformance fixtures (CHA-2961)
+( cd $SOURCE_PATH ; ./build/chat-manager openapi generate-webhook-fixtures --output ../stream-py/tests/assets/webhooks --time-format=unix-ns )
 
 # lint + auto-fix, then format generated code with ruff (align with pre-commit)
 uv run ruff check --fix getstream/ tests/

{getstream-3.3.4 → getstream-3.4.0}/getstream/chat/async_rest_client.py

@@ -31,6 +31,44 @@ class ChatRestClient(AsyncBaseClient):
             user_agent=user_agent,
         )
 
+    @telemetry.operation_name("getstream.api.chat.create_campaign")
+    async def create_campaign(
+        self,
+        sender_id: str,
+        message_template: CampaignMessageTemplate,
+        create_channels: Optional[bool] = None,
+        description: Optional[str] = None,
+        id: Optional[str] = None,
+        name: Optional[str] = None,
+        sender_mode: Optional[str] = None,
+        sender_visibility: Optional[str] = None,
+        show_channels: Optional[bool] = None,
+        skip_push: Optional[bool] = None,
+        skip_webhook: Optional[bool] = None,
+        segment_ids: Optional[List[str]] = None,
+        user_ids: Optional[List[str]] = None,
+        channel_template: Optional[CampaignChannelTemplate] = None,
+    ) -> StreamResponse[CreateCampaignResponse]:
+        json = CreateCampaignRequest(
+            sender_id=sender_id,
+            message_template=message_template,
+            create_channels=create_channels,
+            description=description,
+            id=id,
+            name=name,
+            sender_mode=sender_mode,
+            sender_visibility=sender_visibility,
+            show_channels=show_channels,
+            skip_push=skip_push,
+            skip_webhook=skip_webhook,
+            segment_ids=segment_ids,
+            user_ids=user_ids,
+            channel_template=channel_template,
+        ).to_dict()
+        return await self.post(
+            "/api/v2/chat/campaigns", CreateCampaignResponse, json=json
+        )
+
     @telemetry.operation_name("getstream.api.chat.query_campaigns")
     async def query_campaigns(
         self,
@@ -53,6 +91,17 @@ class ChatRestClient(AsyncBaseClient):
             "/api/v2/chat/campaigns/query", QueryCampaignsResponse, json=json
         )
 
+    @telemetry.operation_name("getstream.api.chat.delete_campaign")
+    async def delete_campaign(self, id: str) -> StreamResponse[DeleteCampaignResponse]:
+        path_params = {
+            "id": id,
+        }
+        return await self.delete(
+            "/api/v2/chat/campaigns/{id}",
+            DeleteCampaignResponse,
+            path_params=path_params,
+        )
+
     @telemetry.operation_name("getstream.api.chat.get_campaign")
     async def get_campaign(
         self,
@@ -72,6 +121,51 @@ class ChatRestClient(AsyncBaseClient):
             path_params=path_params,
         )
 
+    @telemetry.operation_name("getstream.api.chat.update_campaign")
+    async def update_campaign(
+        self,
+        id: str,
+        sender_id: str,
+        message_template: CampaignMessageTemplate,
+        create_channels: Optional[bool] = None,
+        description: Optional[str] = None,
+        id_: Optional[str] = None,
+        name: Optional[str] = None,
+        sender_mode: Optional[str] = None,
+        sender_visibility: Optional[str] = None,
+        show_channels: Optional[bool] = None,
+        skip_push: Optional[bool] = None,
+        skip_webhook: Optional[bool] = None,
+        segment_ids: Optional[List[str]] = None,
+        user_ids: Optional[List[str]] = None,
+        channel_template: Optional[CampaignChannelTemplate] = None,
+    ) -> StreamResponse[CampaignResponse]:
+        path_params = {
+            "id": id,
+        }
+        json = UpdateCampaignRequest(
+            sender_id=sender_id,
+            message_template=message_template,
+            create_channels=create_channels,
+            description=description,
+            id=id_,
+            name=name,
+            sender_mode=sender_mode,
+            sender_visibility=sender_visibility,
+            show_channels=show_channels,
+            skip_push=skip_push,
+            skip_webhook=skip_webhook,
+            segment_ids=segment_ids,
+            user_ids=user_ids,
+            channel_template=channel_template,
+        ).to_dict()
+        return await self.put(
+            "/api/v2/chat/campaigns/{id}",
+            CampaignResponse,
+            path_params=path_params,
+            json=json,
+        )
+
     @telemetry.operation_name("getstream.api.chat.start_campaign")
     async def start_campaign(
         self,
@@ -183,6 +277,20 @@ class ChatRestClient(AsyncBaseClient):
             json=json,
         )
 
+    @telemetry.operation_name("getstream.api.chat.grouped_query_channels")
+    async def grouped_query_channels(
+        self,
+        limit: Optional[int] = None,
+        user_id: Optional[str] = None,
+        user: Optional[UserRequest] = None,
+    ) -> StreamResponse[GroupedQueryChannelsResponse]:
+        json = GroupedQueryChannelsRequest(
+            limit=limit, user_id=user_id, user=user
+        ).to_dict()
+        return await self.post(
+            "/api/v2/chat/channels/grouped", GroupedQueryChannelsResponse, json=json
+        )
+
     @telemetry.operation_name("getstream.api.chat.mark_channels_read")
     async def mark_channels_read(
         self,

{getstream-3.3.4 → getstream-3.4.0}/getstream/chat/rest_client.py

@@ -31,6 +31,42 @@ class ChatRestClient(BaseClient):
             user_agent=user_agent,
         )
 
+    @telemetry.operation_name("getstream.api.chat.create_campaign")
+    def create_campaign(
+        self,
+        sender_id: str,
+        message_template: CampaignMessageTemplate,
+        create_channels: Optional[bool] = None,
+        description: Optional[str] = None,
+        id: Optional[str] = None,
+        name: Optional[str] = None,
+        sender_mode: Optional[str] = None,
+        sender_visibility: Optional[str] = None,
+        show_channels: Optional[bool] = None,
+        skip_push: Optional[bool] = None,
+        skip_webhook: Optional[bool] = None,
+        segment_ids: Optional[List[str]] = None,
+        user_ids: Optional[List[str]] = None,
+        channel_template: Optional[CampaignChannelTemplate] = None,
+    ) -> StreamResponse[CreateCampaignResponse]:
+        json = CreateCampaignRequest(
+            sender_id=sender_id,
+            message_template=message_template,
+            create_channels=create_channels,
+            description=description,
+            id=id,
+            name=name,
+            sender_mode=sender_mode,
+            sender_visibility=sender_visibility,
+            show_channels=show_channels,
+            skip_push=skip_push,
+            skip_webhook=skip_webhook,
+            segment_ids=segment_ids,
+            user_ids=user_ids,
+            channel_template=channel_template,
+        ).to_dict()
+        return self.post("/api/v2/chat/campaigns", CreateCampaignResponse, json=json)
+
     @telemetry.operation_name("getstream.api.chat.query_campaigns")
     def query_campaigns(
         self,
@@ -53,6 +89,17 @@ class ChatRestClient(BaseClient):
             "/api/v2/chat/campaigns/query", QueryCampaignsResponse, json=json
         )
 
+    @telemetry.operation_name("getstream.api.chat.delete_campaign")
+    def delete_campaign(self, id: str) -> StreamResponse[DeleteCampaignResponse]:
+        path_params = {
+            "id": id,
+        }
+        return self.delete(
+            "/api/v2/chat/campaigns/{id}",
+            DeleteCampaignResponse,
+            path_params=path_params,
+        )
+
     @telemetry.operation_name("getstream.api.chat.get_campaign")
     def get_campaign(
         self,
@@ -72,6 +119,51 @@ class ChatRestClient(BaseClient):
             path_params=path_params,
         )
 
+    @telemetry.operation_name("getstream.api.chat.update_campaign")
+    def update_campaign(
+        self,
+        id: str,
+        sender_id: str,
+        message_template: CampaignMessageTemplate,
+        create_channels: Optional[bool] = None,
+        description: Optional[str] = None,
+        id_: Optional[str] = None,
+        name: Optional[str] = None,
+        sender_mode: Optional[str] = None,
+        sender_visibility: Optional[str] = None,
+        show_channels: Optional[bool] = None,
+        skip_push: Optional[bool] = None,
+        skip_webhook: Optional[bool] = None,
+        segment_ids: Optional[List[str]] = None,
+        user_ids: Optional[List[str]] = None,
+        channel_template: Optional[CampaignChannelTemplate] = None,
+    ) -> StreamResponse[CampaignResponse]:
+        path_params = {
+            "id": id,
+        }
+        json = UpdateCampaignRequest(
+            sender_id=sender_id,
+            message_template=message_template,
+            create_channels=create_channels,
+            description=description,
+            id=id_,
+            name=name,
+            sender_mode=sender_mode,
+            sender_visibility=sender_visibility,
+            show_channels=show_channels,
+            skip_push=skip_push,
+            skip_webhook=skip_webhook,
+            segment_ids=segment_ids,
+            user_ids=user_ids,
+            channel_template=channel_template,
+        ).to_dict()
+        return self.put(
+            "/api/v2/chat/campaigns/{id}",
+            CampaignResponse,
+            path_params=path_params,
+            json=json,
+        )
+
     @telemetry.operation_name("getstream.api.chat.start_campaign")
     def start_campaign(
         self,
@@ -181,6 +273,20 @@ class ChatRestClient(BaseClient):
             json=json,
         )
 
+    @telemetry.operation_name("getstream.api.chat.grouped_query_channels")
+    def grouped_query_channels(
+        self,
+        limit: Optional[int] = None,
+        user_id: Optional[str] = None,
+        user: Optional[UserRequest] = None,
+    ) -> StreamResponse[GroupedQueryChannelsResponse]:
+        json = GroupedQueryChannelsRequest(
+            limit=limit, user_id=user_id, user=user
+        ).to_dict()
+        return self.post(
+            "/api/v2/chat/channels/grouped", GroupedQueryChannelsResponse, json=json
+        )
+
     @telemetry.operation_name("getstream.api.chat.mark_channels_read")
     def mark_channels_read(
         self,