@expo-up/cli 0.1.0 → 0.1.2-next.0

package/CHANGELOG.md

@@ -0,0 +1,17 @@
+# @expo-up/cli
+
+## 0.1.2-next.0
+
+### Patch Changes
+
+- 37a6319: chore: patch release across core, server, and cli
+- Updated dependencies [37a6319]
+  - @expo-up/core@0.1.2-next.0
+
+## 0.1.1
+
+### Patch Changes
+
+- 7115c93: chore: patch release across core, server, and cli
+- Updated dependencies [7115c93]
+  - @expo-up/core@0.1.1

package/README.md

@@ -0,0 +1,161 @@
+# @expo-up/cli
+
+CLI package for managing self-hosted Expo OTA workflows.
+
+> Current storage target is GitHub Repository storage.  
+> Additional providers (AWS S3, Firebase Storage, Google Cloud Storage, Azure Blob Storage, etc.) are planned.
+
+## Responsibilities
+
+- Authenticate against GitHub for storage access.
+- Export and release update bundles to storage.
+- Inspect and manage build history.
+- Roll back channels to embedded/previous builds.
+- Bootstrap Expo code signing (generate/configure).
+
+## Global Option
+
+- `--debug`: enable verbose logs for API calls, release diffing, and error context.
+
+## Command Reference
+
+### `expo-up login`
+
+Authenticate and store local token/config for subsequent commands.
+
+### `expo-up logout`
+
+Clear locally stored token/config session.
+
+### `expo-up whoami`
+
+Print resolved project context:
+- projectId from Expo config
+- active channel
+- server URL
+- auth state (masked token)
+
+### `expo-up set-channel <name>`
+
+Persist default channel used by release/history/rollback when `--channel` is not passed.
+Default channel is `main`.
+
+Example:
+
+```bash
+expo-up set-channel main
+expo-up set-channel staging
+```
+
+### `expo-up list-channels`
+
+List available channels from the storage repository.
+
+### `expo-up release`
+
+Build and upload a new OTA build for a channel/runtime.
+
+Options:
+- `--platform <ios|android|all>` default: `all`
+- `--channel <name>` optional channel override
+- channel defaults to `main` when no saved/override channel is provided
+
+Behavior:
+1. Runs `expo export`.
+2. Reads local `dist/metadata.json`.
+3. Compares sorted metadata hash against latest remote build in the channel.
+4. Skips upload if no changes.
+5. Uploads new build and advances channel ref if changed.
+
+Examples:
+
+```bash
+expo-up release --platform all --channel main
+expo-up --debug release --platform ios --channel feat/new-home
+```
+
+### `expo-up history`
+
+Show release/rollback timeline for a channel.
+
+Options:
+- `--channel <name>` optional channel override
+- `--delete <buildIds...>` non-interactive delete mode (CI friendly)
+- `--yes` skip confirmation for delete mode
+- `--no-interactive-delete` disable TUI selection mode
+- channel defaults to `main` when no saved/override channel is provided
+
+Examples:
+
+```bash
+expo-up history --channel main
+expo-up history --channel main --delete 10 11 --yes
+```
+
+### `expo-up rollback`
+
+Rollback channel to previous build or embedded app update.
+
+Options:
+- `--channel <name>` optional channel override
+- `--to <buildId>` rollback target build
+- `--embedded` rollback to embedded/native update
+- channel defaults to `main` when no saved/override channel is provided
+
+Examples:
+
+```bash
+expo-up rollback --channel main --to 10
+expo-up rollback --channel main --embedded
+```
+
+### `expo-up codesigning:generate`
+
+Generate keypair/certificate and update Expo config for signed updates.
+
+Key options:
+- `--organization <name>`
+- `--certificate-validity-duration-years <years>`
+- `--key-id <id>` default: `main`
+- `--project-root <path>`
+- `--key-output-directory <path>` default: `codesigning-keys`
+- `--certificate-output-directory <path>` default: `certs`
+- `--force`
+
+### `expo-up codesigning:configure`
+
+Configure existing signing materials into Expo config.
+
+## Local Development
+
+```bash
+bun install
+bun run build
+bun run test
+bun run check-types
+bun run lint
+```
+
+## End-to-End Test With Example Apps
+
+1. Start server app:
+
+```bash
+cd ../../apps/example-hono-cf-worker
+bun run dev
+```
+
+2. Use CLI from Expo app root:
+
+```bash
+cd ../example-expo-app
+bunx expo-up whoami
+bunx expo-up release --channel main --platform all
+bunx expo-up history --channel main
+```
+
+3. In mobile app, press `Fetch update` and verify logs/status.
+
+## Package
+
+Published as `@expo-up/cli`.

