vibetuner 2.26.9__py3-none-any.whl → 2.30.1__py3-none-any.whl

vibetuner/cli/__init__.py

@@ -4,8 +4,6 @@ import importlib.metadata
 import inspect
 from functools import partial, wraps
 from importlib import import_module
-from pathlib import Path
-from typing import Annotated
 
 import asyncer
 import typer
@@ -111,21 +109,6 @@ def version(
     console.print(table)
 
 
-@app.command()
-def core_template_symlink(
-    target: Annotated[
-        Path,
-        typer.Argument(
-            help="Path where the 'core' symlink should be created or updated",
-        ),
-    ],
-) -> None:
-    """Create or update a 'core' symlink to the package templates directory."""
-    from vibetuner.paths import create_core_templates_symlink
-
-    create_core_templates_symlink(target)
-
-
 app.add_typer(run_app, name="run")
 app.add_typer(scaffold_app, name="scaffold")
 

vibetuner/cli/scaffold.py

@@ -185,3 +185,28 @@ def update(
     except Exception as e:
         console.print(f"[red]Error updating project: {e}[/red]")
         raise typer.Exit(code=1) from None
+
+
+@scaffold_app.command(name="link")
+def link(
+    target: Annotated[
+        Path,
+        typer.Argument(
+            help="Path where the 'core' symlink should be created or updated",
+        ),
+    ],
+) -> None:
+    """Create or update a 'core' symlink to the package templates directory.
+
+    This command creates a symlink from the specified target path to the core
+    templates directory in the vibetuner package. It is used during development
+    to enable Tailwind and other build tools to scan core templates.
+
+    Examples:
+
+        # Create symlink in templates/core
+        vibetuner scaffold link templates/core
+    """
+    from vibetuner.paths import create_core_templates_symlink
+
+    create_core_templates_symlink(target)

vibetuner/config.py

@@ -2,7 +2,7 @@ import base64
 import hashlib
 from datetime import datetime
 from functools import cached_property
-from typing import Annotated
+from typing import Annotated, Literal
 
 import yaml
 from pydantic import (
@@ -100,8 +100,10 @@ class CoreConfiguration(BaseSettings):
     project: ProjectConfiguration = ProjectConfiguration.from_project_config()
 
     debug: bool = False
+    environment: Literal["dev", "prod"] = "dev"
     version: str = version
     session_key: SecretStr = SecretStr("ct-!secret-must-change-me")
+    debug_access_token: str | None = None
 
     # Database and Cache URLs
     mongodb_url: MongoDsn = MongoDsn("mongodb://localhost:27017")
@@ -132,6 +134,16 @@ class CoreConfiguration(BaseSettings):
     def mongo_dbname(self) -> str:
         return self.project.project_slug
 
+    @cached_property
+    def redis_key_prefix(self) -> str:
+        """Returns the Redis key prefix for namespacing all Redis keys by project and environment.
+
+        Format: "{project_slug}:{env}:" for dev, "{project_slug}:" for prod.
+        """
+        if self.environment == "dev":
+            return f"{self.project.project_slug}:dev:"
+        return f"{self.project.project_slug}:"
+
     model_config = SettingsConfigDict(
         case_sensitive=False, extra="ignore", env_file=".env"
     )

vibetuner/frontend/__init__.py

@@ -117,5 +117,6 @@ def default_index(request: Request) -> HTMLResponse:
     return render_template("index.html.jinja", request)
 
 
+app.include_router(debug.auth_router)
 app.include_router(debug.router)
 app.include_router(health.router)

vibetuner/frontend/routes/debug.py

@@ -3,13 +3,13 @@ from fastapi import (
     Depends,
     HTTPException,
     Request,
-    Response,
 )
 from fastapi.responses import (
     HTMLResponse,
     RedirectResponse,
 )
 
+from vibetuner.config import settings
 from vibetuner.context import ctx
 from vibetuner.models import UserModel
 from vibetuner.models.registry import get_all_models
@@ -18,32 +18,41 @@ from ..deps import MAGIC_COOKIE_NAME
 from ..templates import render_template
 
 
-def check_debug_access(request: Request, prod: str | None = None):
+def check_debug_access(request: Request):
     """Check if debug routes should be accessible."""
     # Always allow in development mode
     if ctx.DEBUG:
         return True
 
-    # In production, require prod=1 parameter
-    if prod == "1":
-        return True
+    # In production, require magic cookie
+    if MAGIC_COOKIE_NAME not in request.cookies:
+        raise HTTPException(status_code=404, detail="Not found")
+    if request.cookies[MAGIC_COOKIE_NAME] != "granted":
+        raise HTTPException(status_code=404, detail="Not found")
 
-    # Deny access
-    raise HTTPException(status_code=404, detail="Not found")
+    return True
 
 
-router = APIRouter(prefix="/debug", dependencies=[Depends(check_debug_access)])
+# Unprotected router for token-based debug access
+auth_router = APIRouter()
 
 
-@router.get("/", response_class=HTMLResponse)
-def debug_index(request: Request):
-    return render_template("debug/index.html.jinja", request)
+@auth_router.get("/_unlock-debug")
+def unlock_debug_access(token: str | None = None):
+    """Grant debug access by setting the magic cookie.
 
+    In DEBUG mode, no token is required.
+    In production, the token must match DEBUG_ACCESS_TOKEN.
+    If DEBUG_ACCESS_TOKEN is not configured, debug access is disabled in production.
+    """
+    if not ctx.DEBUG:
+        # In production, validate token
+        if settings.debug_access_token is None:
+            raise HTTPException(status_code=404, detail="Not found")
+        if token is None or token != settings.debug_access_token:
+            raise HTTPException(status_code=404, detail="Not found")
 
-@router.get("/magic")
-def set_magic_cookie(response: Response):
-    """Set the magic access cookie."""
-    response = RedirectResponse(url="/", status_code=302)
+    response = RedirectResponse(url="/debug", status_code=302)
     response.set_cookie(
         key=MAGIC_COOKIE_NAME,
         value="granted",
@@ -55,14 +64,23 @@ def set_magic_cookie(response: Response):
     return response
 
 
-@router.get("/no-magic")
-def remove_magic_cookie(response: Response):
-    """Remove the magic access cookie."""
+@auth_router.get("/_lock-debug")
+def lock_debug_access():
+    """Revoke debug access by removing the magic cookie."""
     response = RedirectResponse(url="/", status_code=302)
     response.delete_cookie(key=MAGIC_COOKIE_NAME)
     return response
 
 
+# Protected router for debug endpoints requiring cookie auth
+router = APIRouter(prefix="/debug", dependencies=[Depends(check_debug_access)])
+
+
+@router.get("/", response_class=HTMLResponse)
+def debug_index(request: Request):
+    return render_template("debug/index.html.jinja", request)
+
+
 @router.get("/version", response_class=HTMLResponse)
 def debug_version(request: Request):
     return render_template("debug/version.html.jinja", request)
@@ -136,20 +154,11 @@ def _is_beanie_link_schema(option: dict) -> bool:
 
 def _infer_link_target_from_field_name(field_name: str) -> str:
     """Infer the target model type from field name patterns."""
-    # Common patterns for field names that reference other models
+    # Core vibetuner models
     patterns = {
         "oauth_accounts": "OAuthAccountModel",
-        "accounts": "AccountModel",
         "users": "UserModel",
         "user": "UserModel",
-        "stations": "StationModel",
-        "station": "StationModel",
-        "rundowns": "RundownModel",
-        "rundown": "RundownModel",
-        "fillers": "FillerModel",
-        "filler": "FillerModel",
-        "voices": "VoiceModel",
-        "voice": "VoiceModel",
         "blobs": "BlobModel",
         "blob": "BlobModel",
     }
@@ -374,10 +383,13 @@ async def debug_users(request: Request):
     )
 
 
+# The following endpoints are restricted to DEBUG mode only (no production access).
+# These are dangerous operations that could compromise security if allowed in production.
+
+
 @router.post("/impersonate/{user_id}")
 async def debug_impersonate_user(request: Request, user_id: str):
     """Impersonate a user by setting their ID in the session."""
-    # Double check debug mode for security
     if not ctx.DEBUG:
         raise HTTPException(status_code=404, detail="Not found")
 
@@ -395,7 +407,6 @@ async def debug_impersonate_user(request: Request, user_id: str):
 @router.post("/stop-impersonation")
 async def debug_stop_impersonation(request: Request):
     """Stop impersonating and clear user session."""
-    # Double check debug mode for security
     if not ctx.DEBUG:
         raise HTTPException(status_code=404, detail="Not found")
 
@@ -406,7 +417,6 @@ async def debug_stop_impersonation(request: Request):
 @router.get("/clear-session")
 async def debug_clear_session(request: Request):
     """Clear all session data to fix corrupted sessions."""
-    # Double check debug mode for security
     if not ctx.DEBUG:
         raise HTTPException(status_code=404, detail="Not found")
 

vibetuner/frontend/templates.py

@@ -17,9 +17,38 @@ from .hotreload import hotreload
 
 __all__ = [
     "render_static_template",
+    "register_filter",
 ]
 
 
+_filter_registry: dict[str, Any] = {}
+
+
+def register_filter(name: str | None = None):
+    """Decorator to register a custom Jinja2 filter.
+
+    Args:
+        name: Optional custom name for the filter. If not provided,
+              uses the function name.
+
+    Usage:
+        @register_filter()
+        def my_filter(value):
+            return value.upper()
+
+        @register_filter("custom_name")
+        def another_filter(value):
+            return value.lower()
+    """
+
+    def decorator(func):
+        filter_name = name or func.__name__
+        _filter_registry[filter_name] = func
+        return func
+
+    return decorator
+
+
 def timeago(dt):
     """Converts a datetime object to a human-readable string representing the time elapsed since the given datetime.
 
@@ -171,4 +200,22 @@ jinja_env.filters["format_datetime"] = format_datetime
 jinja_env.filters["format_duration"] = format_duration
 jinja_env.filters["duration"] = format_duration
 
+# Import user-defined filters to trigger registration
+try:
+    import app.frontend.templates as _app_templates  # type: ignore[import-not-found] # noqa: F401
+except ModuleNotFoundError:
+    # Silent pass - templates module is optional
+    pass
+except ImportError as e:
+    from vibetuner.logging import logger
+
+    logger.warning(
+        f"Failed to import app.frontend.templates: {e}. Custom filters will not be available."
+    )
+
+# Apply all registered custom filters
+for filter_name, filter_func in _filter_registry.items():
+    jinja_env.filters[filter_name] = filter_func
+
+# Configure Jinja environment after all filters are registered
 configure_jinja_env(jinja_env)

vibetuner/paths.py

@@ -33,24 +33,27 @@ def create_core_templates_symlink(target: Path) -> None:
         logger.error(f"Cannot create symlink: {e}")
         return
 
-    # Case 1: target does not exist → create symlink
+    # Case 1: target is already a symlink → check if it needs updating
+    if target.is_symlink():
+        if target.resolve() != source:
+            target.unlink()
+            target.symlink_to(source, target_is_directory=True)
+            logger.info(f"Updated symlink '{target}' → '{source}'")
+        else:
+            logger.debug(f"Symlink '{target}' already points to '{source}'")
+        return
+
+    # Case 2: target does not exist → create symlink
     if not target.exists():
         target.symlink_to(source, target_is_directory=True)
         logger.info(f"Created symlink '{target}' → '{source}'")
         return
 
-    # Case 2: exists but is not a symlink → error
-    if not target.is_symlink():
-        logger.error(f"Cannot create symlink: '{target}' exists and is not a symlink.")
-        raise FileExistsError(
-            f"Cannot create symlink: '{target}' exists and is not a symlink."
-        )
-
-    # Case 3: is a symlink but points somewhere else → update it
-    if target.resolve() != source:
-        target.unlink()
-        target.symlink_to(source, target_is_directory=True)
-        logger.info(f"Updated symlink '{target}' → '{source}'")
+    # Case 3: exists but is not a symlink → error
+    logger.error(f"Cannot create symlink: '{target}' exists and is not a symlink.")
+    raise FileExistsError(
+        f"Cannot create symlink: '{target}' exists and is not a symlink."
+    )
 
 
 # Package templates always available

vibetuner/services/blob.py

@@ -6,18 +6,13 @@ To extend blob functionality, create wrapper services in the parent services dir
 
 import mimetypes
 from pathlib import Path
-from typing import Literal
 
 import aioboto3
-from aiobotocore.config import AioConfig
 
 from vibetuner.config import settings
 from vibetuner.models import BlobModel
 from vibetuner.models.blob import BlobStatus
-
-
-S3_SERVICE_NAME: Literal["s3"] = "s3"
-DEFAULT_CONTENT_TYPE: str = "application/octet-stream"
+from vibetuner.services.s3_storage import DEFAULT_CONTENT_TYPE, S3StorageService
 
 
 class BlobService:
@@ -34,25 +29,22 @@ class BlobService:
             raise ValueError(
                 "R2 bucket endpoint URL, access key, and secret key must be set in settings."
             )
-        self.session = session or aioboto3.Session(
-            aws_access_key_id=settings.r2_access_key.get_secret_value(),
-            aws_secret_access_key=settings.r2_secret_key.get_secret_value(),
-            region_name=settings.r2_default_region,
-        )
-        self.endpoint_url = str(settings.r2_bucket_endpoint_url)
-        self.config = AioConfig(
-            request_checksum_calculation="when_required",
-            response_checksum_validation="when_required",
-        )
 
-        if not default_bucket:
-            if settings.r2_default_bucket_name is None:
-                raise ValueError(
-                    "Default bucket name must be provided either in settings or as an argument."
-                )
-            self.default_bucket = settings.r2_default_bucket_name
-        else:
-            self.default_bucket = default_bucket
+        bucket = default_bucket or settings.r2_default_bucket_name
+        if bucket is None:
+            raise ValueError(
+                "Default bucket name must be provided either in settings or as an argument."
+            )
+
+        self.storage = S3StorageService(
+            endpoint_url=str(settings.r2_bucket_endpoint_url),
+            access_key=settings.r2_access_key.get_secret_value(),
+            secret_key=settings.r2_secret_key.get_secret_value(),
+            region=settings.r2_default_region,
+            default_bucket=bucket,
+            session=session,
+        )
+        self.default_bucket = bucket
 
     async def put_object(
         self,
@@ -80,17 +72,12 @@ class BlobService:
             raise ValueError("Blob ID must be set before uploading to R2.")
 
         try:
-            async with self.session.client(
-                service_name=S3_SERVICE_NAME,
-                endpoint_url=self.endpoint_url,
-                config=self.config,
-            ) as s3_client:
-                await s3_client.put_object(
-                    Bucket=bucket,
-                    Key=blob.full_path,
-                    Body=body,
-                    ContentType=content_type,
-                )
+            await self.storage.put_object(
+                key=blob.full_path,
+                body=body,
+                content_type=content_type,
+                bucket=bucket,
+            )
             blob.status = BlobStatus.UPLOADED
         except Exception:
             blob.status = BlobStatus.ERROR
@@ -144,16 +131,10 @@ class BlobService:
         if not blob:
             raise ValueError(f"Blob not found: {key}")
 
-        async with self.session.client(
-            service_name=S3_SERVICE_NAME,
-            endpoint_url=self.endpoint_url,
-            config=self.config,
-        ) as s3_client:
-            response = await s3_client.get_object(
-                Bucket=blob.bucket,
-                Key=blob.full_path,
-            )
-            return await response["Body"].read()
+        return await self.storage.get_object(
+            key=blob.full_path,
+            bucket=blob.bucket,
+        )
 
     async def delete_object(self, key: str) -> None:
         """Delete an object from the R2 bucket"""
@@ -172,4 +153,9 @@ class BlobService:
         if not blob:
             return False
 
+        if check_bucket:
+            return await self.storage.object_exists(
+                key=blob.full_path, bucket=blob.bucket
+            )
+
         return True

vibetuner/services/email.py

@@ -6,7 +6,7 @@ To extend email functionality, create wrapper services in the parent services di
 
 from typing import Literal
 
-import boto3
+import aioboto3
 
 from vibetuner.config import settings
 
@@ -17,11 +17,9 @@ SES_SERVICE_NAME: Literal["ses"] = "ses"
 class SESEmailService:
     def __init__(
         self,
-        ses_client=None,
         from_email: str | None = None,
     ) -> None:
-        self.ses_client = ses_client or boto3.client(
-            service_name=SES_SERVICE_NAME,
+        self.session = aioboto3.Session(
             region_name=settings.project.aws_default_region,
             aws_access_key_id=settings.aws_access_key_id.get_secret_value()
             if settings.aws_access_key_id
@@ -36,15 +34,16 @@ class SESEmailService:
         self, to_address: str, subject: str, html_body: str, text_body: str
     ):
         """Send email using Amazon SES"""
-        response = self.ses_client.send_email(
-            Source=self.from_email,
-            Destination={"ToAddresses": [to_address]},
-            Message={
-                "Subject": {"Data": subject, "Charset": "UTF-8"},
-                "Body": {
-                    "Html": {"Data": html_body, "Charset": "UTF-8"},
-                    "Text": {"Data": text_body, "Charset": "UTF-8"},
+        async with self.session.client(SES_SERVICE_NAME) as ses_client:
+            response = await ses_client.send_email(
+                Source=self.from_email,
+                Destination={"ToAddresses": [to_address]},
+                Message={
+                    "Subject": {"Data": subject, "Charset": "UTF-8"},
+                    "Body": {
+                        "Html": {"Data": html_body, "Charset": "UTF-8"},
+                        "Text": {"Data": text_body, "Charset": "UTF-8"},
+                    },
                 },
-            },
-        )
-        return response
+            )
+            return response

vibetuner/services/s3_storage.py

@@ -0,0 +1,454 @@
+"""ABOUTME: S3-compatible storage service for managing buckets and objects.
+ABOUTME: Provides async operations for R2, MinIO, and other S3-compatible storage providers.
+"""
+
+from typing import Any, Literal
+
+import aioboto3
+from aiobotocore.config import AioConfig
+from botocore.exceptions import ClientError
+
+
+S3_SERVICE_NAME: Literal["s3"] = "s3"
+DEFAULT_CONTENT_TYPE: str = "application/octet-stream"
+
+
+class S3StorageService:
+    """Async S3-compatible storage service for bucket and object operations.
+
+    This service provides a clean interface to S3-compatible storage providers
+    (AWS S3, Cloudflare R2, MinIO, etc.) without any database dependencies.
+
+    All operations are async and use aioboto3 for efficient I/O.
+    """
+
+    def __init__(
+        self,
+        endpoint_url: str,
+        access_key: str,
+        secret_key: str,
+        region: str = "auto",
+        default_bucket: str | None = None,
+        session: aioboto3.Session | None = None,
+    ) -> None:
+        """Initialize S3 storage service with explicit configuration.
+
+        Args:
+            endpoint_url: S3-compatible endpoint URL (e.g., "https://xxx.r2.cloudflarestorage.com")
+            access_key: Access key ID for authentication
+            secret_key: Secret access key for authentication
+            region: AWS region (default "auto" for R2/MinIO)
+            default_bucket: Optional default bucket for operations
+            session: Optional custom aioboto3 session
+        """
+        self.endpoint_url = endpoint_url
+        self.default_bucket = default_bucket
+        self.session = session or aioboto3.Session(
+            aws_access_key_id=access_key,
+            aws_secret_access_key=secret_key,
+            region_name=region,
+        )
+        self.config = AioConfig(
+            request_checksum_calculation="when_required",
+            response_checksum_validation="when_required",
+        )
+
+    def _get_bucket(self, bucket: str | None) -> str:
+        """Get bucket name, using default if not specified.
+
+        Args:
+            bucket: Optional bucket name
+
+        Returns:
+            Bucket name to use
+
+        Raises:
+            ValueError: If no bucket specified and no default bucket set
+        """
+        if bucket is None:
+            if self.default_bucket is None:
+                raise ValueError(
+                    "No bucket specified and no default bucket configured. "
+                    "Provide bucket parameter or set default_bucket during initialization."
+                )
+            return self.default_bucket
+        return bucket
+
+    # =========================================================================
+    # Object Operations
+    # =========================================================================
+
+    async def put_object(
+        self,
+        key: str,
+        body: bytes,
+        content_type: str = DEFAULT_CONTENT_TYPE,
+        bucket: str | None = None,
+        metadata: dict[str, str] | None = None,
+    ) -> None:
+        """Upload an object to S3-compatible storage.
+
+        Args:
+            key: Object key (path) in the bucket
+            body: Raw bytes to upload
+            content_type: MIME type of the object
+            bucket: Bucket name (uses default_bucket if None)
+            metadata: Optional custom metadata dict
+        """
+        bucket_name = self._get_bucket(bucket)
+
+        async with self.session.client(
+            service_name=S3_SERVICE_NAME,
+            endpoint_url=self.endpoint_url,
+            config=self.config,
+        ) as s3_client:
+            put_params: dict[str, Any] = {
+                "Bucket": bucket_name,
+                "Key": key,
+                "Body": body,
+                "ContentType": content_type,
+            }
+            if metadata:
+                put_params["Metadata"] = metadata
+
+            await s3_client.put_object(**put_params)
+
+    async def get_object(self, key: str, bucket: str | None = None) -> bytes:
+        """Retrieve an object from S3-compatible storage.
+
+        Args:
+            key: Object key (path) in the bucket
+            bucket: Bucket name (uses default_bucket if None)
+
+        Returns:
+            Raw bytes of the object
+
+        Raises:
+            ClientError: If object doesn't exist or other S3 error
+        """
+        bucket_name = self._get_bucket(bucket)
+
+        async with self.session.client(
+            service_name=S3_SERVICE_NAME,
+            endpoint_url=self.endpoint_url,
+            config=self.config,
+        ) as s3_client:
+            response = await s3_client.get_object(
+                Bucket=bucket_name,
+                Key=key,
+            )
+            return await response["Body"].read()
+
+    async def delete_object(self, key: str, bucket: str | None = None) -> None:
+        """Delete an object from S3-compatible storage.
+
+        Args:
+            key: Object key (path) in the bucket
+            bucket: Bucket name (uses default_bucket if None)
+        """
+        bucket_name = self._get_bucket(bucket)
+
+        async with self.session.client(
+            service_name=S3_SERVICE_NAME,
+            endpoint_url=self.endpoint_url,
+            config=self.config,
+        ) as s3_client:
+            await s3_client.delete_object(
+                Bucket=bucket_name,
+                Key=key,
+            )
+
+    async def object_exists(self, key: str, bucket: str | None = None) -> bool:
+        """Check if an object exists in S3-compatible storage.
+
+        Args:
+            key: Object key (path) in the bucket
+            bucket: Bucket name (uses default_bucket if None)
+
+        Returns:
+            True if object exists, False otherwise
+        """
+        bucket_name = self._get_bucket(bucket)
+
+        try:
+            async with self.session.client(
+                service_name=S3_SERVICE_NAME,
+                endpoint_url=self.endpoint_url,
+                config=self.config,
+            ) as s3_client:
+                await s3_client.head_object(
+                    Bucket=bucket_name,
+                    Key=key,
+                )
+                return True
+        except ClientError as e:
+            error_code = e.response.get("Error", {}).get("Code", "")
+            if error_code == "404":
+                return False
+            raise
+
+    async def list_objects(
+        self,
+        prefix: str | None = None,
+        bucket: str | None = None,
+        max_keys: int = 1000,
+    ) -> list[dict[str, Any]]:
+        """List objects in a bucket with optional prefix filter.
+
+        Args:
+            prefix: Optional prefix to filter objects
+            bucket: Bucket name (uses default_bucket if None)
+            max_keys: Maximum number of keys to return (default 1000)
+
+        Returns:
+            List of object metadata dicts with keys: key, size, last_modified, etag
+        """
+        bucket_name = self._get_bucket(bucket)
+
+        async with self.session.client(
+            service_name=S3_SERVICE_NAME,
+            endpoint_url=self.endpoint_url,
+            config=self.config,
+        ) as s3_client:
+            list_params: dict[str, Any] = {
+                "Bucket": bucket_name,
+                "MaxKeys": max_keys,
+            }
+            if prefix:
+                list_params["Prefix"] = prefix
+
+            response = await s3_client.list_objects_v2(**list_params)
+
+            if "Contents" not in response:
+                return []
+
+            return [
+                {
+                    "key": obj.get("Key", ""),
+                    "size": obj.get("Size", 0),
+                    "last_modified": obj.get("LastModified"),
+                    "etag": obj.get("ETag", "").strip('"'),
+                }
+                for obj in response["Contents"]
+            ]
+
+    async def get_object_metadata(
+        self, key: str, bucket: str | None = None
+    ) -> dict[str, Any]:
+        """Get metadata for an object without downloading it.
+
+        Args:
+            key: Object key (path) in the bucket
+            bucket: Bucket name (uses default_bucket if None)
+
+        Returns:
+            Metadata dict with keys: content_type, size, last_modified, etag, metadata
+        """
+        bucket_name = self._get_bucket(bucket)
+
+        async with self.session.client(
+            service_name=S3_SERVICE_NAME,
+            endpoint_url=self.endpoint_url,
+            config=self.config,
+        ) as s3_client:
+            response = await s3_client.head_object(
+                Bucket=bucket_name,
+                Key=key,
+            )
+
+            return {
+                "content_type": response.get("ContentType"),
+                "size": response.get("ContentLength"),
+                "last_modified": response.get("LastModified"),
+                "etag": response.get("ETag", "").strip('"'),
+                "metadata": response.get("Metadata", {}),
+            }
+
+    # =========================================================================
+    # Bucket Operations
+    # =========================================================================
+
+    async def list_buckets(self) -> list[dict[str, Any]]:
+        """List all buckets accessible with current credentials.
+
+        Returns:
+            List of bucket metadata dicts with keys: name, creation_date
+        """
+        async with self.session.client(
+            service_name=S3_SERVICE_NAME,
+            endpoint_url=self.endpoint_url,
+            config=self.config,
+        ) as s3_client:
+            response = await s3_client.list_buckets()
+
+            return [
+                {
+                    "name": bucket.get("Name", ""),
+                    "creation_date": bucket.get("CreationDate"),
+                }
+                for bucket in response.get("Buckets", [])
+            ]
+
+    async def create_bucket(self, bucket: str, region: str | None = None) -> None:
+        """Create a new bucket.
+
+        Args:
+            bucket: Name of the bucket to create
+            region: Optional region (uses session default if None)
+        """
+        async with self.session.client(
+            service_name=S3_SERVICE_NAME,
+            endpoint_url=self.endpoint_url,
+            config=self.config,
+        ) as s3_client:
+            create_params: dict[str, Any] = {"Bucket": bucket}
+
+            # Only set CreateBucketConfiguration for non-us-east-1 regions
+            if region and region not in ("us-east-1", "auto"):
+                create_params["CreateBucketConfiguration"] = {
+                    "LocationConstraint": region
+                }
+
+            await s3_client.create_bucket(**create_params)
+
+    async def delete_bucket(self, bucket: str, force: bool = False) -> None:
+        """Delete a bucket.
+
+        Args:
+            bucket: Name of the bucket to delete
+            force: If True, delete all objects in bucket first
+
+        Note:
+            S3 buckets must be empty before deletion unless force=True
+        """
+        if force:
+            # Delete all objects in the bucket first
+            objects = await self.list_objects(bucket=bucket)
+            async with self.session.client(
+                service_name=S3_SERVICE_NAME,
+                endpoint_url=self.endpoint_url,
+                config=self.config,
+            ) as s3_client:
+                for obj in objects:
+                    await s3_client.delete_object(
+                        Bucket=bucket,
+                        Key=obj["key"],
+                    )
+
+        async with self.session.client(
+            service_name=S3_SERVICE_NAME,
+            endpoint_url=self.endpoint_url,
+            config=self.config,
+        ) as s3_client:
+            await s3_client.delete_bucket(Bucket=bucket)
+
+    async def bucket_exists(self, bucket: str) -> bool:
+        """Check if a bucket exists and is accessible.
+
+        Args:
+            bucket: Name of the bucket to check
+
+        Returns:
+            True if bucket exists and is accessible, False otherwise
+        """
+        try:
+            async with self.session.client(
+                service_name=S3_SERVICE_NAME,
+                endpoint_url=self.endpoint_url,
+                config=self.config,
+            ) as s3_client:
+                await s3_client.head_bucket(Bucket=bucket)
+                return True
+        except ClientError as e:
+            error_code = e.response.get("Error", {}).get("Code", "")
+            if error_code in ("404", "NoSuchBucket"):
+                return False
+            raise
+
+    async def get_bucket_location(self, bucket: str) -> str:
+        """Get the region/location of a bucket.
+
+        Args:
+            bucket: Name of the bucket
+
+        Returns:
+            Region string (e.g., "us-east-1", "auto")
+        """
+        async with self.session.client(
+            service_name=S3_SERVICE_NAME,
+            endpoint_url=self.endpoint_url,
+            config=self.config,
+        ) as s3_client:
+            response = await s3_client.get_bucket_location(Bucket=bucket)
+            location = response.get("LocationConstraint")
+            # S3 returns None for us-east-1
+            return location if location else "us-east-1"
+
+    # =========================================================================
+    # Advanced Operations
+    # =========================================================================
+
+    async def copy_object(
+        self,
+        src_key: str,
+        dest_key: str,
+        src_bucket: str | None = None,
+        dest_bucket: str | None = None,
+    ) -> None:
+        """Copy an object from one location to another.
+
+        Args:
+            src_key: Source object key
+            dest_key: Destination object key
+            src_bucket: Source bucket (uses default_bucket if None)
+            dest_bucket: Destination bucket (uses default_bucket if None)
+        """
+        src_bucket_name = self._get_bucket(src_bucket)
+        dest_bucket_name = self._get_bucket(dest_bucket)
+
+        async with self.session.client(
+            service_name=S3_SERVICE_NAME,
+            endpoint_url=self.endpoint_url,
+            config=self.config,
+        ) as s3_client:
+            copy_source = f"{src_bucket_name}/{src_key}"
+            await s3_client.copy_object(
+                CopySource=copy_source,
+                Bucket=dest_bucket_name,
+                Key=dest_key,
+            )
+
+    async def generate_presigned_url(
+        self,
+        key: str,
+        bucket: str | None = None,
+        expiration: int = 3600,
+        method: str = "get_object",
+    ) -> str:
+        """Generate a presigned URL for temporary access to an object.
+
+        Args:
+            key: Object key
+            bucket: Bucket name (uses default_bucket if None)
+            expiration: URL expiration time in seconds (default 3600 = 1 hour)
+            method: S3 method name ("get_object" or "put_object")
+
+        Returns:
+            Presigned URL string
+        """
+        bucket_name = self._get_bucket(bucket)
+
+        async with self.session.client(
+            service_name=S3_SERVICE_NAME,
+            endpoint_url=self.endpoint_url,
+            config=self.config,
+        ) as s3_client:
+            url = await s3_client.generate_presigned_url(
+                ClientMethod=method,
+                Params={
+                    "Bucket": bucket_name,
+                    "Key": key,
+                },
+                ExpiresIn=expiration,
+            )
+            return url

vibetuner/tasks/worker.py

@@ -6,10 +6,6 @@ from vibetuner.tasks.lifespan import lifespan
 
 worker = Worker(
     redis_url=str(settings.redis_url),
-    queue_name=(
-        settings.project.project_slug
-        if not settings.debug
-        else f"debug-{settings.project.project_slug}"
-    ),
+    queue_name=settings.redis_key_prefix.rstrip(":"),
     lifespan=lifespan,
 )

{vibetuner-2.26.9.dist-info → vibetuner-2.30.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: vibetuner
-Version: 2.26.9
+Version: 2.30.1
 Summary: Core Python framework and blessed dependencies for production-ready FastAPI + MongoDB + HTMX projects
 Keywords: fastapi,mongodb,htmx,web-framework,scaffolding,oauth,background-jobs
 Author: All Tuner Labs, S.L.
@@ -20,11 +20,11 @@ Requires-Dist: aioboto3>=15.5.0
 Requires-Dist: arel>=0.4.0
 Requires-Dist: asyncer>=0.0.10
 Requires-Dist: authlib>=1.6.5
-Requires-Dist: beanie[zstd]>=2.0.0
+Requires-Dist: beanie[zstd]>=2.0.1
 Requires-Dist: click>=8.3.1
-Requires-Dist: copier>=9.10.3,<9.10.4
+Requires-Dist: copier>=9.11.0,<9.11.1
 Requires-Dist: email-validator>=2.3.0
-Requires-Dist: fastapi[standard-no-fastapi-cloud-cli]>=0.121.2
+Requires-Dist: fastapi[standard-no-fastapi-cloud-cli]>=0.122.0
 Requires-Dist: granian[pname]>=2.6.0
 Requires-Dist: httpx[http2]>=0.28.1
 Requires-Dist: itsdangerous>=2.2.0
@@ -33,7 +33,7 @@ Requires-Dist: pydantic[email]>=2.12.4
 Requires-Dist: pydantic-extra-types[pycountry]>=2.10.6
 Requires-Dist: pydantic-settings>=2.12.0
 Requires-Dist: pyyaml>=6.0.3
-Requires-Dist: redis[hiredis]>=7.0.1
+Requires-Dist: redis[hiredis]>=7.1.0
 Requires-Dist: rich>=14.2.0
 Requires-Dist: sse-starlette>=3.0.3
 Requires-Dist: starlette-babel>=1.0.3
@@ -44,20 +44,22 @@ Requires-Dist: babel>=2.17.0 ; extra == 'dev'
 Requires-Dist: cloudflare>=4.3.1 ; extra == 'dev'
 Requires-Dist: djlint>=1.36.4 ; extra == 'dev'
 Requires-Dist: dunamai>=1.25.0 ; extra == 'dev'
-Requires-Dist: gh-bin>=2.83.0 ; extra == 'dev'
+Requires-Dist: gh-bin>=2.83.1 ; extra == 'dev'
 Requires-Dist: granian[pname,reload]>=2.6.0 ; extra == 'dev'
-Requires-Dist: just-bin>=1.43.0 ; extra == 'dev'
-Requires-Dist: pre-commit>=4.4.0 ; extra == 'dev'
+Requires-Dist: just-bin>=1.43.1 ; extra == 'dev'
+Requires-Dist: prek>=0.2.18 ; extra == 'dev'
 Requires-Dist: pysemver>=0.5.0 ; extra == 'dev'
-Requires-Dist: ruff>=0.14.5 ; extra == 'dev'
-Requires-Dist: rumdl>=0.0.177 ; extra == 'dev'
+Requires-Dist: ruff>=0.14.6 ; extra == 'dev'
+Requires-Dist: rumdl>=0.0.182 ; extra == 'dev'
 Requires-Dist: semver>=3.0.4 ; extra == 'dev'
 Requires-Dist: taplo>=0.9.3 ; extra == 'dev'
-Requires-Dist: ty>=0.0.1a26 ; extra == 'dev'
+Requires-Dist: ty>=0.0.1a27 ; extra == 'dev'
 Requires-Dist: types-aioboto3[s3,ses]>=15.5.0 ; extra == 'dev'
 Requires-Dist: types-authlib>=1.6.5.20251005 ; extra == 'dev'
 Requires-Dist: types-pyyaml>=6.0.12.20250915 ; extra == 'dev'
 Requires-Dist: uv-bump>=0.3.1 ; extra == 'dev'
+Requires-Dist: pytest>=9.0.1 ; extra == 'test'
+Requires-Dist: pytest-asyncio>=1.3.0 ; extra == 'test'
 Requires-Python: >=3.11
 Project-URL: Changelog, https://github.com/alltuner/vibetuner/blob/main/CHANGELOG.md
 Project-URL: Documentation, https://vibetuner.alltuner.com/
@@ -65,6 +67,7 @@ Project-URL: Homepage, https://vibetuner.alltuner.com/
 Project-URL: Issues, https://github.com/alltuner/vibetuner/issues
 Project-URL: Repository, https://github.com/alltuner/vibetuner
 Provides-Extra: dev
+Provides-Extra: test
 Description-Content-Type: text/markdown
 
 # vibetuner
@@ -177,7 +180,7 @@ The `[dev]` extra includes all tools needed for development:
 
 - **Ruff**: Fast linting and formatting
 - **Babel**: i18n message extraction
-- **pre-commit**: Git hooks
+- **pre-commit**: Git hooks (prek is a fast pre-commit drop-in replacement)
 - **Type stubs**: For aioboto3, authlib, PyYAML
 - And more...
 

{vibetuner-2.26.9.dist-info → vibetuner-2.30.1.dist-info}/RECORD

@@ -1,11 +1,11 @@
 vibetuner/__init__.py,sha256=rFIVCmxkKTT_g477V8biCw0lgpudyuUabXhYxg189lY,90
 vibetuner/__main__.py,sha256=Ye9oBAgXhcYQ4I4yZli3TIXF5lWQ9yY4tTPs4XnDDUY,29
-vibetuner/cli/__init__.py,sha256=9FFy0MTOhWVS-Z310auNTcpbG1xJtku0TS35Qxoyt-Q,3995
+vibetuner/cli/__init__.py,sha256=lmuLn8ytkO0JwX3ILm6AFQmrzEMe5LeHmwV2oyyy0sI,3543
 vibetuner/cli/run.py,sha256=TILyvy-bZTKWcAK-K2SNYqqD-G3ypCay-ghadGztqRQ,5021
-vibetuner/cli/scaffold.py,sha256=qADWxx1gYECQ8N6dgvJmlucT6mZ29rxWu3VZhbWmhC0,5710
-vibetuner/config.py,sha256=oG5naa6pu8wM4hzra0xaRQCPnQWbid9hGTJOHfsmHeI,4082
+vibetuner/cli/scaffold.py,sha256=5MipgasDKsK6WDa_vpfY4my1kyismkaskvXE277NE-s,6450
+vibetuner/config.py,sha256=UfEyAlow6lE_npr53dgESb-KZQuohP18vlTncOuWJC4,4571
 vibetuner/context.py,sha256=h4f4FfkmLlOD6WiSLhx7-IjFvIA4zcrsAp6478l6npg,743
-vibetuner/frontend/__init__.py,sha256=DIAnvQHCFNBc5VtBXYE6IdAnIqCYTD_EyFAbmui7vW8,3927
+vibetuner/frontend/__init__.py,sha256=COZuPRzTFUfxeyWkvmz0GxBBFFvBHtf2mMGmLw5fy2c,3965
 vibetuner/frontend/deps.py,sha256=b3ocC_ryaK2Jp51SfcFqckrXiaL7V-chkFRqLjzgA_c,1296
 vibetuner/frontend/email.py,sha256=k0d7FCZCge5VYOKp3fLsbx7EA5_SrtBkpMs57o4W7u0,1119
 vibetuner/frontend/hotreload.py,sha256=Gl7FIKJaiCVVoyWQqdErBUOKDP1cGBFUpGzqHMiJd10,285
@@ -14,12 +14,12 @@ vibetuner/frontend/middleware.py,sha256=iOqcp-7WwRqHLYa1dg3xDzAXGrpqmYpqBmtQcdd9
 vibetuner/frontend/oauth.py,sha256=EzEwoOZ_8xn_CiqAWpNoEdhV2NPxZKKwF2bA6W6Bkj0,5884
 vibetuner/frontend/routes/__init__.py,sha256=nHhiylHIUPZ2R-Bd7vXEGHLJBQ7fNuzPTJodjJR3lyc,428
 vibetuner/frontend/routes/auth.py,sha256=vKE-Dm2yPXReaOLvcxfT4a6df1dKUoteZ4p46v8Elm4,4331
-vibetuner/frontend/routes/debug.py,sha256=Mzbyx3gv_mCxg0sdjY4p7LXgH1wI3BoEyn1sRZuGY90,12743
+vibetuner/frontend/routes/debug.py,sha256=hqiuRjcLOvL2DdhA83HUzp5svECKjyFB-LoNn7xDiFE,13269
 vibetuner/frontend/routes/health.py,sha256=_XkMpdMNUemu7qzkGkqn5TBnZmGrArA3Xps5CWCcGlg,959
 vibetuner/frontend/routes/language.py,sha256=wHNfdewqWfK-2JLXwglu0Q0b_e00HFGd0A2-PYT44LE,1240
 vibetuner/frontend/routes/meta.py,sha256=pSyIxQsiB0QZSYwCQbS07KhkT5oHC5r9jvjUDIqZRGw,1409
 vibetuner/frontend/routes/user.py,sha256=b8ow6IGnfsHosSwSmEIYZtuQJnW_tacnNjp_aMnqWxU,2666
-vibetuner/frontend/templates.py,sha256=xHpLMyAEjKWHgbloE40n6Fe3gjTuG5msWeqqYyJO3uU,5308
+vibetuner/frontend/templates.py,sha256=BLBBcF9e-EUDQXeOUzCHgQx1D0lCMkLfUXgNCwG6CtE,6607
 vibetuner/logging.py,sha256=9eNofqVtKZCBDS33NbBI7Sv2875gM8MNStTSCjX2AXQ,2409
 vibetuner/models/__init__.py,sha256=JvmQvzDIxaI7zlk-ROCWEbuzxXSUOqCshINUjgu-AfQ,325
 vibetuner/models/blob.py,sha256=F30HFS4Z_Bji_PGPflWIv4dOwqKLsEWQHcjW1Oz_79M,2523
@@ -30,13 +30,14 @@ vibetuner/models/registry.py,sha256=O5YG7vOrWluqpH5N7m44v72wbscMhU_Pu3TJw_u0MTk,
 vibetuner/models/types.py,sha256=Lj3ASEvx5eNgQMcVhNyKQHHolJqDxj2yH8S-M9oa4J8,402
 vibetuner/models/user.py,sha256=ttcSH4mVREPhA6bCFUWXKfJ9_8_Iq3lEYXe3rDrslw4,2696
 vibetuner/mongo.py,sha256=BejYrqHrupNfvNhEu6xUakCnRQy3YdiExk2r6hkafOs,1056
-vibetuner/paths.py,sha256=IEH_GCJTThUPU0HWxr86j61IcwYgwXBamoWNmaJsxlo,8252
+vibetuner/paths.py,sha256=hWWcjwVPNxac74rRuHgHD46CwmQKHJidEALo-euw72k,8360
 vibetuner/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-vibetuner/services/blob.py,sha256=-lEGIWe30yR2IuTfy5bB9Sg_PX0HoYC_WMTQ3VN28gU,5660
-vibetuner/services/email.py,sha256=IavJZS5MI40LlF_cjBpPPRx_S2r1JD4GcFg3-dWkzPA,1626
+vibetuner/services/blob.py,sha256=mYsMDA04E1fgXLaprWDip28RrxEX60T1G7UT1aMZDBY,5029
+vibetuner/services/email.py,sha256=Y0yKgqki2an7fE6n4hQeROjVglzcqIGBgXICJbKZq0s,1669
+vibetuner/services/s3_storage.py,sha256=purEKXKqb_5iroyDgEWCJ2DRMmG08Jy5tnsc2ZE1An4,15407
 vibetuner/tasks/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 vibetuner/tasks/lifespan.py,sha256=BKOI-wbMLOqEbR4NgCKI5c9OP8W1RpxOswBL3XzPTWc,861
-vibetuner/tasks/worker.py,sha256=s91Pbmz--cV4ygzDuXa-kGLZFe28HSvaXfxhIWJyIhE,340
+vibetuner/tasks/worker.py,sha256=ZCfBpaqpyDG5OD3wtSf9YdIWie6CaQ49KwLNn_iTNCc,248
 vibetuner/templates/email/magic_link.html.jinja,sha256=DzaCnBsYoau2JQh5enPAa2FMFFTyCwdyiM3vGhBQdtA,553
 vibetuner/templates/email/magic_link.txt.jinja,sha256=dANak9ion1cpILt45V3GcI2qnL_gKFPj7PsZKYV0m5s,200
 vibetuner/templates/frontend/base/favicons.html.jinja,sha256=A7s7YXuE82tRd7ZLJs1jGEGwBRiMPrqlWd507xL1iZg,70
@@ -65,7 +66,7 @@ vibetuner/templates/markdown/.placeholder,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5N
 vibetuner/templates.py,sha256=xRoMb_oyAI5x4kxfpg56UcLKkT8e9HVn-o3KFAu9ISE,5094
 vibetuner/time.py,sha256=3_DtveCCzI20ocTnAlTh2u7FByUXtINaUoQZO-_uZow,1188
 vibetuner/versioning.py,sha256=c7Wg-SM-oJzQqG2RE0O8gZGHzHTgvwqa4yHn3Dk5-Sk,372
-vibetuner-2.26.9.dist-info/WHEEL,sha256=w4ZtLaDgMAZW2MMZZwtH8zENekoQYBCeullI-zsXJQk,78
-vibetuner-2.26.9.dist-info/entry_points.txt,sha256=aKIj9YCCXizjYupx9PeWkUJePg3ncHke_LTS5rmCsfs,49
-vibetuner-2.26.9.dist-info/METADATA,sha256=WTPJkk2ZcYPzpzcWRdWDAnEgXcdjOBD3EgWo_ilp0sQ,8061
-vibetuner-2.26.9.dist-info/RECORD,,
+vibetuner-2.30.1.dist-info/WHEEL,sha256=YUH1mBqsx8Dh2cQG2rlcuRYUhJddG9iClegy4IgnHik,79
+vibetuner-2.30.1.dist-info/entry_points.txt,sha256=aKIj9YCCXizjYupx9PeWkUJePg3ncHke_LTS5rmCsfs,49
+vibetuner-2.30.1.dist-info/METADATA,sha256=O25ikO_Zt59f7VbnTMTwQV4ADEFZb0cj7ze2zZzwiE8,8227
+vibetuner-2.30.1.dist-info/RECORD,,

{vibetuner-2.26.9.dist-info → vibetuner-2.30.1.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: uv 0.9.9
+Generator: uv 0.9.11
 Root-Is-Purelib: true
 Tag: py3-none-any