python-casahome 0.2.0__py3-none-any.whl

casahome/models/preferences.py

@@ -0,0 +1,104 @@
+"""Populated preferences and onboarding responses, plus calendar sync metadata."""
+
+from pydantic import JsonValue
+
+from casahome.models._base import CasaModel
+
+
+class SchedulingDay(CasaModel):
+    day_of_week: int
+    label: str
+    enabled: bool
+
+
+class SchedulingTimeOfDay(CasaModel):
+    id: str
+    window_title: str
+    window_time_range: str
+    enabled: bool
+
+
+class SchedulePreferencesResponse(CasaModel):
+    days_of_week: list[SchedulingDay]
+    times_of_day: list[SchedulingTimeOfDay]
+
+
+class NotificationChannel(CasaModel):
+    channel: str
+    enabled: bool
+    default_enabled: bool
+    required: bool
+
+
+class NotificationType(CasaModel):
+    key: str
+    display_name: str
+    description: str
+    sort_order: int
+    channels: list[NotificationChannel]
+
+
+class NotificationGroup(CasaModel):
+    key: str
+    display_name: str
+    sort_order: int
+    types: list[NotificationType]
+
+
+class NotificationSettingsResponse(CasaModel):
+    groups: list[NotificationGroup]
+
+
+class OnboardingSlot(CasaModel):
+    start_time: int
+    vendor_ids: list[str]
+
+
+class OnboardingAvailabilityResponse(CasaModel):
+    message: str
+    number_of_required_vendors: int
+    estimated_visit_duration_seconds: int
+    timezone: str | None = None
+    available_slots: list[OnboardingSlot]
+
+
+class OnboardingEvent(CasaModel):
+    id: str
+    start_at: int
+    end_at: int
+
+
+class OnboardingDetailsResponse(CasaModel):
+    calendar_events: list[OnboardingEvent]
+
+
+class AccessPreferencesResponse(CasaModel):
+    home_id: str
+    general_instructions: str | None = None
+    package_pickup_method: str | None = None
+    package_pickup_spot: str | None = None
+    package_pickup_call_home_member_id: str | None = None
+    package_pickup_general_instructions: str | None = None
+
+
+class CalendarOption(CasaModel):
+    """UNVERIFIED item. Available/display calendars were empty."""
+
+    id: str | None = None
+    summary: str | None = None
+    color: str | None = None
+
+
+class CalendarSyncResponse(CasaModel):
+    home_id: str
+    user_oauth_connected: bool
+    user_oauth_insufficient_scope: bool
+    calendar_sync_active: bool
+    has_active_syncs_in_other_homes: bool
+    available_calendars: list[CalendarOption]
+    display_calendars: list[CalendarOption]
+    user_oauth_email: str | None = None
+    google_calendar_id: str | None = None
+    google_calendar_summary: str | None = None
+    sync_status: str | None = None
+    sync_progress: JsonValue = None  # Only null observed, no static structure.

casahome/models/purchases.py

