Overview

SpatioSDK is a comprehensive Swift package for building API-based capabilities that integrate with the Spatio platform and Spatio AI ecosystem. It provides a framework for creating command-line tools with built-in authentication, mock data support, and multiple storage backends.

Core Components

• BaseRemoteCapability: Abstract base class for creating API integrations
• AuthManager: Hierarchical authentication system (Organization → Group → Capability)
• CapabilityGenerator: Programmatically create organizations and capabilities
• Multi-Format Storage: SQLite, Spatio AI format, and remote repository support

Key Features

• Command-Line First: Build executable scripts with swift-sh support
• Mock Data Provider: Test capabilities without API access
• Environment Variable Integration: Secure token management
• Type-Safe APIs: Full Swift type safety with error handling

Architecture

The SDK follows a modular architecture:

SpatioSDK/
├── API/           # Request/response models
├── Authentication/ # Auth management
├── Capability/    # Base capability classes
├── Store/         # Storage management
└── Utils/         # CLI parsing, logging, mocks

Use Cases

• API Integration Tools: Build CLI tools for any REST API
• Spatio AI Capabilities: Create compatible capabilities
• Test Automation: Mock-enabled development workflow
• Enterprise Integration: Hierarchical auth for teams

Getting Started

1. Add SpatioSDK to your Swift package
2. Create a capability extending BaseRemoteCapability
3. Configure authentication
4. Build and run with swift-sh