Skip to content
Tropikal Tropikal Docs

Connect Protocol Core

tropikal-ai/connect is the framework-free protocol package behind TROPIKAL Connect adapters. Use it when you are building a custom PHP connector.

Most projects should install an adapter package instead of using the core package directly.

Install

Terminal window
composer require tropikal-ai/connect:^0.1

What It Provides

  • OAuth PKCE primitives.
  • Setup state validation helpers.
  • Canonical signed request creation and verification.
  • Nonce replay interfaces for host-owned atomic storage.
  • Resource, field, operation, and grant descriptors.
  • Read projection from declared fields.
  • Write validation against declared writable fields.
  • Public payload safety checks for secret-shaped keys.

What It Does Not Provide

  • Admin UI.
  • Database migrations.
  • WordPress, Filament, n2n Rocket, or other framework integration.
  • Website chat.
  • Workflow execution.
  • Public endpoint hosting.

The host connector owns storage, routing, admin authorization, local discovery, grants, execution, sync, and audit logging.

Build a Custom Connector

  1. Discover business objects from the local system.
  2. Generate resource descriptors with explicit fields and operations.
  3. Store Read, Write, and Delete grants locally.
  4. Expose a signed bridge endpoint.
  5. Verify signatures and nonces before execution.
  6. Project reads and validate writes with the declared schema.
  7. Sync the approved manifest to Tropikal.

Keep the connector default-deny. Discovery may find candidates, but access must remain off until an admin grants it.