Swift Networking SDK

InnoNetwork Documentation

Type-safe request execution and focused companion modules for authentication, downloads, realtime flows, caching, OpenAPI, trust, and testing on current Apple platforms. The documentation site is organized by product so teams can start from the module they need.

Get Started View Repository Draft 5.0 Release Notes
8 Products One core library and seven opt-in companion modules.
Swift 6.2+ Built for current Apple platforms and modern concurrency.
API Stability Public stability policy and release process documented in-repo.

Products

InnoNetwork

Core request and response execution with explicit transport policy, retry handling, trust evaluation, and observability hooks.

  • Type-safe APIDefinition modeling
  • JSON, form-url-encoded, multipart, and protobuf request paths
  • Safe defaults and advanced tuning surfaces
Module Docs Quick Start

InnoNetworkAuthAWS

Late, body-aware AWS Signature Version 4 signing for data-backed and stable file-backed requests without moving AWS-specific policy into the core product.

  • Signs the final encoded request after interceptors and token refresh
  • Supports normal header-based SigV4 and S3 payload hashes
  • Keeps streaming SigV4 and credential rotation explicitly out of scope
Module Docs

InnoNetworkDownload

Durable download lifecycle management with append-log persistence, background session support, retry coordination, and stream or listener delivery.

  • Pause, resume, retry, and restoration paths
  • Foreground and background download orchestration
  • Operational tuning through safeDefaults and advanced configuration
Module Docs

InnoNetworkWebSocket

Reconnect-aware WebSocket management with handshake taxonomy, heartbeat handling, and listener retention across reconnect attempts.

  • Reconnect suppression by close outcome
  • AsyncStream and listener-based event delivery
  • Manual disconnect semantics and heartbeat monitoring
Module Docs

InnoNetworkPersistentCache

Conservative on-disk response caching with privacy defaults, data protection policy, and bounded disk usage.

  • Actor-backed ResponseCache implementation
  • Authenticated, private, and cookie response protections
  • Persistent index and body storage with eviction
Module Docs

InnoNetworkOpenAPI

Adapters for using generated-style operations with the InnoNetwork request pipeline or connecting a swift-openapi-generator client to an application-owned URLSession.

  • Typed OpenAPIRequest integration
  • OpenAPIRuntime.ClientTransport implementation
  • Explicit body-size limits for generated client traffic
Module Docs

InnoNetworkTrust

Optional SPKI public-key pinning for applications whose threat model needs to narrow system trust with host-specific key material.

  • Exact-host and parent-domain matching strategies
  • Leaf-only or any-certificate-in-chain pin scope
  • Granular trust failure reasons through the core trust pipeline
Module Docs

InnoNetworkTestSupport

Consumer-facing test helpers for deterministic URLSession responses, typed request stubs, redacted HTTP cassettes, and WebSocket event assertions.

  • Scripted MockURLSession responses
  • Typed StubNetworkClient behavior
  • Record/replay cassettes with credential redaction
Module Docs

Evaluating the 5.0 Preview

Safe Defaults First New integrations should start from safeDefaults and opt into advanced tuning only for operational requirements.
Latest Platform Baseline The package intentionally targets current Apple releases to avoid compatibility shims and to rely on strict concurrency semantics.
Operational Visibility Included Event delivery, download persistence, and reconnect behavior are built to be measurable and explainable in production.

This site documents the unreleased 5.0 preview on main. The latest tagged stable release is 4.0.0; do not use a moving main dependency in production. For support, issues, and draft release notes, use the repository links above.