burdenoff-sdk-libs 2026.523.1__tar.gz

burdenoff_sdk_libs-2026.523.1/.gitignore

@@ -0,0 +1,16 @@
+__pycache__
+*.py[cod]
+*.egg-info
+build
+dist
+.eggs
+.pytest_cache
+.mypy_cache
+.coverage
+htmlcov
+coverage.xml
+.venv
+.env
+src/burdenoff_sdk_libs/**/__generated__
+schema/supergraph.graphql
+.pypirc

burdenoff_sdk_libs-2026.523.1/LICENSE

@@ -0,0 +1,4 @@
+Copyright (c) 2026 Burdenoff Consultancy Services Private Limited, Algoshred Technologies Private Limited and all sister companies.
+All rights reserved.
+
+Proprietary software. Unauthorized use, distribution, or modification is prohibited.

burdenoff_sdk_libs-2026.523.1/PKG-INFO

@@ -0,0 +1,97 @@
+Metadata-Version: 2.4
+Name: burdenoff-sdk-libs
+Version: 2026.523.1
+Summary: Modular SDK library shared across all Burdenoff product SDKs (Python). Each module exposes attach(ctx) returning a typed API; product SDKs pick which modules to mount. Sister to @burdenoff/cli-sdk.
+Project-URL: Homepage, https://github.com/algoshred/sdk-libs-python
+Project-URL: Repository, https://github.com/algoshred/sdk-libs-python
+Project-URL: Issues, https://github.com/algoshred/sdk-libs-python/issues
+Author-email: "Vignesh T.V" <vignesh@burdenoff.com>
+Maintainer-email: "Vignesh T.V" <vignesh@burdenoff.com>
+License: Copyright (c) 2026 Burdenoff Consultancy Services Private Limited, Algoshred Technologies Private Limited and all sister companies.
+        All rights reserved.
+        
+        Proprietary software. Unauthorized use, distribution, or modification is prohibited.
+License-File: LICENSE
+Keywords: burdenoff,graphql,modular,python,sdk,sdk-libs
+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 :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: typing-extensions>=4.0.0; python_version < '3.11'
+Provides-Extra: codegen
+Requires-Dist: ariadne-codegen>=0.13.0; extra == 'codegen'
+Provides-Extra: dev
+Requires-Dist: ariadne-codegen>=0.13.0; 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.7.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'
+Requires-Dist: respx>=0.21.0; extra == 'dev'
+Provides-Extra: test
+Requires-Dist: httpx[testing]>=0.24.0; 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'
+Provides-Extra: ws
+Requires-Dist: httpx-ws>=0.6.0; extra == 'ws'
+Description-Content-Type: text/markdown
+
+# burdenoff-sdk-libs
+
+Modular SDK library shared across all Burdenoff product SDKs (Python).
+
+Each module under `src/burdenoff_sdk_libs/modules/<name>/` exports an `SdkModule` (a dataclass with `attach(ctx) -> API`). Product SDKs (`vibecontrols-sdk-python`, `botlit-sdk-python`, etc.) become thin shells that pick which modules to mount. Sister to [`@burdenoff/sdk-libs`](https://github.com/algoshred/sdk-libs-node) (Node) and [`@burdenoff/cli-sdk`](https://github.com/algoshred/cli-sdk).
+
+## Architecture
+
+- **Core** (`src/burdenoff_sdk_libs/core/`): `SdkContext`, `SdkModule` Protocol, dual-gateway `BaseGraphQLClient` (workspace + global), `AuthStore` with pluggable `TokenStore` (`InMemoryTokenStore`, `FileTokenStore`, `EnvTokenStore`), error hierarchy with token redaction, structured logger, `ModuleRegistry`.
+- **Modules** (`src/burdenoff_sdk_libs/modules/<name>/`): `__init__.py` exports `SdkModule` instance. `operations.py` holds hand-written GraphQL doc strings. `api.py` builds the API. Generated types land at `src/burdenoff_sdk_libs/modules/<name>/__generated__/types.py` (gitignored).
+- **PEP 562 lazy imports**: top-level `__getattr__` defers module loading until first access (lambda/edge cold-start friendly).
+- **Hard rules**: Modules NEVER import each other directly — use `ctx.modules.get('id')`. Modules NEVER print, raise plain `Exception`, or log secrets unredacted.
+
+## Build & Commands
+
+```bash
+python -m venv .venv && source .venv/bin/activate
+pip install -e ".[dev]"
+pytest                            # unit tests
+pytest --cov                      # with coverage
+python scripts/codegen.py         # generate types from pinned supergraph
+python scripts/parity_check.py    # cross-language manifest diff vs sdk-libs-node
+python -m build                   # sdist + wheel
+```
+
+## Adding a module
+
+1. `mkdir src/burdenoff_sdk_libs/modules/<id>` with `__init__.py`, `operations.py`, `api.py`, `types.py`.
+2. Export `SdkModule` instance from `__init__.py` (e.g. `auth_module = AuthModule()`).
+3. Add to `_LAZY_MODULES` in top-level `__init__.py` if surfacing at package root.
+4. Add manifest entry to `schema/modules.yaml`.
+5. Mirror in `~/products/sdk-libs-node/` in the SAME PR pair.
+
+## Testing
+
+- Unit (`tests/test_*.py`): pure logic. No HTTP. pytest, <5s.
+- Integration: respx intercepts HTTP. Mock factories derived from `__generated__/types.py`.
+- E2E: real svc + state, run nightly.
+- Parity: same `tests/parity/<scenario>.yaml` run by node + python.
+
+## Reference
+
+- `~/products/sdk-libs-node/` — sister Node library.
+- `~/products/cli-sdk/` — sister CLI library.
+- `~/products/vibecontrols/vibecontrols-sdk-python/` — first consumer (thin shell).
+- `~/products/dev/audit/index/vibecontrols.md` — 23-module ground-truth.

burdenoff_sdk_libs-2026.523.1/README.md

@@ -0,0 +1,46 @@
+# burdenoff-sdk-libs
+
+Modular SDK library shared across all Burdenoff product SDKs (Python).
+
+Each module under `src/burdenoff_sdk_libs/modules/<name>/` exports an `SdkModule` (a dataclass with `attach(ctx) -> API`). Product SDKs (`vibecontrols-sdk-python`, `botlit-sdk-python`, etc.) become thin shells that pick which modules to mount. Sister to [`@burdenoff/sdk-libs`](https://github.com/algoshred/sdk-libs-node) (Node) and [`@burdenoff/cli-sdk`](https://github.com/algoshred/cli-sdk).
+
+## Architecture
+
+- **Core** (`src/burdenoff_sdk_libs/core/`): `SdkContext`, `SdkModule` Protocol, dual-gateway `BaseGraphQLClient` (workspace + global), `AuthStore` with pluggable `TokenStore` (`InMemoryTokenStore`, `FileTokenStore`, `EnvTokenStore`), error hierarchy with token redaction, structured logger, `ModuleRegistry`.
+- **Modules** (`src/burdenoff_sdk_libs/modules/<name>/`): `__init__.py` exports `SdkModule` instance. `operations.py` holds hand-written GraphQL doc strings. `api.py` builds the API. Generated types land at `src/burdenoff_sdk_libs/modules/<name>/__generated__/types.py` (gitignored).
+- **PEP 562 lazy imports**: top-level `__getattr__` defers module loading until first access (lambda/edge cold-start friendly).
+- **Hard rules**: Modules NEVER import each other directly — use `ctx.modules.get('id')`. Modules NEVER print, raise plain `Exception`, or log secrets unredacted.
+
+## Build & Commands
+
+```bash
+python -m venv .venv && source .venv/bin/activate
+pip install -e ".[dev]"
+pytest                            # unit tests
+pytest --cov                      # with coverage
+python scripts/codegen.py         # generate types from pinned supergraph
+python scripts/parity_check.py    # cross-language manifest diff vs sdk-libs-node
+python -m build                   # sdist + wheel
+```
+
+## Adding a module
+
+1. `mkdir src/burdenoff_sdk_libs/modules/<id>` with `__init__.py`, `operations.py`, `api.py`, `types.py`.
+2. Export `SdkModule` instance from `__init__.py` (e.g. `auth_module = AuthModule()`).
+3. Add to `_LAZY_MODULES` in top-level `__init__.py` if surfacing at package root.
+4. Add manifest entry to `schema/modules.yaml`.
+5. Mirror in `~/products/sdk-libs-node/` in the SAME PR pair.
+
+## Testing
+
+- Unit (`tests/test_*.py`): pure logic. No HTTP. pytest, <5s.
+- Integration: respx intercepts HTTP. Mock factories derived from `__generated__/types.py`.
+- E2E: real svc + state, run nightly.
+- Parity: same `tests/parity/<scenario>.yaml` run by node + python.
+
+## Reference
+
+- `~/products/sdk-libs-node/` — sister Node library.
+- `~/products/cli-sdk/` — sister CLI library.
+- `~/products/vibecontrols/vibecontrols-sdk-python/` — first consumer (thin shell).
+- `~/products/dev/audit/index/vibecontrols.md` — 23-module ground-truth.

burdenoff_sdk_libs-2026.523.1/pyproject.toml

@@ -0,0 +1,138 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "burdenoff-sdk-libs"
+version = "2026.523.1"
+description = "Modular SDK library shared across all Burdenoff product SDKs (Python). Each module exposes attach(ctx) returning a typed API; product SDKs pick which modules to mount. Sister to @burdenoff/cli-sdk."
+readme = "README.md"
+license = {file = "LICENSE"}
+authors = [
+    {name = "Vignesh T.V", email = "vignesh@burdenoff.com"}
+]
+maintainers = [
+    {name = "Vignesh T.V", email = "vignesh@burdenoff.com"}
+]
+keywords = [
+    "burdenoff",
+    "sdk",
+    "sdk-libs",
+    "graphql",
+    "modular",
+    "python",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: Other/Proprietary License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+requires-python = ">=3.10"
+dependencies = [
+    "httpx>=0.24.0",
+    "typing-extensions>=4.0.0; python_version<'3.11'",
+    "PyYAML>=6.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "pytest-cov>=4.0.0",
+    "respx>=0.21.0",
+    "black>=23.0.0",
+    "isort>=5.12.0",
+    "flake8>=6.0.0",
+    "mypy>=1.7.0",
+    "ariadne-codegen>=0.13.0",
+]
+test = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "pytest-cov>=4.0.0",
+    "respx>=0.21.0",
+    "httpx[testing]>=0.24.0",
+]
+codegen = [
+    "ariadne-codegen>=0.13.0",
+]
+ws = [
+    "httpx-ws>=0.6.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/algoshred/sdk-libs-python"
+Repository = "https://github.com/algoshred/sdk-libs-python"
+Issues = "https://github.com/algoshred/sdk-libs-python/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/burdenoff_sdk_libs"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src",
+    "/tests",
+    "/schema",
+    "/scripts",
+    "README.md",
+    "LICENSE",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py", "*_test.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = [
+    "--cov=burdenoff_sdk_libs",
+    "--cov-report=term-missing",
+    "--strict-markers",
+    "--disable-warnings",
+]
+asyncio_mode = "auto"
+markers = [
+    "slow: marks tests as slow",
+    "integration: marks tests as integration tests",
+    "unit: marks tests as unit tests",
+]
+
+[tool.coverage.run]
+source = ["src/burdenoff_sdk_libs"]
+omit = ["*/tests/*", "*/__pycache__/*", "*/__generated__/*"]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "def __repr__",
+    "raise NotImplementedError",
+    "if 0:",
+    "class .*\\bProtocol\\):",
+    "@(abc\\.)?abstractmethod",
+    "TYPE_CHECKING",
+]
+
+[tool.black]
+line-length = 100
+target-version = ["py313"]
+
+[tool.isort]
+profile = "black"
+line_length = 100
+
+[tool.flake8]
+max-line-length = 100
+extend-ignore = ["E203", "W503"]
+exclude = [".git", "__pycache__", "build", "dist", ".venv", "**/__generated__/**"]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+warn_unused_ignores = true
+exclude = ["tests/", "build/", "dist/", "**/__generated__/**"]

burdenoff_sdk_libs-2026.523.1/schema/SUPERGRAPH_PIN

@@ -0,0 +1 @@
+d3a2c296710d664134cb307eb44e9c0cc715b64852643300fabde59fe09f19c5