mushu-sdk 0.1.2__tar.gz

mushu_sdk-0.1.2/.gitignore

@@ -0,0 +1,39 @@
+# Dependencies
+node_modules/
+__pycache__/
+*.pyc
+.venv/
+venv/
+*.egg-info/
+
+# CDK
+cdk.out/
+*.js
+!jest.config.js
+*.d.ts
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Environment
+.env
+.env.local
+*.local
+
+# Build
+dist/
+build/
+*.zip
+.lambda_build/
+
+# Secrets (never commit)
+*.p8
+*.pem
+credentials.json

mushu_sdk-0.1.2/CHANGELOG.md

@@ -0,0 +1,16 @@
+# Changelog
+
+## [0.1.2](https://github.com/cjoelrun/mushu/compare/mushu-sdk-v0.1.1...mushu-sdk-v0.1.2) (2026-01-25)
+
+
+### Bug Fixes
+
+* **sdk:** add email-validator dependency for EmailStr ([ac57008](https://github.com/cjoelrun/mushu/commit/ac57008d1715a1851b6af89662d77125740c1986))
+
+## [0.1.1](https://github.com/cjoelrun/mushu/compare/mushu-sdk-v0.1.0...mushu-sdk-v0.1.1) (2026-01-25)
+
+
+### Features
+
+* **sdk:** regenerate from OpenAPI specs ([b1c44c5](https://github.com/cjoelrun/mushu/commit/b1c44c555175769bf20a3f493395c34bf2ee60be))
+* **sdk:** regenerate from OpenAPI specs ([ab73e9e](https://github.com/cjoelrun/mushu/commit/ab73e9e575074ac1a0fa554d6154c076f7bb463d))

mushu_sdk-0.1.2/PKG-INFO

@@ -0,0 +1,61 @@
+Metadata-Version: 2.4
+Name: mushu-sdk
+Version: 0.1.2
+Summary: Python types for Mushu API - auto-generated from OpenAPI specs
+Project-URL: Homepage, https://admin.mushucorp.com
+Project-URL: Documentation, https://admin.mushucorp.com/docs
+Project-URL: Repository, https://github.com/mushucorp/mushu
+License: MIT
+Keywords: api,mushu,openapi,sdk
+Requires-Python: >=3.10
+Requires-Dist: pydantic[email]>=2.0.0
+Description-Content-Type: text/markdown
+
+# Mushu Python SDK
+
+Auto-generated Python types for the Mushu API.
+
+## Installation
+
+```bash
+pip install mushu-sdk
+```
+
+## Usage
+
+```python
+from mushu.media import UploadUrlRequest, MediaItem, MediaStatus
+from mushu.auth import UserResponse
+from mushu.notify import NotifyRequest
+from mushu.pay import WalletResponse
+
+# Type-safe request
+request = UploadUrlRequest(
+    org_id="org_123",
+    filename="photo.jpg",
+    content_type="image/jpeg",
+    size_bytes=1024000,
+)
+
+# Type hints work in your IDE
+def handle_media(item: MediaItem) -> str:
+    if item.status == MediaStatus.ready:
+        return item.url
+    return "Processing..."
+```
+
+## Regenerating
+
+These types are auto-generated from OpenAPI specs. To regenerate:
+
+```bash
+cd sdks
+./generate.sh
+```
+
+## Services
+
+- **auth** - Authentication, users, organizations
+- **notify** - Push notifications, email, devices
+- **media** - Image and video hosting
+- **pay** - Payments, wallets, billing

mushu_sdk-0.1.2/README.md

@@ -0,0 +1,48 @@
+# Mushu Python SDK
+
+Auto-generated Python types for the Mushu API.
+
+## Installation
+
+```bash
+pip install mushu-sdk
+```
+
+## Usage
+
+```python
+from mushu.media import UploadUrlRequest, MediaItem, MediaStatus
+from mushu.auth import UserResponse
+from mushu.notify import NotifyRequest
+from mushu.pay import WalletResponse
+
+# Type-safe request
+request = UploadUrlRequest(
+    org_id="org_123",
+    filename="photo.jpg",
+    content_type="image/jpeg",
+    size_bytes=1024000,
+)
+
+# Type hints work in your IDE
+def handle_media(item: MediaItem) -> str:
+    if item.status == MediaStatus.ready:
+        return item.url
+    return "Processing..."
+```
+
+## Regenerating
+
+These types are auto-generated from OpenAPI specs. To regenerate:
+
+```bash
+cd sdks
+./generate.sh
+```
+
+## Services
+
+- **auth** - Authentication, users, organizations
+- **notify** - Push notifications, email, devices
+- **media** - Image and video hosting
+- **pay** - Payments, wallets, billing

mushu_sdk-0.1.2/mushu/__init__.py

@@ -0,0 +1,20 @@
+"""
+Mushu SDK - Auto-generated Python types
+
+Generated from OpenAPI specs at:
+- https://auth.mushucorp.com/openapi.json
+- https://notify.mushucorp.com/openapi.json
+- https://media.mushucorp.com/openapi.json
+- https://pay.mushucorp.com/openapi.json
+
+Usage:
+    from mushu.media import UploadUrlRequest, MediaItem
+    from mushu.auth import UserResponse, OrgResponse
+    from mushu.notify import NotifyRequest
+    from mushu.pay import WalletResponse
+"""
+
+from mushu import auth, media, notify, pay
+
+__all__ = ["auth", "media", "notify", "pay"]
+__version__ = "0.1.0"

mushu_sdk-0.1.2/mushu/auth.py

@@ -0,0 +1,220 @@
+# generated by datamodel-codegen:
+#   filename:  auth-openapi.json
+#   timestamp: 2026-01-25T18:54:23+00:00
+
+from __future__ import annotations
+
+from enum import Enum
+
+from pydantic import BaseModel, Field
+
+
+class AppleS2SRequest(BaseModel):
+    payload: str = Field(
+        ..., description='JWT containing the S2S notification', title='Payload'
+    )
+
+
+class AppleSignInRequest(BaseModel):
+    id_token: str = Field(
+        ..., description='Apple ID token from Sign In with Apple', title='Id Token'
+    )
+    access_code: str = Field(
+        ..., description='Apple authorization code', title='Access Code'
+    )
+    nonce: str = Field(
+        ..., description='Nonce used during sign in (for validation)', title='Nonce'
+    )
+    given_name: str | None = Field(
+        None, description="User's given name", title='Given Name'
+    )
+    family_name: str | None = Field(
+        None, description="User's family name", title='Family Name'
+    )
+
+
+class AuthProviderType(Enum):
+    apple = 'apple'
+    google = 'google'
+
+
+class BodyAppleCallbackAuthAppleCallbackPost(BaseModel):
+    code: str = Field(..., description='Authorization code from Apple', title='Code')
+    id_token: str = Field(..., description='ID token from Apple', title='Id Token')
+    state: str = Field(..., description='OAuth state parameter', title='State')
+    user: str | None = Field(
+        None, description='User info JSON (first sign-in)', title='User'
+    )
+
+
+class CreateAuthProviderRequest(BaseModel):
+    provider_type: AuthProviderType = Field(
+        ..., description='Provider type (apple, google)'
+    )
+    enabled: bool | None = Field(
+        True, description='Whether the provider is enabled', title='Enabled'
+    )
+    apple_team_id: str | None = Field(
+        None, description='Apple Team ID', title='Apple Team Id'
+    )
+    apple_key_id: str | None = Field(
+        None, description='Apple Key ID', title='Apple Key Id'
+    )
+    apple_bundle_ids: list[str] | None = Field(
+        None, description='iOS app bundle IDs', title='Apple Bundle Ids'
+    )
+    apple_services_id: str | None = Field(
+        None, description='Apple Services ID for web OAuth', title='Apple Services Id'
+    )
+    apple_private_key: str | None = Field(
+        None, description='Apple private key (P8 format)', title='Apple Private Key'
+    )
+    google_client_id: str | None = Field(
+        None, description='Google OAuth client ID', title='Google Client Id'
+    )
+    google_client_secret: str | None = Field(
+        None, description='Google OAuth client secret', title='Google Client Secret'
+    )
+
+
+class HealthResponse(BaseModel):
+    status: str | None = Field('ok', description='Service status', title='Status')
+    service: str | None = Field(
+        'mushu-auth', description='Service name', title='Service'
+    )
+    version: str = Field(..., description='Service version', title='Version')
+
+
+class RefreshTokenRequest(BaseModel):
+    access_token: str = Field(
+        ..., description='Current access token (can be expired)', title='Access Token'
+    )
+    refresh_token: str = Field(
+        ..., description='Valid refresh token', title='Refresh Token'
+    )
+
+
+class SessionTokens(BaseModel):
+    access_token: str = Field(..., description='JWT access token', title='Access Token')
+    refresh_token: str = Field(
+        ..., description='JWT refresh token', title='Refresh Token'
+    )
+
+
+class UpdateAuthProviderRequest(BaseModel):
+    enabled: bool | None = Field(
+        None, description='Whether the provider is enabled', title='Enabled'
+    )
+    apple_team_id: str | None = Field(
+        None, description='Apple Team ID', title='Apple Team Id'
+    )
+    apple_key_id: str | None = Field(
+        None, description='Apple Key ID', title='Apple Key Id'
+    )
+    apple_bundle_ids: list[str] | None = Field(
+        None, description='iOS app bundle IDs', title='Apple Bundle Ids'
+    )
+    apple_services_id: str | None = Field(
+        None, description='Apple Services ID for web OAuth', title='Apple Services Id'
+    )
+    apple_private_key: str | None = Field(
+        None, description='Apple private key (P8 format)', title='Apple Private Key'
+    )
+    google_client_id: str | None = Field(
+        None, description='Google OAuth client ID', title='Google Client Id'
+    )
+    google_client_secret: str | None = Field(
+        None, description='Google OAuth client secret', title='Google Client Secret'
+    )
+
+
+class UserType(Enum):
+    apple = 'apple'
+    google = 'google'
+
+
+class ValidateTokenResponse(BaseModel):
+    valid: bool = Field(..., description='Whether the token is valid', title='Valid')
+    user_id: str | None = Field(
+        None, description='User ID if token is valid', title='User Id'
+    )
+    user_type: UserType | None = Field(None, description='User type if token is valid')
+    email: str | None = Field(
+        None, description='User email if available', title='Email'
+    )
+    app_id: str | None = Field(
+        None, description='App ID if token is valid', title='App Id'
+    )
+
+
+class ValidationError(BaseModel):
+    loc: list[str | int] = Field(..., title='Location')
+    msg: str = Field(..., title='Message')
+    type: str = Field(..., title='Error Type')
+
+
+class AuthProvider(BaseModel):
+    app_id: str = Field(..., description='App ID', title='App Id')
+    provider_type: AuthProviderType = Field(..., description='Provider type')
+    enabled: bool = Field(
+        ..., description='Whether the provider is enabled', title='Enabled'
+    )
+    created_at: str = Field(
+        ..., description='ISO timestamp of creation', title='Created At'
+    )
+    updated_at: str = Field(
+        ..., description='ISO timestamp of last update', title='Updated At'
+    )
+    is_configured: bool = Field(
+        ...,
+        description='Whether provider has minimum required config',
+        title='Is Configured',
+    )
+    apple_team_id: str | None = Field(
+        None, description='Apple Team ID', title='Apple Team Id'
+    )
+    apple_key_id: str | None = Field(
+        None, description='Apple Key ID', title='Apple Key Id'
+    )
+    apple_bundle_ids: list[str] | None = Field(
+        None, description='iOS app bundle IDs', title='Apple Bundle Ids'
+    )
+    apple_services_id: str | None = Field(
+        None, description='Apple Services ID for web OAuth', title='Apple Services Id'
+    )
+    google_client_id: str | None = Field(
+        None, description='Google OAuth client ID', title='Google Client Id'
+    )
+
+
+class AuthProviderListResponse(BaseModel):
+    providers: list[AuthProvider] = Field(
+        ..., description='List of configured providers', title='Providers'
+    )
+
+
+class HTTPValidationError(BaseModel):
+    detail: list[ValidationError] | None = Field(None, title='Detail')
+
+
+class User(BaseModel):
+    user_id: str = Field(..., description='Unique user identifier', title='User Id')
+    user_type: UserType = Field(..., description='Authentication provider')
+    email: str | None = Field(
+        None, description='User email if available', title='Email'
+    )
+    email_verified: bool | None = Field(
+        False, description='Whether email is verified', title='Email Verified'
+    )
+    name: str | None = Field(None, description="User's display name", title='Name')
+    created_at: str = Field(
+        ..., description='ISO timestamp of account creation', title='Created At'
+    )
+    last_login: str = Field(
+        ..., description='ISO timestamp of last login', title='Last Login'
+    )
+
+
+class SessionResponse(BaseModel):
+    user: User
+    tokens: SessionTokens

mushu_sdk-0.1.2/mushu/media.py

@@ -0,0 +1,156 @@
+# generated by datamodel-codegen:
+#   filename:  media-openapi.json
+#   timestamp: 2026-01-25T18:54:24+00:00
+
+from __future__ import annotations
+
+from enum import Enum
+
+from pydantic import BaseModel, Field, conint
+
+
+class HealthResponse(BaseModel):
+    status: str = Field(..., title='Status')
+    service: str = Field(..., title='Service')
+    version: str = Field(..., title='Version')
+
+
+class ImageUrlsResponse(BaseModel):
+    media_id: str = Field(..., title='Media Id')
+    original: str = Field(..., description='Original image URL', title='Original')
+    thumbnail: str = Field(..., description='150x150 thumbnail URL', title='Thumbnail')
+    small: str = Field(..., description='320px width URL', title='Small')
+    medium: str = Field(..., description='640px width URL', title='Medium')
+    large: str = Field(..., description='1280px width URL', title='Large')
+
+
+class MediaStatus(Enum):
+    pending = 'pending'
+    uploaded = 'uploaded'
+    ready = 'ready'
+    failed = 'failed'
+
+
+class MediaType(Enum):
+    image = 'image'
+    document = 'document'
+    video = 'video'
+    other = 'other'
+
+
+class UploadUrlRequest(BaseModel):
+    org_id: str = Field(..., description='Organization ID', title='Org Id')
+    app_id: str | None = Field(
+        None, description='App ID (optional, for app-specific media)', title='App Id'
+    )
+    filename: str = Field(..., description='Original filename', title='Filename')
+    content_type: str = Field(
+        ..., description='MIME type of the file', title='Content Type'
+    )
+    size_bytes: conint(ge=1, le=100000000) = Field(
+        ..., description='File size in bytes (max 100MB)', title='Size Bytes'
+    )
+
+
+class UploadUrlResponse(BaseModel):
+    media_id: str = Field(..., description='Unique media ID', title='Media Id')
+    upload_url: str = Field(
+        ..., description='Presigned URL for upload', title='Upload Url'
+    )
+    expires_in: int = Field(
+        ..., description='Seconds until URL expires', title='Expires In'
+    )
+    key: str = Field(..., description='Storage key for the media', title='Key')
+
+
+class ValidationError(BaseModel):
+    loc: list[str | int] = Field(..., title='Location')
+    msg: str = Field(..., title='Message')
+    type: str = Field(..., title='Error Type')
+
+
+class VideoStatus(Enum):
+    pending = 'pending'
+    uploading = 'uploading'
+    processing = 'processing'
+    ready = 'ready'
+    error = 'error'
+
+
+class VideoUploadUrlRequest(BaseModel):
+    org_id: str = Field(..., description='Organization ID', title='Org Id')
+    app_id: str | None = Field(None, description='App ID (optional)', title='App Id')
+    filename: str = Field(..., description='Original filename', title='Filename')
+    content_type: str | None = Field(
+        'video/mp4',
+        description='MIME type (video/mp4, video/quicktime, etc.)',
+        title='Content Type',
+    )
+    size_bytes: conint(ge=1, le=500000000) = Field(
+        ..., description='File size in bytes (max 500MB)', title='Size Bytes'
+    )
+
+
+class VideoUploadUrlResponse(BaseModel):
+    media_id: str = Field(..., description='Unique media ID', title='Media Id')
+    upload_url: str = Field(
+        ..., description='Presigned URL for upload to R2', title='Upload Url'
+    )
+    expires_in: int = Field(
+        ..., description='Seconds until URL expires', title='Expires In'
+    )
+    key: str = Field(..., description='Storage key for the video', title='Key')
+
+
+class VideoVariantsResponse(BaseModel):
+    media_id: str = Field(..., title='Media Id')
+    status: VideoStatus
+    job_id: str | None = Field(None, description='MediaConvert job ID', title='Job Id')
+    original: str | None = Field(
+        None, description='Original uploaded video URL', title='Original'
+    )
+    optimized: str | None = Field(
+        None, description='H.264 MP4 (1080p, 8Mbps) URL', title='Optimized'
+    )
+    web: str | None = Field(
+        None, description='VP9 WebM (1080p, 5Mbps) URL', title='Web'
+    )
+    thumbnail: str | None = Field(
+        None, description='Thumbnail JPEG (640x360) URL', title='Thumbnail'
+    )
+    poster: str | None = Field(
+        None, description='Poster JPEG (1280x720) URL', title='Poster'
+    )
+    error_message: str | None = Field(
+        None, description='Error message if status is ERROR', title='Error Message'
+    )
+
+
+class ConfirmUploadResponse(BaseModel):
+    media_id: str = Field(..., title='Media Id')
+    status: MediaStatus
+    url: str | None = Field(None, description='Public URL if ready', title='Url')
+
+
+class HTTPValidationError(BaseModel):
+    detail: list[ValidationError] | None = Field(None, title='Detail')
+
+
+class MediaItem(BaseModel):
+    media_id: str = Field(..., title='Media Id')
+    org_id: str = Field(..., title='Org Id')
+    app_id: str | None = Field(..., title='App Id')
+    filename: str = Field(..., title='Filename')
+    content_type: str = Field(..., title='Content Type')
+    size_bytes: int = Field(..., title='Size Bytes')
+    media_type: MediaType
+    status: MediaStatus
+    key: str = Field(..., title='Key')
+    created_at: str = Field(..., title='Created At')
+    updated_at: str = Field(..., title='Updated At')
+    url: str | None = Field(None, title='Url')
+
+
+class MediaListResponse(BaseModel):
+    items: list[MediaItem] = Field(..., title='Items')
+    next_cursor: str | None = Field(None, title='Next Cursor')

mushu_sdk-0.1.2/mushu/notify.py

@@ -0,0 +1,333 @@
+# generated by datamodel-codegen:
+#   filename:  notify-openapi.json
+#   timestamp: 2026-01-25T18:54:24+00:00
+
+from __future__ import annotations
+
+from enum import Enum
+from typing import Any
+
+from pydantic import BaseModel, EmailStr, Field
+
+
+class AddDomainRequest(BaseModel):
+    domain: str = Field(
+        ..., description="Domain to verify (e.g., 'acme.com')", title='Domain'
+    )
+    from_name: str | None = Field(
+        None, description="Default sender name (e.g., 'Acme Inc')", title='From Name'
+    )
+
+
+class AlertPayload(BaseModel):
+    title: str | None = Field(None, description='Notification title', title='Title')
+    body: str | None = Field(None, description='Notification body', title='Body')
+    subtitle: str | None = Field(
+        None, description='Notification subtitle', title='Subtitle'
+    )
+
+
+class ApiKey(BaseModel):
+    key_id: str = Field(..., description='API key ID', title='Key Id')
+    key: str | None = Field(
+        None, description='API key (only shown on creation)', title='Key'
+    )
+    name: str = Field(..., description='Key name', title='Name')
+    created_at: str = Field(..., description='Creation timestamp', title='Created At')
+
+
+class BulkPushRequest(BaseModel):
+    user_ids: list[str] = Field(..., description='Target user IDs', title='User Ids')
+    alert: AlertPayload | None = Field(None, description='Alert payload')
+    badge: int | None = Field(None, description='Badge count', title='Badge')
+    sound: str | None = Field(None, description='Sound name', title='Sound')
+    content_available: bool | None = Field(
+        False, description='Silent/background push', title='Content Available'
+    )
+    data: dict[str, Any] | None = Field(
+        None, description='Custom data payload', title='Data'
+    )
+
+
+class Channel(Enum):
+    push = 'push'
+    email = 'email'
+    all = 'all'
+
+
+class ChannelStats(BaseModel):
+    sent: int = Field(..., title='Sent')
+    delivered: int = Field(..., title='Delivered')
+    failed: int = Field(..., title='Failed')
+    delivery_rate: float = Field(..., title='Delivery Rate')
+
+
+class CreateApiKeyRequest(BaseModel):
+    name: str = Field(..., description='Name for the API key', title='Name')
+
+
+class CreateNotifyConfigRequest(BaseModel):
+    org_id: str = Field(
+        ..., description='Organization ID that owns this app', title='Org Id'
+    )
+    bundle_id: str | None = Field(
+        None, description='iOS app bundle ID', title='Bundle Id'
+    )
+    team_id: str | None = Field(
+        None, description='Apple Developer Team ID', title='Team Id'
+    )
+    key_id: str | None = Field(None, description='APNs Key ID', title='Key Id')
+    private_key: str | None = Field(
+        None, description='APNs private key (.p8 contents)', title='Private Key'
+    )
+    use_sandbox: bool | None = Field(
+        True, description='Use APNs sandbox environment', title='Use Sandbox'
+    )
+
+
+class DailyStats(BaseModel):
+    date: str = Field(..., title='Date')
+    push_sent: int = Field(..., title='Push Sent')
+    push_delivered: int = Field(..., title='Push Delivered')
+    push_failed: int = Field(..., title='Push Failed')
+    email_sent: int = Field(..., title='Email Sent')
+    email_delivered: int = Field(..., title='Email Delivered')
+    email_failed: int = Field(..., title='Email Failed')
+
+
+class DnsRecordPurpose(Enum):
+    dkim = 'dkim'
+
+
+class EmailContact(BaseModel):
+    email: str = Field(..., description='Email address', title='Email')
+    user_id: str = Field(..., description='Associated user ID', title='User Id')
+    subscribed: bool | None = Field(
+        True, description='Whether contact is subscribed', title='Subscribed'
+    )
+    created_at: str = Field(
+        ..., description='Registration timestamp', title='Created At'
+    )
+
+
+class EmailDomainStatus(Enum):
+    pending = 'pending'
+    verified = 'verified'
+    failed = 'failed'
+
+
+class HealthResponse(BaseModel):
+    status: str | None = Field('ok', description='Service status', title='Status')
+    service: str | None = Field(
+        'mushu-notify', description='Service name', title='Service'
+    )
+    version: str = Field(..., description='Service version', title='Version')
+
+
+class NotifyConfig(BaseModel):
+    app_id: str = Field(..., description='App identifier', title='App Id')
+    org_id: str = Field(
+        ..., description='Organization ID that owns this app', title='Org Id'
+    )
+    created_at: str = Field(..., description='Creation timestamp', title='Created At')
+    created_by: str = Field(
+        ..., description='User ID who created this config', title='Created By'
+    )
+    bundle_id: str | None = Field(
+        None, description='iOS app bundle ID', title='Bundle Id'
+    )
+    team_id: str | None = Field(
+        None, description='Apple Developer Team ID', title='Team Id'
+    )
+    key_id: str | None = Field(None, description='APNs Key ID', title='Key Id')
+    use_sandbox: bool | None = Field(
+        True, description='Using APNs sandbox', title='Use Sandbox'
+    )
+    email_domain: str | None = Field(
+        None, description='Verified email domain', title='Email Domain'
+    )
+    email_domain_status: str | None = Field(
+        None, description='Domain verification status', title='Email Domain Status'
+    )
+    email_from_name: str | None = Field(
+        None, description='Default sender name', title='Email From Name'
+    )
+    email_verified_at: str | None = Field(
+        None, description='When email domain was verified', title='Email Verified At'
+    )
+    push_enabled: bool | None = Field(
+        False,
+        description='Whether push notifications are configured',
+        title='Push Enabled',
+    )
+    email_enabled: bool | None = Field(
+        False,
+        description='Whether email is configured and verified',
+        title='Email Enabled',
+    )
+
+
+class NotifyConfigListResponse(BaseModel):
+    configs: list[NotifyConfig] = Field(..., title='Configs')
+
+
+class Platform(Enum):
+    ios = 'ios'
+    watchos = 'watchos'
+
+
+class PushResult(BaseModel):
+    success: bool = Field(..., description='Whether push was sent', title='Success')
+    message_id: str | None = Field(
+        None, description='APNs message ID', title='Message Id'
+    )
+    error: str | None = Field(
+        None, description='Error message if failed', title='Error'
+    )
+
+
+class RegisterContactRequest(BaseModel):
+    user_id: str = Field(
+        ..., description='User ID to associate email with', title='User Id'
+    )
+    email: EmailStr = Field(..., description='Email address', title='Email')
+
+
+class RegisterDeviceRequest(BaseModel):
+    user_id: str = Field(
+        ..., description='User ID to associate device with', title='User Id'
+    )
+    token: str = Field(..., description='APNs device token', title='Token')
+    platform: Platform = Field(..., description='Device platform')
+    app_version: str | None = Field(
+        None, description='App version', title='App Version'
+    )
+
+
+class SendNotifyRequest(BaseModel):
+    user_id: str = Field(..., description='Target user ID', title='User Id')
+    channel: Channel | None = Field('push', description='Notification channel')
+    alert: AlertPayload | None = Field(None, description='Alert payload for push')
+    badge: int | None = Field(None, description='Badge count for push', title='Badge')
+    sound: str | None = Field(None, description='Sound name for push', title='Sound')
+    content_available: bool | None = Field(
+        False, description='Silent/background push', title='Content Available'
+    )
+    data: dict[str, Any] | None = Field(
+        None, description='Custom data payload for push', title='Data'
+    )
+    email_subject: str | None = Field(
+        None, description='Email subject', title='Email Subject'
+    )
+    email_body_html: str | None = Field(
+        None, description='Email HTML body', title='Email Body Html'
+    )
+    email_body_text: str | None = Field(
+        None, description='Email plain text body', title='Email Body Text'
+    )
+    email_from: str | None = Field(
+        None, description='Sender email (must be @verified-domain)', title='Email From'
+    )
+
+
+class SendPushRequest(BaseModel):
+    user_id: str = Field(..., description='Target user ID', title='User Id')
+    alert: AlertPayload | None = Field(None, description='Alert payload')
+    badge: int | None = Field(None, description='Badge count', title='Badge')
+    sound: str | None = Field(None, description='Sound name', title='Sound')
+    content_available: bool | None = Field(
+        False, description='Silent/background push', title='Content Available'
+    )
+    data: dict[str, Any] | None = Field(
+        None, description='Custom data payload', title='Data'
+    )
+
+
+class TimeSeriesResponse(BaseModel):
+    app_id: str = Field(..., title='App Id')
+    start_date: str = Field(..., title='Start Date')
+    end_date: str = Field(..., title='End Date')
+    daily: list[DailyStats] = Field(..., title='Daily')
+
+
+class ValidationError(BaseModel):
+    loc: list[str | int] = Field(..., title='Location')
+    msg: str = Field(..., title='Message')
+    type: str = Field(..., title='Error Type')
+
+
+class VerifyDomainResponse(BaseModel):
+    domain: str = Field(..., description='Domain name', title='Domain')
+    status: EmailDomainStatus = Field(..., description='Current verification status')
+    verified_at: str | None = Field(
+        None, description='When verified, if applicable', title='Verified At'
+    )
+
+
+class AnalyticsResponse(BaseModel):
+    app_id: str = Field(..., title='App Id')
+    start_date: str = Field(..., title='Start Date')
+    end_date: str = Field(..., title='End Date')
+    total_events: int = Field(..., title='Total Events')
+    push: ChannelStats
+    email: ChannelStats
+
+
+class BulkPushResult(BaseModel):
+    total: int = Field(..., description='Total users targeted', title='Total')
+    success: int = Field(..., description='Successful sends', title='Success')
+    failed: int = Field(..., description='Failed sends', title='Failed')
+    results: list[PushResult] = Field(
+        ..., description='Per-user results', title='Results'
+    )
+
+
+class ContactListResponse(BaseModel):
+    contacts: list[EmailContact] = Field(..., title='Contacts')
+
+
+class Device(BaseModel):
+    token: str = Field(..., description='APNs device token', title='Token')
+    user_id: str = Field(..., description='Associated user ID', title='User Id')
+    platform: Platform = Field(..., description='Device platform')
+    app_version: str | None = Field(
+        None, description='App version', title='App Version'
+    )
+    created_at: str = Field(
+        ..., description='Registration timestamp', title='Created At'
+    )
+    updated_at: str = Field(
+        ..., description='Last update timestamp', title='Updated At'
+    )
+
+
+class DeviceListResponse(BaseModel):
+    devices: list[Device] = Field(..., title='Devices')
+
+
+class DnsRecord(BaseModel):
+    type: str = Field(..., description="Record type (e.g., 'CNAME')", title='Type')
+    name: str = Field(..., description='Record name/host', title='Name')
+    value: str = Field(..., description='Record value', title='Value')
+    purpose: DnsRecordPurpose = Field(..., description='Purpose of this record')
+
+
+class EmailDomain(BaseModel):
+    domain: str = Field(..., description='Domain name', title='Domain')
+    status: EmailDomainStatus = Field(..., description='Verification status')
+    from_name: str | None = Field(
+        None, description='Default sender name', title='From Name'
+    )
+    dns_records: list[DnsRecord] | None = Field(
+        None, description='DNS records to add', title='Dns Records'
+    )
+    created_at: str = Field(
+        ..., description='When domain was added', title='Created At'
+    )
+    verified_at: str | None = Field(
+        None, description='When domain was verified', title='Verified At'
+    )
+
+
+class HTTPValidationError(BaseModel):
+    detail: list[ValidationError] | None = Field(None, title='Detail')

mushu_sdk-0.1.2/mushu/pay.py

@@ -0,0 +1,345 @@
+# generated by datamodel-codegen:
+#   filename:  pay-openapi.json
+#   timestamp: 2026-01-25T18:54:24+00:00
+
+from __future__ import annotations
+
+from enum import Enum
+
+from pydantic import BaseModel, Field, PositiveInt, conint
+
+
+class ApiKeyCreatedResponse(BaseModel):
+    key_id: str = Field(..., description='API key ID', title='Key Id')
+    name: str = Field(..., description='API key name', title='Name')
+    api_key: str = Field(
+        ..., description='The API key (only shown once)', title='Api Key'
+    )
+    created_at: str = Field(..., description='Creation timestamp', title='Created At')
+
+
+class ApiKeyResponse(BaseModel):
+    key_id: str = Field(..., description='API key ID', title='Key Id')
+    name: str = Field(..., description='API key name', title='Name')
+    created_at: str = Field(..., description='Creation timestamp', title='Created At')
+
+
+class AutoRefillConfig(BaseModel):
+    enabled: bool = Field(
+        ..., description='Whether auto-refill is enabled', title='Enabled'
+    )
+    product_id: str | None = Field(
+        None, description='Product to purchase for auto-refill', title='Product Id'
+    )
+    threshold: conint(ge=0) | None = Field(
+        0,
+        description='Trigger auto-refill when balance falls below this (in micro-dollars)',
+        title='Threshold',
+    )
+
+
+class BillingModel(Enum):
+    one_time = 'one_time'
+    subscription = 'subscription'
+    usage_based = 'usage_based'
+    tiered = 'tiered'
+
+
+class CheckoutRequest(BaseModel):
+    product_id: str = Field(..., description='Product to purchase', title='Product Id')
+    success_url: str = Field(
+        ..., description='URL to redirect on success', title='Success Url'
+    )
+    cancel_url: str = Field(
+        ..., description='URL to redirect on cancel', title='Cancel Url'
+    )
+
+
+class CheckoutResponse(BaseModel):
+    checkout_url: str = Field(
+        ..., description='Stripe Checkout URL', title='Checkout Url'
+    )
+
+
+class CreateApiKeyRequest(BaseModel):
+    name: str = Field(..., description='Name for this API key', title='Name')
+
+
+class CreateOrgBillingRequest(BaseModel):
+    name: str = Field(..., description='Human-readable name for billing', title='Name')
+    stripe_secret_key: str | None = Field(
+        None, description='Stripe secret key', title='Stripe Secret Key'
+    )
+    stripe_webhook_secret: str | None = Field(
+        None, description='Stripe webhook signing secret', title='Stripe Webhook Secret'
+    )
+    free_tier_amount: int | None = Field(
+        0,
+        description='Amount granted to new organizations in micro-dollars (0 to disable)',
+        title='Free Tier Amount',
+    )
+
+
+class HealthResponse(BaseModel):
+    status: str = Field(..., description='Health status', title='Status')
+    service: str = Field(..., description='Service name', title='Service')
+    version: str = Field(..., description='Service version', title='Version')
+
+
+class OrgBilling(BaseModel):
+    org_id: str = Field(..., description='Organization ID', title='Org Id')
+    name: str = Field(..., description='Billing config name', title='Name')
+    is_platform: bool | None = Field(
+        False, description="True if this is Mushu's own billing", title='Is Platform'
+    )
+    has_stripe_key: bool = Field(
+        ..., description='Whether Stripe key is configured', title='Has Stripe Key'
+    )
+    has_webhook_secret: bool = Field(
+        ...,
+        description='Whether webhook secret is configured',
+        title='Has Webhook Secret',
+    )
+    free_tier_amount: int | None = Field(
+        0,
+        description='Amount granted to new orgs in micro-dollars',
+        title='Free Tier Amount',
+    )
+    wallet_balance: int | None = Field(
+        0, description='Current wallet balance in micro-dollars', title='Wallet Balance'
+    )
+    wallet_balance_usd: str | None = Field(
+        '$0.00',
+        description='Wallet balance formatted as USD',
+        title='Wallet Balance Usd',
+    )
+    auto_refill_enabled: bool | None = Field(
+        False, description='Whether auto-refill is enabled', title='Auto Refill Enabled'
+    )
+    auto_refill_product_id: str | None = Field(
+        None, description='Product for auto-refill', title='Auto Refill Product Id'
+    )
+    auto_refill_threshold: int | None = Field(
+        0,
+        description='Auto-refill threshold in micro-dollars',
+        title='Auto Refill Threshold',
+    )
+    has_payment_method: bool | None = Field(
+        False,
+        description='Whether a payment method is saved',
+        title='Has Payment Method',
+    )
+    created_at: str = Field(
+        ..., description='ISO timestamp of creation', title='Created At'
+    )
+    created_by: str = Field(
+        ..., description='User ID who created this', title='Created By'
+    )
+
+
+class PriceTier(BaseModel):
+    up_to: int | None = Field(
+        None, description='Maximum units for this tier (None = infinity)', title='Up To'
+    )
+    price_per_unit_cents: int = Field(
+        ..., description='Price per unit in cents', title='Price Per Unit Cents'
+    )
+    flat_fee_cents: int | None = Field(
+        None, description='Optional flat fee for this tier', title='Flat Fee Cents'
+    )
+
+
+class SetupIntentResponse(BaseModel):
+    client_secret: str = Field(
+        ..., description='Stripe client secret for Stripe.js', title='Client Secret'
+    )
+    setup_intent_id: str = Field(
+        ..., description='Setup intent ID', title='Setup Intent Id'
+    )
+
+
+class UpdateOrgBillingRequest(BaseModel):
+    name: str | None = Field(None, description='Updated name', title='Name')
+    stripe_secret_key: str | None = Field(
+        None, description='Updated Stripe secret key', title='Stripe Secret Key'
+    )
+    stripe_webhook_secret: str | None = Field(
+        None, description='Updated Stripe webhook secret', title='Stripe Webhook Secret'
+    )
+    free_tier_amount: int | None = Field(
+        None,
+        description='Amount granted to new organizations in micro-dollars (0 to disable)',
+        title='Free Tier Amount',
+    )
+
+
+class UpdateProductRequest(BaseModel):
+    name: str | None = Field(None, description='Updated name', title='Name')
+    price_cents: int | None = Field(
+        None, description='Updated price', title='Price Cents'
+    )
+    active: bool | None = Field(
+        None, description='Whether product is active', title='Active'
+    )
+    amount_micros: int | None = Field(
+        None,
+        description='Updated amount in micro-dollars deposited to wallet',
+        title='Amount Micros',
+    )
+
+
+class ValidationError(BaseModel):
+    loc: list[str | int] = Field(..., title='Location')
+    msg: str = Field(..., title='Message')
+    type: str = Field(..., title='Error Type')
+
+
+class WalletOperationType(Enum):
+    deposit = 'deposit'
+    charge = 'charge'
+
+
+class WalletTransaction(BaseModel):
+    org_id: str = Field(..., description='Organization ID', title='Org Id')
+    transaction_id: str = Field(
+        ..., description='Transaction ID', title='Transaction Id'
+    )
+    type: str = Field(
+        ..., description='Transaction type (deposit, charge, refund)', title='Type'
+    )
+    amount_micros: int = Field(
+        ...,
+        description='Amount in micro-dollars (positive=deposit, negative=charge)',
+        title='Amount Micros',
+    )
+    amount_usd: str = Field(
+        ..., description='Amount formatted as USD', title='Amount Usd'
+    )
+    balance_after: int = Field(
+        ...,
+        description='Balance after transaction in micro-dollars',
+        title='Balance After',
+    )
+    balance_after_usd: str = Field(
+        ...,
+        description='Balance after transaction formatted as USD',
+        title='Balance After Usd',
+    )
+    description: str = Field(
+        ..., description='Transaction description', title='Description'
+    )
+    stripe_payment_id: str | None = Field(
+        None, description='Stripe payment ID', title='Stripe Payment Id'
+    )
+    app_id: str | None = Field(
+        None, description='App that triggered this', title='App Id'
+    )
+    created_at: str = Field(..., description='ISO timestamp', title='Created At')
+
+
+class ApiKeyListResponse(BaseModel):
+    api_keys: list[ApiKeyResponse] = Field(
+        ..., description='List of API keys', title='Api Keys'
+    )
+
+
+class CreateProductRequest(BaseModel):
+    name: str = Field(..., description='Product name', title='Name')
+    billing_model: BillingModel = Field(..., description='Billing model')
+    price_cents: int = Field(
+        ..., description='Base price in cents', title='Price Cents'
+    )
+    amount_micros: int | None = Field(
+        None,
+        description='Amount in micro-dollars deposited to wallet on purchase (for one_time)',
+        title='Amount Micros',
+    )
+    interval: str | None = Field(
+        None,
+        description="Billing interval: 'month' or 'year' (for subscription)",
+        title='Interval',
+    )
+    interval_amount_micros: int | None = Field(
+        None,
+        description='Amount in micro-dollars deposited per billing period (for subscription)',
+        title='Interval Amount Micros',
+    )
+    unit_name: str | None = Field(
+        None,
+        description="Name of the unit, e.g., 'API call' (for usage_based)",
+        title='Unit Name',
+    )
+    price_per_unit_cents: int | None = Field(
+        None,
+        description='Price per unit in cents (for usage_based)',
+        title='Price Per Unit Cents',
+    )
+    tiers: list[PriceTier] | None = Field(
+        None, description='Volume pricing tiers (for tiered)', title='Tiers'
+    )
+
+
+class HTTPValidationError(BaseModel):
+    detail: list[ValidationError] | None = Field(None, title='Detail')
+
+
+class PayProduct(BaseModel):
+    org_id: str = Field(..., description='Owning organization ID', title='Org Id')
+    product_id: str = Field(
+        ..., description='Unique product identifier', title='Product Id'
+    )
+    name: str = Field(..., description='Product name', title='Name')
+    billing_model: BillingModel = Field(..., description='Billing model')
+    price_cents: int = Field(
+        ..., description='Base price in cents', title='Price Cents'
+    )
+    stripe_price_id: str = Field(
+        ..., description='Stripe Price ID', title='Stripe Price Id'
+    )
+    active: bool = Field(..., description='Whether product is active', title='Active')
+    created_at: str = Field(
+        ..., description='ISO timestamp of creation', title='Created At'
+    )
+    amount_micros: int | None = Field(
+        None,
+        description='Amount in micro-dollars deposited to wallet on purchase',
+        title='Amount Micros',
+    )
+    interval: str | None = Field(None, description='Billing interval', title='Interval')
+    interval_amount_micros: int | None = Field(
+        None,
+        description='Amount in micro-dollars deposited per billing period',
+        title='Interval Amount Micros',
+    )
+    unit_name: str | None = Field(None, description='Unit name', title='Unit Name')
+    price_per_unit_cents: int | None = Field(
+        None, description='Price per unit', title='Price Per Unit Cents'
+    )
+    tiers: list[PriceTier] | None = Field(
+        None, description='Pricing tiers', title='Tiers'
+    )
+
+
+class ProductListResponse(BaseModel):
+    products: list[PayProduct] = Field(
+        ..., description='List of products', title='Products'
+    )
+
+
+class TransactionListResponse(BaseModel):
+    transactions: list[WalletTransaction] = Field(
+        ..., description='List of transactions', title='Transactions'
+    )
+
+
+class WalletOperationRequest(BaseModel):
+    operation: WalletOperationType = Field(..., description='Operation type')
+    amount_micros: PositiveInt = Field(
+        ..., description='Amount in micro-dollars', title='Amount Micros'
+    )
+    description: str = Field(
+        ..., description='Reason for the operation', title='Description'
+    )
+    app_id: str | None = Field(
+        None, description='App that triggered this (for charges)', title='App Id'
+    )

mushu_sdk-0.1.2/pyproject.toml

@@ -0,0 +1,23 @@
+[project]
+name = "mushu-sdk"
+version = "0.1.2"
+description = "Python types for Mushu API - auto-generated from OpenAPI specs"
+readme = "README.md"
+requires-python = ">=3.10"
+license = {text = "MIT"}
+keywords = ["mushu", "api", "sdk", "openapi"]
+dependencies = [
+    "pydantic[email]>=2.0.0",
+]
+
+[project.urls]
+Homepage = "https://admin.mushucorp.com"
+Documentation = "https://admin.mushucorp.com/docs"
+Repository = "https://github.com/mushucorp/mushu"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["mushu"]