@apollo-deploy/tesseract 0.9.1 → 1.0.0

package/templates/php/types.hbs

@@ -0,0 +1,95 @@
+<?php
+
+/**
+ * @generated
+ * This file was automatically generated by Tesseract.
+ * DO NOT MODIFY THIS FILE DIRECTLY.
+ */
+
+declare(strict_types=1);
+
+namespace {{namespace}};
+
+{{#each schemas}}
+{{#if isEnum}}
+/**
+{{#if description}}
+ * {{description}}
+ *
+{{/if}}
+ * @generated
+ */
+enum {{name}}: {{#each properties}}{{#if @first}}{{type}}{{/if}}{{/each}}
+{
+{{#each enumValues}}
+    case {{this}} = '{{this}}';
+{{/each}}
+}
+
+{{else if isTypeAlias}}
+{{!-- PHP type aliases are not direct; they are used as docblock hints --}}
+{{!-- Skipping type alias: {{name}} --}}
+
+{{else if isUnionType}}
+{{!-- PHP union types are handled via properties, not standalone declarations --}}
+{{!-- Skipping union type: {{name}} --}}
+
+{{else}}
+/**
+{{#if description}}
+ * {{description}}
+ *
+{{/if}}
+ * @generated
+ */
+class {{name}}{{#if extends}} extends {{extends}}{{/if}}
+{
+{{#each properties}}
+    /**
+     * @var {{tsType type nullable}}
+     */
+    public {{#if nullable}}?{{/if}}{{type}} ${{name}}{{#if defaultValue}} = {{{json defaultValue}}}{{/if}};
+
+{{/each}}
+
+    /**
+     * @param array<string, mixed> $data
+     */
+    public static function fromArray(array $data): self
+    {
+        $instance = new self();
+
+        {{#each properties}}
+        {{#if (eq type "string")}}
+        $instance->{{name}} = isset($data['{{name}}']) ? (string) $data['{{name}}'] : {{#if required}}throw new \InvalidArgumentException('Missing required field: {{name}}'){{else}}null{{/if}};
+        {{else if (eq type "int")}}
+        $instance->{{name}} = isset($data['{{name}}']) ? (int) $data['{{name}}'] : {{#if required}}throw new \InvalidArgumentException('Missing required field: {{name}}'){{else}}null{{/if}};
+        {{else if (eq type "float")}}
+        $instance->{{name}} = isset($data['{{name}}']) ? (float) $data['{{name}}'] : {{#if required}}throw new \InvalidArgumentException('Missing required field: {{name}}'){{else}}null{{/if}};
+        {{else if (eq type "bool")}}
+        $instance->{{name}} = isset($data['{{name}}']) ? (bool) $data['{{name}}'] : {{#if required}}throw new \InvalidArgumentException('Missing required field: {{name}}'){{else}}null{{/if}};
+        {{else if (eq type "array")}}
+        $instance->{{name}} = isset($data['{{name}}']) ? (array) $data['{{name}}'] : {{#if required}}[]{{else}}null{{/if}};
+        {{else}}
+        $instance->{{name}} = $data['{{name}}'] ?? {{#if required}}throw new \InvalidArgumentException('Missing required field: {{name}}'){{else}}null{{/if}};
+        {{/if}}
+
+        {{/each}}
+        return $instance;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function toArray(): array
+    {
+        return [
+            {{#each properties}}
+            '{{name}}' => $this->{{name}},
+            {{/each}}
+        ];
+    }
+}
+
+{{/if}}
+{{/each}}

package/templates/python/client.hbs

@@ -0,0 +1,102 @@
+"""{{title}} SDK Client"""
+
+from typing import Optional, Dict, Any, List, Callable, Union
+import httpx
+from .transport import create_transport, SDKTransport, RequestOptions
+{{#each groups}}
+from .resources.{{fileName}} import {{interfaceName}}
+{{/each}}
+
+{{#if hasSSE}}
+# SSE support requires the sseclient-py package:
+#   pip install sseclient-py>=1.8.0
+{{/if}}
+
+class {{clientName}}ClientConfig:
+    """Configuration for {{title}} client."""
+
+    def __init__(
+        self,
+        base_url: str = "{{baseUrl}}",
+{{#each securitySchemes}}
+{{#if (eq type "apiKey")}}
+        {{configKey}}: Optional[str] = None,
+{{/if}}
+{{#if (and (eq type "http") (eq scheme "bearer"))}}
+        {{configKey}}: Optional[str] = None,
+{{/if}}
+{{#if (eq type "oauth2")}}
+        {{configKey}}: Optional[str] = None,
+{{/if}}
+{{#if (eq type "openIdConnect")}}
+        {{configKey}}: Optional[str] = None,
+{{/if}}
+{{/each}}
+        timeout_ms: int = 15000,
+        retries: int = 3,
+        default_headers: Optional[Dict[str, str]] = None,
+        on_request: Optional[Callable] = None,
+        on_response: Optional[Callable] = None,
+        on_error: Optional[Callable] = None,
+    ):
+        self.base_url = base_url
+{{#each securitySchemes}}
+        self.{{configKey}} = {{configKey}}
+{{/each}}
+        self.timeout_ms = timeout_ms
+        self.retries = retries
+        self.default_headers = default_headers or {}
+        self.on_request = on_request
+        self.on_response = on_response
+        self.on_error = on_error
+
+
+class {{clientName}}Client:
+    """{{title}} SDK Client"""
+
+    def __init__(self, config: Optional[{{clientName}}ClientConfig] = None):
+        self.config = config or {{clientName}}ClientConfig()
+        self._transport = create_transport(
+            base_url=self.config.base_url,
+{{#each securitySchemes}}
+            {{configKey}}=self.config.{{configKey}},
+{{/each}}
+            timeout_ms=self.config.timeout_ms,
+            retries=self.config.retries,
+            default_headers=self.config.default_headers,
+            on_request=self.config.on_request,
+            on_response=self.config.on_response,
+            on_error=self.config.on_error,
+        )
+{{#each groups}}
+        self.{{snakeCase name}} = {{interfaceName}}(self._transport)
+{{/each}}
+
+
+def create_{{snakeCase clientName}}_client(
+    base_url: str = "{{baseUrl}}",
+{{#each securitySchemes}}
+{{#if (eq type "apiKey")}}
+    {{configKey}}: Optional[str] = None,
+{{/if}}
+{{#if (and (eq type "http") (eq scheme "bearer"))}}
+    {{configKey}}: Optional[str] = None,
+{{/if}}
+{{#if (eq type "oauth2")}}
+    {{configKey}}: Optional[str] = None,
+{{/if}}
+{{#if (eq type "openIdConnect")}}
+    {{configKey}}: Optional[str] = None,
+{{/if}}
+{{/each}}
+    **kwargs,
+) -> {{clientName}}Client:
+    """Create a new {{title}} SDK client."""
+    config = {{clientName}}ClientConfig(
+        base_url=base_url,
+{{#each securitySchemes}}
+        {{configKey}}={{configKey}},
+{{/each}}
+        **kwargs,
+    )
+    return {{clientName}}Client(config)

package/templates/python/domain.hbs

@@ -0,0 +1,139 @@
+"""{{interfaceName}} operations."""
+
+from typing import Optional, Dict, Any, List
+{{#if imports.length}}
+from ..types import {{#each imports}}{{this}}{{#unless @last}}, {{/unless}}{{/each}}
+{{/if}}
+from ..transport import SDKTransport, RequestOptions
+from ..errors import SDKError
+
+
+class {{interfaceName}}:
+    """{{#if description}}{{description}}{{else}}{{interfaceName}} API operations{{/if}}"""
+
+    def __init__(self, transport: SDKTransport):
+        self._transport = transport
+
+{{#each operations}}
+{{#if isEventStream}}
+    def {{snakeCase name}}(
+        self,
+{{#each pathParams}}
+        {{name}}: str,
+{{/each}}
+{{#if (and queryType (not queryParams.length))}}
+        *,
+        query: Optional[Dict[str, Any]] = None,
+{{/if}}
+{{#if queryParams.length}}
+        *,
+{{#each queryParams}}
+        {{name}}: Optional[{{pythonType type}}] = None,
+{{/each}}
+{{/if}}
+        options: Optional[RequestOptions] = None,
+    ):
+        """{{#if summary}}{{summary}}{{#if description}} - {{description}}{{/if}}{{else if description}}{{description}}{{/if}} (SSE stream)
+        """
+{{#if deprecated}}
+        # @deprecated {{deprecationMessage}}
+{{/if}}
+        # Build path with parameter substitution
+        _path = "{{path}}"
+{{#each pathParams}}
+        _path = _path.replace("{" + "{{originalName}}" + "}", str({{name}}))
+{{/each}}
+
+        # Build query parameters
+        _query: Dict[str, Any] = {}
+{{#each queryParams}}
+        if query is not None and hasattr(query, "{{name}}") and getattr(query, "{{name}}") is not None:
+            _query["{{originalName}}"] = getattr(query, "{{name}}")
+{{/each}}
+
+        response = self._transport.request(
+            method="{{httpMethod}}",
+            path=_path,
+            query=_query if _query else None,
+            options=options,
+        )
+        return response.json()
+
+{{else}}
+    def {{snakeCase name}}(
+        self,
+{{#each pathParams}}
+        {{name}}: str,
+{{/each}}
+{{#if requestBody}}
+        body: {{pythonType requestBody.type}},
+{{/if}}
+{{#if (and queryType (not queryParams.length))}}
+        *,
+        query: Optional[Dict[str, Any]] = None,
+{{/if}}
+{{#if queryParams.length}}
+        *,
+{{#each queryParams}}
+        {{name}}: Optional[{{pythonType type}}] = None,
+{{/each}}
+{{/if}}
+{{#if headerType}}
+        headers: Optional[{{pythonType headerType}}] = None,
+{{/if}}
+        options: Optional[RequestOptions] = None,
+    ) -> {{pythonType responseType}}:
+        """{{#if summary}}{{summary}}{{#if description}} - {{description}}{{/if}}{{else if description}}{{description}}{{/if}}
+        """
+{{#if deprecated}}
+        # @deprecated {{deprecationMessage}}
+{{/if}}
+        # Build path with parameter substitution
+        _path = "{{path}}"
+{{#each pathParams}}
+        _path = _path.replace("{" + "{{originalName}}" + "}", str({{name}}))
+{{/each}}
+
+        # Build query parameters
+        _query: Dict[str, Any] = {}
+{{#each queryParams}}
+        if {{name}} is not None:
+            _query["{{originalName}}"] = {{name}}
+{{/each}}
+{{#if queryType}}
+        if query is not None:
+            _items = query.__dict__.items() if hasattr(query, "__dict__") else []
+            for k, v in _items:
+                if v is not None:
+                    _query[k] = v
+{{/if}}
+
+        # Build headers
+        _headers: Dict[str, str] = {}
+{{#each headerParams}}
+        if headers is not None and hasattr(headers, "{{name}}") and getattr(headers, "{{name}}") is not None:
+            _headers["{{originalName}}"] = str(getattr(headers, "{{name}}"))
+{{/each}}
+
+{{#if (hasRequestBody this)}}
+        _content_type = "{{requestBody.contentType}}"
+{{/if}}
+
+        response = self._transport.request(
+            method="{{httpMethod}}",
+            path=_path,
+{{#if (or queryParams.length queryType)}}
+            query=_query if _query else None,
+{{/if}}
+{{#if (hasRequestBody this)}}
+            body=body,
+            content_type=_content_type,
+{{/if}}
+{{#if (or headerParams.length (hasRequestBody this))}}
+            options=RequestOptions(headers=_headers if _headers else None),
+{{/if}}
+        )
+        return response.json()
+
+{{/if}}
+{{/each}}

package/templates/python/index.hbs

@@ -0,0 +1,20 @@
+"""
+{{title}} Python SDK
+"""
+
+from .client import create_{{snakeCase clientName}}_client, {{clientName}}Client
+from .errors import SDKError
+from .resources import (
+{{#each groups}}
+    {{interfaceName}},
+{{/each}}
+)
+
+__all__ = [
+    "create_{{snakeCase clientName}}_client",
+    "{{clientName}}Client",
+    "SDKError",
+{{#each groups}}
+    "{{interfaceName}}",
+{{/each}}
+]

package/templates/python/pyproject.hbs

@@ -0,0 +1,26 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "{{packageName}}"
+version = "{{#if packageVersion}}{{packageVersion}}{{else}}{{version}}{{/if}}"
+description = "{{#if description}}{{description}}{{else}}Python SDK for {{title}}{{/if}}"
+readme = "README.md"
+requires-python = ">=3.9"
+license = {text = "MIT"}
+dependencies = [
+    "httpx>=0.27.0",
+    "pydantic>=2.0.0",
+    "python-dateutil>=2.8.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.24.0",
+    "mypy>=1.0",
+]
+
+[tool.setuptools.packages.find]
+include = ["{{moduleName}}*"]

package/templates/python/readme.hbs

@@ -0,0 +1,64 @@
+# {{title}} Python SDK
+
+{{#if description}}
+{{description}}
+{{/if}}
+
+> Auto-generated by Tesseract.
+
+## Installation
+
+```bash
+pip install {{packageName}}
+```
+
+## Quick Start
+
+```python
+from {{moduleName}} import create_{{snakeCase clientName}}_client
+
+client = create_{{snakeCase clientName}}_client(
+    base_url="{{baseUrl}}",
+{{#each securitySchemes}}
+{{#if (eq type "apiKey")}}
+    {{configKey}}="your-api-key",
+{{/if}}
+{{#if (and (eq type "http") (eq scheme "bearer"))}}
+    {{configKey}}="your-bearer-token",
+{{/if}}
+{{/each}}
+)
+
+{{#with groups.[0]}}
+# Example: {{interfaceName}}
+result = client.{{snakeCase name}}.{{snakeCase operations.[0].name}}()
+{{/with}}
+```
+
+## API Reference
+
+{{#each groups}}
+### {{interfaceName}}
+
+{{#if description}}
+{{description}}
+{{/if}}
+
+| Method | HTTP | Path | Description |
+|--------|------|------|-------------|
+{{#each operations}}
+| `{{name}}` | {{httpMethod}} | `{{path}}` | {{#if description}}{{description}}{{else}}-{{/if}} |
+{{/each}}
+
+{{/each}}
+
+## Error Handling
+
+```python
+from {{moduleName}}.errors import SDKError
+
+try:
+    result = client.some_api.some_method()
+except SDKError as e:
+    print(f"Error {e.status}: {e.message} ({e.code})")
+```

package/templates/python/resources-init.hbs

@@ -0,0 +1,11 @@
+"""API resource modules for {{moduleName}}."""
+
+{{#each groups}}
+from .{{fileName}} import {{interfaceName}}
+{{/each}}
+
+__all__ = [
+{{#each groups}}
+    "{{interfaceName}}",
+{{/each}}
+]

package/templates/python/transport.hbs

@@ -0,0 +1,191 @@
+"""HTTP transport layer for {{moduleName}}."""
+
+import time
+import json
+import random
+from typing import Optional, Dict, Any, Callable
+from urllib.parse import urlencode
+import httpx
+from .errors import SDKError
+
+
+class RequestOptions:
+    """Per-request options."""
+
+    def __init__(
+        self,
+        timeout_ms: Optional[int] = None,
+        headers: Optional[Dict[str, str]] = None,
+        signal: Optional[Any] = None,
+    ):
+        self.timeout_ms = timeout_ms
+        self.headers = headers or {}
+        self.signal = signal
+
+
+class SDKTransport:
+    """HTTP transport with retry, auth, and error handling."""
+
+    def __init__(
+        self,
+        base_url: str,
+{{#each securitySchemes}}
+        {{configKey}}: Optional[str] = None,
+{{/each}}
+        timeout_ms: int = 15000,
+        retries: int = 3,
+        default_headers: Optional[Dict[str, str]] = None,
+        on_request: Optional[Callable] = None,
+        on_response: Optional[Callable] = None,
+        on_error: Optional[Callable] = None,
+    ):
+        self.base_url = base_url.rstrip("/")
+{{#each securitySchemes}}
+        self._{{configKey}} = {{configKey}}
+{{/each}}
+        self.timeout_ms = timeout_ms
+        self.max_retries = retries
+        self.default_headers = default_headers or {}
+        self.on_request = on_request
+        self.on_response = on_response
+        self.on_error = on_error
+        self._client = httpx.Client(timeout=timeout_ms / 1000.0)
+
+    def _build_headers(self, extra_headers: Optional[Dict[str, str]] = None) -> Dict[str, str]:
+        headers = {**self.default_headers}
+{{#each securitySchemes}}
+{{#if (eq type "apiKey")}}
+        if self._{{configKey}}:
+            headers["{{paramName}}"] = self._{{configKey}}
+{{/if}}
+{{#if (and (eq type "http") (eq scheme "bearer"))}}
+        if self._{{configKey}}:
+            headers["Authorization"] = "Bearer " + self._{{configKey}}
+{{/if}}
+{{#if (eq type "oauth2")}}
+        if self._{{configKey}}:
+            headers["Authorization"] = "Bearer " + self._{{configKey}}
+{{/if}}
+{{#if (eq type "openIdConnect")}}
+        if self._{{configKey}}:
+            headers["Authorization"] = "Bearer " + self._{{configKey}}
+{{/if}}
+{{/each}}
+        if extra_headers:
+            headers.update(extra_headers)
+        return headers
+
+    def request(
+        self,
+        method: str,
+        path: str,
+        query: Optional[Dict[str, Any]] = None,
+        body: Optional[Any] = None,
+        content_type: str = "application/json",
+        options: Optional[RequestOptions] = None,
+    ) -> httpx.Response:
+        """Execute an HTTP request with retry logic."""
+        url = self.base_url + path
+        headers = self._build_headers(options.headers if options else None)
+        timeout = (options.timeout_ms if options and options.timeout_ms else self.timeout_ms) / 1000.0
+
+        if query:
+            filtered = {k: v for k, v in query.items() if v is not None}
+            if filtered:
+                url += "?" + urlencode(filtered)
+
+        data = None
+        if body is not None:
+            if content_type == "application/json":
+                data = json.dumps(body, default=str)
+                headers["Content-Type"] = "application/json"
+            else:
+                data = body
+
+        last_error = None
+        for attempt in range(self.max_retries + 1):
+            try:
+                if self.on_request:
+                    self.on_request(method, url, attempt)
+
+                response = self._client.request(
+                    method=method,
+                    url=url,
+                    headers=headers,
+                    content=data,
+                    timeout=timeout,
+                )
+
+                if self.on_response:
+                    self.on_response(response)
+
+                if response.status_code >= 400:
+                    self._handle_error_response(response)
+
+                return response
+
+            except httpx.TimeoutException as e:
+                last_error = SDKError("Request timed out: " + str(e), 0, "timeout")
+            except httpx.NetworkError as e:
+                last_error = SDKError("Network error: " + str(e), 0, "network_error")
+            except SDKError:
+                raise
+            except Exception as e:
+                last_error = SDKError("Request failed: " + str(e), 0, "unknown_error")
+
+            if attempt < self.max_retries:
+                delay = min(1000 * (2 ** attempt) + random.uniform(0, 500), 30000) / 1000.0
+                time.sleep(delay)
+
+        if self.on_error and last_error:
+            self.on_error(last_error)
+        raise last_error
+
+    def _handle_error_response(self, response: httpx.Response) -> None:
+        try:
+            body = response.json()
+            error_code = body.get("error", "unknown_error")
+            message = body.get("message", response.text)
+            request_id = body.get("request_id")
+            raise SDKError(message, response.status_code, error_code, request_id)
+        except (json.JSONDecodeError, KeyError):
+            raise SDKError(
+                "HTTP " + str(response.status_code) + ": " + str(response.text)[:200],
+                response.status_code,
+                "http_error",
+            )
+
+    def close(self):
+        self._client.close()
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *args):
+        self.close()
+
+
+def create_transport(
+    base_url: str,
+{{#each securitySchemes}}
+    {{configKey}}: Optional[str] = None,
+{{/each}}
+    timeout_ms: int = 15000,
+    retries: int = 3,
+    default_headers: Optional[Dict[str, str]] = None,
+    on_request: Optional[Callable] = None,
+    on_response: Optional[Callable] = None,
+    on_error: Optional[Callable] = None,
+) -> SDKTransport:
+    return SDKTransport(
+        base_url=base_url,
+{{#each securitySchemes}}
+        {{configKey}}={{configKey}},
+{{/each}}
+        timeout_ms=timeout_ms,
+        retries=retries,
+        default_headers=default_headers,
+        on_request=on_request,
+        on_response=on_response,
+        on_error=on_error,
+    )