@otalan/cli 1.1.0 → 1.2.0

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 All notable changes to `@otalan/cli` will be documented in this file.
 
+## 1.2.0 - 2026-05-08
+
+### Changed
+
+- Switch `otalan publish` to the direct-upload release contract: create JSON upload metadata, upload the ZIP to the returned signed URL, complete the ingest, then poll validation.
+- Stream the local ZIP through Bun's disk-backed file body during signed uploads instead of loading the full archive into memory.
+- Send the full generated Otalan Expo satellite manifest as `expoManifest` during publish instead of only raw Expo config.
+- Use the Expo `runtimeVersion` as the release `nativeVersion` sent to the API, matching the current Expo update matching contract.
+- Use the release bundle `publishedAt` timestamp for bundle lists, status summaries, rollback prompts, and published bundle ID hints.
+
+## 1.1.1 - 2026-05-07
+
+### Changed
+
+- Remove unsupported target mentions from public documentation, CLI help, and package metadata.
+- Document official support for Capacitor 7 and 8, and Expo SDK 54 and 55.
+
 ## 1.1.0 - 2026-05-07
 
 ### Added
@@ -13,7 +30,7 @@ All notable changes to `@otalan/cli` will be documented in this file.
 - Let `otalan login` reuse the saved API URL and keep the saved CI key from a masked prompt.
 - Export Expo bundles into a project-local `.otalan/expo-export-*` folder so Expo accepts the output path.
 - Fall back to the resolved native version when Expo runtimeVersion is not configured or present in export metadata.
-- Clarify Capacitor and Expo / React Native bundling behavior in CLI help and README.
+- Clarify Capacitor and Expo bundling behavior in CLI help and README.
 
 ## 1.0.9 - 2026-05-06
 
@@ -87,7 +104,7 @@ Initial public release of the Otalan CLI.
 ### Added
 
 - Capacitor OTA bundle packaging from built web assets.
-- Expo / React Native OTA bundle packaging through `expo export`.
+- Expo OTA bundle packaging through `expo export`.
 - Release publishing with rollout metadata and server-side validation polling.
 - Bundle listing, active bundle status, and rollback commands.
 - CI key login, project initialization, and API connectivity doctor checks.

package/README.md

@@ -1,6 +1,6 @@
 # `@otalan/cli`
 
