Release automation (#579)

- Add version and platform compatibility badges from [Swift Package
Index](https://swiftpackageindex.com/) to README
  - Automatically updated on each release 
- Add [nanpa](https://github.com/nbsp/nanpa) configuration
- Custom script bumps version across repo (currently Podspec, README,
and LiveKitSDK class)
  - GitHub publish workflow (based on workflow from livekit/rust-sdks)
- Create workflow to push new releases to Cocopods when a release is
published on GitHub

I have also added changeset files to my currently open PRs (#565, #576,
and #573) that can be used to test this configuration.

---------

Co-authored-by: Hiroshi Horie <[email protected]>

Author: ladvoc

.github/workflows/bump.yaml

@@ -0,0 +1,17 @@
+name: Bump version
+on:
+  workflow_dispatch:
+env:
+    PACKAGE_NAME: client-sdk-swift
+jobs:
+  bump:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          ssh-key: ${{ secrets.NANPA_KEY }}
+      - uses: nbsp/ilo@v1
+        with:
+          packages: ${{ env.PACKAGE_NAME }}

.github/workflows/cocoapods.yaml

@@ -0,0 +1,20 @@
+name: Push to Cocoapods
+on:
+  workflow_dispatch:
+  release:
+    types: [published]
+env:
+    PODSPEC_FILE: LiveKitClient.podspec
+jobs:
+  build:
+    runs-on: macos-latest
+    steps:
+    - uses: actions/checkout@v3
+    - name: Install Cocoapods
+      run: gem install cocoapods
+    - name: Validate Podspec
+      run: pod lib lint --allow-warnings
+    - name: Publish to CocoaPods
+      run: pod trunk push ${{ env.PODSPEC_FILE }} --allow-warnings --verbose
+      env:
+        COCOAPODS_TRUNK_TOKEN: ${{ secrets.COCOAPODS_TRUNK_TOKEN }}

.nanpa/.keep

@@ -0,0 +1,4 @@
+Add changeset files in this directory.
+
+See nanpa documentation for more info:
+https://github.com/nbsp/nanpa/blob/trunk/doc/nanpa-changeset.5.scd

.nanparc

@@ -0,0 +1,3 @@
+version 2.1.1
+name client-sdk-swift
+custom ./scripts/replace_version.sh

README.md

@@ -14,6 +14,9 @@
 Use this SDK to add realtime video, audio and data features to your Swift app. By connecting to <a href="https://livekit.io/">LiveKit</a> Cloud or a self-hosted server, you can quickly build applications such as multi-modal AI, live streaming, or video calls with just a few lines of code.
 <!--END_DESCRIPTION-->
 
+[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Flivekit%2Fclient-sdk-swift%2Fbadge%3Ftype%3Dswift-versions)](https://swiftpackageindex.com/livekit/client-sdk-swift)
+[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Flivekit%2Fclient-sdk-swift%2Fbadge%3Ftype%3Dplatforms)](https://swiftpackageindex.com/livekit/client-sdk-swift)
+
 ## Docs & Example app
 
 > [!NOTE]

build_docs.sh renamed to scripts/build_docs.sh

@@ -0,0 +1,41 @@
+#!/bin/sh
+# This script is invoked by nanpa with the new version set in VERSION.
+# ed is used instead of sed to make this script POSIX compliant (run on Mac or Linux runner).
+
+if [ -z "${VERSION}" ]; then
+    echo "Error: VERSION is not set. Exiting..."
+    exit 1
+fi
+
+replace() {
+    ed -s "$1" >/dev/null
+    if [ $? -ne 0 ]; then
+        echo "Error: unable to replace version in $1" >&2
+        exit 1
+    fi
+}
+
+# 1. Podspec version & tag
+# -----------------------------------------
+replace ./LiveKitClient.podspec <<EOF
+,s/spec.version = "[^"]*"/spec.version = "${VERSION}"/g
+,s/:tag => "[^"]*"/:tag => "${VERSION}"/g
+w
+q
+EOF
+
+# 2. README.md, installation guide
+# -----------------------------------------
+replace ./README.md <<EOF
+,s/upToNextMajor("[^"]*")/upToNextMajor("${VERSION}")/g
+w
+q
+EOF
+
+# 3. LiveKitSDK class, static version constant
+# -----------------------------------------
+replace ./Sources/LiveKit/LiveKit.swift <<EOF
+,s/static let version = "[^"]*"/static let version = "${VERSION}"/g
+w
+q
+EOF