somewhere-tech 0.2.0__tar.gz

somewhere_tech-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 somewhere.tech
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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.

somewhere_tech-0.2.0/PKG-INFO

@@ -0,0 +1,150 @@
+Metadata-Version: 2.4
+Name: somewhere-tech
+Version: 0.2.0
+Summary: Official Python SDK for the somewhere.tech platform API. Supabase-compatible interface.
+Author: somewhere.tech
+License: MIT
+Project-URL: Homepage, https://somewhere.tech
+Project-URL: Repository, https://github.com/somewhere-tech/somewhere-sdk-python
+Keywords: somewhere,somewhere.tech,backend,sdk,cloudflare,d1,r2,supabase
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.8
+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: Intended Audience :: Developers
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.24
+Dynamic: license-file
+
+# somewhere — Python SDK
+
+Official Python SDK for the [somewhere.tech](https://somewhere.tech) platform API. Thin wrapper around the REST API at `https://api.somewhere.tech/v1`.
+
+## Install
+
+```bash
+pip install somewhere
+```
+
+## Quick start
+
+```python
+from somewhere import Somewhere, SomewhereError
+
+sw = Somewhere(key="smt_...")  # or token="eyJ..." for app-user mode
+
+# Create a project
+project = sw.projects.create(name="Booking App")
+
+# Run a migration
+sw.db.migrate(
+    """
+    CREATE TABLE bookings (
+        id INTEGER PRIMARY KEY,
+        name TEXT NOT NULL,
+        slot TEXT NOT NULL,
+        created_at TEXT DEFAULT (datetime('now'))
+    );
+    """,
+    project["id"],
+)
+
+# Insert + query
+sw.db.query(
+    "INSERT INTO bookings (name, slot) VALUES (?, ?)",
+    ["Alice", "2026-05-01 18:00"],
+    project["id"],
+)
+rows = sw.db.query("SELECT * FROM bookings", [], project["id"])
+
+# Deploy a static site
+sw.deploy(
+    files={"index.html": "<h1>Book a table</h1>"},
+    project_id=project["id"],
+)
+
+print(f"Live at https://{project['subdomain']}.somewhere.tech")
+```
+
+## Auth modes
+
+**Developer mode** — full access, server-side only:
+
+```python
+sw = Somewhere(key="smt_...")
+```
+
+**App-user mode** — app JWT, browser-safe operations only (db, storage, fs, auth.me):
+
+```python
+sw = Somewhere(token="eyJ...", project_id="booking-app")
+me = sw.auth.me()
+rows = sw.db.query("SELECT * FROM bookings WHERE email = ?", [me["user"]["email"]])
+```
+
+**Default project**:
+
+```python
+sw = Somewhere(key="smt_...", project_id="booking-app")
+sw.db.query("SELECT * FROM bookings")  # uses 'booking-app'
+```
+
+## Error handling
+
+Every API error raises a typed `SomewhereError`:
+
+```python
+from somewhere import SomewhereError
+
+try:
+    sw.email.send(to="user@example.com", subject="Hi", text="Welcome")
+except SomewhereError as err:
+    print(err.code)           # "QUOTA_EXCEEDED"
+    print(err.message)        # human-readable
+    print(err.status_code)    # 429
+    print(err.retry)          # True if client should retry
+    print(err.retry_after_ms) # ms to wait
+```
+
+## Method reference
+
+| Namespace | Methods |
+|---|---|
+| `sw.projects` | `create`, `list`, `get`, `delete`, `undeploy`, `archive`, `unarchive`, `rename`, `deploys` |
+| `sw.deploy` | `sw.deploy(files=..., functions=..., project_id=...)`, `sw.deploy.status(project_id)` |
+| `sw.promote` | `sw.promote(project_id)`, `sw.promote.rollback(project_id)` |
+| `sw.db` | `query`, `migrate`, `tables`, `schema` |
+| `sw.storage` | `put`, `get`, `delete`, `list` |
+| `sw.fs` | `write`, `read`, `delete`, `move`, `copy`, `stat`, `versions`, `restore` |
+| `sw.auth` | `signup`, `login`, `logout`, `me`, `forgot`, `reset`, `users`, `verify_email`, `request_verification`, `delete_account`, `update_me` |
+| `sw.email` | `send` |
+| `sw.ai` | `complete`, `embed`*, `image`*, `tts`*, `transcribe`* |
+| `sw.jobs` | `create`, `status`, `list`, `cancel`, `progress` |
+| `sw.cron` | `create`, `list`, `update`, `delete` |
+| `sw.queue` | `push` |
+| `sw.logs` | `write`, `read` |
+| `sw.env` | `set`, `list`, `delete` |
+| `sw.domains` | `add`, `verify`, `list`, `delete` |
+| `sw.preview` | `invite`, `revoke`, `viewers` |
+| `sw.feedback` | `submit`, `list` |
+| `sw.billing` | `status`, `checkout`, `portal` |
+| `sw.usage` | `get`, `summary` |
+
+`*` = stub for not-yet-shipped endpoints; calling returns `UNSUPPORTED_FEATURE`.
+
+## Test
+
+```bash
+SMT_KEY=smt_... python tests/test_basic.py
+```
+
+## License
+
+MIT © somewhere.tech

somewhere_tech-0.2.0/README.md

@@ -0,0 +1,125 @@
+# somewhere — Python SDK
+
+Official Python SDK for the [somewhere.tech](https://somewhere.tech) platform API. Thin wrapper around the REST API at `https://api.somewhere.tech/v1`.
+
+## Install
+
+```bash
+pip install somewhere
+```
+
+## Quick start
+
+```python
+from somewhere import Somewhere, SomewhereError
+
+sw = Somewhere(key="smt_...")  # or token="eyJ..." for app-user mode
+
+# Create a project
+project = sw.projects.create(name="Booking App")
+
+# Run a migration
+sw.db.migrate(
+    """
+    CREATE TABLE bookings (
+        id INTEGER PRIMARY KEY,
+        name TEXT NOT NULL,
+        slot TEXT NOT NULL,
+        created_at TEXT DEFAULT (datetime('now'))
+    );
+    """,
+    project["id"],
+)
+
+# Insert + query
+sw.db.query(
+    "INSERT INTO bookings (name, slot) VALUES (?, ?)",
+    ["Alice", "2026-05-01 18:00"],
+    project["id"],
+)
+rows = sw.db.query("SELECT * FROM bookings", [], project["id"])
+
+# Deploy a static site
+sw.deploy(
+    files={"index.html": "<h1>Book a table</h1>"},
+    project_id=project["id"],
+)
+
+print(f"Live at https://{project['subdomain']}.somewhere.tech")
+```
+
+## Auth modes
+
+**Developer mode** — full access, server-side only:
+
+```python
+sw = Somewhere(key="smt_...")
+```
+
+**App-user mode** — app JWT, browser-safe operations only (db, storage, fs, auth.me):
+
+```python
+sw = Somewhere(token="eyJ...", project_id="booking-app")
+me = sw.auth.me()
+rows = sw.db.query("SELECT * FROM bookings WHERE email = ?", [me["user"]["email"]])
+```
+
+**Default project**:
+
+```python
+sw = Somewhere(key="smt_...", project_id="booking-app")
+sw.db.query("SELECT * FROM bookings")  # uses 'booking-app'
+```
+
+## Error handling
+
+Every API error raises a typed `SomewhereError`:
+
+```python
+from somewhere import SomewhereError
+
+try:
+    sw.email.send(to="user@example.com", subject="Hi", text="Welcome")
+except SomewhereError as err:
+    print(err.code)           # "QUOTA_EXCEEDED"
+    print(err.message)        # human-readable
+    print(err.status_code)    # 429
+    print(err.retry)          # True if client should retry
+    print(err.retry_after_ms) # ms to wait
+```
+
+## Method reference
+
+| Namespace | Methods |
+|---|---|
+| `sw.projects` | `create`, `list`, `get`, `delete`, `undeploy`, `archive`, `unarchive`, `rename`, `deploys` |
+| `sw.deploy` | `sw.deploy(files=..., functions=..., project_id=...)`, `sw.deploy.status(project_id)` |
+| `sw.promote` | `sw.promote(project_id)`, `sw.promote.rollback(project_id)` |
+| `sw.db` | `query`, `migrate`, `tables`, `schema` |
+| `sw.storage` | `put`, `get`, `delete`, `list` |
+| `sw.fs` | `write`, `read`, `delete`, `move`, `copy`, `stat`, `versions`, `restore` |
+| `sw.auth` | `signup`, `login`, `logout`, `me`, `forgot`, `reset`, `users`, `verify_email`, `request_verification`, `delete_account`, `update_me` |
+| `sw.email` | `send` |
+| `sw.ai` | `complete`, `embed`*, `image`*, `tts`*, `transcribe`* |
+| `sw.jobs` | `create`, `status`, `list`, `cancel`, `progress` |
+| `sw.cron` | `create`, `list`, `update`, `delete` |
+| `sw.queue` | `push` |
+| `sw.logs` | `write`, `read` |
+| `sw.env` | `set`, `list`, `delete` |
+| `sw.domains` | `add`, `verify`, `list`, `delete` |
+| `sw.preview` | `invite`, `revoke`, `viewers` |
+| `sw.feedback` | `submit`, `list` |
+| `sw.billing` | `status`, `checkout`, `portal` |
+| `sw.usage` | `get`, `summary` |
+
+`*` = stub for not-yet-shipped endpoints; calling returns `UNSUPPORTED_FEATURE`.
+
+## Test
+
+```bash
+SMT_KEY=smt_... python tests/test_basic.py
+```
+
+## License
+
+MIT © somewhere.tech

somewhere_tech-0.2.0/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "somewhere-tech"
+version = "0.2.0"
+description = "Official Python SDK for the somewhere.tech platform API. Supabase-compatible interface."
+readme = "README.md"
+license = { text = "MIT" }
+authors = [{ name = "somewhere.tech" }]
+keywords = ["somewhere", "somewhere.tech", "backend", "sdk", "cloudflare", "d1", "r2", "supabase"]
+requires-python = ">=3.8"
+classifiers = [
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.8",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Intended Audience :: Developers",
+]
+dependencies = [
+  "httpx>=0.24",
+]
+
+[project.urls]
+Homepage = "https://somewhere.tech"
+Repository = "https://github.com/somewhere-tech/somewhere-sdk-python"
+
+[tool.setuptools.packages.find]
+include = ["somewhere*"]
+exclude = ["tests*"]

somewhere_tech-0.2.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

somewhere_tech-0.2.0/somewhere/__init__.py

@@ -0,0 +1,168 @@
+"""Official Python SDK for the somewhere.tech platform API.
+
+Supabase-compatible interface with query builder, auth, storage, email,
+and OpenAI-compatible chat completions.
+
+Usage:
+    from somewhere import Somewhere
+
+    sw = Somewhere(key='smt_...', project_id='my-project')
+
+    # Database (Supabase-style query builder)
+    result = sw.from_('users').select('*').eq('role', 'admin').execute()
+
+    # Auth
+    result = sw.auth.sign_up(email='u@test.com', password='pass123')
+
+    # Storage
+    result = sw.storage.from_('avatars').upload('photo.png', file_bytes)
+
+    # Email
+    result = sw.emails.send(to='user@test.com', subject='Hi', html='<h1>Hello</h1>')
+
+    # AI (OpenAI-compatible)
+    completion = sw.chat.completions.create(model='claude-sonnet-4-6', messages=[...])
+"""
+from __future__ import annotations
+
+from typing import Dict, Optional
+
+import httpx
+
+from .auth import AuthClient
+from .chat import ChatClient
+from .client import (
+    BillingClient,
+    CronClient,
+    DeployClient,
+    DomainsClient,
+    EnvClient,
+    FeedbackClient,
+    HttpClient,
+    JobsClient,
+    LogsClient,
+    PreviewClient,
+    ProjectsClient,
+    QueueClient,
+    UsageClient,
+)
+from .emails import EmailsClient
+from .errors import SomewhereError
+from .query_builder import QueryBuilder, Result
+from .storage import StorageClient
+
+__all__ = ["Somewhere", "SomewhereError", "Result"]
+__version__ = "0.2.0"
+
+
+class Somewhere:
+    """Entry point for the somewhere.tech SDK.
+
+    Provides a Supabase-compatible interface with query builder, auth,
+    storage, email, and OpenAI-compatible chat completions.
+
+    Args:
+        key: Developer API key (smt_...). Mutually exclusive with token.
+        token: App-user JWT. Mutually exclusive with key.
+        project_id: Default project ID for all operations.
+        base_url: API base URL (defaults to https://api.somewhere.tech/v1).
+        http_client: Custom httpx.Client instance (optional).
+        headers: Extra headers to send with every request (optional).
+        timeout: Request timeout in seconds (default 60).
+
+    Example:
+        sw = Somewhere(key='smt_...', project_id='booking-app')
+        result = sw.from_('users').select('*').eq('role', 'admin').execute()
+        print(result.data)
+    """
+
+    def __init__(
+        self,
+        *,
+        key: Optional[str] = None,
+        token: Optional[str] = None,
+        project_id: Optional[str] = None,
+        base_url: str = "https://api.somewhere.tech/v1",
+        http_client: Optional[httpx.Client] = None,
+        headers: Optional[Dict[str, str]] = None,
+        timeout: float = 60.0,
+    ) -> None:
+        self._http = HttpClient(
+            key=key,
+            token=token,
+            project_id=project_id,
+            base_url=base_url,
+            http_client=http_client,
+            headers=headers,
+            timeout=timeout,
+        )
+
+        # Supabase-compatible clients
+        self.auth = AuthClient(
+            project_id=self._http.project_id,
+            http_client=self._http.client,
+            base_url=self._http.base_url,
+            auth_header=self._http.auth_header,
+            extra_headers=self._http.extra_headers,
+        )
+        self.storage = StorageClient(
+            project_id=self._http.project_id,
+            http_client=self._http.client,
+            base_url=self._http.base_url,
+            auth_header=self._http.auth_header,
+            extra_headers=self._http.extra_headers,
+        )
+        self.emails = EmailsClient(
+            project_id=self._http.project_id,
+            http_client=self._http.client,
+            base_url=self._http.base_url,
+            auth_header=self._http.auth_header,
+            extra_headers=self._http.extra_headers,
+        )
+        self.chat = ChatClient(
+            project_id=self._http.project_id,
+            http_client=self._http.client,
+            base_url=self._http.base_url,
+            auth_header=self._http.auth_header,
+            extra_headers=self._http.extra_headers,
+        )
+
+        # Simple resource clients
+        self.env = EnvClient(self._http)
+        self.jobs = JobsClient(self._http)
+        self.cron = CronClient(self._http)
+        self.domains = DomainsClient(self._http)
+        self.projects = ProjectsClient(self._http)
+        self.deploy = DeployClient(self._http)
+        self.logs = LogsClient(self._http)
+        self.queue = QueueClient(self._http)
+        self.billing = BillingClient(self._http)
+        self.usage = UsageClient(self._http)
+        self.feedback = FeedbackClient(self._http)
+        self.preview = PreviewClient(self._http)
+
+    def from_(self, table: str) -> QueryBuilder:
+        """Start a Supabase-style query builder for the given table.
+
+        Uses `from_` because `from` is a reserved word in Python.
+
+        Args:
+            table: The database table name.
+
+        Returns:
+            A QueryBuilder that supports .select(), .insert(), .update(),
+            .delete(), .upsert(), plus filter chains (.eq(), .gt(), etc.)
+            ending with .execute().
+
+        Example:
+            result = sw.from_('users').select('*').eq('role', 'admin').execute()
+            result = sw.from_('users').insert({'name': 'A'}).execute()
+        """
+        return QueryBuilder(
+            table=table,
+            project_id=self._http.project_id,
+            http_client=self._http.client,
+            base_url=self._http.base_url,
+            auth_header=self._http.auth_header,
+            extra_headers=self._http.extra_headers,
+        )