-Otalan CLI for bundling and publishing OTA update releases for Capacitor and Expo / React Native apps.
+Otalan CLI for bundling and publishing OTA update releases for Capacitor and Expo apps.
 
 Website: [otalan.com](https://otalan.com)
 
@@ -21,6 +21,15 @@ The npm package ships a Bun-based CLI entrypoint, not standalone native binaries
 - Windows support is experimental until the CLI release flow is validated on Windows.
 - Native compile scripts exist for macOS, Linux, and Windows maintainers, but the compiled binaries are not included in the npm package.
 
+## App Framework Support
+
+Officially supported app targets and versions:
+
+- Capacitor 7 and 8 with `--target capacitor`
+- Expo SDK 54 and 55 with `--target expo`
+
+Other app targets and older framework versions may work, but they are not officially supported for the moment.
+
 ## Install
 
 Recommended:
@@ -70,7 +79,7 @@ otalan publish --channel production
 `otalan bundle --target capacitor` packages existing built web assets. By default it reads `dist/` first, then `www/`; pass `--input-dir <path>` if your build outputs somewhere else. Your app build must run first.
 `otalan publish` waits for server-side validation to finish before it returns.
 
-### Expo / React Native
+### Expo
 
 1. Log in with your CI key:
 
@@ -96,7 +105,7 @@ otalan bundle --target expo --platform ios --bundle-id 1.0.5
 otalan publish --channel production
 ```
 
-`otalan bundle --target expo` runs `bunx expo export` itself, exports into a temporary project-local `.otalan/expo-export-*` folder, packages the exported JS bundle and assets, and stores the resolved Expo config in the Otalan manifest for publish. You do not need to create a `dist/` or `www/` folder before running it.
+`otalan bundle --target expo` runs `bunx expo export` itself, exports into a temporary project-local `.otalan/expo-export-*` folder, packages the exported JS bundle and assets, and stores the generated Otalan satellite manifest for publish. You do not need to create a `dist/` or `www/` folder before running it.
 `otalan publish` waits for server-side validation to finish before it returns.
 
 ## CI/CD Usage
@@ -126,7 +135,7 @@ otalan publish --channel production
 
 Use your normal app build command before `otalan bundle`. The CLI then packages the built web output from `dist/` or `www/` by default; pass `--input-dir <path>` if your Capacitor web output uses another folder.
 
-### CI/CD Example: Expo / React Native
+### CI/CD Example: Expo
 
 ```bash
 bun install --frozen-lockfile
@@ -137,7 +146,7 @@ otalan bundle --target expo --platform ios --bundle-from-package
 otalan publish --channel production
 ```
 
-This runs `bunx expo export` through the CLI, using a temporary project-local `.otalan/expo-export-*` folder, packages the exported OTA assets, and publishes the resulting bundle through Otalan's validation pipeline. Do not add a separate web build step just to create `dist/` or `www/` for Expo / React Native.
+This runs `bunx expo export` through the CLI, using a temporary project-local `.otalan/expo-export-*` folder, packages the exported OTA assets, and publishes the resulting bundle through Otalan's validation pipeline. Do not add a separate web build step just to create `dist/` or `www/` for Expo.
 
 ### GitHub Actions Example
 
@@ -173,7 +182,7 @@ jobs:
 Adjust the build step and bundle target for your app:
 
 - Capacitor: keep your web build step and use `--target capacitor`
-- Expo / React Native: remove the web build step if not needed and use `--target expo`
+- Expo: remove the web build step if not needed and use `--target expo`
 
 ## What It Does
 
@@ -181,7 +190,7 @@ Adjust the build step and bundle target for your app:
 - checks API connectivity and CI key context
 - generates CI and OTA key material locally for dashboard import
 - links the current repo to an Otalan app
-- bundles Capacitor or Expo / React Native OTA output
+- bundles Capacitor or Expo OTA output
 - publishes a bundle with rollout metadata
 - lists published bundles
 - rolls back to an older bundle
@@ -213,7 +222,7 @@ Example project config:
 }
 ```
 
-`otalan.config.json` only links the repo to an Otalan project/app. Bundle and release targeting data such as `target`, `platform`, `nativeVersion`, and `bundleId` live in `.otalan/bundle/manifest.json`.
+`otalan.config.json` only links the repo to an Otalan project/app. Bundle and release targeting data such as `target`, `platform`, `nativeVersion`, `runtimeVersion`, and `bundleId` live in `.otalan/bundle/manifest.json`.
 
 ## Command Reference
 
@@ -311,7 +320,7 @@ otalan bundle --target capacitor --platform ios
 otalan bundle --target capacitor --platform ios --input-dir build
 ```
 
-Expo / React Native:
+Expo:
 
 ```bash
 otalan bundle --target expo --platform ios
@@ -319,12 +328,14 @@ otalan bundle --target expo --platform ios
 
 Current behavior:
 
+- Official support covers Capacitor 7 and 8, and Expo SDK 54 and 55
+- Other app targets and older framework versions may work, but they are not officially supported for the moment
 - Capacitor packages prebuilt web assets; it does not run your app build command
 - without `--input-dir`, Capacitor checks `dist/` first and then `www/`
 - pass `--input-dir <path>` to package a different Capacitor web output folder
-- Expo / React Native runs `bunx expo export --platform <platform>` into a temporary project-local `.otalan/expo-export-*` folder
-- Expo / React Native does not require a prebuilt `dist/` or `www/` folder
-- Expo stores the resolved Expo app config in `.otalan/bundle/manifest.json` so publish can forward it for `extra.expoClient`
+- Expo runs `bunx expo export --platform <platform>` into a temporary project-local `.otalan/expo-export-*` folder
+- Expo does not require a prebuilt `dist/` or `www/` folder
+- Expo stores the generated Otalan satellite manifest in `.otalan/bundle/manifest.json`, including `launchAsset`, `assets`, `runtimeVersion`, `bundleId`, and `expoConfig`
 - both outputs produce a ZIP plus `manifest.json`
 - `--platform` is required so the CLI exports the selected platform and resolves the correct native/runtime version
 
@@ -335,6 +346,7 @@ Native version defaults:
 - Capacitor Android reads `versionName` from `android/app/build.gradle` or `build.gradle.kts`
 - Expo reads the selected platform version from Expo config and falls back to the top-level Expo `version`
 - Expo runtimeVersion reads `--runtime-version`, Expo export metadata, or Expo config runtimeVersion policies/strings; if none are present, the CLI falls back to the resolved native version
+- Expo publishes use `runtimeVersion` as the Otalan release `nativeVersion` because Expo update checks send `expo-runtime-version`
 - `--native-version` overrides auto-detection
 
 For Expo projects, the recommended app config is:
@@ -389,7 +401,7 @@ otalan bundle --target expo --platform ios --bundle-from-package
 
 Publishes the current bundle output with rollout metadata.
 
-`otalan publish` uses the `bundleId`, `platform`, and `nativeVersion` already stored in `.otalan/bundle/manifest.json`. To release `1.0.5`, set it when you run `otalan bundle --bundle-id 1.0.5`.
+`otalan publish` uses the `bundleId`, `platform`, and release version stored in `.otalan/bundle/manifest.json`. Capacitor uses `nativeVersion`; Expo uses `runtimeVersion`. To release `1.0.5`, set it when you run `otalan bundle --bundle-id 1.0.5`.
 
 Current behavior:
 
@@ -401,7 +413,8 @@ Current behavior:
 - `--rollout-percent` accepts an integer from `0` to `100`
 - `--optional` marks the update as non-mandatory
 - `--release-notes` attaches release notes to the published bundle
-- Expo publish forwards the stored Expo app config when present
+- Expo publish forwards the full generated Otalan satellite manifest when present
+- Expo publish sends `runtimeVersion` as the API `nativeVersion` and normalizes the serialized `expoManifest.nativeVersion` to the same value for server validation
 - Otalan validates the release ZIP before the publish completes
 
 Default flow:
@@ -422,7 +435,14 @@ Optional update:
 otalan publish --channel production --optional
 ```
 
-This uses `POST /v1/releases/create` and waits for `GET /v1/releases/ingests/:id` to reach `ready` before returning success.
+This uses the direct-upload release flow:
+
+1. `POST /v1/releases/create` with JSON metadata for the release and local ZIP, including `expoManifest` for Expo bundles
+2. `PUT` the ZIP bytes directly to the returned `uploadUrl` with the exact returned `Content-Type`
+3. `POST /v1/releases/ingests/:id/complete`
+4. poll `GET /v1/releases/ingests/:id` until the ingest reaches `ready` or `failed`
+
+The ZIP is opened as a disk-backed `Bun.file` and passed directly to the signed `PUT`; `otalan publish` does not load the full archive into memory first.
 
 If validation fails, `otalan publish` exits non-zero and prints the ingest failure reason when the API provides one. This makes the command safe to use directly in CI/CD pipelines.
 
@@ -430,6 +450,8 @@ If validation fails, `otalan publish` exits non-zero and prints the ingest failu
 
 Lists remote bundles for the current app so you can choose a bundle for rollback or rollout operations.
 
+Remote bundle tables display the API `publishedAt` timestamp, not the bundle row `createdAt` timestamp.
+
 Default resolution order:
 
 1. `--native-version`
@@ -455,6 +477,8 @@ otalan rollback --bundle-id 1.0.0-web.1 --platform ios --channel production
 
 Shows the active bundle for the selected release tuple.
 
+The active bundle summary displays `publishedAt` as `Published at`.
+
 `status` also uses the same native-version default order as `bundles`.
 
 ```bash
@@ -476,7 +500,7 @@ otalan status --platform ios --channel production
 }
 ```
 
-### Expo Manifest
+### Expo Satellite Manifest
 
 ```json
 {
@@ -499,6 +523,8 @@ otalan status --platform ios --channel production
 }
 ```
 
+For Expo publishes, `otalan publish` serializes this file and sends it to `/v1/releases/create` as `expoManifest`.
+
 ## Maintainer Release Checklist
 
 Before publishing a public package release:
@@ -521,7 +547,7 @@ bun pm pack --dry-run
 ## Notes
 
 - This is a Bun-based CLI published on npm.
-- Expo / React Native bundling uses `bunx expo ...`.
+- Expo bundling uses `bunx expo ...`.
 - Default API URL is `https://api.otalan.com`.
 - Publishing, rollback, status, and `bundles` expect a CI key and an active app.
 - Release commands print the organization and project resolved from the CI key before continuing.