iatoolkit 2.77.8__tar.gz → 2.77.10__tar.gz

{iatoolkit-2.77.8/src/iatoolkit.egg-info → iatoolkit-2.77.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: iatoolkit
-Version: 2.77.8
+Version: 2.77.10
 Summary: IAToolkit
 Author: Fernando Libedinsky
 License-Expression: MIT

{iatoolkit-2.77.8 → iatoolkit-2.77.10}/src/iatoolkit/__init__.py

@@ -3,7 +3,7 @@
 #
 # IAToolkit is open source software.
 
-__version__ = "2.77.8"
+__version__ = "2.77.10"
 
 # Expose main classes and functions at the top level of the package
 

{iatoolkit-2.77.8 → iatoolkit-2.77.10}/src/iatoolkit/common/interfaces/signup_policy_resolver.py

@@ -38,6 +38,14 @@ class SignupPolicyResolver(ABC):
     def invitation_email(self, company_short_name: str, invite_token: str | None) -> str | None:
         return None
 
+    def invitation_status(self, company_short_name: str, invite_token: str | None) -> str | None:
+        """Why an invitation link does or does not work.
+
+        One of ``pending``, ``expired``, ``used``, ``superseded``, ``revoked`` or
+        ``invalid``; ``None`` when the resolver does not track invitations.
+        """
+        return None
+
     def claim_signup(
         self,
         company_short_name: str,

{iatoolkit-2.77.8 → iatoolkit-2.77.10}/src/iatoolkit/locales/en.yaml

@@ -330,6 +330,24 @@ ui:
     login_link: "Log In"
     disclaimer: "🔒We value your privacy. Your data will be used exclusively for the operation of the platform."
 
+  invitation_invalid:
+    page_title: "Invitation unavailable"
+    company_label: "Company"
+    expired_title: "This invitation has expired"
+    expired_message: "Invitation links are valid for 7 days. Ask your administrator to send you a new one."
+    used_title: "This invitation was already used"
+    used_message: "An account was already created with this invitation. If it is yours, just sign in."
+    superseded_title: "This link was replaced by a newer invitation"
+    superseded_message: "Your administrator sent you a more recent invitation. Open the link in the latest invitation email."
+    revoked_title: "This invitation was cancelled"
+    revoked_message: "Your administrator cancelled this invitation. Ask them for a new one if you still need access."
+    invalid_title: "We couldn't recognize this invitation link"
+    invalid_message: "The link may be incomplete or mistyped. Open it again from the invitation email, or ask your administrator for a new one."
+    missing_title: "You need an invitation to join"
+    missing_message: "{company_name} only accepts new members by invitation. Ask your administrator to send you one."
+    login_button: "Go to sign in"
+    help_text: "Need help? Contact the administrator of {company_name}."
+
   forgot_password:
     title: "Recover Password"
     subtitle: "Enter your email address and we will send you a link to reset your password."

{iatoolkit-2.77.8 → iatoolkit-2.77.10}/src/iatoolkit/locales/es.yaml

@@ -344,6 +344,24 @@ ui:
     login_link: "Inicia Sesión"
     disclaimer: "🔒 Valoramos tu privacidad. Tus datos se usarán exclusivamente para el funcionamiento de la plataforma."
 
+  invitation_invalid:
+    page_title: "Invitación no disponible"
+    company_label: "Empresa"
+    expired_title: "Esta invitación expiró"
+    expired_message: "Los enlaces de invitación duran 7 días. Pide a tu administrador que te envíe uno nuevo."
+    used_title: "Esta invitación ya fue utilizada"
+    used_message: "Ya se creó una cuenta con esta invitación. Si es tuya, solo inicia sesión."
+    superseded_title: "Este enlace fue reemplazado por una invitación más reciente"
+    superseded_message: "Tu administrador te envió una invitación más nueva. Abre el enlace del último correo de invitación."
+    revoked_title: "Esta invitación fue cancelada"
+    revoked_message: "Tu administrador canceló esta invitación. Si todavía necesitas acceso, pídele una nueva."
+    invalid_title: "No reconocemos este enlace de invitación"
+    invalid_message: "Puede que el enlace esté incompleto o mal copiado. Ábrelo de nuevo desde el correo de invitación, o pide uno nuevo a tu administrador."
+    missing_title: "Necesitas una invitación para unirte"
+    missing_message: "{company_name} solo acepta nuevos miembros por invitación. Pide a tu administrador que te envíe una."
+    login_button: "Ir a iniciar sesión"
+    help_text: "¿Necesitas ayuda? Contacta al administrador de {company_name}."
+
   forgot_password:
     title: "Recuperar Contraseña"
     subtitle: "Ingresa tu correo electrónico y te enviaremos un enlace para restablecer tu contraseña."

{iatoolkit-2.77.8 → iatoolkit-2.77.10}/src/iatoolkit/services/profile_service.py

@@ -79,6 +79,19 @@ class ProfileService:
         )
         return required, email
 
+    INVITATION_STATUSES = ("pending", "expired", "used", "superseded", "revoked", "invalid")
+
+    def signup_invitation_status(self, company_short_name: str, invite_token: str | None) -> str:
+        """Why a signup link cannot be used, so the page can say it plainly.
+
+        ``missing`` when the link has no token at all; otherwise the resolver's
+        reading of the token, ``invalid`` when it cannot tell.
+        """
+        if not invite_token:
+            return "missing"
+        status = self.signup_policy_resolver.invitation_status(company_short_name, invite_token)
+        return status if status in self.INVITATION_STATUSES else "invalid"
+
     @staticmethod
     def _normalize_name_value(value: str | None, fallback: str) -> str:
         text = str(value or "").strip()

iatoolkit-2.77.10/src/iatoolkit/templates/invitation_invalid.html

@@ -0,0 +1,61 @@
+{% extends "base.html" %}
+
+{% block title %}{{ t('ui.invitation_invalid.page_title') }} - {{ company_name }}{% endblock %}
+
+{% block styles %}
+{% if branding %}
+    <style>
+        {{ branding.css_variables | safe }}
+    </style>
+{% endif %}
+    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.11.3/font/bootstrap-icons.min.css">
+{% endblock %}
+
+{% block content %}
+{# Shown when a signup link cannot be used: expired, already used, replaced,
+   cancelled, unrecognized or missing. It is an expected outcome, so it reads
+   as guidance (what happened, what to do next), never as a server error. #}
+{% set icons = {
+    'expired': 'bi-hourglass-bottom',
+    'used': 'bi-person-check',
+    'superseded': 'bi-envelope-arrow-up',
+    'revoked': 'bi-envelope-slash',
+    'invalid': 'bi-link-45deg',
+    'missing': 'bi-envelope-paper',
+} %}
+{% set login_lang = lang or 'en' %}
+<div class="container mt-4">
+
+{% include '_company_header.html' %}
+
+<div class="container mt-5">
+    <div class="row justify-content-center">
+        <div class="col-md-8 col-lg-6">
+            <div class="card shadow-sm text-center" data-invitation-status="{{ status }}">
+                <div class="card-body p-4 p-md-5">
+
+                    <i class="bi {{ icons.get(status, 'bi-envelope-paper') }}"
+                       style="font-size: 3.5rem; color: var(--brand-primary-color, #6c757d);"
+                       aria-hidden="true"></i>
+
+                    <h4 class="card-title mt-4">{{ t('ui.invitation_invalid.' ~ status ~ '_title') }}</h4>
+
+                    <p class="text-muted mt-3 mb-4" style="text-align: center;">
+                        {{ t('ui.invitation_invalid.' ~ status ~ '_message', company_name=company_name) }}
+                    </p>
+
+                    <a href="{{ url_for('home', company_short_name=company_short_name, lang=login_lang) }}"
+                       class="btn btn-branded-primary px-4">
+                        {{ t('ui.invitation_invalid.login_button') }}
+                    </a>
+
+                    <p class="text-muted small mt-4 mb-0" style="text-align: center;">
+                        {{ t('ui.invitation_invalid.help_text', company_name=company_name) }}
+                    </p>
+                </div>
+            </div>
+        </div>
+    </div>
+</div>
+</div>
+{% endblock %}

{iatoolkit-2.77.8 → iatoolkit-2.77.10}/src/iatoolkit/views/signup_view.py

@@ -43,9 +43,19 @@ class SignupView(MethodView):
             invitation_context if isinstance(invitation_context, tuple) else (False, None)
         )
         if invitation_required and not invited_email:
+            # An unusable invitation is an expected outcome, not a server error:
+            # say which case it is and point the person to sign in or to their admin.
+            status = self.profile_service.signup_invitation_status(company_short_name, invite_token)
+            if status == "pending":
+                status = "invalid"
+            company_name = (branding_data or {}).get("name") or company.name or company_short_name
             response = make_response(render_template(
-                'error.html',
-                message=self.i18n_service.t('errors.signup.invitation_required'),
+                'invitation_invalid.html',
+                company_short_name=company_short_name,
+                branding=branding_data,
+                lang=current_lang,
+                status=status,
+                company_name=company_name,
             ), 403)
             response.headers['Referrer-Policy'] = 'no-referrer'
             response.headers['Cache-Control'] = 'no-store'

{iatoolkit-2.77.8 → iatoolkit-2.77.10/src/iatoolkit.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: iatoolkit
-Version: 2.77.8
+Version: 2.77.10
 Summary: IAToolkit
 Author: Fernando Libedinsky
 License-Expression: MIT

{iatoolkit-2.77.8 → iatoolkit-2.77.10}/src/iatoolkit.egg-info/SOURCES.txt

@@ -240,6 +240,7 @@ src/iatoolkit/templates/chat_modals.html
 src/iatoolkit/templates/error.html
 src/iatoolkit/templates/forgot_password.html
 src/iatoolkit/templates/home_hosted_default.html
+src/iatoolkit/templates/invitation_invalid.html
 src/iatoolkit/templates/login_global.html
 src/iatoolkit/templates/signup.html
 src/iatoolkit/templates/wiki_page.html