# googlecloudplatform/recaptcha-enterprise-mobile-sdk architecture

> Architecture diagram of the GitHub repository googlecloudplatform/recaptcha-enterprise-mobile-sdk, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/googlecloudplatform/recaptcha-enterprise-mobile-sdk
- Repository: https://github.com/googlecloudplatform/recaptcha-enterprise-mobile-sdk

## Overview

This repository distributes an iOS reCAPTCHA Enterprise SDK wrapper; the main workflow is an app obtaining a client for its site key, executing an action, and receiving a token or error. The Swift source adapts the SDK’s client and action APIs to Google’s interop protocols, while the substantive SDK implementation is a precompiled dependency. The README also documents score-based and visual challenge examples. Source inspection is limited to the wrapper and package manifest, so internal SDK behavior is not shown.

Main entry points: [`Sources/RecaptchaEnterprise/RecaptchaInteropBidings.swift`](https://github.com/googlecloudplatform/recaptcha-enterprise-mobile-sdk/blob/main/Sources/RecaptchaEnterprise/RecaptchaInteropBidings.swift) (Interop bindings), [`Sources/Public/RecaptchaEnterprise/RecaptchaEnterprise.h`](https://github.com/googlecloudplatform/recaptcha-enterprise-mobile-sdk/blob/main/Sources/Public/RecaptchaEnterprise/RecaptchaEnterprise.h) (Public SDK header), [`examples`](https://github.com/googlecloudplatform/recaptcha-enterprise-mobile-sdk/tree/main/examples) (Score examples)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_integration["App integration"]
  node_public_api["Public SDK header"]
end

subgraph group_adapter["Interop adapter"]
  node_interop["Interop bindings"]
  node_interop_protocol["Interop protocols"]
end

subgraph group_sdk["SDK capability"]
  node_sdk_binary["Recaptcha SDK"]
  node_score_examples["Score examples"]
  node_visual_examples["Visual examples"]
end

node_ios_app(("iOS app"))

node_ios_app -->|"integrates"| node_public_api
node_public_api -->|"exposes SDK"| node_sdk_binary
node_interop -->|"fetches and executes"| node_sdk_binary
node_interop -->|"adapts protocols"| node_interop_protocol
node_ios_app -->|"uses score flow"| node_score_examples
node_ios_app -->|"uses visual flow"| node_visual_examples

click node_public_api "https://github.com/googlecloudplatform/recaptcha-enterprise-mobile-sdk/blob/main/Sources/Public/RecaptchaEnterprise/RecaptchaEnterprise.h"
click node_interop "https://github.com/googlecloudplatform/recaptcha-enterprise-mobile-sdk/blob/main/Sources/RecaptchaEnterprise/RecaptchaInteropBidings.swift"
click node_score_examples "https://github.com/googlecloudplatform/recaptcha-enterprise-mobile-sdk/tree/main/examples"
click node_visual_examples "https://github.com/googlecloudplatform/recaptcha-enterprise-mobile-sdk/tree/main/examples"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_public_api toneBlue
class node_interop,node_interop_protocol toneAmber
class node_sdk_binary,node_score_examples,node_visual_examples toneMint
class node_ios_app toneIndigo
```

## Components

### App integration

- [Public SDK header](https://github.com/googlecloudplatform/recaptcha-enterprise-mobile-sdk/blob/main/Sources/Public/RecaptchaEnterprise/RecaptchaEnterprise.h): `Sources/Public/RecaptchaEnterprise/RecaptchaEnterprise.h`

### Interop adapter

- [Interop bindings](https://github.com/googlecloudplatform/recaptcha-enterprise-mobile-sdk/blob/main/Sources/RecaptchaEnterprise/RecaptchaInteropBidings.swift): `Sources/RecaptchaEnterprise/RecaptchaInteropBidings.swift`
- **Interop protocols**

### SDK capability

- **Recaptcha SDK**
- [Score examples](https://github.com/googlecloudplatform/recaptcha-enterprise-mobile-sdk/tree/main/examples): `examples`
- [Visual examples](https://github.com/googlecloudplatform/recaptcha-enterprise-mobile-sdk/tree/main/examples): `examples`

### Other components

- **iOS app**

## Connections

- iOS app → Public SDK header: integrates (evidence: `README.md`)
- Public SDK header → Recaptcha SDK: exposes SDK (evidence: `Sources/Public/RecaptchaEnterprise/RecaptchaEnterprise.h`)
- Interop bindings → Recaptcha SDK: fetches and executes (evidence: `Sources/RecaptchaEnterprise/RecaptchaInteropBidings.swift`)
- Interop bindings → Interop protocols: adapts protocols (evidence: `Sources/RecaptchaEnterprise/RecaptchaInteropBidings.swift`)
- iOS app → Score examples: uses score flow (evidence: `README.md`)
- iOS app → Visual examples: uses visual flow (evidence: `README.md`)