@@ -0,0 +1,106 @@
+"""Read-only purchases. All item lists were empty, item fields are static.
+
+Invoice payment structures, pricing summaries, and return info stay opaque JSON.
+No payment or purchase mutation is exposed by these models.
+"""
+
+from pydantic import JsonValue
+
+from casahome.models._base import CasaModel
+
+
+class PurchaseVendor(CasaModel):
+    id: str | None = None
+    name: str | None = None
+    image_url: str | None = None
+    image_url_cache_key: str | None = None
+
+
+class PurchaseApproval(CasaModel):
+    id: str | None = None
+    home_id: str | None = None
+    title: str | None = None
+    image_url: str | None = None
+    image_cache_key: str | None = None
+    vendor: PurchaseVendor | None = None
+    unit_price_usd_cents: int | None = None
+    max_approved_unit_price_usd_cents: int | None = None
+    quantity: int | None = None
+    estimated_shipping_price_usd_cents: int | None = None
+    estimated_return_window_days: int | None = None
+    return_policy_notes: str | None = None
+    purchase_link: str | None = None
+    member_pricing_summary: JsonValue = None
+    updated_at: int | None = None
+
+
+class ApprovedPurchase(PurchaseApproval):
+    item_id: str | None = None
+    approved_at: int | None = None
+    is_voided: bool | None = None
+
+
+class PurchasedItem(CasaModel):
+    id: str | None = None
+    home_id: str | None = None
+    title: str | None = None
+    image_url: str | None = None
+    image_cache_key: str | None = None
+    vendor: PurchaseVendor | None = None
+    unit_price_usd_cents: int | None = None
+    return_policy_notes: str | None = None
+    purchase_link: str | None = None
+    updated_at: int | None = None
+    quantity: int | None = None
+    invoice_id: str | None = None
+    return_by_date: int | None = None
+    purchased_at: int | None = None
+    return_info: JsonValue = None
+
+
+class PurchaseInvoice(CasaModel):
+    """Minimal static SimpleInvoice fields. Non-purchase wire items unobserved."""
+
+    id: str | None = None
+    date: str | None = None
+    date_display: str | None = None
+    date_epoch_seconds: int | None = None
+    amount: float | None = None
+    vendor_name: str | None = None
+    status: str | None = None
+    type: str | None = None
+    member_payment: JsonValue = None
+    vendor_payment: JsonValue = None
+
+
+class PurchasesResponse(CasaModel):
+    context_title: str | None = None
+    pending_purchase_approvals: list[PurchaseApproval]
+    approved_purchases: list[ApprovedPurchase]
+    purchased_items: list[PurchasedItem]
+    non_purchase_invoices: list[PurchaseInvoice]
+    next_package_pickup_by: int | None = None
+
+
+class ScopedPurchasesResponse(CasaModel):
+    """Provisional request/visit linkage to PurchasesResponse (static only).
+
+    Unlike the observed home response, the app model doesn't require
+    non_purchase_invoices. Unknown additions still survive as model_extra.
+    Scoped route envelopes and populated items remain UNVERIFIED.
+    """
+
+    context_title: str | None = None
+    pending_purchase_approvals: list[PurchaseApproval]
+    approved_purchases: list[ApprovedPurchase]
+    purchased_items: list[PurchasedItem]
+    next_package_pickup_by: int | None = None
+
+
+class RequestPurchase(CasaModel):
+    """Static preview within visit detail."""
+
+    id: str
+    image_url: str | None = None
+    image_cache_key: str | None = None
+    status: str

casahome/models/read_todos.py

@@ -0,0 +1,22 @@
+"""Typed read envelopes without changing the existing create_todo return model."""
+
+from pydantic import Field
+
+from casahome.models._base import CasaModel
+from casahome.models.images import MediaAttachment
+from casahome.models.todos import TodoDetail
+
+
+class TodoReadDetail(TodoDetail):
+    """Populated core fields and attachments observed. Other nested fields static."""
+
+    flagged_for_support: bool = False
+    attachments: list[MediaAttachment] = Field(default_factory=list)
+
+
+class TodoDetailsResponse(CasaModel):
+    todo: TodoReadDetail
+
+
+class SuggestedTodosResponse(CasaModel):
+    suggested_todos: list[TodoReadDetail]

casahome/models/referral.py

@@ -0,0 +1,21 @@
+"""Member referral code, ``/protected/member/referral_code/v2``.
+
+The envelope and top-level ``referral_code`` keys were VERIFIED by a live
+GET (2026-10). Display keys and referred-home item shapes aren't pinned, so
+they stay ``JsonValue``. Unknown fields ride along in ``model_extra``.
+"""
+
+from pydantic import JsonValue
+
+from casahome.models._base import CasaModel
+
+
+class ReferralCode(CasaModel):
+    code: str
+    referral_url: str
+    display: dict[str, JsonValue]
+    referred_homes: list[JsonValue]
+
+
+class ReferralCodeResponse(CasaModel):
+    referral_code: ReferralCode

casahome/models/requests.py

