app/templates/RESTlet.html.j2

{% extends "base.html.j2" %}
{% import "components.html.j2" as ui %}

{% block content %}

{# =========================
   VALIDACIÓN RAÍZ REAL
   ========================= #}
{% if not (doc and doc is mapping) %}
  <div class="alert alert-error">
    <strong>Error:</strong> El documento recibido no tiene una estructura válida.
  </div>
{% else %}

<header class="doc-header">
  <h1>
    RESTlet ·
    {{ doc.metadata.description
       if doc.metadata and doc.metadata.description
       else doc.metadata.script_type
       if doc.metadata
       else "Documento sin metadata" }}
  </h1>
  <p class="doc-header-meta">
    SuiteScript {{ doc.metadata.suitescript_version if doc.metadata else "N/D" }}
  </p>
  <p class="muted">Documentación técnica del servicio RESTlet.</p>
</header>

{% if doc.metadata %}
  {{ ui.metadata_block(doc.metadata) }}
{% else %}
  <p class="muted">No se proporcionó metadata.</p>
{% endif %}

{% if doc.summary %}
  {{ ui.summary_block(doc.summary) }}
{% endif %}

{# ============================================================
   ENDPOINTS
   ============================================================ #}
{% set endpoints = doc.endpoints if doc.endpoints and doc.endpoints is mapping else {} %}

<div class="section">
  <h2>Endpoints</h2>

  {% if endpoints|length == 0 %}
    <p class="muted">No se definieron endpoints.</p>
  {% else %}
    {% for method, definition in endpoints.items() %}
      <h3>{{ method|upper }}</h3>

      {% if not (definition and definition is mapping) %}
        <p class="muted">Definición inválida o no estructurada.</p>
      {% else %}

        {% if definition.description %}
          <p>{{ definition.description }}</p>
        {% endif %}

        {# ---------------- INPUTS ---------------- #}
        {% set inputs = definition.inputs if definition.inputs and definition.inputs is mapping else {} %}
        {% if inputs|length == 0 %}
          <p class="muted">No se definieron inputs.</p>
        {% else %}
          {% if inputs.url_params %}
            {{ ui.table_block("URL params", inputs.url_params, [
              {"field": "name", "title": "Nombre"},
              {"field": "description", "title": "Descripción"},
              {"field": "type", "title": "Tipo"}
            ]) }}
          {% endif %}

          {% if inputs.query_string %}
            {{ ui.table_block("Query string", inputs.query_string, [
              {"field": "name", "title": "Nombre"},
              {"field": "description", "title": "Descripción"},
              {"field": "type", "title": "Tipo"}
            ]) }}
          {% endif %}

          {% if inputs.body_fields %}
            {{ ui.table_block("Body", inputs.body_fields, [
              {"field": "name", "title": "Nombre"},
              {"field": "description", "title": "Descripción"},
              {"field": "type", "title": "Tipo"}
            ]) }}
          {% endif %}
        {% endif %}

        {# ---------------- LÓGICA ---------------- #}
        {% if definition.logic %}
          {{ ui.logic_block("Lógica", definition.logic) }}
        {% else %}
          <p class="muted">No se documentó la lógica.</p>
        {% endif %}

        {# ---------------- OPERACIONES ---------------- #}
        {% if definition.record_operations %}
          {{ ui.table_block("Operaciones sobre registros", definition.record_operations, [
            {"field": "type", "title": "Operación"},
            {"field": "recordType", "title": "Record"},
            {"field": "details", "title": "Detalles"}
          ]) }}
        {% endif %}

        {# ---------------- BÚSQUEDAS ---------------- #}
        {% if definition.searches %}
          {{ ui.table_block("Búsquedas", definition.searches, [
            {"field": "id", "title": "ID"},
            {"field": "filters", "title": "Filtros"},
            {"field": "columns", "title": "Columnas"}
          ]) }}
        {% endif %}

        {# ---------------- OUTPUT ---------------- #}
        {% if definition.output %}
          {{ ui.logic_block("Salida", definition.output) }}
        {% else %}
          <p class="muted">No se definió salida.</p>
        {% endif %}

        {# ---------------- VALIDACIONES ---------------- #}
        {% if definition.validations %}
          {{ ui.list_block("Validaciones", definition.validations) }}
        {% endif %}

        {# ---------------- SIDE EFFECTS ---------------- #}
        {% if definition.side_effects %}
          {{ ui.list_block("Side effects", definition.side_effects) }}
        {% endif %}

      {% endif %}
    {% endfor %}
  {% endif %}
</div>

{# ================= VALIDACIONES GLOBALES ================= #}
{% if doc.validations %}
  {{ ui.list_block("Validaciones globales", doc.validations) }}
{% endif %}

{# ================= ERRORES ================= #}
{% if doc.errors %}
  {{ ui.table_block("Errores", doc.errors, [
    {"field": "location", "title": "Ubicación"},
    {"field": "description", "title": "Descripción"},
    {"field": "throws", "title": "Excepción"}
  ]) }}
{% endif %}

{# ================= SIDE EFFECTS GLOBALES ================= #}
{% if doc.side_effects %}
  {{ ui.list_block("Side effects globales", doc.side_effects) }}
{% endif %}

{% endif %}
{% endblock %}