Envolver cada línea con texto

La entrada vacía o solo de espacios se rechaza con un error invalid_input claro para que un formulario en blanco nunca parezca un envoltorio correcto. El camino es lógica de cadenas pura y determinista—sin red, sin semillas aleatorias, sin dependencia del reloj—de modo que el ejecutor gratuito del navegador y la API prepaga devuelven el mismo JSON cada vez que la invoca.

Qué significa envolver cada línea y cuándo conviene

Los valores por omisión usan una comilla doble recta a ambos lados, de modo que tres nombres se convierten en tres nombres entrecomillados, listos para pegar en JSON, CSV o un archivo de configuración. Cuando skip_empty es true, una línea de longitud cero permanece vacía para que los huecos de párrafo sobrevivan mientras se envuelven las líneas con contenido. La entrada completa vacía o solo de espacios es un error duro: no hay un documento envuelto significativo que devolver, y quien llama debe tratarlo como invalid_input y no como un éxito de cero líneas.

Cómo llamar a la API y qué contiene la respuesta

Si envía una cadena vacía explícita en un lado, ese lado permanece vacío para que pueda anteponer solo o posponer solo. Si ambos lados resultan cadenas vacías, la llamada se rechaza, porque envolver con nada no es un envoltorio. Prefiera enviar el cuerpo multilínea en bruto en lugar de unirlo de antemano si desea semántica real por línea. Envíe un cuerpo JSON con un campo string obligatorio text (alias input, value, string, s, content y body). Incluya de forma opcional prefix (alias pre y left) y suffix (alias post y right) como cadenas de sesenta y cuatro caracteres como máximo cada una, y skip_empty (alias skip_blank, ignore_empty y skip_blanks) como boolean. Si se omite prefix o suffix, cada uno toma por omisión una comilla doble recta. El valor de text debe ser no vacío tras recortar los espacios generales y no debe superar cien mil caracteres, de modo que una sola petición no agote la memoria del Worker o del navegador con pegados enormes. En caso de éxito la respuesta devuelve input como la cadena original enviada, text como el resultado totalmente envuelto unido con LF, prefix y suffix como los afijos efectivos, skip_empty como el indicador efectivo, line_count como el número de segmentos tras la división, wrapped_count como cuántos de esos segmentos recibieron de verdad los afijos, lines como un array ordenado de las cadenas envueltas, y message como un resumen breve en inglés. La validación fallida—text ausente, un valor que no es string, una carga sobredimensionada, contenido vacío tras el recorte general, un afijo que no es string o es demasiado largo, ambos afijos vacíos o un skip_empty que no es boolean—devuelve invalid_input y nunca se cobra. El precio es un $0.002 fijo por petición exitosa con unidad item. Al integrar, aserte sobre text o lines para el contenido envuelto, sobre wrapped_count cuando skip_empty entra en juego, y trate invalid_input como un error del cliente en envíos de formulario en blanco y no como un evento de facturación.

Consejos prácticos, límites y búsquedas relacionadas

Asigne a prefix un signo mayor que y un espacio con suffix vacío para convertir notas en una cita de bloque de markdown. Asigne a prefix una etiqueta de elemento de lista de apertura y a suffix la de cierre correspondiente para construir filas de marcado. Las comprobaciones de ida y vuelta para pruebas son sencillas: envíe tres líneas cortas y espere tres líneas entrecomilladas con line_count tres y wrapped_count tres; envíe una línea en blanco entre dos palabras con skip_empty true y espere que la línea del medio permanezca vacía; envíe a propósito cadena vacía o solo espacios para confirmar invalid_input y el mensaje que pide una cadena no vacía; envíe prefix vacío y suffix vacío juntos para confirmar el rechazo de ambos vacíos. Tenga en cuenta los saltos finales intencionales: un LF final crea un último segmento vacío que se envuelve salvo que skip_empty sea true. Las tareas fallidas que devuelven invalid_input no consumen saldo prepagado, lo que mantiene barata la validación de formularios y las pruebas negativas de CI.