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. HLS media is provided by the separate InnoNetwork-Stream package. Current stable Core: 6.1.1.

9 Products One core library and eight 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 and package boundaries

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 and multipart; Protobuf through its separate companion
  • Safe defaults and advanced tuning surfaces

InnoNetwork 6 Contract

Operation-first execution, value-only failure, and secure configuration contracts promoted into the core module.

  • Immediate cancellation-capable operation handles
  • Bounded operation-local start and terminal events
  • Explicit migration bridges for existing endpoints and configurations

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

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

InnoNetworkUpload

File-backed foreground and background uploads with progress, system-task restoration, bounded response capture, and typed decoding.

  • Pre-registered event streams that cannot miss a fast completion
  • Background URLSession reattachment through opaque logical task identifiers
  • HTTPS-only admission and redirect-sensitive header rejection

InnoNetwork-Stream (HLS)

The four HLS products retain their module names in an independently versioned package after the InnoNetwork 6 split.

  • Playlist parsing, VOD download, live reload, and DVR
  • AVFoundation playback, offline assets, and FairPlay workflows
  • Decoded-audio and real-time audio-mix processing
  • Separate public API, runtime, conformance, and release gates

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

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

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

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

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

InnoNetworkMacroSupport

Compiler-host support for companion endpoint macros, including shared encoded endpoint validation and expansion. Link this product only into macro implementation targets, never application runtime targets. Available in published 6.1.1.

Adopting 6.1.1

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.