expo-release 2.2.0 → 2.3.0

package/README.md

@@ -70,7 +70,7 @@ Reference the upstream README for full input/output docs and recovery operations
 uses: HansKristoffer/expo-release@v2
 ```
 
-The action runs `bun ${{ github.action_path }}/src/cli.ts`. The caller must already have checked out the repo (`fetch-depth: 0`), installed Bun, set up EAS, and installed workspace dependencies.
+The action installs its own dependencies (`hanzio`, `zod`) in `${{ github.action_path }}`, then runs `bun ${{ github.action_path }}/src/cli.ts`. The caller must already have checked out the repo (`fetch-depth: 0`), installed Bun, set up EAS, and installed workspace dependencies.
 
 ### npm (CLI)
 
@@ -425,6 +425,8 @@ expo-release operate \
   [--post-update "bunx posthog-cli hermes upload --directory dist"]
 ```
 
+Run `expo-release <command> --help` for every flag. Each flag also reads `EXPO_RELEASE_<FLAG>` (for example `EXPO_RELEASE_IMPACT_PATHS`) when it is not passed; an empty value counts as unset.
+
 `release` is decide + operate (same as the action default). `force-native`, `republish`, and `rollback-embedded` skip decide. `decide` prints JSON including `deployType` and `nativeBuildPending`. When `GITHUB_OUTPUT` is set, decide writes `deploy_type`, `native_build_pending`, `changed`, `fingerprint`, `build_id`, `build_url`. Operate writes `result`.
 
 ```bash
@@ -490,12 +492,30 @@ export const push = createPushNotifications({
 | Member | Use |
 |--------|-----|
 | `prompt()` | After sign-in. Asks once per install (soft-ask, then OS dialog), registers the token on a grant. Never throws; concurrent calls share one dialog. |
-| `enable()` / `disable()` | Settings toggle. `enable` requests permission and registers; `disable` calls `registerDevice(null)`. Save the user's preference yourself, before `enable()`: a denied dialog then leaves the preference on with `isEnabled` false, and the token registers on the next mount once permission is granted in device settings. |
-| `syncToken()` | Re-registers the current token when permission is granted. |
-| `listen({ onReceived, onResponse })` | Subscribes and returns the unsubscribe function. `onResponse` also receives the tap that launched the app. |
+| `enable()` / `disable()` | Settings toggle. `enable` requests permission and registers; `disable` calls `registerDevice(null)`. Use `disable()` to turn push off (also on sign-out) so the token is not re-sent on the next launch. |
+| `syncToken()` | Registers the current token when permission is granted. |
+| `listen({ onReceived, onResponse })` | Subscribes and returns the unsubscribe function. `onResponse` also receives the tap that launched the app. Also keeps the token current: on start and whenever Expo rotates it, a token that differs from the last one sent is registered again. This runs only after a token was sent and `disable()` has not run since. Call it once at the root of the app. |
 | `getPermissionStatus()`, `getPushToken()`, `requestPermissions()`, `hasPrompted()` | Lower-level steps. |
 
-`usePushNotifications(push, { enabled })` gives a settings screen `permission`, `isEnabled`, `isLoading` and wrapped `prompt`/`enable`/`disable`. `enabled` is the saved preference; while it is on, the token is re-registered on mount.
+`usePushNotifications(push, { enabled, persist })` gives a settings screen `permission`, `isEnabled`, `isLoading` and wrapped `prompt`/`enable`/`disable`. `enabled` is the saved preference; while it is on, the token is re-registered on mount.
+
+`persist` saves the preference, for example on the user's account. `enable()` and `disable()` call it first and show the new value right away. If it rejects, the hook restores `enabled`, skips the push step and rethrows, so catch it for your error toast. Saving before `enable()` means a denied dialog leaves the preference on with `isEnabled` false; the token registers on the next mount once permission is granted in device settings. Without `persist`, save the preference yourself before calling `enable()`.
+
+```tsx
+const { isEnabled, isLoading, enable, disable } = usePushNotifications(push, {
+  enabled: user.pushEnabled,
+  persist: (pushEnabled) => api.user.update({ pushEnabled })
+})
+
+const onToggle = async (on: boolean) => {
+  try {
+    if (!on) return await disable()
+    if (!(await enable())) toast('Allow notifications in device settings')
+  } catch {
+    toast('Could not save your notification setting')
+  }
+}
+```
 
 ### Error boundary
 

package/action.yml

@@ -107,6 +107,12 @@ outputs:
 runs:
   using: composite
   steps:
+    # The CLI imports hanzio and zod; the action checkout has no node_modules.
+    - name: Install expo-release dependencies
+      working-directory: ${{ github.action_path }}
+      shell: bash
+      run: bun install --production --frozen-lockfile --omit peer
+
     - name: Expo release
       id: release
       working-directory: ${{ inputs.working-directory }}

package/dist/args.d.ts

@@ -1,3 +1,5 @@
+import type { CommandContext } from 'hanzio/cli';
+import { z } from 'zod';
 export declare const DEFAULT_IMPACT_PATHS: readonly ['apps/expo/'];
 export type ReleasePlatform = 'ios' | 'android';
 export type CommandName = 'release' | 'decide' | 'operate';
@@ -26,14 +28,51 @@ export type ReleaseOptions = {
     fingerprint?: string;
     dryRun: boolean;
 };
-export declare const USAGE = "Usage: expo-release <release|decide|operate> --profile <profile> [--base <sha>] [--head <sha>] [--platform ios|android] [--impact-paths apps/expo/] [--operation deploy|force-native|retry-ota|republish|rollback-embedded] [--deploy-type none|ota|native] [--channel <channel>] [--environment <env>] [--group <id>] [--runtime-version <hash>] [--message <msg>] [--fingerprint <hash>] [--auto-submit true] [--export-source-maps true] [--pre-update <cmd>] [--post-update <cmd>] [--update-extra-args <args>] [--dry-run] [--ignore-expo-impact true]";
-export declare function optionalString(value: string | undefined): string | undefined;
-export declare function parseImpactPaths(value: string | undefined): string[];
-export declare function parsePlatform(value: string | undefined): ReleasePlatform;
-export declare function parseBoolean(value: string | undefined, fallback: boolean): boolean;
-export declare function parseOperation(value: string | undefined): Operation;
-export declare function parseDeployType(value: string | undefined): DeployType;
-export declare function parseCommandName(value: string | undefined): CommandName;
+export declare const releaseFlags: z.ZodObject<{
+    profile: z.ZodString;
+    base: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+    head: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+    platform: z.ZodDefault<z.ZodEnum<{
+        android: "android";
+        ios: "ios";
+    }>>;
+    impactPaths: z.ZodPipe<z.ZodDefault<z.ZodString>, z.ZodTransform<string[], string>>;
+    ignoreExpoImpact: z.ZodPipe<z.ZodDefault<z.ZodEnum<{
+        false: "false";
+        true: "true";
+    }>>, z.ZodTransform<boolean, "false" | "true">>;
+    operation: z.ZodDefault<z.ZodEnum<{
+        deploy: "deploy";
+        "force-native": "force-native";
+        republish: "republish";
+        "retry-ota": "retry-ota";
+        "rollback-embedded": "rollback-embedded";
+    }>>;
+    deployType: z.ZodDefault<z.ZodEnum<{
+        native: "native";
+        none: "none";
+        ota: "ota";
+    }>>;
+    channel: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+    environment: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+    autoSubmit: z.ZodPipe<z.ZodDefault<z.ZodEnum<{
+        false: "false";
+        true: "true";
+    }>>, z.ZodTransform<boolean, "false" | "true">>;
+    preUpdate: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+    postUpdate: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+    updateExtraArgs: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+    exportSourceMaps: z.ZodPipe<z.ZodDefault<z.ZodEnum<{
+        false: "false";
+        true: "true";
+    }>>, z.ZodTransform<boolean, "false" | "true">>;
+    group: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+    runtimeVersion: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+    message: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+    fingerprint: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+    dryRun: z.ZodBoolean;
+}, z.core.$strip>;
+export type ReleaseFlags = z.output<typeof releaseFlags>;
+export declare function toReleaseOptions(command: CommandName, { context: flags, env }: CommandContext<ReleaseFlags>): ReleaseOptions;
 export declare function needsDecide(operation: Operation): boolean;
 export declare function shouldIgnoreExpoImpact(options: Pick<ReleaseOptions, 'ignoreExpoImpact' | 'operation'>): boolean;
-export declare function parseReleaseOptions(args: string[], env?: NodeJS.ProcessEnv): ReleaseOptions;

package/dist/cli.js

@@ -1,62 +1,65 @@
 #!/usr/bin/env bun
 // @bun
 
+// src/cli.ts
+import { defineCli, defineCommand } from "hanzio/cli";
+
 // src/args.ts
-import { parseArgs } from "util";
+import { z } from "zod";
 var DEFAULT_IMPACT_PATHS = ["apps/expo/"];
-var USAGE = "Usage: expo-release <release|decide|operate> --profile <profile> [--base <sha>] [--head <sha>] [--platform ios|android] [--impact-paths apps/expo/] [--operation deploy|force-native|retry-ota|republish|rollback-embedded] [--deploy-type none|ota|native] [--channel <channel>] [--environment <env>] [--group <id>] [--runtime-version <hash>] [--message <msg>] [--fingerprint <hash>] [--auto-submit true] [--export-source-maps true] [--pre-update <cmd>] [--post-update <cmd>] [--update-extra-args <args>] [--dry-run] [--ignore-expo-impact true]";
-function fromEnv(env, name) {
-  const value = env[name]?.trim();
-  return value ? value : undefined;
-}
-function firstDefined(...values) {
-  return values.find((value) => value !== undefined && value.length > 0);
-}
-function optionalString(value) {
-  const trimmed = value?.trim();
-  return trimmed ? trimmed : undefined;
-}
-function parseImpactPaths(value) {
-  const paths = (value ?? DEFAULT_IMPACT_PATHS.join(",")).split(",").map((path) => path.trim()).filter(Boolean);
-  if (paths.length === 0) {
-    throw new Error("At least one --impact-paths entry is required");
-  }
-  return paths;
-}
-function parsePlatform(value) {
-  if (value === undefined || value === "ios")
-    return "ios";
-  if (value === "android")
-    return "android";
-  throw new Error("Usage: --platform ios|android");
-}
-function parseBoolean(value, fallback) {
-  if (value === undefined)
-    return fallback;
-  if (value === "true")
-    return true;
-  if (value === "false")
-    return false;
-  throw new Error(`Expected true or false, received: ${value}`);
-}
-function parseOperation(value) {
-  if (value === undefined || value === "deploy" || value === "force-native" || value === "retry-ota" || value === "republish" || value === "rollback-embedded") {
-    return value ?? "deploy";
-  }
-  throw new Error("Usage: --operation deploy|force-native|retry-ota|republish|rollback-embedded");
-}
-function parseDeployType(value) {
-  if (value === undefined || value === "none")
-    return "none";
-  if (value === "ota" || value === "native")
-    return value;
-  throw new Error("Usage: --deploy-type none|ota|native");
-}
-function parseCommandName(value) {
-  if (value === "release" || value === "decide" || value === "operate") {
-    return value;
-  }
-  throw new Error(USAGE);
+var text = (env) => z.string().transform((value) => value.trim() || undefined).optional().meta({ env: `EXPO_RELEASE_${env}` });
+var trueFalse = (env, fallback) => z.enum(["true", "false"]).default(fallback).transform((value) => value === "true").meta({ env: `EXPO_RELEASE_${env}` });
+var releaseFlags = z.object({
+  profile: z.string().trim().min(1).meta({ env: "EXPO_RELEASE_PROFILE" }).describe("EAS build profile, also the default update channel"),
+  base: text("BASE").describe("Git base SHA for the impact diff (falls back to GITHUB_EVENT_BEFORE)"),
+  head: text("HEAD").describe("Git head SHA for the impact diff (falls back to GITHUB_SHA)"),
+  platform: z.enum(["ios", "android"]).default("ios").meta({ env: "EXPO_RELEASE_PLATFORM" }).describe("Native platform"),
+  impactPaths: z.string().default(DEFAULT_IMPACT_PATHS.join(",")).transform((value, ctx) => {
+    const paths = value.split(",").map((path) => path.trim()).filter(Boolean);
+    if (paths.length === 0)
+      ctx.addIssue({
+        code: "custom",
+        message: "At least one --impact-paths entry is required"
+      });
+    return paths;
+  }).meta({ env: "EXPO_RELEASE_IMPACT_PATHS" }).describe("Comma-separated repo-root paths that count as an Expo change"),
+  ignoreExpoImpact: trueFalse("IGNORE_EXPO_IMPACT", "false").describe("Check the fingerprint even when no impact path changed"),
+  operation: z.enum([
+    "deploy",
+    "force-native",
+    "retry-ota",
+    "republish",
+    "rollback-embedded"
+  ]).default("deploy").meta({ env: "EXPO_RELEASE_OPERATION" }).describe("What to run"),
+  deployType: z.enum(["none", "ota", "native"]).default("none").meta({ env: "EXPO_RELEASE_DEPLOY_TYPE" }).describe("Decision type for operate"),
+  channel: text("CHANNEL").describe("EAS Update channel (default: the profile)"),
+  environment: text("ENVIRONMENT").describe("EAS environment for eas update (required for Expo SDK 55+)"),
+  autoSubmit: trueFalse("AUTO_SUBMIT", "true").describe("Pass --auto-submit on native builds"),
+  preUpdate: text("PRE_UPDATE").describe("Shell command run before eas update"),
+  postUpdate: text("POST_UPDATE").describe("Shell command run after a successful eas update"),
+  updateExtraArgs: text("UPDATE_EXTRA_ARGS").describe("Extra tokens appended to eas update"),
+  exportSourceMaps: trueFalse("EXPORT_SOURCE_MAPS", "false").describe("On OTA, expo export with external source maps, then publish dist"),
+  group: text("GROUP").describe("Update group ID for --operation republish"),
+  runtimeVersion: text("RUNTIME_VERSION").describe("Runtime version for rollback-embedded (default: the fingerprint)"),
+  message: text("MESSAGE").describe("Override the eas update message"),
+  fingerprint: text("FINGERPRINT").describe("Fingerprint hash to use instead of generating one"),
+  dryRun: z.boolean().meta({ env: "EXPO_RELEASE_DRY_RUN" }).describe("Print mutating EAS commands without running them")
+}).superRefine((flags, ctx) => {
+  if (flags.operation === "republish" && !flags.group)
+    ctx.addIssue({
+      code: "custom",
+      path: ["group"],
+      message: "required by --operation republish"
+    });
+});
+function toReleaseOptions(command, { context: flags, env }) {
+  return {
+    ...flags,
+    command,
+    base: flags.base ?? env.GITHUB_EVENT_BEFORE,
+    head: flags.head ?? env.GITHUB_SHA,
+    channel: flags.channel ?? flags.profile
+  };
 }
 function needsDecide(operation) {
   switch (operation) {
@@ -80,82 +83,6 @@ function shouldIgnoreExpoImpact(options) {
     return true;
   return process.env.GITHUB_EVENT_NAME === "workflow_dispatch" && options.operation === "deploy";
 }
-function parseReleaseOptions(args, env = process.env) {
-  let values;
-  let positionals;
-  try {
-    const parsed = parseArgs({
-      args,
-      allowPositionals: true,
-      strict: true,
-      options: {
-        profile: { type: "string" },
-        base: { type: "string" },
-        head: { type: "string" },
-        platform: { type: "string" },
-        "impact-paths": { type: "string" },
-        "ignore-expo-impact": { type: "string" },
-        operation: { type: "string" },
-        "deploy-type": { type: "string" },
-        channel: { type: "string" },
-        environment: { type: "string" },
-        "auto-submit": { type: "string" },
-        "pre-update": { type: "string" },
-        "post-update": { type: "string" },
-        "update-extra-args": { type: "string" },
-        "export-source-maps": { type: "string" },
-        group: { type: "string" },
-        "runtime-version": { type: "string" },
-        message: { type: "string" },
-        fingerprint: { type: "string" },
-        "dry-run": { type: "boolean", default: false }
-      }
-    });
-    values = parsed.values;
-    positionals = parsed.positionals;
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    throw new Error(`${USAGE}
-${message}`);
-  }
-  if (positionals.length > 1) {
-    throw new Error(USAGE);
-  }
-  const command = parseCommandName(positionals[0] ?? fromEnv(env, "EXPO_RELEASE_COMMAND"));
-  const profile = firstDefined(values.profile, fromEnv(env, "EXPO_RELEASE_PROFILE"));
-  if (!profile) {
-    throw new Error(USAGE);
-  }
-  const operation = parseOperation(firstDefined(values.operation, fromEnv(env, "EXPO_RELEASE_OPERATION")));
-  const group = optionalString(firstDefined(values.group, fromEnv(env, "EXPO_RELEASE_GROUP")));
-  if (operation === "republish" && !group) {
-    throw new Error("Usage: --operation republish requires --group <update-group-id>");
-  }
-  const channel = firstDefined(values.channel, fromEnv(env, "EXPO_RELEASE_CHANNEL")) ?? profile;
-  return {
-    command,
-    profile,
-    base: optionalString(firstDefined(values.base, fromEnv(env, "EXPO_RELEASE_BASE"), fromEnv(env, "GITHUB_EVENT_BEFORE"))),
-    head: optionalString(firstDefined(values.head, fromEnv(env, "EXPO_RELEASE_HEAD"), fromEnv(env, "GITHUB_SHA"))),
-    platform: parsePlatform(firstDefined(values.platform, fromEnv(env, "EXPO_RELEASE_PLATFORM"))),
-    impactPaths: parseImpactPaths(firstDefined(values["impact-paths"], fromEnv(env, "EXPO_RELEASE_IMPACT_PATHS"))),
-    ignoreExpoImpact: parseBoolean(firstDefined(values["ignore-expo-impact"], fromEnv(env, "EXPO_RELEASE_IGNORE_EXPO_IMPACT")), false),
-    operation,
-    deployType: parseDeployType(firstDefined(values["deploy-type"], fromEnv(env, "EXPO_RELEASE_DEPLOY_TYPE"))),
-    channel,
-    environment: optionalString(firstDefined(values.environment, fromEnv(env, "EXPO_RELEASE_ENVIRONMENT"))),
-    autoSubmit: parseBoolean(firstDefined(values["auto-submit"], fromEnv(env, "EXPO_RELEASE_AUTO_SUBMIT")), true),
-    preUpdate: optionalString(firstDefined(values["pre-update"], fromEnv(env, "EXPO_RELEASE_PRE_UPDATE"))),
-    postUpdate: optionalString(firstDefined(values["post-update"], fromEnv(env, "EXPO_RELEASE_POST_UPDATE"))),
-    updateExtraArgs: optionalString(firstDefined(values["update-extra-args"], fromEnv(env, "EXPO_RELEASE_UPDATE_EXTRA_ARGS"))),
-    exportSourceMaps: parseBoolean(firstDefined(values["export-source-maps"], fromEnv(env, "EXPO_RELEASE_EXPORT_SOURCE_MAPS")), false),
-    group,
-    runtimeVersion: optionalString(firstDefined(values["runtime-version"], fromEnv(env, "EXPO_RELEASE_RUNTIME_VERSION"))),
-    message: optionalString(firstDefined(values.message, fromEnv(env, "EXPO_RELEASE_MESSAGE"))),
-    fingerprint: optionalString(firstDefined(values.fingerprint, fromEnv(env, "EXPO_RELEASE_FINGERPRINT"))),
-    dryRun: values["dry-run"] === true || parseBoolean(fromEnv(env, "EXPO_RELEASE_DRY_RUN"), false)
-  };
-}
 
 // src/github-output.ts
 import { appendFile } from "fs/promises";
@@ -628,48 +555,52 @@ function toOperationInput(options, decision) {
     dryRun: options.dryRun
   };
 }
-async function main() {
-  const raw = Bun.argv.slice(2);
-  const hasEnvCommand = Boolean(process.env.EXPO_RELEASE_COMMAND?.trim());
-  if (raw.length === 0 && !hasEnvCommand || raw[0] === "--help" || raw[0] === "-h") {
-    process.stdout.write(`${USAGE}
-`);
-    return;
-  }
-  const options = parseReleaseOptions(raw);
-  switch (options.command) {
-    case "decide": {
-      const decision = await decideRelease(toDecisionInput(options));
-      await writeDecideGitHubOutput(decision);
-      process.stdout.write(`${JSON.stringify(decision)}
+async function decide(options, ctx) {
+  const decision = await decideRelease(toDecisionInput(options));
+  await writeDecideGitHubOutput(decision);
+  ctx.stdout.write(`${JSON.stringify(decision)}
 `);
-      return;
-    }
-    case "operate": {
-      const result = await operateRelease(toOperationInput(options, null));
-      await writeOperateGitHubOutput(result);
-      process.stdout.write(`${result}
-`);
-      return;
-    }
-    case "release": {
-      let decision = null;
-      if (needsDecide(options.operation)) {
-        decision = await decideRelease(toDecisionInput(options));
-        await writeDecideGitHubOutput(decision);
-        process.stdout.write(`${JSON.stringify(decision)}
+  return decision;
+}
+async function operate(options, decision, ctx) {
+  const result = await operateRelease(toOperationInput(options, decision));
+  await writeOperateGitHubOutput(result);
+  ctx.stdout.write(`${result}
 `);
+}
+var COMMANDS = ["release", "decide", "operate"];
+var cli = defineCli({
+  name: "expo-release",
+  description: "Fingerprint-driven Expo EAS release: OTA update or native store build",
+  globals: releaseFlags,
+  context: (flags) => flags,
+  commands: {
+    release: defineCommand({
+      description: "Run decide, then operate on its decision",
+      run: async (_input, ctx) => {
+        const options = toReleaseOptions("release", ctx);
+        const decision = needsDecide(options.operation) ? await decide(options, ctx) : null;
+        await operate(options, decision, ctx);
       }
-      const result = await operateRelease(toOperationInput(options, decision));
-      await writeOperateGitHubOutput(result);
-      process.stdout.write(`${result}
-`);
-      return;
-    }
-    default: {
-      const _exhaustive = options.command;
-      throw new Error(`Unsupported command: ${_exhaustive}`);
-    }
+    }),
+    decide: defineCommand({
+      description: "Print whether this change needs no deploy, an OTA update or a native build",
+      run: async (_input, ctx) => {
+        await decide(toReleaseOptions("decide", ctx), ctx);
+      }
+    }),
+    operate: defineCommand({
+      description: "Run --operation for --deploy-type",
+      run: async (_input, ctx) => {
+        await operate(toReleaseOptions("operate", ctx), null, ctx);
+      }
+    })
   }
+});
+var env = Object.fromEntries(Object.entries(process.env).flatMap(([name, value]) => value?.trim() ? [[name, value.trim()]] : []));
+var argv = process.argv.slice(2);
+if (!argv.some((arg) => COMMANDS.includes(arg))) {
+  argv = env.EXPO_RELEASE_COMMAND ? [env.EXPO_RELEASE_COMMAND, ...argv] : argv.length === 0 ? ["--help"] : argv;
 }
-await main();
+var code = await cli.run(argv, { env });
+process.exitCode = code === 2 ? 1 : code;

package/dist/index.js

@@ -1,60 +1,60 @@
 // @bun
 // src/args.ts
-import { parseArgs } from "util";
+import { z } from "zod";
 var DEFAULT_IMPACT_PATHS = ["apps/expo/"];
-var USAGE = "Usage: expo-release <release|decide|operate> --profile <profile> [--base <sha>] [--head <sha>] [--platform ios|android] [--impact-paths apps/expo/] [--operation deploy|force-native|retry-ota|republish|rollback-embedded] [--deploy-type none|ota|native] [--channel <channel>] [--environment <env>] [--group <id>] [--runtime-version <hash>] [--message <msg>] [--fingerprint <hash>] [--auto-submit true] [--export-source-maps true] [--pre-update <cmd>] [--post-update <cmd>] [--update-extra-args <args>] [--dry-run] [--ignore-expo-impact true]";
-function fromEnv(env, name) {
-  const value = env[name]?.trim();
-  return value ? value : undefined;
-}
-function firstDefined(...values) {
-  return values.find((value) => value !== undefined && value.length > 0);
-}
-function optionalString(value) {
-  const trimmed = value?.trim();
-  return trimmed ? trimmed : undefined;
-}
-function parseImpactPaths(value) {
-  const paths = (value ?? DEFAULT_IMPACT_PATHS.join(",")).split(",").map((path) => path.trim()).filter(Boolean);
-  if (paths.length === 0) {
-    throw new Error("At least one --impact-paths entry is required");
-  }
-  return paths;
-}
-function parsePlatform(value) {
-  if (value === undefined || value === "ios")
-    return "ios";
-  if (value === "android")
-    return "android";
-  throw new Error("Usage: --platform ios|android");
-}
-function parseBoolean(value, fallback) {
-  if (value === undefined)
-    return fallback;
-  if (value === "true")
-    return true;
-  if (value === "false")
-    return false;
-  throw new Error(`Expected true or false, received: ${value}`);
-}
-function parseOperation(value) {
-  if (value === undefined || value === "deploy" || value === "force-native" || value === "retry-ota" || value === "republish" || value === "rollback-embedded") {
-    return value ?? "deploy";
-  }
-  throw new Error("Usage: --operation deploy|force-native|retry-ota|republish|rollback-embedded");
-}
-function parseDeployType(value) {
-  if (value === undefined || value === "none")
-    return "none";
-  if (value === "ota" || value === "native")
-    return value;
-  throw new Error("Usage: --deploy-type none|ota|native");
-}
-function parseCommandName(value) {
-  if (value === "release" || value === "decide" || value === "operate") {
-    return value;
-  }
-  throw new Error(USAGE);
+var text = (env) => z.string().transform((value) => value.trim() || undefined).optional().meta({ env: `EXPO_RELEASE_${env}` });
+var trueFalse = (env, fallback) => z.enum(["true", "false"]).default(fallback).transform((value) => value === "true").meta({ env: `EXPO_RELEASE_${env}` });
+var releaseFlags = z.object({
+  profile: z.string().trim().min(1).meta({ env: "EXPO_RELEASE_PROFILE" }).describe("EAS build profile, also the default update channel"),
+  base: text("BASE").describe("Git base SHA for the impact diff (falls back to GITHUB_EVENT_BEFORE)"),
+  head: text("HEAD").describe("Git head SHA for the impact diff (falls back to GITHUB_SHA)"),
+  platform: z.enum(["ios", "android"]).default("ios").meta({ env: "EXPO_RELEASE_PLATFORM" }).describe("Native platform"),
+  impactPaths: z.string().default(DEFAULT_IMPACT_PATHS.join(",")).transform((value, ctx) => {
+    const paths = value.split(",").map((path) => path.trim()).filter(Boolean);
+    if (paths.length === 0)
+      ctx.addIssue({
+        code: "custom",
+        message: "At least one --impact-paths entry is required"
+      });
+    return paths;
+  }).meta({ env: "EXPO_RELEASE_IMPACT_PATHS" }).describe("Comma-separated repo-root paths that count as an Expo change"),
+  ignoreExpoImpact: trueFalse("IGNORE_EXPO_IMPACT", "false").describe("Check the fingerprint even when no impact path changed"),
+  operation: z.enum([
+    "deploy",
+    "force-native",
+    "retry-ota",
+    "republish",
+    "rollback-embedded"
+  ]).default("deploy").meta({ env: "EXPO_RELEASE_OPERATION" }).describe("What to run"),
+  deployType: z.enum(["none", "ota", "native"]).default("none").meta({ env: "EXPO_RELEASE_DEPLOY_TYPE" }).describe("Decision type for operate"),
+  channel: text("CHANNEL").describe("EAS Update channel (default: the profile)"),
+  environment: text("ENVIRONMENT").describe("EAS environment for eas update (required for Expo SDK 55+)"),
+  autoSubmit: trueFalse("AUTO_SUBMIT", "true").describe("Pass --auto-submit on native builds"),
+  preUpdate: text("PRE_UPDATE").describe("Shell command run before eas update"),
+  postUpdate: text("POST_UPDATE").describe("Shell command run after a successful eas update"),
+  updateExtraArgs: text("UPDATE_EXTRA_ARGS").describe("Extra tokens appended to eas update"),
+  exportSourceMaps: trueFalse("EXPORT_SOURCE_MAPS", "false").describe("On OTA, expo export with external source maps, then publish dist"),
+  group: text("GROUP").describe("Update group ID for --operation republish"),
+  runtimeVersion: text("RUNTIME_VERSION").describe("Runtime version for rollback-embedded (default: the fingerprint)"),
+  message: text("MESSAGE").describe("Override the eas update message"),
+  fingerprint: text("FINGERPRINT").describe("Fingerprint hash to use instead of generating one"),
+  dryRun: z.boolean().meta({ env: "EXPO_RELEASE_DRY_RUN" }).describe("Print mutating EAS commands without running them")
+}).superRefine((flags, ctx) => {
+  if (flags.operation === "republish" && !flags.group)
+    ctx.addIssue({
+      code: "custom",
+      path: ["group"],
+      message: "required by --operation republish"
+    });
+});
+function toReleaseOptions(command, { context: flags, env }) {
+  return {
+    ...flags,
+    command,
+    base: flags.base ?? env.GITHUB_EVENT_BEFORE,
+    head: flags.head ?? env.GITHUB_SHA,
+    channel: flags.channel ?? flags.profile
+  };
 }
 function needsDecide(operation) {
   switch (operation) {
@@ -78,82 +78,6 @@ function shouldIgnoreExpoImpact(options) {
     return true;
   return process.env.GITHUB_EVENT_NAME === "workflow_dispatch" && options.operation === "deploy";
 }
-function parseReleaseOptions(args, env = process.env) {
-  let values;
-  let positionals;
-  try {
-    const parsed = parseArgs({
-      args,
-      allowPositionals: true,
-      strict: true,
-      options: {
-        profile: { type: "string" },
-        base: { type: "string" },
-        head: { type: "string" },
-        platform: { type: "string" },
-        "impact-paths": { type: "string" },
-        "ignore-expo-impact": { type: "string" },
-        operation: { type: "string" },
-        "deploy-type": { type: "string" },
-        channel: { type: "string" },
-        environment: { type: "string" },
-        "auto-submit": { type: "string" },
-        "pre-update": { type: "string" },
-        "post-update": { type: "string" },
-        "update-extra-args": { type: "string" },
-        "export-source-maps": { type: "string" },
-        group: { type: "string" },
-        "runtime-version": { type: "string" },
-        message: { type: "string" },
-        fingerprint: { type: "string" },
-        "dry-run": { type: "boolean", default: false }
-      }
-    });
-    values = parsed.values;
-    positionals = parsed.positionals;
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    throw new Error(`${USAGE}
-${message}`);
-  }
-  if (positionals.length > 1) {
-    throw new Error(USAGE);
-  }
-  const command = parseCommandName(positionals[0] ?? fromEnv(env, "EXPO_RELEASE_COMMAND"));
-  const profile = firstDefined(values.profile, fromEnv(env, "EXPO_RELEASE_PROFILE"));
-  if (!profile) {
-    throw new Error(USAGE);
-  }
-  const operation = parseOperation(firstDefined(values.operation, fromEnv(env, "EXPO_RELEASE_OPERATION")));
-  const group = optionalString(firstDefined(values.group, fromEnv(env, "EXPO_RELEASE_GROUP")));
-  if (operation === "republish" && !group) {
-    throw new Error("Usage: --operation republish requires --group <update-group-id>");
-  }
-  const channel = firstDefined(values.channel, fromEnv(env, "EXPO_RELEASE_CHANNEL")) ?? profile;
-  return {
-    command,
-    profile,
-    base: optionalString(firstDefined(values.base, fromEnv(env, "EXPO_RELEASE_BASE"), fromEnv(env, "GITHUB_EVENT_BEFORE"))),
-    head: optionalString(firstDefined(values.head, fromEnv(env, "EXPO_RELEASE_HEAD"), fromEnv(env, "GITHUB_SHA"))),
-    platform: parsePlatform(firstDefined(values.platform, fromEnv(env, "EXPO_RELEASE_PLATFORM"))),
-    impactPaths: parseImpactPaths(firstDefined(values["impact-paths"], fromEnv(env, "EXPO_RELEASE_IMPACT_PATHS"))),
-    ignoreExpoImpact: parseBoolean(firstDefined(values["ignore-expo-impact"], fromEnv(env, "EXPO_RELEASE_IGNORE_EXPO_IMPACT")), false),
-    operation,
-    deployType: parseDeployType(firstDefined(values["deploy-type"], fromEnv(env, "EXPO_RELEASE_DEPLOY_TYPE"))),
-    channel,
-    environment: optionalString(firstDefined(values.environment, fromEnv(env, "EXPO_RELEASE_ENVIRONMENT"))),
-    autoSubmit: parseBoolean(firstDefined(values["auto-submit"], fromEnv(env, "EXPO_RELEASE_AUTO_SUBMIT")), true),
-    preUpdate: optionalString(firstDefined(values["pre-update"], fromEnv(env, "EXPO_RELEASE_PRE_UPDATE"))),
-    postUpdate: optionalString(firstDefined(values["post-update"], fromEnv(env, "EXPO_RELEASE_POST_UPDATE"))),
-    updateExtraArgs: optionalString(firstDefined(values["update-extra-args"], fromEnv(env, "EXPO_RELEASE_UPDATE_EXTRA_ARGS"))),
-    exportSourceMaps: parseBoolean(firstDefined(values["export-source-maps"], fromEnv(env, "EXPO_RELEASE_EXPORT_SOURCE_MAPS")), false),
-    group,
-    runtimeVersion: optionalString(firstDefined(values["runtime-version"], fromEnv(env, "EXPO_RELEASE_RUNTIME_VERSION"))),
-    message: optionalString(firstDefined(values.message, fromEnv(env, "EXPO_RELEASE_MESSAGE"))),
-    fingerprint: optionalString(firstDefined(values.fingerprint, fromEnv(env, "EXPO_RELEASE_FINGERPRINT"))),
-    dryRun: values["dry-run"] === true || parseBoolean(fromEnv(env, "EXPO_RELEASE_DRY_RUN"), false)
-  };
-}
 // src/github-output.ts
 import { appendFile } from "fs/promises";
 async function appendGitHubOutput(entries) {