@customyai/cli 0.7.1 → 0.10.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +83 -0
- package/LICENSE +2 -1
- package/README.md +77 -0
- package/dist/bin.cjs +6 -2
- package/dist/bin.mjs +5 -1
- package/dist/chunk-2A6WFLXS.cjs +235 -0
- package/dist/chunk-3M6ZLCSN.mjs +237 -0
- package/dist/chunk-57NNDUEX.mjs +3246 -0
- package/dist/chunk-6X3AX6PB.cjs +3266 -0
- package/dist/chunk-ABK4QQWW.cjs +244 -0
- package/dist/chunk-BYMLRMNS.mjs +27 -0
- package/dist/chunk-MFJL3NO5.cjs +31 -0
- package/dist/chunk-QKIF4C5R.mjs +226 -0
- package/dist/index.cjs +32 -11
- package/dist/index.d.cts +63 -1
- package/dist/index.d.ts +63 -1
- package/dist/index.mjs +2 -1
- package/dist/json-NETFQXLJ.mjs +67 -0
- package/dist/json-NSJMTBPP.cjs +70 -0
- package/dist/po-AKWHAYBL.mjs +387 -0
- package/dist/po-IJGMXNVY.cjs +394 -0
- package/dist/pseudo-CKYMJJBX.mjs +101 -0
- package/dist/pseudo-LBLMBD2T.cjs +106 -0
- package/dist/quality-6SEZNA6Q.cjs +207 -0
- package/dist/quality-ILK6IA5O.mjs +199 -0
- package/dist/xliff-DEJHB2SY.mjs +512 -0
- package/dist/xliff-DXICWMWC.cjs +518 -0
- package/package.json +9 -3
- package/dist/chunk-6KGKN5HN.cjs +0 -1108
- package/dist/chunk-KDUW3KTG.mjs +0 -1093
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,88 @@
|
|
|
1
1
|
# @customyai/cli
|
|
2
2
|
|
|
3
|
+
## 0.10.1
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- Primera versión de la CLI con `customy experience …` en npm: lo publicado hasta hoy era la 0.7.2, así que 0.7.3–0.10.0 (Experience: `pull|push|status|check`, `export|import|pseudo`, protocolo v2 `init|revoke|scope|signing|reconcile`, `signing rotate`, `--publish`; WhatsApp: `numbers|send|messages|templates|findings|webhooks|broadcasts|flows`) nunca llegaron al registro y se publican de una vez en esta versión, junto con `@customyai/whatsapp@0.3.0` (primera publicación; la CLI depende de él). `customy experience --help` lista ahora `signing rotate` (el comando existía pero la ayuda lo omitía). La descripción y las palabras clave del paquete mencionan Experience.
|
|
8
|
+
|
|
9
|
+
## 0.10.0
|
|
10
|
+
|
|
11
|
+
### Minor Changes
|
|
12
|
+
|
|
13
|
+
- Customy WhatsApp cubre difusiones, ciclo de vida de plantillas, flujos y conexión de números. SDK: `broadcasts.create/list/get/status/recipients/iterateRecipients/cancel` (consentimiento, horas de silencio, pacing y límites se respetan; el avance y la causa de fallo salen por destinatario), `templates.update/delete/status`, `flows.list/get/create/preview/publish` y `numbers.connect/connection` (enlace de Embedded Signup, sin tocar tokens de Meta). Scopes nuevos: `whatsapp:broadcasts:read|send|cancel`, `whatsapp:templates:delete`, `whatsapp:flows:read|manage|publish` y `whatsapp:numbers:connect`; las operaciones destructivas piden su scope propio. CLI: `customy whatsapp broadcasts create|list|status|cancel`, `templates status|edit|delete`, `flows list|get|create|preview|publish` y `numbers connect|connection`, con `--json`, `--dry-run` (imprime la petición y no cambia nada) y `--yes` para borrar, cancelar y publicar.
|
|
14
|
+
|
|
15
|
+
### Patch Changes
|
|
16
|
+
|
|
17
|
+
- Dependencias actualizadas:
|
|
18
|
+
- @customyai/whatsapp@0.3.0
|
|
19
|
+
|
|
20
|
+
## 0.9.0
|
|
21
|
+
|
|
22
|
+
### Minor Changes
|
|
23
|
+
|
|
24
|
+
- Webhooks de WhatsApp hacia tu endpoint. `@customyai/whatsapp`: `wa.webhooks` registra una URL https (`create`, con el secreto `whsec_…` visible una sola vez), `list`, `get`, `update` (activar/desactivar), `delete`, `rotateSecret` (el secreto anterior firma 24 h más) y `test`, y `wa.webhooks.deliveries.list/iterate/get/redeliver` para el registro de entregas (estado, código HTTP, latencia, intentos, cuerpo y respuesta) y el reenvío manual. Nuevo scope `whatsapp:webhooks`, constante `WHATSAPP_WEBHOOK_EVENTS` y los tipos `WhatsAppWebhookEvent` (unión discriminada de `message.received|sent|delivered|read|failed`, `template.approved|rejected`, `number.connected|disconnected`), `WhatsAppWebhookEndpoint` y `WhatsAppWebhookDelivery`. La entrega va firmada con el esquema que ya valida `verifyWebhook`, con 8 intentos con backoff exponencial y cola de muertos. `@customyai/cli`: `customy whatsapp webhooks list|create|get|update|delete|rotate|test|deliveries|delivery|redeliver|tail`; `webhooks tail` ahora existe y sigue las entregas (nuevas y cambios de estado) por sondeo. `@customyai/sdk` re-exporta el cliente con `customy.whatsapp.webhooks`.
|
|
25
|
+
|
|
26
|
+
### Patch Changes
|
|
27
|
+
|
|
28
|
+
- Dependencias actualizadas:
|
|
29
|
+
- @customyai/whatsapp@0.2.0
|
|
30
|
+
|
|
31
|
+
## 0.8.1
|
|
32
|
+
|
|
33
|
+
### Patch Changes
|
|
34
|
+
|
|
35
|
+
- Dependencias actualizadas:
|
|
36
|
+
- @customyai/whatsapp@0.1.1
|
|
37
|
+
|
|
38
|
+
## 0.8.0
|
|
39
|
+
|
|
40
|
+
### Minor Changes
|
|
41
|
+
|
|
42
|
+
- Añade `customy whatsapp` (alias `customy wa`): `numbers list|status`, `send` (texto, plantilla, media, interactivo; `--dry-run`), `messages list`, `conversations list`, `tail`, `templates list|get|sync|create`, `readiness`, `findings` (con `--fail-on` para CI) y `webhooks verify|sign`, con salida legible y `--json`. Usa la llave de Access de la app (`CUSTOMY_CLIENT_ID`, `CUSTOMY_CLIENT_SECRET`, `CUSTOMY_ACCESS_URL`); el entorno lo decide el issuer. `CliIo` gana `signal` y `sleep` opcionales.
|
|
43
|
+
|
|
44
|
+
### Patch Changes
|
|
45
|
+
|
|
46
|
+
- Dependencias actualizadas:
|
|
47
|
+
- @customyai/whatsapp@0.1.0
|
|
48
|
+
|
|
49
|
+
## 0.7.7
|
|
50
|
+
|
|
51
|
+
### Patch Changes
|
|
52
|
+
|
|
53
|
+
- `customy experience signing rotate --reason "…" [--retire id,id] [--compromised id,id] [--window-elapsed]` publica UN paso de la rotación de la clave de firma (`POST /v1/signing/rotation/step`, capacidad `experience.signing.rotate`): pide el plan de lectura para saber el conjunto de claves nuevo y lo firma el servicio con las claves vigentes no comprometidas. En un entorno de producción el servicio responde 409 `approval_required` (el paso se pide con una solicitud `signing_rotate` que aprueban dos personas). Un paso a medias sale 5 y se repite. `signing plan` no cambia.
|
|
54
|
+
|
|
55
|
+
## 0.7.6
|
|
56
|
+
|
|
57
|
+
### Patch Changes
|
|
58
|
+
|
|
59
|
+
- `customy experience push|import --publish` manda la pista de tipo e idioma (`?kind=catalog&locale=`) al guardar el borrador y al crear la revisión, para que el Workspace estampe `experience.catalog.publish` (publicar un catálogo es un permiso aparte de guardar borradores). Sin ese permiso el borrador queda guardado y la publicación se rechaza.
|
|
60
|
+
|
|
61
|
+
## 0.7.5
|
|
62
|
+
|
|
63
|
+
### Patch Changes
|
|
64
|
+
|
|
65
|
+
- `customy experience` habla el protocolo v2 de Customy Experience (manifest@2 / timestamp@1, ámbito opaco): `init` escribe `customy.experience.json` (ámbito, base, anclas con roles y piso) desde `GET /v1/context`; `status` añade el ámbito de entrega (con el que drena), `minSequence`, el candidato y la vigencia del timestamp (aviso por omisión a V/6); nuevos `revoke <release|#número> --reason … [--fallback …]` (sube `minSequence`), `scope show|rotate|retire`, `signing plan` (solo lectura; `signing rotate` no existe porque el servicio no expone la firma de un paso) y `reconcile <canal>`. Un 404 se explica como «sin permiso o inexistente» (anti-oráculo) y sale 3; los 409/503 del servicio traen el siguiente paso. El token nunca se imprime y no se hace ninguna petición si el uso es inválido.
|
|
66
|
+
|
|
67
|
+
## 0.7.4
|
|
68
|
+
|
|
69
|
+
### Patch Changes
|
|
70
|
+
|
|
71
|
+
- `customy experience` integra las herramientas de traducción (XLIFF 2.1, PO, JSON plano, pseudo-localización y comprobaciones de calidad): `export --format xliff|po|json` descarga los catálogos publicados (o el borrador con `--draft`) como ficheros para traductores; `import <fichero> [--format auto] [--publish]` los convierte a `catalog@1`, los valida con el contrato y con las comprobaciones de calidad (avisos; `--strict` los bloquea) y guarda un BORRADOR con `revisionBase` y `draftVersion` igual que `push` — nunca publica sin `--publish`; `pseudo --locale xx [--rtl]` genera en local, sin red ni token, el catálogo pseudo-localizado. `check` usa ahora `checkCatalog` (variables, plurales, longitud, HTML, URLs y un glosario con `--glossary`; `--strict` convierte los avisos en fallo). Un XLIFF con `DOCTYPE` o entidades, un PO o JSON mal formado o un fichero que no es UTF-8 salen con código 1 sin abrir ninguna conexión. Mismos códigos de salida (0/1/2/3/4/5) y el token nunca se imprime. El tope de tamaño del bundle sube de 25 381 a 45 897 bytes min+gzip por el código de las herramientas (que se carga bajo demanda en el CLI).
|
|
72
|
+
|
|
73
|
+
## 0.7.3
|
|
74
|
+
|
|
75
|
+
### Patch Changes
|
|
76
|
+
|
|
77
|
+
- Nuevo grupo `customy experience pull|push|status|check`: los catálogos de traducción `catalog@1` de Customy Experience como ficheros en el repositorio. `pull` los descarga ordenados por clave con un lock de revisiones; `push` valida en local, guarda el borrador con `revisionBase` y, con `--publish`, crea la revisión (reconociendo `--ack-remove` y `--ack-placeholders` clave por clave); `status` enseña revisiones, releases, canales y caducidad del manifiesto; `check` es solo local (paridad entre idiomas, ICU y claves usadas por el código) y sale 1 si falla. El token sale de `CUSTOMY_EXPERIENCE_TOKEN` y nunca se imprime.
|
|
78
|
+
|
|
79
|
+
## 0.7.2
|
|
80
|
+
|
|
81
|
+
### Patch Changes
|
|
82
|
+
|
|
83
|
+
- Los comandos de Experiments (`flags`, `segments`, `experiments`) se niegan, antes de enviar el Bearer, a un origen que no sea `https://` (`http://` solo hacia `localhost`, `127.0.0.1` o `[::1]`) (P-B8).
|
|
84
|
+
`customy audit export --out` escribe el archivo con permisos 0600 (solo el dueño), también si ya existía con otros permisos (P-B9): la auditoría nombra personas y acciones.
|
|
85
|
+
|
|
3
86
|
## 0.7.1
|
|
4
87
|
|
|
5
88
|
### Patch Changes
|
package/LICENSE
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
|
-
Copyright (c) 2026 Customy. All rights reserved.
|
|
1
|
+
Copyright (c) 2026 DIVERGENTE S.A.S. (Customy). All rights reserved.
|
|
2
|
+
Terms: https://customy.ai/legal/sdk-terms/v1
|
|
2
3
|
|
|
3
4
|
This software is proprietary. It is distributed so that Customy products and
|
|
4
5
|
parties that hold a written agreement with Customy can install it. Its
|
package/README.md
CHANGED
|
@@ -2,6 +2,8 @@
|
|
|
2
2
|
|
|
3
3
|
La CLI de Customy para apps: valida, tipa y sincroniza el `customy.app.json` de una app, y provisiona usuarios de prueba (manifiesto `app/v1`: productos y scopes, recursos, eventos con schema y propósitos de consentimiento, capabilities, planes y meters; opcionalmente `permissions` y `roles` de la app).
|
|
4
4
|
|
|
5
|
+
También opera Customy WhatsApp (`customy whatsapp …`) y los catálogos de traducción y releases de Customy Experience (`customy experience …`, más abajo). Requiere Node 20 o superior.
|
|
6
|
+
|
|
5
7
|
```bash
|
|
6
8
|
npm install --save-dev @customyai/cli
|
|
7
9
|
|
|
@@ -45,6 +47,33 @@ customy login # device flow: aún no d
|
|
|
45
47
|
|
|
46
48
|
También se puede usar como biblioteca: `validateManifest`, `generateAppTypes`, `syncApp` y `runCli`.
|
|
47
49
|
|
|
50
|
+
## Customy WhatsApp (`customy whatsapp`)
|
|
51
|
+
|
|
52
|
+
Operar WhatsApp desde la terminal, sobre [`@customyai/whatsapp`](../sdk-whatsapp). Credencial en el entorno (nunca por argv): `CUSTOMY_CLIENT_ID` + `CUSTOMY_CLIENT_SECRET` + `CUSTOMY_ACCESS_URL` (una llave de Access con la audiencia `customy-whatsapp`), o un `CUSTOMY_TOKEN`. El issuer decide staging o producción: el discovery dice a qué host de WhatsApp hablar (`--base-url` / `CUSTOMY_WHATSAPP_URL` lo sustituyen). Número por defecto: `--phone` o `CUSTOMY_WHATSAPP_PHONE_ID`. Todos los comandos aceptan `--json`.
|
|
53
|
+
|
|
54
|
+
```bash
|
|
55
|
+
customy whatsapp numbers status # números + readiness: qué bloquea el envío
|
|
56
|
+
customy whatsapp send --to +573001234567 --template order_update --language es --param 1=Ana
|
|
57
|
+
customy whatsapp send --to +573001234567 --text "Hola" --dry-run # imprime la petición, no envía
|
|
58
|
+
customy whatsapp messages list --direction inbound --limit 20
|
|
59
|
+
customy whatsapp tail --direction inbound # sigue los mensajes nuevos (sondeo; Ctrl+C)
|
|
60
|
+
customy whatsapp templates list --status approved
|
|
61
|
+
customy whatsapp templates status <id> # aprobación: estado local, de Meta y motivo de rechazo
|
|
62
|
+
customy whatsapp templates edit <id> --file cambios.json --dry-run # PATCH a Meta; vuelve a revisión
|
|
63
|
+
customy whatsapp templates delete <id> --yes # irreversible: también en Meta (scope templates:delete)
|
|
64
|
+
customy whatsapp broadcasts create --template promo --language es --recipients-file lista.json --consent opted_in --dry-run
|
|
65
|
+
customy whatsapp broadcasts status <id> --failures # avance por estado y fallos por destinatario
|
|
66
|
+
customy whatsapp broadcasts cancel <id> --yes # solo lo que aún no salió (scope broadcasts:cancel)
|
|
67
|
+
customy whatsapp flows create --file flujo.json && customy whatsapp flows publish <id> --yes
|
|
68
|
+
customy whatsapp numbers connect --external-id cliente-1 # enlace de Embedded Signup (se ve una sola vez)
|
|
69
|
+
customy whatsapp findings --hours 24 --fail-on high # problemas de entrega por causa; código de salida 4 para CI
|
|
70
|
+
customy whatsapp webhooks create --url https://app.example.com/wa --event message.received # imprime el secreto whsec_… UNA vez
|
|
71
|
+
customy whatsapp webhooks deliveries --status dead && customy whatsapp webhooks redeliver <id>
|
|
72
|
+
customy whatsapp webhooks verify --body-file evento.json --header webhook-id=… --header webhook-timestamp=… --header webhook-signature=…
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
`--dry-run` imprime la petición y no cambia nada (send, templates create/edit/delete/sync, broadcasts create/cancel, flows create/publish, numbers connect); borrar, cancelar y publicar exigen `--yes`. `customy wa` es un alias. Códigos de salida: 0 ok, 1 error, 2 no disponible, 3 credencial o scope rechazado, 4 `findings --fail-on` encontró algo. Webhooks hacia tu servidor: `customy whatsapp webhooks list|create|get|update|delete|rotate|test|deliveries|delivery|redeliver|tail` (scope `whatsapp:webhooks`; el secreto `whsec_…` se imprime una sola vez al crear o rotar; `webhooks tail` sigue las entregas por sondeo). Guía completa: [Quick setup](../../docs/CUSTOMY_WHATSAPP_QUICKSTART.md).
|
|
76
|
+
|
|
48
77
|
## Customy Experiments: flags, segmentos y experimentos
|
|
49
78
|
|
|
50
79
|
Control de Customy Experiments desde la terminal o un pipeline. El origen sale de `--base-url` o `CUSTOMY_EXPERIMENTS_URL` y la credencial de `CUSTOMY_EXPERIMENTS_TOKEN` (nunca por la línea de comandos); el inquilino y el entorno los decide el servidor por la credencial. Toda escritura exige `--reason` (la auditoría pide el porqué) y admite `--dry-run`, que imprime la petición y no envía nada.
|
|
@@ -62,3 +91,51 @@ customy experiments conclude <key> --decision ship --reason "ganó la variante B
|
|
|
62
91
|
```
|
|
63
92
|
|
|
64
93
|
Códigos de salida: 0 ok, 1 error del servidor o de uso, 3 credencial rechazada (401/403), 4 conflicto o solicitud de cambio pendiente (409/412).
|
|
94
|
+
|
|
95
|
+
## Customy Experience: catálogos de traducción (`customy experience`)
|
|
96
|
+
|
|
97
|
+
Los catálogos `catalog@1` como ficheros del repositorio (`<namespace>.<locale>.json`, claves ordenadas, un diff estable en Git).
|
|
98
|
+
|
|
99
|
+
```bash
|
|
100
|
+
export CUSTOMY_EXPERIENCE_URL=https://<origen-del-BFF> # o --base-url (https://; http:// solo hacia localhost)
|
|
101
|
+
export CUSTOMY_EXPERIENCE_TOKEN=… # token de máquina; nunca por argv ni impreso
|
|
102
|
+
|
|
103
|
+
customy experience pull --dir catalogs [--namespace checkout --locale es,en] [--draft]
|
|
104
|
+
customy experience check --dir catalogs --locales es,en --src src # LOCAL: sin red ni token
|
|
105
|
+
customy experience push --dir catalogs [--create] [--rebase] # guarda el borrador (revisionBase del lock)
|
|
106
|
+
customy experience push --dir catalogs --publish --note "…" --ack-remove a.vieja --ack-placeholders b.nueva
|
|
107
|
+
customy experience status [--locale es] [--warn-hours N] [--fail-on-expiry]
|
|
108
|
+
|
|
109
|
+
# Protocolo v2 (manifest@2 / timestamp@1, ámbito opaco)
|
|
110
|
+
customy experience init [--channel production] [--out customy.experience.json] [--force] # ámbito, base, anclas con roles y piso
|
|
111
|
+
customy experience revoke <xpr_…|#número> --reason "…" [--fallback <xpr_…|#número>] [--dry-run] # sube minSequence
|
|
112
|
+
customy experience scope show | rotate --reason "…" | retire [--force]
|
|
113
|
+
customy experience signing plan [--retire id,id] [--threshold n] [--compromised id,id] # SOLO LECTURA
|
|
114
|
+
customy experience signing rotate --reason "…" [--retire id,id] [--compromised id,id] [--window-elapsed] # publica UN paso (experience.signing.rotate)
|
|
115
|
+
customy experience reconcile production|staging|preview|beta
|
|
116
|
+
|
|
117
|
+
# Traductores y calidad (XLIFF 2.1, PO, JSON plano, pseudo-localización)
|
|
118
|
+
customy experience export --format xliff|po|json [--namespace checkout] [--locale es,fr] [--source-locale en] [--out translations] [--draft]
|
|
119
|
+
customy experience import translations/checkout.en-es.xlf [--format auto] [--dir catalogs] [--rebase|--create] [--strict] [--glossary glossary.json]
|
|
120
|
+
customy experience import translations/checkout.es.po --publish --note "traducción revisada"
|
|
121
|
+
customy experience pseudo --locale xx [--rtl] [--source-locale en] [--dir catalogs] [--out catalogs] # LOCAL: sin red ni token
|
|
122
|
+
customy experience check --dir catalogs --glossary glossary.json [--strict]
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
- **pull**: descarga la última revisión publicada de cada catálogo (o su borrador con `--draft`) y escribe `.customy-experience.lock.json` (artefacto, revisión, versión del borrador) junto a los ficheros. Súbelo a Git: es la base de `push`.
|
|
126
|
+
- **push**: valida TODO en local con `validateCatalog` (límites del plan con `--plan free|pro|enterprise`, por omisión `pro`) antes de la primera petición; si algo no valida sale 1 sin enviar nada. Guarda el borrador con `revisionBase` y `draftVersion` del lock; sin lock exige `pull` o `--rebase`; un catálogo inexistente exige `--create`. `--publish` crea la revisión y pide el permiso `experience.catalog.publish` (distinto del de guardar borradores, `experience.catalog.write`; sin él, el servicio responde 404 y el borrador queda guardado); quitar claves o cambiar sus variables se bloquea salvo `--ack-remove` / `--ack-placeholders` con las claves una a una (sin comodines). `--dry-run` solo valida.
|
|
127
|
+
- **export**: baja el catálogo de origen (`--source-locale`, por omisión `en`) y cada idioma de destino (`--locale`, por omisión todos los que existan; uno sin catálogo sale como plantilla vacía) en `--out` (un directorio, o un fichero si hay una sola salida; por omisión `translations/`). XLIFF: `<namespace>.<origen>-<destino>.xlf`; PO: `<namespace>.<destino>.po`; JSON plano: `<namespace>.<destino>.flat.json` (nunca pisa un `catalog@1`). Con `--draft` lee los borradores en lugar de la última revisión publicada.
|
|
128
|
+
- **import**: convierte el fichero (`--format auto` lo deduce de la extensión o del contenido) al catálogo `catalog@1` de destino, lo valida con el contrato (`--plan`) y con las comprobaciones de calidad, y lo guarda como BORRADOR con `revisionBase` y `draftVersion` del lock, exactamente como `push` (mismo `--create`, `--rebase`, `--ack-*`, 409 → exit 4). **Nunca publica sin `--publish`.** Las comprobaciones de calidad son avisos y se imprimen; con `--strict` los errores y avisos bloquean y no se envía nada. Un JSON plano toma namespace e idioma de `--namespace`/`--locale` o del nombre `<namespace>.<idioma>.json`, y se compara con el catálogo de origen de `--dir` si existe. Un XLIFF con `DOCTYPE`/entidades (XXE, «billion laughs»), un PO o JSON mal formado, un fichero que no es UTF-8 o que pasa de 8 MiB salen con código 1 antes de abrir ninguna conexión. `--dry-run` solo valida.
|
|
129
|
+
- **pseudo**: lee los catálogos del idioma de origen y escribe `<namespace>.<xx>.json` pseudo-localizados (acentos, +40 % de longitud, marcas `[!! … !!]`; `--rtl` los envuelve en marcas bidi). Las variables, `#` y la sintaxis de plural/select no se tocan, así que el resultado pasa `check`. Sin red.
|
|
130
|
+
- **status**: últimas revisiones por catálogo, releases, el ámbito de entrega (`GET /v1/scope`, con el que drena si hay rotación) y por canal `sequence`, `minSequence`, candidato y la caducidad del TIMESTAMP (`expiresAt`; el manifiesto v2 no caduca). `--warn-hours` por omisión es V/6 de la vigencia que anuncia el servicio (4 h con 24 h).
|
|
131
|
+
- **init**: lee `GET /v1/context` y escribe `customy.experience.json` (`scope`, `base`, `environmentId`, `channel`, `anchors` con roles y `floor` si el canal ya tiene release). Las claves públicas solo las ve quien tiene `experience.release.publish`; no pisa un fichero existente sin `--force`.
|
|
132
|
+
- **revoke**: `POST /v1/releases/:id/revoke` (`experience.release.kill`, motivo obligatorio). Sube `minSequence` de cada canal que lo servía y los reapunta al `--fallback` (obligatorio si algún canal lo sirve). Acepta el id o el número (`#7`). Tras revocar, comprueba el timestamp en la CDN (`CF-Cache-Status`).
|
|
133
|
+
- **scope**: `show` (`GET /v1/scope`), `rotate` y `retire` (`experience.scope.rotate`, motivo obligatorio al rotar; retirar antes de `drainsUntil` exige `--force`).
|
|
134
|
+
- **signing plan**: el plan de rotación de la clave de firma (`POST /v1/signing/rotation/plan`); no firma ni publica.
|
|
135
|
+
- **signing rotate**: publica UN paso de la rotación (`POST /v1/signing/rotation/step`, capacidad `experience.signing.rotate`): pide el plan para saber el conjunto nuevo y el servicio republica cada canal con un manifiesto que lleva `keys`, firmado por las claves vigentes no comprometidas (umbral de rotación 2). En producción responde 409 `approval_required`: el paso se pide con una solicitud `signing_rotate` de dos personas (Workspace → solicitudes). Un paso a medias sale 5; repítelo (es idempotente).
|
|
136
|
+
- **reconcile**: `POST /v1/channels/:canal/reconcile` tras restaurar la base (503 `storage_ahead_of_database`); en producción, con dos personas.
|
|
137
|
+
- Un `404` del servicio es igual para «no existe» y «sin permiso» (anti-oráculo): el CLI lo dice así y sale `3`.
|
|
138
|
+
- **check**: ICU válido, paridad entre idiomas (`parityReport`; `--locales` fija los obligatorios, `--base-locale` el de referencia) y, con `--src`, las claves usadas por el código (`t("a.b")`, `{ $t: "a.b" }`, `i18nKey="a.b"`; solo claves con punto) frente al catálogo base. `--fail-on-unused` convierte las claves sin uso en error. Además corre `checkCatalog` de cada idioma contra el base: variables, plurales, longitud, HTML, URLs y el glosario de `--glossary` (un arreglo de `{ term, translation?, forbidden?, doNotTranslate?, caseSensitive?, wholeWord?, locale? }`). Los errores fallan; los avisos (longitud, espacios, números…) se imprimen y solo fallan con `--strict`. Una categoría de plural que falta en el idioma (p. ej. `many` en `es`) es aviso, no error: el runtime cae a `other`.
|
|
139
|
+
- `--json`: un único documento en stdout. `--timeout MS` (30000 por omisión).
|
|
140
|
+
- **Códigos de salida:** `0` ok · `1` contenido inválido o `check` fallido (también 422) · `2` uso incorrecto · `3` credencial o capacidad rechazada (401/403) o recurso sin permiso/inexistente (404) · `4` conflicto (409: `stale_revision_base`, `draft_conflict`, `catalog_gate_blocked`, falta de base) · `5` red caída, tope de plan (402) o error del servidor.
|
|
141
|
+
- **Suposición sobre el BFF:** el servicio solo acepta al BFF del Workspace; el CLI usa su API pública prevista `<origen>/api/experience/*`, espejo 1:1 de `/v1/*` del registro (`artifacts`, `artifacts/:id/draft`, `artifacts/:id/revisions`, `releases`, `channels`), con `Authorization: Bearer`. Para `status` se espera `expiresAt` en cada canal (si falta, se muestra «desconocido»).
|
package/dist/bin.cjs
CHANGED
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
'use strict';
|
|
3
3
|
|
|
4
|
-
var
|
|
4
|
+
var chunk6X3AX6PB_cjs = require('./chunk-6X3AX6PB.cjs');
|
|
5
|
+
require('./chunk-2A6WFLXS.cjs');
|
|
5
6
|
var promises = require('readline/promises');
|
|
6
7
|
|
|
7
8
|
async function prompt(question) {
|
|
@@ -12,7 +13,10 @@ async function prompt(question) {
|
|
|
12
13
|
rl.close();
|
|
13
14
|
}
|
|
14
15
|
}
|
|
15
|
-
|
|
16
|
+
var interrupt = new AbortController();
|
|
17
|
+
process.once("SIGINT", () => interrupt.abort());
|
|
18
|
+
chunk6X3AX6PB_cjs.runCli(process.argv.slice(2), {
|
|
19
|
+
signal: interrupt.signal,
|
|
16
20
|
cwd: process.cwd(),
|
|
17
21
|
env: process.env,
|
|
18
22
|
out: (line) => console.log(line),
|
package/dist/bin.mjs
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import { runCli } from './chunk-
|
|
2
|
+
import { runCli } from './chunk-57NNDUEX.mjs';
|
|
3
|
+
import './chunk-QKIF4C5R.mjs';
|
|
3
4
|
import { createInterface } from 'readline/promises';
|
|
4
5
|
|
|
5
6
|
async function prompt(question) {
|
|
@@ -10,7 +11,10 @@ async function prompt(question) {
|
|
|
10
11
|
rl.close();
|
|
11
12
|
}
|
|
12
13
|
}
|
|
14
|
+
var interrupt = new AbortController();
|
|
15
|
+
process.once("SIGINT", () => interrupt.abort());
|
|
13
16
|
runCli(process.argv.slice(2), {
|
|
17
|
+
signal: interrupt.signal,
|
|
14
18
|
cwd: process.cwd(),
|
|
15
19
|
env: process.env,
|
|
16
20
|
out: (line) => console.log(line),
|
|
@@ -0,0 +1,235 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
|
|
3
|
+
var zod = require('zod');
|
|
4
|
+
|
|
5
|
+
// src/vendor/translation-catalog.ts
|
|
6
|
+
function utf8Bytes(text) {
|
|
7
|
+
const out = [];
|
|
8
|
+
for (let i = 0; i < text.length; i++) {
|
|
9
|
+
let c = text.charCodeAt(i);
|
|
10
|
+
if (c >= 55296 && c <= 56319 && i + 1 < text.length) {
|
|
11
|
+
const d = text.charCodeAt(i + 1);
|
|
12
|
+
if (d >= 56320 && d <= 57343) {
|
|
13
|
+
c = 65536 + (c - 55296 << 10) + (d - 56320);
|
|
14
|
+
i++;
|
|
15
|
+
} else c = 65533;
|
|
16
|
+
} else if (c >= 55296 && c <= 57343) c = 65533;
|
|
17
|
+
if (c < 128) out.push(c);
|
|
18
|
+
else if (c < 2048) out.push(192 | c >> 6, 128 | c & 63);
|
|
19
|
+
else if (c < 65536) out.push(224 | c >> 12, 128 | c >> 6 & 63, 128 | c & 63);
|
|
20
|
+
else out.push(240 | c >> 18, 128 | c >> 12 & 63, 128 | c >> 6 & 63, 128 | c & 63);
|
|
21
|
+
}
|
|
22
|
+
return Uint8Array.from(out);
|
|
23
|
+
}
|
|
24
|
+
var utf8Length = (text) => utf8Bytes(text).length;
|
|
25
|
+
|
|
26
|
+
// src/vendor/safe-input.ts
|
|
27
|
+
var hasOwnKey = (obj, key) => Object.prototype.hasOwnProperty.call(obj, key);
|
|
28
|
+
|
|
29
|
+
// src/vendor/translation-catalog.ts
|
|
30
|
+
var CATALOG_DOC_VERSION = "catalog@1";
|
|
31
|
+
var CATALOG_RESERVED_KEYS = ["constructor", "toString", "valueOf", "hasOwnProperty", "isPrototypeOf", "propertyIsEnumerable", "toLocaleString", "__proto__", "__defineGetter__", "__defineSetter__", "__lookupGetter__", "__lookupSetter__"];
|
|
32
|
+
var isReservedCatalogKey = (key) => CATALOG_RESERVED_KEYS.includes(key);
|
|
33
|
+
var CATALOG_KEY = /^(?!(?:constructor|toString|valueOf|hasOwnProperty|isPrototypeOf|propertyIsEnumerable|toLocaleString)$)[a-z][A-Za-z0-9]*(\.[a-z][A-Za-z0-9-]*)*$/;
|
|
34
|
+
var CATALOG_NAMESPACE = /^[a-z][a-z0-9-]{1,31}$/;
|
|
35
|
+
var CATALOG_LOCALE = /^[a-z]{2,3}(-[A-Za-z0-9]{2,8}){0,2}$/;
|
|
36
|
+
var CATALOG_SYNTAXES = ["icu1", "mf2"];
|
|
37
|
+
var SUPPORTED_CATALOG_SYNTAXES = ["icu1"];
|
|
38
|
+
var CATALOG_MAX_KEY_LENGTH = 120;
|
|
39
|
+
var CATALOG_MAX_MESSAGE_LENGTH = 2e3;
|
|
40
|
+
var TRANSLATION_PLAN_LIMITS = {
|
|
41
|
+
free: { keys: 200, locales: 2, revisions: 20, bytes: 32768 },
|
|
42
|
+
pro: { keys: 5e3, locales: 8, revisions: 200, bytes: 524288 },
|
|
43
|
+
enterprise: { keys: 5e4, locales: 40, revisions: 2e3, bytes: 4194304 }
|
|
44
|
+
};
|
|
45
|
+
var CatalogDocSchema = zod.z.object({
|
|
46
|
+
version: zod.z.literal(CATALOG_DOC_VERSION),
|
|
47
|
+
namespace: zod.z.string().regex(CATALOG_NAMESPACE),
|
|
48
|
+
locale: zod.z.string().regex(CATALOG_LOCALE),
|
|
49
|
+
syntax: zod.z.enum(CATALOG_SYNTAXES).default("icu1"),
|
|
50
|
+
messages: zod.z.record(zod.z.string(), zod.z.string())
|
|
51
|
+
}).strict();
|
|
52
|
+
var ARG_TYPES = /* @__PURE__ */ new Set(["number", "date", "time", "plural", "select", "selectordinal"]);
|
|
53
|
+
var NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;
|
|
54
|
+
function analyzeMessage(message) {
|
|
55
|
+
if (message.length > CATALOG_MAX_MESSAGE_LENGTH) return { ok: false, params: [], error: `el mensaje pasa de ${CATALOG_MAX_MESSAGE_LENGTH} caracteres` };
|
|
56
|
+
if (/[<>]/.test(message)) return { ok: false, params: [], error: "los mensajes no admiten HTML (< o >)" };
|
|
57
|
+
const params = /* @__PURE__ */ new Set();
|
|
58
|
+
let error = null;
|
|
59
|
+
let i = 0;
|
|
60
|
+
const parseText = (inPlural, depth) => {
|
|
61
|
+
while (i < message.length && !error) {
|
|
62
|
+
const c = message[i];
|
|
63
|
+
if (c === "'") {
|
|
64
|
+
if (message[i + 1] === "'") {
|
|
65
|
+
i += 2;
|
|
66
|
+
continue;
|
|
67
|
+
}
|
|
68
|
+
if (message[i + 1] === "{" || message[i + 1] === "}") {
|
|
69
|
+
const end = message.indexOf("'", i + 2);
|
|
70
|
+
i = end === -1 ? message.length : end + 1;
|
|
71
|
+
continue;
|
|
72
|
+
}
|
|
73
|
+
i += 1;
|
|
74
|
+
continue;
|
|
75
|
+
}
|
|
76
|
+
if (c === "}") {
|
|
77
|
+
if (depth === 0) error = "llave de cierre sin abrir";
|
|
78
|
+
return;
|
|
79
|
+
}
|
|
80
|
+
if (c === "{") {
|
|
81
|
+
i += 1;
|
|
82
|
+
parseArgument(depth + 1);
|
|
83
|
+
continue;
|
|
84
|
+
}
|
|
85
|
+
if (c === "#" && inPlural) {
|
|
86
|
+
i += 1;
|
|
87
|
+
continue;
|
|
88
|
+
}
|
|
89
|
+
i += 1;
|
|
90
|
+
}
|
|
91
|
+
};
|
|
92
|
+
const parseArgument = (depth) => {
|
|
93
|
+
const start = i;
|
|
94
|
+
while (i < message.length && message[i] !== "}" && message[i] !== ",") i += 1;
|
|
95
|
+
const name = message.slice(start, i).trim();
|
|
96
|
+
if (!NAME.test(name)) {
|
|
97
|
+
error = `nombre de variable no v\xE1lido \xAB${name}\xBB`;
|
|
98
|
+
return;
|
|
99
|
+
}
|
|
100
|
+
params.add(name);
|
|
101
|
+
if (message[i] === "}") {
|
|
102
|
+
i += 1;
|
|
103
|
+
return;
|
|
104
|
+
}
|
|
105
|
+
if (i >= message.length) {
|
|
106
|
+
error = "falta cerrar una llave";
|
|
107
|
+
return;
|
|
108
|
+
}
|
|
109
|
+
i += 1;
|
|
110
|
+
const tstart = i;
|
|
111
|
+
while (i < message.length && message[i] !== "}" && message[i] !== ",") i += 1;
|
|
112
|
+
const type = message.slice(tstart, i).trim();
|
|
113
|
+
if (!ARG_TYPES.has(type)) {
|
|
114
|
+
error = `tipo \xAB${type}\xBB no admitido`;
|
|
115
|
+
return;
|
|
116
|
+
}
|
|
117
|
+
if (message[i] === "}") {
|
|
118
|
+
if (type === "plural" || type === "select" || type === "selectordinal") error = `\xAB${type}\xBB necesita opciones`;
|
|
119
|
+
else i += 1;
|
|
120
|
+
return;
|
|
121
|
+
}
|
|
122
|
+
i += 1;
|
|
123
|
+
if (type !== "plural" && type !== "select" && type !== "selectordinal") {
|
|
124
|
+
const style = message.indexOf("}", i);
|
|
125
|
+
if (style === -1) {
|
|
126
|
+
error = "falta cerrar una llave";
|
|
127
|
+
return;
|
|
128
|
+
}
|
|
129
|
+
i = style + 1;
|
|
130
|
+
return;
|
|
131
|
+
}
|
|
132
|
+
let hasOther = false;
|
|
133
|
+
while (i < message.length && !error) {
|
|
134
|
+
while (message[i] === " " || message[i] === "\n" || message[i] === " ") i += 1;
|
|
135
|
+
if (message[i] === "}") {
|
|
136
|
+
i += 1;
|
|
137
|
+
if (!hasOther) error = `\xAB${type}\xBB de \xAB${name}\xBB necesita la opci\xF3n other`;
|
|
138
|
+
return;
|
|
139
|
+
}
|
|
140
|
+
const ostart = i;
|
|
141
|
+
while (i < message.length && message[i] !== "{" && message[i] !== "}" && !/\s/.test(message[i])) i += 1;
|
|
142
|
+
const option = message.slice(ostart, i);
|
|
143
|
+
while (message[i] === " ") i += 1;
|
|
144
|
+
if (!option || message[i] !== "{") {
|
|
145
|
+
error = `opci\xF3n mal formada en \xAB${name}\xBB`;
|
|
146
|
+
return;
|
|
147
|
+
}
|
|
148
|
+
if (option === "other") hasOther = true;
|
|
149
|
+
i += 1;
|
|
150
|
+
parseText(type !== "select", depth);
|
|
151
|
+
if (error) return;
|
|
152
|
+
if (message[i] !== "}") {
|
|
153
|
+
error = "falta cerrar una llave";
|
|
154
|
+
return;
|
|
155
|
+
}
|
|
156
|
+
i += 1;
|
|
157
|
+
}
|
|
158
|
+
if (!error) error = "falta cerrar una llave";
|
|
159
|
+
};
|
|
160
|
+
parseText(false, 0);
|
|
161
|
+
if (!error && i < message.length) error = "llave de cierre sin abrir";
|
|
162
|
+
return { ok: error === null, params: [...params].sort(), error };
|
|
163
|
+
}
|
|
164
|
+
function validateCatalog(input, options = {}) {
|
|
165
|
+
try {
|
|
166
|
+
return validateCatalogUnsafe(input, options);
|
|
167
|
+
} catch {
|
|
168
|
+
return { ok: false, doc: null, issues: [{ path: "", code: "invalid-shape", message: "el cat\xE1logo no se pudo analizar" }] };
|
|
169
|
+
}
|
|
170
|
+
}
|
|
171
|
+
function validateCatalogUnsafe(input, options) {
|
|
172
|
+
const limits = options.limits ?? TRANSLATION_PLAN_LIMITS.pro;
|
|
173
|
+
const issues = [];
|
|
174
|
+
try {
|
|
175
|
+
let bytes = 0;
|
|
176
|
+
try {
|
|
177
|
+
bytes = utf8Length(JSON.stringify(input) ?? "");
|
|
178
|
+
} catch {
|
|
179
|
+
return { ok: false, doc: null, issues: [{ path: "", code: "invalid-shape", message: "el cat\xE1logo no es JSON o est\xE1 anidado en exceso" }] };
|
|
180
|
+
}
|
|
181
|
+
if (bytes > limits.bytes) return { ok: false, doc: null, issues: [{ path: "", code: "too-large", message: `el cat\xE1logo pesa ${bytes} bytes (m\xE1ximo ${limits.bytes})` }] };
|
|
182
|
+
const parsed = CatalogDocSchema.safeParse(input);
|
|
183
|
+
if (!parsed.success) return { ok: false, doc: null, issues: parsed.error.issues.slice(0, 20).map((i) => ({ path: i.path.join("."), code: "invalid-shape", message: i.message })) };
|
|
184
|
+
const doc = parsed.data;
|
|
185
|
+
if (!SUPPORTED_CATALOG_SYNTAXES.includes(doc.syntax)) return { ok: false, doc: null, issues: [{ path: "syntax", code: "unsupported-syntax", message: `la sintaxis \xAB${doc.syntax}\xBB todav\xEDa no est\xE1 soportada` }] };
|
|
186
|
+
const rawMessages = input.messages;
|
|
187
|
+
if (typeof rawMessages === "object" && rawMessages !== null && hasOwnKey(rawMessages, "__proto__")) issues.push({ path: "messages.__proto__", code: "invalid-key", message: "clave reservada \xAB__proto__\xBB: coincide con un nombre de Object.prototype" });
|
|
188
|
+
const keys = Object.keys(doc.messages);
|
|
189
|
+
if (keys.length > limits.keys) issues.push({ path: "messages", code: "too-many-keys", message: `m\xE1s de ${limits.keys} claves` });
|
|
190
|
+
for (const key of keys) {
|
|
191
|
+
if (isReservedCatalogKey(key)) {
|
|
192
|
+
issues.push({ path: `messages.${key}`, code: "invalid-key", message: `clave reservada \xAB${key}\xBB: coincide con un nombre de Object.prototype (ren\xF3mbrala, p. ej. \xAB${key}Label\xBB)` });
|
|
193
|
+
continue;
|
|
194
|
+
}
|
|
195
|
+
if (key.length > CATALOG_MAX_KEY_LENGTH || !CATALOG_KEY.test(key)) {
|
|
196
|
+
issues.push({ path: `messages.${key}`, code: "invalid-key", message: "clave no v\xE1lida (min\xFAscula inicial, segmentos con puntos, sin espacios)" });
|
|
197
|
+
continue;
|
|
198
|
+
}
|
|
199
|
+
const a = analyzeMessage(doc.messages[key]);
|
|
200
|
+
if (!a.ok) issues.push({ path: `messages.${key}`, code: "invalid-message", message: a.error ?? "mensaje no v\xE1lido" });
|
|
201
|
+
}
|
|
202
|
+
return { ok: issues.length === 0, doc: issues.length === 0 ? doc : null, issues };
|
|
203
|
+
} catch {
|
|
204
|
+
return { ok: false, doc: null, issues: [{ path: "", code: "invalid-shape", message: "el cat\xE1logo no se pudo analizar" }] };
|
|
205
|
+
}
|
|
206
|
+
}
|
|
207
|
+
function parityReport(byLocale, required, base = required[0] ?? "en") {
|
|
208
|
+
const all = /* @__PURE__ */ new Set();
|
|
209
|
+
for (const messages of Object.values(byLocale)) for (const key of Object.keys(messages)) all.add(key);
|
|
210
|
+
const missing = {};
|
|
211
|
+
const placeholderMismatch = [];
|
|
212
|
+
const baseMessages = hasOwnKey(byLocale, base) ? byLocale[base] : {};
|
|
213
|
+
for (const locale of required) {
|
|
214
|
+
const messages = hasOwnKey(byLocale, locale) ? byLocale[locale] : {};
|
|
215
|
+
const gone = [...all].filter((key) => !hasOwnKey(messages, key) || typeof messages[key] !== "string" || !messages[key].trim()).sort();
|
|
216
|
+
if (gone.length) missing[locale] = gone;
|
|
217
|
+
if (locale === base) continue;
|
|
218
|
+
for (const key of Object.keys(messages).sort()) {
|
|
219
|
+
if (!hasOwnKey(baseMessages, key)) continue;
|
|
220
|
+
const expected = analyzeMessage(baseMessages[key]).params;
|
|
221
|
+
const got = analyzeMessage(messages[key]).params;
|
|
222
|
+
if (expected.join("|") !== got.join("|")) placeholderMismatch.push({ key, locale, expected, got });
|
|
223
|
+
}
|
|
224
|
+
}
|
|
225
|
+
return { ok: Object.keys(missing).length === 0 && placeholderMismatch.length === 0, missing, placeholderMismatch };
|
|
226
|
+
}
|
|
227
|
+
|
|
228
|
+
exports.CATALOG_DOC_VERSION = CATALOG_DOC_VERSION;
|
|
229
|
+
exports.CATALOG_KEY = CATALOG_KEY;
|
|
230
|
+
exports.CATALOG_LOCALE = CATALOG_LOCALE;
|
|
231
|
+
exports.CATALOG_NAMESPACE = CATALOG_NAMESPACE;
|
|
232
|
+
exports.TRANSLATION_PLAN_LIMITS = TRANSLATION_PLAN_LIMITS;
|
|
233
|
+
exports.analyzeMessage = analyzeMessage;
|
|
234
|
+
exports.parityReport = parityReport;
|
|
235
|
+
exports.validateCatalog = validateCatalog;
|