@wevion/cli 1.0.3772 → 1.0.3774

package/openapi.json

@@ -171086,6 +171086,139 @@
         }
       }
     },
+    "/api/v1/referral/offer": {
+      "get": {
+        "operationId": "getReferralOffer",
+        "summary": "L’offerta che mi aspetta al primo checkout",
+        "tags": [
+          "partner"
+        ],
+        "description": "L’offerta del programma partner che aspetta il richiedente al suo primo checkout, per mostrarla PRIMA di Stripe (pagina piani, onboarding). 204 quando non ce n’e’ una: il richiedente non e’ un referito tracciato, il vantaggio e’ gia’ stato erogato, il programma e’ spento o congelato, oppure il catalogo del livello non e’ seminato (nessuna riga attiva: la promessa non potrebbe essere mantenuta al checkout). Non e’ un errore e non distingue i casi: la superficie mostra i prezzi pieni, come oggi.",
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "L’offerta del programma partner che verra’ applicata al PRIMO checkout del richiedente. E’ la stessa risoluzione che il checkout esegue (`resolveRefereeLevel`), e risponde solo se il catalogo del livello ha almeno una riga attiva: se qui c’e’, al checkout il coupon entra in `discounts[]`, salvo una riga mancante per il singolo piano, intervallo o valuta scelti, che e’ un seed interrotto.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "L’offerta del programma partner che verra’ applicata al PRIMO checkout del richiedente. E’ la stessa risoluzione che il checkout esegue (`resolveRefereeLevel`), e risponde solo se il catalogo del livello ha almeno una riga attiva: se qui c’e’, al checkout il coupon entra in `discounts[]`, salvo una riga mancante per il singolo piano, intervallo o valuta scelti, che e’ un seed interrotto.",
+                  "type": "object",
+                  "required": [
+                    "cap_minor",
+                    "discount_bp",
+                    "duration",
+                    "duration_in_months",
+                    "level"
+                  ],
+                  "properties": {
+                    "cap_minor": {
+                      "description": "Tetto dello sconto in minor units NELLA valuta di fatturazione, come stringa (bigint).",
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "discount_bp": {
+                      "description": "Sconto in basis point (3000 = 30%).",
+                      "anyOf": [
+                        {
+                          "type": "integer"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "duration": {
+                      "description": "`once` = sulla prima fattura · `repeating` = per `duration_in_months` mesi.",
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "enum": [
+                            "once"
+                          ]
+                        },
+                        {
+                          "type": "string",
+                          "enum": [
+                            "repeating"
+                          ]
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "duration_in_months": {
+                      "description": "Mesi di validita’ quando `duration` e’ `repeating`.",
+                      "anyOf": [
+                        {
+                          "type": "integer"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "level": {
+                      "description": "Livello di catalogo (`partner_coupon.catalog_level`) che scattera’ al checkout.",
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "204": {
+            "description": "Nessuna offerta in attesa per il richiedente."
+          },
+          "401": {
+            "description": "Errore standard del backend.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "Errore standard del backend.",
+                  "type": "object",
+                  "required": [
+                    "error",
+                    "message",
+                    "statusCode"
+                  ],
+                  "properties": {
+                    "code": {
+                      "description": "Codice macchina dell’errore, quando disponibile.",
+                      "type": "string"
+                    },
+                    "error": {
+                      "description": "Etichetta breve dell’errore.",
+                      "type": "string"
+                    },
+                    "message": {
+                      "description": "Messaggio leggibile.",
+                      "type": "string"
+                    },
+                    "statusCode": {
+                      "description": "Codice di stato HTTP ripetuto nel corpo.",
+                      "type": "integer"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/api/v1/referral/disclosure": {
       "put": {
         "operationId": "setReferralDisclosure",
@@ -182419,6 +182552,293 @@
         }
       }
     },
+    "/api/v1/public/contact-request": {
+      "post": {
+        "operationId": "createSiteContactRequest",
+        "summary": "Richiesta di contatto dal sito",
+        "tags": [
+          "public"
+        ],
+        "description": "Registra una richiesta dai moduli pubblici del sito (`contact`, `get_started`) e la consegna a Customer.io attraverso l’outbox durevole. Rotta PUBBLICA: nessun login, nessuna sessione aperta. ★ Risponde SEMPRE 202 con lo stesso corpo — anche a un invio identico ripetuto entro 10 minuti e al campo trappola `website` compilato — perché la risposta non deve confermare niente su un’email. Il modulo `contact` pretende `first_name`, `company` e `topic`; `get_started` solo l’email, e rifiuta `topic`. Un campo sconosciuto è un 400. Limite: 5 invii ogni 10 minuti per IP (429).",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "additionalProperties": false,
+                "type": "object",
+                "required": [
+                  "email",
+                  "form"
+                ],
+                "properties": {
+                  "attribution": {
+                    "additionalProperties": false,
+                    "description": "Provenienza della visita: i parametri utm e il referral, mai l’URL intero.",
+                    "type": "object",
+                    "properties": {
+                      "ref": {
+                        "description": "Codice referral letto dal sito.",
+                        "maxLength": 64,
+                        "type": "string"
+                      },
+                      "utm_campaign": {
+                        "maxLength": 120,
+                        "type": "string"
+                      },
+                      "utm_content": {
+                        "maxLength": 120,
+                        "type": "string"
+                      },
+                      "utm_medium": {
+                        "maxLength": 120,
+                        "type": "string"
+                      },
+                      "utm_source": {
+                        "maxLength": 120,
+                        "type": "string"
+                      },
+                      "utm_term": {
+                        "maxLength": 120,
+                        "type": "string"
+                      }
+                    }
+                  },
+                  "company": {
+                    "description": "Azienda. Obbligatoria per `contact`.",
+                    "maxLength": 200,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "email": {
+                    "description": "Email di contatto, senza spazi intorno.",
+                    "format": "email",
+                    "maxLength": 320,
+                    "type": "string"
+                  },
+                  "first_name": {
+                    "description": "Nome. Obbligatorio per `contact`.",
+                    "maxLength": 100,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "form": {
+                    "description": "Il modulo di partenza: `contact` (pagina contatti) o `get_started` (pagina di prova).",
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "enum": [
+                          "contact"
+                        ]
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          "get_started"
+                        ]
+                      }
+                    ]
+                  },
+                  "last_name": {
+                    "maxLength": 100,
+                    "type": "string"
+                  },
+                  "locale": {
+                    "description": "Lingua della pagina, es. `it` o `zh-CN`.",
+                    "maxLength": 10,
+                    "pattern": "^[a-z]{2}(-[A-Z]{2})?$",
+                    "type": "string"
+                  },
+                  "message": {
+                    "maxLength": 5000,
+                    "type": "string"
+                  },
+                  "page_path": {
+                    "description": "Percorso della pagina, senza dominio né query.",
+                    "maxLength": 500,
+                    "pattern": "^/[^?#]*$",
+                    "type": "string"
+                  },
+                  "topic": {
+                    "description": "Argomento scelto nel modulo contatti. Obbligatorio per `contact`, vietato per `get_started`.",
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "enum": [
+                          "general_inquiry"
+                        ]
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          "custom_plan"
+                        ]
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          "product_walkthrough"
+                        ]
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          "founding_partner_request"
+                        ]
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          "partner_program"
+                        ]
+                      }
+                    ]
+                  },
+                  "website": {
+                    "description": "Campo trappola: il modulo lo nasconde agli umani. Deve arrivare vuoto o non arrivare.",
+                    "maxLength": 200,
+                    "type": "string"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "202": {
+            "description": "Accepted - processing asynchronously",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "status"
+                  ],
+                  "properties": {
+                    "status": {
+                      "description": "Sempre `received`: la risposta non dice se l’invio era doppio, se l’email era nota o se era un bot.",
+                      "type": "string",
+                      "enum": [
+                        "received"
+                      ]
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid request - schema validation failed",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "type": "integer"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "code": {
+                      "type": "string"
+                    },
+                    "request_id": {
+                      "type": "string"
+                    },
+                    "details": {
+                      "type": "object",
+                      "additionalProperties": {}
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "429": {
+            "description": "Too many requests - rate limit exceeded",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "type": "integer"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "code": {
+                      "type": "string"
+                    },
+                    "request_id": {
+                      "type": "string"
+                    },
+                    "details": {
+                      "type": "object",
+                      "additionalProperties": {}
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Internal server error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "type": "integer"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "code": {
+                      "type": "string"
+                    },
+                    "request_id": {
+                      "type": "string"
+                    },
+                    "details": {
+                      "type": "object",
+                      "additionalProperties": {}
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/api/v1/public/site-config": {
       "get": {
         "operationId": "getPublicSiteConfig",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wevion/cli",
-  "version": "1.0.3772",
+  "version": "1.0.3774",
   "description": "Wevion API command-line interface — generated from the public OpenAPI spec",
   "type": "module",
   "bin": {