movethewheels-sdk 2026.1107.1__tar.gz

movethewheels_sdk-2026.1107.1/.gitignore

@@ -0,0 +1,172 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be added to the global gitignore or merged into this project gitignore.  For a PyCharm
+#  project, it is recommended to include the following directory since it contains user-specific
+#  configurations:
+.idea/
+
+# VSCode
+.vscode/
+
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db

movethewheels_sdk-2026.1107.1/CHANGELOG.md

@@ -0,0 +1,30 @@
+# Changelog
+
+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 [CalVer](https://calver.org/) (`YYYY.MDD.PATCH`).
+
+## [Unreleased]
+
+### Changed
+- Rewrote the SDK as a thin shell over `burdenoff-sdk-libs`. The hand-vendored
+  per-feature module tree (client, types, auth, user, workspace, rbac, team,
+  project, resources, billing, organization, payment, quota, store, support,
+  usage, utils, addon, plan, product) and its mock-based tests were removed.
+- All module surfaces are now nested under their owning module. The Movethewheels
+  domain bundle is reached via `sdk.movethewheels.<entity>` (customers, drivers,
+  vehicles, products, warehouses, inventory, orders, shipments, tracking, routes,
+  marketplace, reports, settings, data, analytics).
+
+### Added
+- `MovethewheelsSDK` facade mounting 23 modules from `burdenoff-sdk-libs`: the
+  shared generic set plus the `movethewheels` domain module and the standalone
+  `sandbox` module.
+- Shared-gateway defaults and the `burdenoff_cli_movethewheels` OIDC client id.
+- `py.typed` marker shipped in the wheel; strict mypy in CI.
+- Real-construction smoke tests (no mocks).
+
+### Removed
+- Vendored module directories under `src/movethewheels_sdk/` and the mock-based
+  unit tests.

movethewheels_sdk-2026.1107.1/LICENSE

@@ -0,0 +1,9 @@
+Copyright (c) 2025 Burdenoff Consultancy Services Private Limited, Algoshred Technologies Private Limited and all sister companies.
+
+All rights reserved.
+
+This software is proprietary and confidential. Unauthorized copying, modification, distribution, or use of this software, via any medium, is strictly prohibited without the express written permission of the copyright holders.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+For licensing inquiries, please contact: legal@algoshred.com

movethewheels_sdk-2026.1107.1/PKG-INFO

@@ -0,0 +1,204 @@
+Metadata-Version: 2.5
+Name: movethewheels-sdk
+Version: 2026.1107.1
+Summary: Official Python SDK for Movethewheels — thin shell over burdenoff-sdk-libs
+Project-URL: Homepage, https://github.com/algoshred/movethewheels-sdk-python
+Project-URL: Documentation, https://docs.algoshred.com/sdk/python
+Project-URL: Repository, https://github.com/algoshred/movethewheels-sdk-python
+Project-URL: Issues, https://github.com/algoshred/movethewheels-sdk-python/issues
+Project-URL: Changelog, https://github.com/algoshred/movethewheels-sdk-python/blob/main/CHANGELOG.md
+Author-email: "Vignesh T.V" <vignesh@algoshred.com>
+Maintainer-email: "Vignesh T.V" <vignesh@algoshred.com>
+License: Copyright (c) 2025 Burdenoff Consultancy Services Private Limited, Algoshred Technologies Private Limited and all sister companies.
+        
+        All rights reserved.
+        
+        This software is proprietary and confidential. Unauthorized copying, modification, distribution, or use of this software, via any medium, is strictly prohibited without the express written permission of the copyright holders.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+        
+        For licensing inquiries, please contact: legal@algoshred.com
+License-File: LICENSE
+Keywords: api-client,burdenoff,delivery,fleet,graphql,logistics,movethewheels,python,sdk
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+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: Topic :: Internet :: WWW/HTTP :: HTTP Servers
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: burdenoff-sdk-libs>=2026.1107.1
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: typing-extensions>=4.0.0; python_version < '3.11'
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: flake8>=6.0.0; extra == 'dev'
+Requires-Dist: isort>=5.12.0; extra == 'dev'
+Requires-Dist: mypy>=1.0.0; extra == 'dev'
+Requires-Dist: pre-commit>=3.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: sphinx-autodoc-typehints>=1.19.0; extra == 'docs'
+Requires-Dist: sphinx-rtd-theme>=1.2.0; extra == 'docs'
+Requires-Dist: sphinx>=6.0.0; extra == 'docs'
+Provides-Extra: test
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'test'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'test'
+Requires-Dist: pytest>=7.0.0; extra == 'test'
+Requires-Dist: respx>=0.21.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# movethewheels-sdk
+
+Official Python SDK for **Movethewheels** — a logistics, fleet, and delivery-operations platform on the Burdenoff platform.
+
+> **Pre-launch notice:** Movethewheels is launching in 2026. This package is published ahead of general availability so integrators can build early. There is no live production service yet — [join the waitlist at movethewheels.com](https://movethewheels.com) to get early access.
+
+This SDK is a **thin shell** over [`burdenoff-sdk-libs`](https://github.com/algoshred/sdk-libs-python). It mounts the shared platform modules plus the Movethewheels domain module and a standalone sandbox module, and exposes them as one ergonomic, fully typed client.
+
+## Features
+
+- Async/await throughout, built on `httpx`
+- Dual-endpoint GraphQL client (workspace + global gateways)
+- 23 mounted modules: the shared generic set + `movethewheels` + `sandbox`
+- Multiple auth flows: email/password, device code, PKCE, client credentials
+- Automatic token refresh
+- Typed error hierarchy
+- Full type hints with `py.typed` marker
+
+## Installation
+
+```bash
+pip install movethewheels-sdk
+
+# Development install
+pip install -e ".[dev]"
+```
+
+## Quick Start
+
+```python
+import asyncio
+from movethewheels_sdk import MovethewheelsSDK
+
+
+async def main():
+    # Defaults to the shared prod gateways and the burdenoff_cli_movethewheels
+    # OIDC client. Override the endpoints for local dev.
+    sdk = MovethewheelsSDK()
+
+    # Sign in with email/password
+    await sdk.auth.sign_in(email="user@example.com", password="secret")
+
+    # Movethewheels-domain operations are nested under sdk.movethewheels
+    customers = await sdk.movethewheels.customers.list()
+    orders = await sdk.movethewheels.orders.list()
+
+    # Shared cross-product modules are mounted at the top level
+    tags = await sdk.tags.list()
+
+    await sdk.close()
+
+
+asyncio.run(main())
+```
+
+## Nested namespace
+
+Per the platform mandate (no compatibility shim), every module surface is nested
+under its owning module. The Movethewheels domain bundle keeps its sub-entities
+nested:
+
+```python
+await sdk.movethewheels.customers.list()
+await sdk.movethewheels.drivers.list()
+await sdk.movethewheels.vehicles.list()
+await sdk.movethewheels.warehouses.list()
+await sdk.movethewheels.inventory.list()
+await sdk.movethewheels.orders.list()
+await sdk.movethewheels.shipments.list()
+await sdk.movethewheels.tracking.list()
+await sdk.movethewheels.routes.list()
+await sdk.movethewheels.reports.list()
+await sdk.movethewheels.analytics.dashboard()
+```
+
+## Modules
+
+All methods are async. The following modules are mounted on the `MovethewheelsSDK`
+instance: `auth`, `billing`, `channels`, `conversations`, `devportal`,
+`export`, `files`, `groups`, `health`, `integrations`, `movethewheels`,
+`notifications`, `organizations`, `products`, `rbac`, `sandbox`, `scheduler`,
+`security`, `store`, `support`, `tags`, `tours`, `workspaces`.
+
+## Configuration
+
+```python
+from movethewheels_sdk import MovethewheelsSDK
+
+sdk = MovethewheelsSDK(
+    workspace_endpoint="https://graphqlworkspaces.burdenoff.com/workspaces/graphql",
+    global_endpoint="https://graphql.burdenoff.com/global/graphql",
+    client_id="burdenoff_cli_movethewheels",   # default
+    oidc_issuer=None,                       # derived from global_endpoint
+    api_key=None,
+    access_token=None,
+    refresh_token=None,
+    workspace_token=None,
+    timeout=30.0,
+    auto_refresh=True,
+)
+```
+
+## Error Handling
+
+```python
+from movethewheels_sdk import (
+    MovethewheelsError,
+    AuthenticationError,
+    AuthorizationError,
+    NetworkError,
+    ValidationError,
+    RateLimitError,
+    DeviceCodeExpiredError,
+    DeviceCodeDeniedError,
+)
+
+try:
+    await sdk.auth.sign_in(email="user@example.com", password="wrong")
+except AuthenticationError:
+    print("Invalid credentials")
+except NetworkError:
+    print("Could not reach the API")
+except MovethewheelsError as e:
+    print(f"SDK error: {e}")
+```
+
+## Development
+
+```bash
+python -m venv .venv && source .venv/bin/activate
+pip install -e ".[dev]"
+
+make format        # black + isort
+make lint          # flake8
+make type-check    # mypy (strict)
+make test          # pytest
+make sanity        # format-check + lint + type-check + test (cov>=80) + build
+```
+
+## License
+
+Proprietary — Copyright Burdenoff Consultancy Services Pvt. Ltd.
+
+## Support
+
+- Issues: [GitHub Issues](https://github.com/algoshred/movethewheels-sdk-python/issues)

movethewheels_sdk-2026.1107.1/README.md

@@ -0,0 +1,146 @@
+# movethewheels-sdk
+
+Official Python SDK for **Movethewheels** — a logistics, fleet, and delivery-operations platform on the Burdenoff platform.
+
+> **Pre-launch notice:** Movethewheels is launching in 2026. This package is published ahead of general availability so integrators can build early. There is no live production service yet — [join the waitlist at movethewheels.com](https://movethewheels.com) to get early access.
+
+This SDK is a **thin shell** over [`burdenoff-sdk-libs`](https://github.com/algoshred/sdk-libs-python). It mounts the shared platform modules plus the Movethewheels domain module and a standalone sandbox module, and exposes them as one ergonomic, fully typed client.
+
+## Features
+
+- Async/await throughout, built on `httpx`
+- Dual-endpoint GraphQL client (workspace + global gateways)
+- 23 mounted modules: the shared generic set + `movethewheels` + `sandbox`
+- Multiple auth flows: email/password, device code, PKCE, client credentials
+- Automatic token refresh
+- Typed error hierarchy
+- Full type hints with `py.typed` marker
+
+## Installation
+
+```bash
+pip install movethewheels-sdk
+
+# Development install
+pip install -e ".[dev]"
+```
+
+## Quick Start
+
+```python
+import asyncio
+from movethewheels_sdk import MovethewheelsSDK
+
+
+async def main():
+    # Defaults to the shared prod gateways and the burdenoff_cli_movethewheels
+    # OIDC client. Override the endpoints for local dev.
+    sdk = MovethewheelsSDK()
+
+    # Sign in with email/password
+    await sdk.auth.sign_in(email="user@example.com", password="secret")
+
+    # Movethewheels-domain operations are nested under sdk.movethewheels
+    customers = await sdk.movethewheels.customers.list()
+    orders = await sdk.movethewheels.orders.list()
+
+    # Shared cross-product modules are mounted at the top level
+    tags = await sdk.tags.list()
+
+    await sdk.close()
+
+
+asyncio.run(main())
+```
+
+## Nested namespace
+
+Per the platform mandate (no compatibility shim), every module surface is nested
+under its owning module. The Movethewheels domain bundle keeps its sub-entities
+nested:
+
+```python
+await sdk.movethewheels.customers.list()
+await sdk.movethewheels.drivers.list()
+await sdk.movethewheels.vehicles.list()
+await sdk.movethewheels.warehouses.list()
+await sdk.movethewheels.inventory.list()
+await sdk.movethewheels.orders.list()
+await sdk.movethewheels.shipments.list()
+await sdk.movethewheels.tracking.list()
+await sdk.movethewheels.routes.list()
+await sdk.movethewheels.reports.list()
+await sdk.movethewheels.analytics.dashboard()
+```
+
+## Modules
+
+All methods are async. The following modules are mounted on the `MovethewheelsSDK`
+instance: `auth`, `billing`, `channels`, `conversations`, `devportal`,
+`export`, `files`, `groups`, `health`, `integrations`, `movethewheels`,
+`notifications`, `organizations`, `products`, `rbac`, `sandbox`, `scheduler`,
+`security`, `store`, `support`, `tags`, `tours`, `workspaces`.
+
+## Configuration
+
+```python
+from movethewheels_sdk import MovethewheelsSDK
+
+sdk = MovethewheelsSDK(
+    workspace_endpoint="https://graphqlworkspaces.burdenoff.com/workspaces/graphql",
+    global_endpoint="https://graphql.burdenoff.com/global/graphql",
+    client_id="burdenoff_cli_movethewheels",   # default
+    oidc_issuer=None,                       # derived from global_endpoint
+    api_key=None,
+    access_token=None,
+    refresh_token=None,
+    workspace_token=None,
+    timeout=30.0,
+    auto_refresh=True,
+)
+```
+
+## Error Handling
+
+```python
+from movethewheels_sdk import (
+    MovethewheelsError,
+    AuthenticationError,
+    AuthorizationError,
+    NetworkError,
+    ValidationError,
+    RateLimitError,
+    DeviceCodeExpiredError,
+    DeviceCodeDeniedError,
+)
+
+try:
+    await sdk.auth.sign_in(email="user@example.com", password="wrong")
+except AuthenticationError:
+    print("Invalid credentials")
+except NetworkError:
+    print("Could not reach the API")
+except MovethewheelsError as e:
+    print(f"SDK error: {e}")
+```
+
+## Development
+
+```bash
+python -m venv .venv && source .venv/bin/activate
+pip install -e ".[dev]"
+
+make format        # black + isort
+make lint          # flake8
+make type-check    # mypy (strict)
+make test          # pytest
+make sanity        # format-check + lint + type-check + test (cov>=80) + build
+```
+
+## License
+
+Proprietary — Copyright Burdenoff Consultancy Services Pvt. Ltd.
+
+## Support
+
+- Issues: [GitHub Issues](https://github.com/algoshred/movethewheels-sdk-python/issues)

movethewheels_sdk-2026.1107.1/docs/Makefile

@@ -0,0 +1,20 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line, and also
+# from the environment for the first two.
+SPHINXOPTS    ?=
+SPHINXBUILD  ?= sphinx-build
+SOURCEDIR    = .
+BUILDDIR     = _build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

movethewheels_sdk-2026.1107.1/docs/conf.py

@@ -0,0 +1,57 @@
+# Configuration file for the Sphinx documentation builder.
+#
+# For the full list of built-in configuration values, see the documentation:
+# https://www.sphinx-doc.org/en/master/usage/configuration.html
+
+# -- Project information -----------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
+
+project = 'Movethewheels SDK Python'
+copyright = '2026, Vignesh T.V'
+author = 'Vignesh T.V'
+release = '2026.627.1'
+
+# -- General configuration ---------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
+
+extensions = [
+    'sphinx.ext.autodoc',
+    'sphinx.ext.automodule',
+    'sphinx.ext.viewcode',
+    'sphinx.ext.napoleon',
+    'sphinx_autodoc_typehints',
+]
+
+templates_path = ['_templates']
+exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
+
+# -- Options for HTML output -------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
+
+html_theme = 'sphinx_rtd_theme'
+html_static_path = ['_static']
+
+# -- Options for autodoc ----------------------------------------------------
+autodoc_default_options = {
+    'members': True,
+    'member-order': 'bysource',
+    'special-members': '__init__',
+    'undoc-members': True,
+    'exclude-members': '__weakref__'
+}
+
+# -- Options for napoleon ---------------------------------------------------
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_init_with_doc = False
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
+napoleon_preprocess_types = False
+napoleon_type_aliases = None
+napoleon_attr_annotations = True

movethewheels_sdk-2026.1107.1/docs/index.rst

@@ -0,0 +1,18 @@
+Welcome to Movethewheels SDK Python's documentation!
+=============================================
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Contents:
+
+   quickstart
+   api
+   examples
+   contributing
+
+Indices and tables
+==================
+
+* :ref:`genindex`
+* :ref:`modindex`
+* :ref:`search`

movethewheels_sdk-2026.1107.1/examples/basic_usage.py

@@ -0,0 +1,36 @@
+"""Basic usage example for the Movethewheels Python SDK.
+
+Demonstrates how to:
+1. Initialize the SDK (defaults to the shared Burdenoff prod gateways)
+2. Sign in with email + password
+3. Access the nested Movethewheels-domain API and a shared module
+4. Clean up
+"""
+
+import asyncio
+
+from movethewheels_sdk import MovethewheelsSDK
+
+
+async def main() -> None:
+    # Defaults to the shared prod gateways and the burdenoff_cli_movethewheels
+    # OIDC client. Override workspace_endpoint / global_endpoint for local dev.
+    sdk = MovethewheelsSDK()
+
+    try:
+        # Sign in with email/password (delegated to the shared auth module).
+        await sdk.auth.sign_in(email="user@example.com", password="your-password")
+
+        # Movethewheels-domain operations are nested under sdk.movethewheels.
+        customers = await sdk.movethewheels.customers.list()
+        print(f"Found {len(customers)} customers")
+
+        # Shared cross-product modules are mounted at the top level.
+        tags = await sdk.tags.list()
+        print(f"Found {len(tags)} tags")
+    finally:
+        await sdk.close()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())