@@ -0,0 +1,149 @@
+"""Requests tab, request threads, and vendor visit models (UNVERIFIED endpoints)."""
+
+from __future__ import annotations
+
+from datetime import datetime
+from typing import Any
+
+from pydantic import Field
+
+from ._base import CasaModel, epoch_to_dt
+from .enums import (
+    RequestStatusField,
+    RequestTypeField,
+    SenderRoleField,
+    VendorVisitStatusField,
+    VisitTypeField,
+)
+from .todos import TodoLaneCard
+
+
+class Pagination(CasaModel):
+    page: int
+    page_size: int
+    total_count: int
+    total_pages: int
+
+
+class RequestCard(CasaModel):
+    id: str
+    type: RequestTypeField
+    title: str
+    emoji: str
+    updated_at: int
+    latest_message_preview: str | None = None
+    has_unread_messages: bool = False
+    pending_invoice_count: int = 0
+    pending_purchase_count: int = 0
+    pending_schedule_prompt_count: int = 0
+    concierge_awaiting_reply: bool = False
+    vendor_visits: list[Any] = Field(default_factory=list)
+
+    @property
+    def updated_at_dt(self) -> datetime | None:
+        return epoch_to_dt(self.updated_at)
+
+
+class RequestsSectionPresentation(CasaModel):
+    title: str
+    symbol: str | None = None
+
+
+class RequestsLaneSection(CasaModel):
+    name: str
+    title: str
+    symbol: str | None = None
+    count: int | None = None
+    items: list[RequestCard] = Field(default_factory=list)
+
+
+class RequestsLane(CasaModel):
+    needs_review: list[RequestCard] = Field(default_factory=list)
+    completed: RequestsSectionPresentation | None = None
+    completed_count: int = 0
+    sections: list[RequestsLaneSection] = Field(default_factory=list)
+
+
+class TasksLaneSection(CasaModel):
+    name: str
+    title: str
+    symbol: str | None = None
+    count: int | None = None
+    items: list[Any] = Field(default_factory=list)  # TaskCard, not yet modeled
+
+
+class TasksLane(CasaModel):
+    sections: list[TasksLaneSection] = Field(default_factory=list)
+
+
+class TodosLaneSection(CasaModel):
+    name: str
+    title: str
+    items: list[TodoLaneCard] = Field(default_factory=list)
+    order_revision: int | None = None
+
+
+class TodosLane(CasaModel):
+    sections: list[TodosLaneSection] = Field(default_factory=list)
+
+
+class RequestsResponse(CasaModel):
+    requests: RequestsLane
+    tasks: TasksLane
+    todos: TodosLane | None = None
+
+
+class RequestMessage(CasaModel):
+    id: str
+    created_at: int
+    sender_role: SenderRoleField
+    sender_name: str
+    content: str | None = None
+    attachments: list[Any] = Field(default_factory=list)
+    scheduling_prompt: Any | None = None
+    availability_request: Any | None = None
+    invoice: Any | None = None
+    purchase_approval_requests: list[Any] | None = None
+
+    @property
+    def created_at_dt(self) -> datetime | None:
+        return epoch_to_dt(self.created_at)
+
+
+class RequestDetails(CasaModel):
+    id: str
+    type: RequestTypeField
+    status: RequestStatusField
+    title: str
+    emoji: str
+    created_at: int
+    updated_at: int
+    has_unread_messages: bool = False
+    summary: dict[str, Any] = Field(default_factory=dict)
+    messages: list[RequestMessage] = Field(default_factory=list)
+    visits: list[Any] = Field(default_factory=list)
+    invoices: list[Any] = Field(default_factory=list)
+    purchases: list[Any] = Field(default_factory=list)
+    feedback: Any | None = None
+
+
+class VendorVisitCalendarEvent(CasaModel):
+    id: str
+    start_time: int
+    end_time: int
+
+
+class VendorVisit(CasaModel):
+    id: str
+    type: VisitTypeField
+    status: VendorVisitStatusField
+    request: dict[str, Any] = Field(default_factory=dict)
+    calendar_event: VendorVisitCalendarEvent | None = None
+    vendors: list[Any] = Field(default_factory=list)
+    task_items: list[Any] = Field(default_factory=list)
+    invoices: list[Any] = Field(default_factory=list)
+    purchases: list[Any] = Field(default_factory=list)
+    can_add_remove_items: bool = False
+    can_cancel: bool = False
+    feedback: Any | None = None
+    conversation: Any | None = None

casahome/models/tasks.py

