Swift Networking SDK

InnoNetwork Documentation

Type-safe request execution and focused companion modules for authentication, downloads, HLS media, 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 5.1 Release Notes
12 Products One core library and eleven 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

InnoNetworkHLS

Typed HLS 2nd Edition metadata, AES-128 non-DRM VOD assembly, and atomic local packages for selected external audio and subtitles.

  • Bounded playlist parsing and relative URL resolution
  • Stable IDs, accessibility, audio-format, and pathway metadata
  • Typed HDCP, content-protection, video-layout, and live-sequence metadata
  • Opt-in Apple authoring and LL-HLS guidance
  • Bounded draft-22 presentation-graph conformance inspection
  • Typed interstitial coordination, timeline, restriction, and skip-control metadata
  • Purpose-aware request policy and value-redacted HLS request events
  • Explicit quality, resolution, and bandwidth variant policies
  • Event-stream or one-shot ordered TS/fMP4 assembly
  • Local multivariant packages with rewritten rendition playlists
  • Localized recovery guidance, retry hints, and explicit storage policy
Module Docs

InnoNetworkHLSLive

Media-playlist reloads with negotiated blocking requests, delta reconstruction, bounded async snapshots, and atomic live DVR.

  • Typed blocking, part, and skip request negotiation
  • Sequence-based delta and Date Range reconstruction
  • Value-only HTTP freshness and live-health diagnostics
  • Uncached reloads with one clean full-reload recovery
  • Polling fallback and deterministic ENDLIST completion
  • Memory-only AES-128 keys and plaintext local DVR packages
  • Opt-in URL-free complete-segment checkpoints and atomic resume
  • Typed encryption, byte-range, and disk-capacity failures
Module Docs

InnoNetworkHLSAVFoundation

Native, system-managed HLS persistence for applications that need background asset downloads, media selections, or FairPlay setup.

  • Reconnectable AVFoundation background sessions
  • Typed AVFoundation CMCD opt-in and platform status
  • Task restoration with bounded progress and terminal streams
  • Versioned, bounded Codable offline-asset libraries
  • Value-only catalogs for custom subtitle and caption UI
  • Typed FairPlay session attachment and expiration lifecycle
  • Localized app-group, HTTPS, and lifecycle diagnostics
Module Docs

InnoNetworkHLSAudio

Demand-driven decoded PCM for HLS playback analysis and assistive experiences on version 27 Apple platforms, built with Xcode 27 and Swift 6.4.

  • Validated PCM and convenient Float32 configuration
  • Single-consumer async sample delivery
  • Typed marker and sequence-restart metadata
  • Caller-owned timebase pacing and audio processing
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

Adopting the 5.x Line

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 released 5.x line. The latest tagged stable release is 5.1.0; use a tagged dependency rather than moving main in production. For support, issues, and release notes, use the repository links above.