package/dist/index.js

@@ -77252,7 +77252,7 @@ var require_source_map_support = __commonJS((exports, module) => {
 
 // ../../node_modules/.bun/typescript@5.9.2/node_modules/typescript/lib/typescript.js
 var require_typescript4 = __commonJS((exports, module) => {
-  var __dirname = "/Users/glncy/codes/glncy/expo-up/node_modules/.bun/typescript@5.9.2/node_modules/typescript/lib", __filename = "/Users/glncy/codes/glncy/expo-up/node_modules/.bun/typescript@5.9.2/node_modules/typescript/lib/typescript.js";
+  var __dirname = "/home/runner/work/expo-up/expo-up/node_modules/.bun/typescript@5.9.2/node_modules/typescript/lib", __filename = "/home/runner/work/expo-up/expo-up/node_modules/.bun/typescript@5.9.2/node_modules/typescript/lib/typescript.js";
   /*! *****************************************************************************
   Copyright (c) Microsoft Corporation. All rights reserved.
   Licensed under the Apache License, Version 2.0 (the "License"); you may not use
@@ -261315,7 +261315,7 @@ var require_dist3 = __commonJS((exports, module) => {
 
 // ../../node_modules/.bun/xcode@3.0.1/node_modules/xcode/lib/pbxProject.js
 var require_pbxProject = __commonJS((exports, module) => {
-  var __dirname = "/Users/glncy/codes/glncy/expo-up/node_modules/.bun/xcode@3.0.1/node_modules/xcode/lib";
+  var __dirname = "/home/runner/work/expo-up/expo-up/node_modules/.bun/xcode@3.0.1/node_modules/xcode/lib";
   var util = __require("util");
   var f = util.format;
   var EventEmitter = __require("events").EventEmitter;
@@ -291301,7 +291301,6 @@ config(en_default());
 var DEFAULT_CHANNEL = "main";
 var INIT_CHANNEL = "__INIT__";
 var EMBEDDED_ROLLBACK_TARGET = "EMBEDDED";
-var DEFAULT_EXPO_UP_BASE_PATH = "/api/expo-up";
 // ../core/src/project.ts
 function isRecord(value2) {
   return typeof value2 === "object" && value2 !== null;
@@ -291360,7 +291359,7 @@ async function resolveRollbackTarget(input) {
   throw new Error(`Rollback chain exceeded max depth (${maxDepth}).`);
 }
 // ../core/src/url.ts
-function parseExpoUpUpdatesUrl(rawUpdatesUrl, basePath = DEFAULT_EXPO_UP_BASE_PATH) {
+function parseExpoUpUpdatesUrl(rawUpdatesUrl, basePath = "/api/expo-up") {
   if (!rawUpdatesUrl) {
     return { serverUrl: "", projectId: "" };
   }

package/package.json

@@ -1,9 +1,13 @@
 {
   "name": "@expo-up/cli",
-  "version": "0.1.0",
+  "version": "0.1.2-next.0",
   "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/glncy/expo-up"
+  },
   "bin": {
-    "expo-up": "./dist/index.js"
+    "expo-up": "dist/index.js"
   },
   "scripts": {
     "build": "bun build ./src/index.tsx --outdir ./dist --target node --external react --external ink --external ink-spinner --external figlet",

package/src/index.tsx

@@ -306,7 +306,9 @@ program
 
 program
   .command("codesigning:configure")
-  .description("Configure Expo config codeSigning fields from existing cert/key")
+  .description(
+    "Configure Expo config codeSigning fields from existing cert/key",
+  )
   .option(
     "-p, --project-root <path>",
     "Expo app root containing app.json or app.config.* (defaults to auto-detect)",

package/src/release-utils.test.ts

@@ -193,7 +193,9 @@ describe("createSortedMetadataHash", () => {
       },
     };
 
-    expect(createSortedMetadataHash(first)).toBe(createSortedMetadataHash(second));
+    expect(createSortedMetadataHash(first)).toBe(
+      createSortedMetadataHash(second),
+    );
   });
 
   it("changes when metadata content changes", () => {

package/src/release.tsx

@@ -146,7 +146,8 @@ export const Release: React.FC<ReleaseProps> = ({
 
         const metadata = readJsonFile<unknown>(metadataPath);
         const sortedMetadataHash = createSortedMetadataHash(metadata);
-        if (debug) appendDebug(`Local sorted metadata hash: ${sortedMetadataHash}`);
+        if (debug)
+          appendDebug(`Local sorted metadata hash: ${sortedMetadataHash}`);
 
         const appConfig = getConfig(process.cwd());
         fs.writeFileSync(