@@ -0,0 +1,77 @@
+"""Static task detail and grouped visit-plan fields remain UNVERIFIED.
+
+Fields inferred from the app. GroupedTaskDetails.tasks uses GroupedTaskItem.
+Bookable's envelope was observed live, but tagged items remain JsonValue.
+Swift case names aren't wire tags.
+"""
+
+from pydantic import JsonValue
+
+from casahome.models._base import CasaModel
+from casahome.models.images import MediaAttachment
+
+
+class BookableHandymanTasksResponse(CasaModel):
+    items: list[JsonValue]
+    current_vendor_additional_availability_minutes: int | None = None
+    total_additional_availability_minutes: int | None = None
+
+
+class TaskDetailsVisit(CasaModel):
+    id: str
+    start_time: int
+
+
+class TaskUpdate(CasaModel):
+    id: str
+    message: str
+    sender_name: str
+    sender_avatar_url: str | None = None
+    sender_avatar_cache_key: str | None = None
+    sent_at: int
+    attachments: list[MediaAttachment] | None = None
+
+
+class TaskDetails(CasaModel):
+    id: str
+    title: str
+    description: str
+    emoji: str
+    status: str
+    visit: TaskDetailsVisit | None = None
+    updates: list[TaskUpdate]
+    attachments: list[MediaAttachment] | None = None
+    can_schedule_handyman_vendor_visit: bool
+    can_chat_with_concierge: bool
+    can_edit: bool
+    can_delete: bool
+
+
+class VendorVisitAutopilotPlan(CasaModel):
+    id: str
+    title: str
+    description: str
+    emoji: str
+
+
+class VendorVisitAutopilotTaskTarget(CasaModel):
+    id: str
+    kind: str
+    primary_label: str
+    secondary_label: str
+    symbol_name: str
+    image_url: str | None = None
+    image_cache_key: str | None = None
+
+
+class GroupedTaskItem(CasaModel):
+    id: str
+    status: str
+    target: VendorVisitAutopilotTaskTarget | None = None
+    updates: list[TaskUpdate]
+
+
+class GroupedTaskDetails(CasaModel):
+    plan: VendorVisitAutopilotPlan
+    visit: TaskDetailsVisit | None = None
+    tasks: list[GroupedTaskItem]

casahome/models/taxes.py

@@ -0,0 +1,47 @@
+"""Property tax reads. Only refresh metadata and an empty reports list observed."""
+
+from pydantic import Field
+
+from casahome.models._base import CasaModel
+
+
+class PropertyTaxRefresh(CasaModel):
+    status: str
+    next_fetch_at: int | None = None
+
+
+class PropertyTaxSpecialAssessment(CasaModel):
+    id: str | None = None
+    name: str | None = None
+    amount: float | None = None
+
+
+class PropertyTaxInstallment(CasaModel):
+    id: str | None = None
+    total: float | None = None
+    due_date: int | None = None
+    payment_amount: float | None = None
+    payment_date: int | None = None
+
+
+class PropertyTaxReport(CasaModel):
+    id: str | None = None
+    report_id: str | None = None
+    issued_at: int | None = None
+    agency_name: str | None = None
+    tax_collector_url: str | None = None
+    tax_year_start: int | None = None
+    tax_year_end: int | None = None
+    land_value: float | None = None
+    improvement_value: float | None = None
+    total_assessed_value: float | None = None
+    total_taxable_value: float | None = None
+    total_tax_due: float | None = None
+    special_assessments: list[PropertyTaxSpecialAssessment] = Field(default_factory=list)
+    installments: list[PropertyTaxInstallment] = Field(default_factory=list)
+
+
+class PropertyTaxesResponse(CasaModel):
+    next_tax_bill_release_at: int | None = None
+    refresh: PropertyTaxRefresh | None = None
+    reports: list[PropertyTaxReport]

casahome/models/todos.py

@@ -0,0 +1,52 @@
+"""To-do models (UNVERIFIED endpoints)."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from pydantic import Field
+
+from ._base import CasaModel
+from .enums import (
+    TodoCreatorRoleField,
+    TodoLaneCardKindField,
+    TodoLaneCardStateField,
+    TodoStatusField,
+)
+
+
+class AttachMediaPayload(CasaModel):
+    upload_ids: list[str] = Field(default_factory=list)
+
+
+class CreateTodoBody(CasaModel):
+    content: str
+    attachments: AttachMediaPayload | None = None
+
+
+class TodoLaneCard(CasaModel):
+    kind: TodoLaneCardKindField
+    id: str
+    title: str
+    emoji: str
+    updated_at: int
+    state: TodoLaneCardStateField
+    origin_todo_id: str | None = None
+    can_delete: bool = False
+
+
+class TodoDetail(CasaModel):
+    id: str
+    title: str
+    emoji: str
+    original_text: str
+    prepared_brief: str
+    status: TodoStatusField
+    creator_role: TodoCreatorRoleField
+    created_at: int
+    updated_at: int
+    can_delete: bool = False
+    is_suggested: bool = False
+    attachments: list[Any] = Field(default_factory=list)
+    question_rounds: list[Any] = Field(default_factory=list)
+    destination: Any | None = None