qiloback-sdk 0.3.2__tar.gz

qiloback_sdk-0.3.2/.gitignore

@@ -0,0 +1,64 @@
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+*.egg-info/
+dist/
+build/
+*.egg
+.venv/
+venv/
+
+# uv
+.python-version
+
+# Testing
+.coverage
+htmlcov/
+.pytest_cache/
+
+# Environment
+.env
+.env.local
+.env.production
+
+# Secrets (JWT keys, signing material)
+.keys/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Node (admin panel)
+node_modules/
+.next/
+out/
+.turbo/
+
+# Generated output
+generated/*/
+
+# Docker
+*.log
+
+# Lock files for generated projects
+# (the platform's own lock files are tracked)
+generated/**/.bp-lock.json
+
+# Database
+*.db
+*.sqlite3
+tsconfig.tsbuildinfo
+docs/internal/
+
+# uv.lock and pnpm-lock.yaml are committed for reproducibility — see
+# Renovate / Dependabot config for the bot-driven update cadence.
+wrappers/pip/.venv
+wrappers/pip/uv.lock

qiloback_sdk-0.3.2/LICENSE

@@ -0,0 +1,102 @@
+# Functional Source License, Version 1.1, Apache 2.0 Future License
+
+## Abbreviation
+
+FSL-1.1-ALv2
+
+## Notice
+
+Copyright 2026 XPlus Technologies LLC
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly display
+and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to
+the infringement of any patent, then your patent license to the Software ends
+immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES, EVEN
+IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the Apache License, Version 2.0 that is effective on the second anniversary of
+the date we make the Software available. On or after that date, you may use the
+Software under the Apache License, Version 2.0, in which case the following will
+apply:
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use
+this file except in compliance with the License. You may obtain a copy of the
+License at http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed
+under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+CONDITIONS OF ANY KIND, either express or implied. See the License for the
+specific language governing permissions and limitations under the License.

qiloback_sdk-0.3.2/PKG-INFO

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: qiloback-sdk
+Version: 0.3.2
+Summary: Official QiloBack Python SDK — talk to a QiloBack platform-api from Python.
+Project-URL: Homepage, https://qiloback.dev
+Project-URL: Documentation, https://qiloback.dev/docs/sdk-py
+Project-URL: Repository, https://github.com/delixon-labs/delixon-qiloback
+Project-URL: Issues, https://github.com/delixon-labs/delixon-qiloback/issues
+Author-email: Delixon Labs <hello@delixon.dev>
+License-Expression: LicenseRef-FSL-1.1-ALv2
+License-File: LICENSE
+Keywords: backend,client,dsl,fastapi,qiloback,sdk
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+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: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2.6
+Description-Content-Type: text/markdown
+
+# qiloback-sdk
+
+Official Python SDK for the QiloBack platform-api.
+
+## Install
+
+```bash
+pip install qiloback-sdk
+```
+
+## Quick start
+
+```python
+from qiloback import Client
+
+with Client(base_url="https://api.qiloback.dev", token="...") as qb:
+    project = qb.projects.create(name="My CRM", slug="my_crm")
+    qb.projects.upload_dsl(project.id, dsl_yaml)
+    log = qb.projects.generate(project.id)
+    print(log.status)
+
+    # Eject a portable bundle and write it to disk
+    bundle = qb.projects.eject(project.id)
+    bundle.save_to("./my-crm.zip")
+```
+
+The SDK is intentionally thin: it wraps the most-used surface
+(projects, DSL, generations, eject, audit, health) with type-safe
+methods, and falls back to a raw `client.request(...)` for anything
+not yet covered. The full 193-endpoint surface is auto-generated
+from the OpenAPI snapshot in v0.2.
+
+## Auth
+
+```python
+qb = Client(base_url="...", token="bearer-token")
+# or
+qb = Client(base_url="...")
+qb.set_token("bearer-token")
+```
+
+The SDK is sync today; an async variant (`AsyncClient`) ships in v0.2
+with the same surface.
+
+## License
+
+Source-available under FSL-1.1-ALv2. Auto-conversion to Apache 2.0 two
+years after each release. See the QiloBack LICENSE-FAQ for details.

qiloback_sdk-0.3.2/README.md

