{
  "module": "mail_intake.adapters.base",
  "content": {
    "path": "mail_intake.adapters.base",
    "docstring": "Mail provider adapter contracts for Mail Intake.\n\nThis module defines the **provider-agnostic adapter interface** used for\nread-only mail ingestion.\n\nAdapters encapsulate all provider-specific access logic and expose a\nminimal, normalized contract to the rest of the system. No provider-specific\ntypes or semantics should leak beyond implementations of this interface.",
    "objects": {
      "ABC": {
        "name": "ABC",
        "kind": "alias",
        "path": "mail_intake.adapters.base.ABC",
        "signature": "<bound method Alias.signature of Alias('ABC', 'abc.ABC')>",
        "docstring": null
      },
      "abstractmethod": {
        "name": "abstractmethod",
        "kind": "alias",
        "path": "mail_intake.adapters.base.abstractmethod",
        "signature": "<bound method Alias.signature of Alias('abstractmethod', 'abc.abstractmethod')>",
        "docstring": null
      },
      "Iterator": {
        "name": "Iterator",
        "kind": "alias",
        "path": "mail_intake.adapters.base.Iterator",
        "signature": "<bound method Alias.signature of Alias('Iterator', 'typing.Iterator')>",
        "docstring": null
      },
      "Dict": {
        "name": "Dict",
        "kind": "alias",
        "path": "mail_intake.adapters.base.Dict",
        "signature": "<bound method Alias.signature of Alias('Dict', 'typing.Dict')>",
        "docstring": null
      },
      "Any": {
        "name": "Any",
        "kind": "alias",
        "path": "mail_intake.adapters.base.Any",
        "signature": "<bound method Alias.signature of Alias('Any', 'typing.Any')>",
        "docstring": null
      },
      "MailIntakeAdapter": {
        "name": "MailIntakeAdapter",
        "kind": "class",
        "path": "mail_intake.adapters.base.MailIntakeAdapter",
        "signature": "<bound method Class.signature of Class('MailIntakeAdapter', 16, 76)>",
        "docstring": "Base adapter interface for mail providers.\n\nThis interface defines the minimal contract required to:\n- Discover messages matching a query\n- Retrieve full message payloads\n- Retrieve full thread payloads\n\nAdapters are intentionally read-only and must not mutate provider state.",
        "members": {
          "iter_message_refs": {
            "name": "iter_message_refs",
            "kind": "function",
            "path": "mail_intake.adapters.base.MailIntakeAdapter.iter_message_refs",
            "signature": "<bound method Function.signature of Function('iter_message_refs', 28, 49)>",
            "docstring": "Iterate over lightweight message references matching a query.\n\nImplementations must yield dictionaries containing at least:\n- ``message_id``: Provider-specific message identifier\n- ``thread_id``: Provider-specific thread identifier\n\nArgs:\n    query: Provider-specific query string used to filter messages.\n\nYields:\n    Dictionaries containing message and thread identifiers.\n\nExample yield:\n    {\n        \"message_id\": \"...\",\n        \"thread_id\": \"...\"\n    }"
          },
          "fetch_message": {
            "name": "fetch_message",
            "kind": "function",
            "path": "mail_intake.adapters.base.MailIntakeAdapter.fetch_message",
            "signature": "<bound method Function.signature of Function('fetch_message', 51, 63)>",
            "docstring": "Fetch a full raw message by message identifier.\n\nArgs:\n    message_id: Provider-specific message identifier.\n\nReturns:\n    Provider-native message payload\n    (e.g., Gmail message JSON structure)."
          },
          "fetch_thread": {
            "name": "fetch_thread",
            "kind": "function",
            "path": "mail_intake.adapters.base.MailIntakeAdapter.fetch_thread",
            "signature": "<bound method Function.signature of Function('fetch_thread', 65, 76)>",
            "docstring": "Fetch a full raw thread by thread identifier.\n\nArgs:\n    thread_id: Provider-specific thread identifier.\n\nReturns:\n    Provider-native thread payload."
          }
        }
      }
    }
  }
}