Lanzamiento a App Store
Gestiona un envío completo a la App Store de iOS desde la API de App Store Connect. Objetivo de diseño: el usuario proporciona las credenciales + un config.json una vez, luego el agente hace todo lo que es automatizable y solo interrumpe al usuario para las pocas cosas que Apple genuinamente no expone mediante API. No preguntes al usuario que vuelva a confirmar cosas que ya están en la configuración o tienen valores predeterminados sensatos.
Principio de funcionamiento (léelo primero)
- Basado en configuración, no en instrucciones. Todo el contenido de la aplicación vive en
config.json. Ejecuta comandos; no entrevistes al usuario. - Solo dos cosas son solo de interfaz de usuario (Apple no tiene API): la declaración de recopilación de datos de privacidad de la aplicación y la primera suscripción (adjuntar y enviar). Las herramientas detectan y muestran estos con clics exactos. Todo lo demás está automatizado.
- Pregunta al usuario solo cuando: falta un campo obligatorio en la configuración (dile exactamente cuál), una decisión comercial no está en la configuración (precio de suscripción, momento de lanzamiento), o antes de la única acción irreversible (el envío final). En caso contrario, procede.
- Idempotente: todos los comandos son seguros de re-ejecutar.
node cli.mjs releasese puede ejecutar repetidamente.
Arquitectura (SÓLIDA, para que puedas extenderla)
scripts/
cli.mjs punto de entrada único / despachador (node cli.mjs <comando>)
lib/ servicios inyectados, una responsabilidad cada uno
env.mjs analiza+valida el entorno (credenciales, id de app)
jwt.mjs proveedor de tokens ES256
client.mjs AscClient — autenticación + HTTP + errores uniformes
discovery.mjs localiza recursos de ASC por clave natural (sin ids hardcodeados)
assets.mjs cargador binario: reservar→subir→confirmar
config.mjs carga + valida la configuración, lista lo que falta
log.mjs resultados estructurados + resumen legible por máquina
context.mjs raíz de composición (inyección de dependencias)
commands/ un archivo por tarea; contrato uniforme (ver _contract.md)
Añadir una capacidad = añadir un archivo commands/x.mjs (meta + run(ctx)) y registrarlo en cli.mjs.
Configuración (una vez) — consulta references/setup.md
- Clave API de ASC (App Manager): descarga
AuthKey_XXXX.p8, anota el ID de Clave + ID de Emisor. - El registro de la aplicación existe en ASC (ID de bundle registrado).
ASC_APP_ID= id numérico de la URL de ASC de la aplicación. - Proyecto EAS configurado,
eas loginrealizado. - Rellena
config.jsondesdereferences/config-template.json. Valida en cualquier momento: cualquier comando imprime exactamente qué campos faltan.
Entorno
export ASC_KEY_ID=... ASC_ISSUER_ID=... ASC_P8_PATH=/abs/AuthKey_XXXX.p8 # gitignore el .p8
export ASC_APP_ID=1234567890
export APPSTORE_CONFIG=/abs/config.json
cd scripts # luego: node cli.mjs <comando>
Manual de ejecución
1. Orientación
node cli.mjs status # resumen completo de solo lectura
node cli.mjs check # preparación + los pasos solo de interfaz de usuario pendientes
2. Construir el binario (EAS)
- Si
eas buildfalla con credenciales caducas ("perfil de aprovisionamiento caducado / no hay certificado con serial…"):luego establecenode cli.mjs credentials # nuevo certificado de distribución + perfil → credentials.json"credentialsSource":"local"en el perfil de producción de eas.json. - Construye y envía el binario (exporta
EXPO_ASC_API_KEY_PATH/KEY_ID/ISSUER_ID+EXPO_APPLE_TEAM_ID+EXPO_APPLE_TEAM_TYPEpara modo no interactivo):Espera hasta que la compilación esté VÁLIDA (eas build -p ios --profile production --non-interactive --no-wait eas submit -p ios --profile production --id <buildId>node cli.mjs status).
3. Rellenar todo el listado de una sola vez
node cli.mjs release # adjuntar compilación → metadatos → precios → derechos de contenido →
# calificación de edad → categoría → información de revisión → capturas de pantalla →
# suscripción → verificar
release ejecuta todo el pipeline (idempotente) y termina con check, que imprime los pasos restantes solo de interfaz de usuario. Las capturas de pantalla deben existir primero (config.screenshots.dir) — consulta references/screenshots.md para generarlas.
4. Los dos pasos solo de interfaz de usuario (entrega con clics exactos)
check los enumera cuando corresponden:
- Privacidad de la aplicación → Recopilación de datos: declara los tipos de datos que coinciden con el manifiesto de privacidad de la aplicación, luego Publicar. ⚠️ Si el binario incluye
NSUserTrackingUsageDescriptionpero declaras que no hay seguimiento, la publicación estará bloqueada → elimina la clave, recompila (references/gotchas.md). - Primera suscripción: página de versión → Compras dentro de la aplicación y suscripciones → Seleccionar → → Guardar → Agregar para revisión → Enviar. (La API no puede adjuntar una primera suscripción).
5. Enviar
node cli.mjs check # confirma que no falta nada
node cli.mjs submit --submit # solo aplicación / actualizaciones (sin primera compra dentro de la aplicación)
Para una primera suscripción, el usuario envía en la interfaz de usuario (paso 4.2). Verifica con status: versión y suscripción ambas en WAITING_FOR_REVIEW.
Rechazos
Si hay rechazo, la versión vuelve a ser editable (REJECTED/METADATA_REJECTED/DEVELOPER_REJECTED). Lee el mensaje del centro de resolución, corrige (metadatos mediante release, o recompila si es un problema del binario), y vuelve a enviar.
Referencias
references/setup.md— creación de claves, registro de la aplicación, EAS, higiene de secretos.references/gotchas.md— todas las trampas reales (léelo antes de la primera ejecución).references/screenshots.md— generación de PNGs de tamaño exacto (HTML → Chrome sin cabeza).references/config-template.json— configuración por aplicación (validada porlib/config.mjs).