@@ -0,0 +1,48 @@
+# qiloback-sdk
+
+Official Python SDK for the QiloBack platform-api.
+
+## Install
+
+```bash
+pip install qiloback-sdk
+```
+
+## Quick start
+
+```python
+from qiloback import Client
+
+with Client(base_url="https://api.qiloback.dev", token="...") as qb:
+    project = qb.projects.create(name="My CRM", slug="my_crm")
+    qb.projects.upload_dsl(project.id, dsl_yaml)
+    log = qb.projects.generate(project.id)
+    print(log.status)
+
+    # Eject a portable bundle and write it to disk
+    bundle = qb.projects.eject(project.id)
+    bundle.save_to("./my-crm.zip")
+```
+
+The SDK is intentionally thin: it wraps the most-used surface
+(projects, DSL, generations, eject, audit, health) with type-safe
+methods, and falls back to a raw `client.request(...)` for anything
+not yet covered. The full 193-endpoint surface is auto-generated
+from the OpenAPI snapshot in v0.2.
+
+## Auth
+
+```python
+qb = Client(base_url="...", token="bearer-token")
+# or
+qb = Client(base_url="...")
+qb.set_token("bearer-token")
+```
+
+The SDK is sync today; an async variant (`AsyncClient`) ships in v0.2
+with the same surface.
+
+## License
+
+Source-available under FSL-1.1-ALv2. Auto-conversion to Apache 2.0 two
+years after each release. See the QiloBack LICENSE-FAQ for details.

qiloback_sdk-0.3.2/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "qiloback-sdk"
+version = "0.3.2"
+description = "Official QiloBack Python SDK — talk to a QiloBack platform-api from Python."
+readme = "README.md"
+license = "LicenseRef-FSL-1.1-ALv2"
+license-files = ["LICENSE"]
+requires-python = ">=3.10"
+authors = [
+    {name = "Delixon Labs", email = "hello@delixon.dev"},
+]
+keywords = ["qiloback", "sdk", "client", "backend", "fastapi", "dsl"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "httpx>=0.27",
+    "pydantic>=2.6",
+]
+
+[project.urls]
+Homepage = "https://qiloback.dev"
+Documentation = "https://qiloback.dev/docs/sdk-py"
+Repository = "https://github.com/delixon-labs/delixon-qiloback"
+Issues = "https://github.com/delixon-labs/delixon-qiloback/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/qiloback"]

qiloback_sdk-0.3.2/src/qiloback/__init__.py

@@ -0,0 +1,45 @@
+"""QiloBack Python SDK — sync client for the platform-api.
+
+Public surface kept deliberately small so the import line is a single
+``from qiloback import Client`` and everything else hangs off the
+client. The async variant lands in v0.2 alongside the auto-generated
+full-surface client; until then anything not exposed as a typed method
+is reachable via ``client.request("GET", "/api/v1/...")`` which
+returns the raw ``httpx.Response``.
+"""
+
+from __future__ import annotations
+
+from qiloback._client import Client, ComponentsAPI
+from qiloback._errors import (
+    APIError,
+    AuthError,
+    NotFoundError,
+    QiloBackError,
+    ValidationError,
+)
+from qiloback._models import (
+    DSLDiff,
+    EjectBundle,
+    GenerationLog,
+    Project,
+    ValidationResult,
+)
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "APIError",
+    "AuthError",
+    "Client",
+    "ComponentsAPI",
+    "DSLDiff",
+    "EjectBundle",
+    "GenerationLog",
+    "NotFoundError",
+    "Project",
+    "QiloBackError",
+    "ValidationError",
+    "ValidationResult",
+    "__version__",
+]

qiloback_sdk-0.3.2/src/qiloback/_client.py

@@ -0,0 +1,269 @@
+"""Sync client for the QiloBack platform-api.
+
+The class layers a small ergonomic surface (``client.projects.list()``)
+on top of an httpx.Client. Anything not covered by the typed methods
+is reachable through ``client.request(method, path, **kwargs)`` which
+returns the raw ``httpx.Response`` (after the 4xx/5xx mapping has run).
+"""
+
+from __future__ import annotations
+
+import re
+from collections.abc import Sequence
+from types import TracebackType
+from typing import Any
+from uuid import UUID
+
+import httpx
+
+from qiloback._errors import raise_for_response
+from qiloback._models import DSLDiff, EjectBundle, GenerationLog, Project, ValidationResult
+
+_FILENAME_RE = re.compile(r'filename="?([^"]+)"?')
+_DEFAULT_TIMEOUT = httpx.Timeout(30.0, connect=10.0)
+
+
+class Client:
+    """Sync entry point. Use as a context manager when possible.
+
+    >>> with Client(base_url="...", token="...") as qb:
+    ...     for project in qb.projects.list():
+    ...         print(project.slug)
+    """
+
+    def __init__(
+        self,
+        *,
+        base_url: str,
+        token: str | None = None,
+        timeout: float | httpx.Timeout = _DEFAULT_TIMEOUT,
+        http_client: httpx.Client | None = None,
+    ) -> None:
+        self._base_url = base_url.rstrip("/")
+        self._token = token or ""
+        self._owns_http = http_client is None
+        self._http = http_client or httpx.Client(
+            base_url=self._base_url,
+            timeout=timeout,
+        )
+        self.projects = ProjectsAPI(self)
+        self.audit = AuditAPI(self)
+        self.components = ComponentsAPI(self)
+
+    # ── Lifecycle ───────────────────────────────────────────────
+
+    def close(self) -> None:
+        if self._owns_http:
+            self._http.close()
+
+    def __enter__(self) -> Client:
+        return self
+
+    def __exit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc: BaseException | None,
+        tb: TracebackType | None,
+    ) -> None:
+        self.close()
+
+    # ── Auth ────────────────────────────────────────────────────
+
+    def set_token(self, token: str | None) -> None:
+        self._token = token or ""
+
+    @property
+    def token(self) -> str:
+        return self._token
+
+    # ── HTTP ────────────────────────────────────────────────────
+
+    def _headers(self, extra: dict[str, str] | None = None) -> dict[str, str]:
+        headers: dict[str, str] = {"Accept": "application/json"}
+        if self._token:
+            headers["Authorization"] = f"Bearer {self._token}"
+        if extra:
+            headers.update(extra)
+        return headers
+
+    def request(
+        self,
+        method: str,
+        path: str,
+        *,
+        params: dict[str, Any] | None = None,
+        json: Any = None,
+        headers: dict[str, str] | None = None,
+        timeout: float | httpx.Timeout | None = None,
+    ) -> httpx.Response:
+        """Lower-level call that bypasses the typed surface.
+
+        Useful for endpoints not yet wrapped by a method on the SDK.
+        Raises one of the SDK exception classes on a non-2xx status;
+        otherwise returns the raw ``httpx.Response``.
+        """
+        response = self._http.request(
+            method,
+            path,
+            params=params,
+            json=json,
+            headers=self._headers(headers),
+            timeout=timeout if timeout is not None else self._http.timeout,
+        )
+        raise_for_response(response)
+        return response
+
+    # ── High-level helpers ──────────────────────────────────────
+
+    def health(self) -> dict[str, Any]:
+        """Hit ``/health`` and return the JSON payload."""
+        response = self.request("GET", "/health")
+        result = response.json()
+        return result if isinstance(result, dict) else {}
+
+
+# ── Resource façades ────────────────────────────────────────────
+
+
+class _Resource:
+    def __init__(self, client: Client) -> None:
+        self._client = client
+
+
+class ProjectsAPI(_Resource):
+    """Wraps everything under ``/api/v1/projects``."""
+
+    def list(self, include_archived: bool = False) -> Sequence[Project]:
+        response = self._client.request(
+            "GET",
+            "/api/v1/projects",
+            params={"include_archived": str(include_archived).lower()},
+        )
+        return [Project.model_validate(row) for row in response.json()]
+
+    def get(self, project_id: UUID | str) -> Project:
+        response = self._client.request("GET", f"/api/v1/projects/{project_id}")
+        return Project.model_validate(response.json())
+
+    def create(
+        self,
+        *,
+        name: str,
+        slug: str,
+        description: str | None = None,
+    ) -> Project:
+        response = self._client.request(
+            "POST",
+            "/api/v1/projects",
+            json={"name": name, "slug": slug, "description": description},
+        )
+        return Project.model_validate(response.json())
+
+    def delete(self, project_id: UUID | str) -> None:
+        self._client.request("DELETE", f"/api/v1/projects/{project_id}")
+
+    # ── DSL ───────────────────────────────────────────────────
+
+    def upload_dsl(self, project_id: UUID | str, content: str) -> dict[str, Any]:
+        response = self._client.request(
+            "POST",
+            f"/api/v1/projects/{project_id}/dsl",
+            json={"content": content},
+        )
+        return dict(response.json())
+
+    def get_dsl(self, project_id: UUID | str) -> dict[str, Any]:
+        response = self._client.request("GET", f"/api/v1/projects/{project_id}/dsl")
+        return dict(response.json())
+
+    def validate_dsl(self, project_id: UUID | str) -> ValidationResult:
+        response = self._client.request("POST", f"/api/v1/projects/{project_id}/validate")
+        return ValidationResult.model_validate(response.json())
+
+    def diff_dsl(self, project_id: UUID | str, proposed_content: str) -> DSLDiff:
+        response = self._client.request(
+            "POST",
+            f"/api/v1/projects/{project_id}/dsl/diff",
+            json={"content": proposed_content},
+        )
+        return DSLDiff.model_validate(response.json())
+
+    # ── Codegen ───────────────────────────────────────────────
+
+    def generate(self, project_id: UUID | str) -> GenerationLog:
+        response = self._client.request("POST", f"/api/v1/projects/{project_id}/generate")
+        return GenerationLog.model_validate(response.json())
+
+    def list_generations(self, project_id: UUID | str) -> Sequence[GenerationLog]:
+        response = self._client.request("GET", f"/api/v1/projects/{project_id}/generations")
+        return [GenerationLog.model_validate(row) for row in response.json()]
+
+    # ── Eject (the anti-lock-in surface) ─────────────────────
+
+    def eject(self, project_id: UUID | str) -> EjectBundle:
+        """Download the portable bundle for a project.
+
+        Returns an :class:`EjectBundle` carrying the zip bytes and the
+        filename suggested by the platform — call ``.save_to(path)``
+        to write it to disk.
+        """
+        response = self._client.request(
+            "POST",
+            f"/api/v1/projects/{project_id}/eject",
+        )
+        return EjectBundle(
+            content=response.content,
+            filename=_extract_filename(response.headers.get("content-disposition", "")),
+        )
+
+
+class ComponentsAPI(_Resource):
+    """Read access to the platform's component marketplace.
+
+    Same shape the panel and the MCP server consume — list returns
+    summaries (light-weight, scannable in a table), get returns the
+    full manifest. Both endpoints are unauthenticated by design;
+    the marketplace is public information so anyone can browse
+    before installing.
+    """
+
+    def list(self) -> Sequence[dict[str, Any]]:
+        response = self._client.request("GET", "/api/v1/components")
+        body = response.json()
+        if isinstance(body, dict):
+            return list(body.get("components", []))
+        return list(body) if isinstance(body, list) else []
+
+    def get(self, name: str) -> dict[str, Any]:
+        response = self._client.request("GET", f"/api/v1/components/{name}")
+        return dict(response.json())
+
+
+class AuditAPI(_Resource):
+    """Read access to the platform's audit log."""
+
+    def events(
+        self,
+        *,
+        project_id: UUID | str | None = None,
+        event_type: str | None = None,
+        limit: int = 50,
+    ) -> Sequence[dict[str, Any]]:
+        params: dict[str, Any] = {"limit": int(limit)}
+        if project_id is not None:
+            params["project_id"] = str(project_id)
+        if event_type is not None:
+            params["event_type"] = event_type
+        response = self._client.request("GET", "/api/v1/audit/events", params=params)
+        body = response.json()
+        return list(body) if isinstance(body, list) else list(body.get("events", []))
+
+
+# ── Helpers ────────────────────────────────────────────────────
+
+
+def _extract_filename(content_disposition: str) -> str:
+    if not content_disposition:
+        return "qiloback-eject.zip"
+    match = _FILENAME_RE.search(content_disposition)
+    return match.group(1) if match else "qiloback-eject.zip"