<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Diego Caceres on Medium]]></title>
        <description><![CDATA[Stories by Diego Caceres on Medium]]></description>
        <link>https://medium.com/@diegocaceres1997garcia?source=rss-9daf2182b687------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*HRwVhf0IqePUxTrkD_KuXA.jpeg</url>
            <title>Stories by Diego Caceres on Medium</title>
            <link>https://medium.com/@diegocaceres1997garcia?source=rss-9daf2182b687------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Sat, 21 Nov 2026 14:47:54 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@diegocaceres1997garcia/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Cambia de proveedor sin desplegar: puertos y adaptadores en Ionic]]></title>
            <link>https://medium.com/@diegocaceres1997garcia/cambia-de-proveedor-sin-desplegar-puertos-y-adaptadores-en-ionic-96234d65dac8?source=rss-9daf2182b687------2</link>
            <guid isPermaLink="false">https://medium.com/p/96234d65dac8</guid>
            <category><![CDATA[ionic]]></category>
            <category><![CDATA[angular]]></category>
            <dc:creator><![CDATA[Diego Caceres]]></dc:creator>
            <pubDate>Mon, 21 Sep 2026 22:25:28 GMT</pubDate>
            <atom:updated>2026-09-21T22:25:28.599Z</atom:updated>
            <content:encoded><![CDATA[<p><em>Una bandera por caso de uso convierte una migración de meses en un cambio de configuración, sin pasar por la tienda.</em></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/699/1*fAac_ZqykuoQ_pZljTlr_w.png" /><figcaption>Pragma creator</figcaption></figure><p>Tu aplicación móvil integra el SDK de un proveedor externo para algo crítico: firma electrónica, pasarela de pagos, verificación de identidad. Funciona bien. Hasta el día en que el proveedor sube el precio, deprecia la versión que usas o tu equipo de seguridad te pide salir de ahí.</p><p>Entonces alguien propone lo obvio en la reunión: <em>«cambiamos el SDK, probamos todo y lo subimos en un release»</em>.</p><p><strong>El caso de este artículo: una app de banca en Ionic 8 + Capacitor + Angular, publicada en App Store y Google Play</strong>, donde once flujos de negocio distintos abren un webview embebido de un motor externo. Ese webview llega como plugin de Capacitor, y hay dos proveedores compitiendo por el puesto.</p><p>Cambiarlo de golpe es una migración big bang, y tiene tres problemas que no son técnicos sino de riesgo.</p><p>Primero, la superficie de prueba es el producto entero: no puedes certificar once flujos en un sprint, y en móvil cada uno hay que probarlo en las dos plataformas. Segundo, el rollback es una publicación en tienda: si algo falla un viernes, tu tiempo de recuperación incluye la revisión de Apple. Días, no minutos. Tercero, es todo o nada: no hay forma de aprender del flujo más pequeño antes de tocar el más crítico.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*IC4RU2q2k_V3UEk2YeKCbQ.jpeg" /><figcaption>Imagen 1 · va acá, después de los tres problemas. Medium toma la primera imagen como preview del feed.</figcaption></figure><h3>La idea en una frase</h3><p>Un puerto abstracto, un adaptador por proveedor, y una bandera remota que elige el adaptador caso de uso por caso de uso.</p><p>Lo primero y lo segundo es arquitectura hexagonal clásica. Lo tercero es lo que cambia el juego, y es lo que casi nunca se implementa: la bandera no es global, es <em>por flujo de negocio</em>.</p><p>En móvil eso importa el doble. Un webview embebido no se comporta igual en iOS que en Android — el ciclo de vida, el manejo del teclado y el evento de cierre difieren — así que un proveedor puede ser mejor para un flujo y peor para otro. Una bandera global te obliga a elegir un ganador único; una por flujo te deja quedarte con lo mejor de cada uno.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*-r61Lm6UAzmnaviRg0PXfw.jpeg" /><figcaption>Imagen 2 · va acá, cerrando la idea antes de entrar al código. El resolutor lee la bandera; los adaptadores son lo único que importa un plugin.</figcaption></figure><h3>1. El puerto: el contrato de tu dominio</h3><p>Empieza aquí. Es el archivo más importante de la arquitectura y el más corto.</p><pre>// domain/browser-bridge.port.ts<br>export abstract class BrowserBridge {<br>  abstract open(request: SessionRequest): Promise&lt;void&gt;;<br>  abstract awaitOutcome(): Promise&lt;SessionOutcome&gt;;<br>  abstract close(): Promise&lt;void&gt;;<br>}</pre><p>El resultado se expresa en el vocabulario de tu dominio, nunca en el del proveedor.</p><pre>// domain/session.types.ts<br>export type FlowKey = &#39;checkout&#39; | &#39;onboarding&#39; | &#39;origination&#39; | &#39;certificates&#39;;</pre><pre>export type SessionOutcome =<br>  | { readonly status: &#39;completed&#39;; readonly reference: string }<br>  | { readonly status: &#39;cancelled&#39; }<br>  | { readonly status: &#39;failed&#39;; readonly reason: string };</pre><p><strong>Prueba ácida:</strong> ¿puedes implementarlo entero con un mock en memoria en menos de cincuenta líneas? Si no, copiaste la superficie del SDK en vez de modelar una capacidad.</p><h3>2. El adaptador: el único lugar contaminado</h3><pre>/ infrastructure/vendor-a.adapter.ts<br>import { InAppBrowser } from &#39;@vendor-a/browser&#39;; // único import del SDK en todo el repo</pre><pre>@Injectable()<br>export class VendorABrowserBridge extends BrowserBridge {<br>  readonly #outcomes = new Subject&lt;SessionOutcome&gt;();</pre><pre>  async open({ url, locale }: SessionRequest): Promise&lt;void&gt; {<br>    await InAppBrowser.openWebView({ url, headers: { &#39;Accept-Language&#39;: locale ?? &#39;es&#39; } });<br>    await InAppBrowser.addListener(&#39;urlChangeEvent&#39;, ({ url }) =&gt;<br>      this.#outcomes.next(this.#translate(url)),<br>    );<br>  }</pre><pre>  awaitOutcome(): Promise&lt;SessionOutcome&gt; {<br>    return firstValueFrom(this.#outcomes);<br>  }</pre><pre>  async close(): Promise&lt;void&gt; {<br>    await InAppBrowser.removeAllListeners();<br>    await InAppBrowser.close();<br>    this.#outcomes.complete();<br>  }</pre><pre>  /**<br>   * Capa anticorrupción: traduce el vocabulario del proveedor al del dominio.<br>   * Si mañana cambia &quot;success&quot; por &quot;OK&quot;, se toca este método y nada más.<br>   */<br>  #translate(rawUrl: string): SessionOutcome {<br>    const params = new URL(rawUrl).searchParams;<br>    switch (params.get(&#39;result&#39;)) {<br>      case &#39;success&#39;:    return { status: &#39;completed&#39;, reference: params.get(&#39;ref&#39;) ?? &#39;&#39; };<br>      case &#39;user_abort&#39;: return { status: &#39;cancelled&#39; };<br>      default:           return { status: &#39;failed&#39;, reason: params.get(&#39;error&#39;) ?? &#39;unknown&#39; };<br>    }<br>  }<br>}</pre><p>Fíjate en lo que este adaptador no hace: no escribe en el store global, no abre modales, no navega, no dispara analítica. Un adaptador que hace cualquiera de esas cosas dejó de ser infraestructura y se convirtió en una dependencia oculta que el próximo adaptador tendrá que replicar para no romper nada.</p><p>El segundo proveedor es un archivo nuevo que extiende el mismo puerto. <strong>No se toca ninguna de las clases que dependen de él.</strong></p><h3>3. La bandera por caso de uso</h3><p>La configuración remota es entrada <strong>no confiable</strong>. Alguien va a escribir mal un valor en la consola un martes a las tres de la tarde, así que se valida como se valida el body de un request.</p><pre>{<br>  &quot;browser.routing&quot;: {<br>    &quot;byFlow&quot;: {<br>      &quot;checkout&quot;:     &quot;vendor-b&quot;,<br>      &quot;certificates&quot;: &quot;vendor-b&quot;,<br>      &quot;onboarding&quot;:   &quot;vendor-a&quot;,<br>      &quot;origination&quot;:  &quot;vendor-a&quot;<br>    },<br>    &quot;fallback&quot;: &quot;vendor-a&quot;<br>  }<br>}</pre><p>Ese JSON es el plan de despliegue de la migración, escrito en un formato que se revierte en treinta segundos.</p><pre>// application/browser-bridge.resolver.ts<br>export const PROVIDERS = [&#39;vendor-a&#39;, &#39;vendor-b&#39;] as const;<br>export type Provider = (typeof PROVIDERS)[number];</pre><pre>const isProvider = (v: unknown): v is Provider =&gt;<br>  typeof v === &#39;string&#39; &amp;&amp; (PROVIDERS as readonly string[]).includes(v);</pre><pre>@Injectable({ providedIn: &#39;root&#39; })<br>export class BrowserBridgeResolver {<br>  readonly #flags = inject(FeatureFlagsService);</pre><pre>  readonly #adapters: ReadonlyMap&lt;Provider, BrowserBridge&gt; = new Map([<br>    [&#39;vendor-a&#39;, inject(VendorABrowserBridge)],<br>    [&#39;vendor-b&#39;, inject(VendorBBrowserBridge)],<br>  ]);</pre><pre>  resolve(flow: FlowKey): { provider: Provider; bridge: BrowserBridge } {<br>    const routing = this.#flags.getValue&lt;ProviderRouting&gt;(&#39;browser.routing&#39;, DEFAULT_ROUTING);</pre><pre>    const candidate = routing.byFlow?.[flow];<br>    const provider = isProvider(candidate) ? candidate : routing.fallback;</pre><pre>    const bridge = this.#adapters.get(provider) ?? this.#adapters.get(DEFAULT_ROUTING.fallback)!;<br>    return { provider, bridge };<br>  }<br>}</pre><p>Ese isProvider es lo que separa una bandera de una bomba: un typo en la consola degrada al fallback en vez de tumbar un flujo de negocio.</p><p>Y fíjate que resolve devuelve el proveedor junto al adaptador. Sin eso no puedes etiquetar tus métricas, y una bandera que cambia el comportamiento de producción sin dejar rastro en la observabilidad es un cambio del que no vas a aprender nada.</p><h3>4. El caso de uso</h3><p>Uno por flujo de negocio, no un servicio compartido.</p><pre>@Injectable()<br>export class CheckoutSessionService {<br>  readonly #resolver = inject(BrowserBridgeResolver);<br>  readonly #analytics = inject(AnalyticsService);</pre><pre>  async run(url: string): Promise&lt;SessionOutcome&gt; {<br>    const { provider, bridge } = this.#resolver.resolve(&#39;checkout&#39;);<br>    await bridge.open({ url, flow: &#39;checkout&#39; });</pre><pre>    try {<br>      const outcome = await bridge.awaitOutcome();<br>      this.#analytics.track(&#39;checkout_session_end&#39;, { provider, status: outcome.status });<br>      return outcome;<br>    } finally {<br>      await bridge.close(); // el cierre no depende del camino feliz<br>    }<br>  }<br>}</pre><p>Al consumir el resultado, assertNever convierte al compilador en tu red de seguridad. Si mañana agregas un cuarto estado al dominio, el build se rompe hasta que lo manejes en todos lados:</p><pre>const assertNever = (value: never): never =&gt; {<br>  throw new Error(`Estado no manejado: ${JSON.stringify(value)}`);<br>};</pre><pre>function handle(outcome: SessionOutcome): void {<br>  switch (outcome.status) {<br>    case &#39;completed&#39;: return showReceipt(outcome.reference); // TS sabe que &#39;reference&#39; existe<br>    case &#39;cancelled&#39;: return goBack();<br>    case &#39;failed&#39;:    return showError(outcome.reason);<br>    default:          return assertNever(outcome);<br>  }<br>}</pre><p>La regla no es «evita el switch». Es: traduce el vocabulario del tercero en el borde y ramifica sobre tu propio tipo.</p><h3>5. La factura que paga todo esto</h3><pre>it(&#39;should close the bridge even when the session fails&#39;, async () =&gt; {<br>  // Arrange<br>  const bridge = {<br>    open: jest.fn().mockResolvedValue(undefined),<br>    awaitOutcome: jest.fn().mockRejectedValue(new Error(&#39;sdk caído&#39;)),<br>    close: jest.fn().mockResolvedValue(undefined),<br>  };<br>  const resolver = { resolve: jest.fn().mockReturnValue({ provider: &#39;vendor-a&#39;, bridge }) };<br>  const service = new CheckoutSessionService(resolver as never, analyticsSpy);</pre><pre>  // Act<br>  await expect(service.run(&#39;https://ejemplo.test/firma&#39;)).rejects.toThrow(&#39;sdk caído&#39;);</pre><pre>  // Assert<br>  expect(bridge.close).toHaveBeenCalledTimes(1);<br>});</pre><p>Sin emulador, sin dispositivo, sin el SDK instalado. <strong>Tu lógica de negocio quedó testeable sin infraestructura</strong>, que en móvil vale doble: los tests que necesitan un dispositivo real son los que nadie corre.</p><h3>Lo que compró, en números</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*5OU-9frfaFjGTbHreXWTBA.jpeg" /><figcaption>Imagen 3 · va acá. Los cuatro primeros números son el éxito; el quinto es la lección.</figcaption></figure><h3>Cinco lecciones, con su costo</h3><h3>👉🏻 El puerto pequeño se defiende activamente</h3><p>Cada vez que alguien necesita «una cosita más del SDK», la presión es agregar un método al puerto. Cede tres veces y ya tienes una abstracción que nadie puede volver a implementar.</p><p><em>Costo: alguien tiene que decir que no, con argumento, en cada revisión de código.</em></p><h3>👉🏻 El adaptador no puede filtrarse</h3><p>Si toca el store global o abre modales, dejó de ser infraestructura.</p><p><em>Costo: lo descubrimos tarde y limpiarlo salió más caro que haberlo hecho bien.</em></p><h3>👉🏻 Un caso de uso por flujo, no un servicio dios</h3><p>El nuestro más grande llegó a 254 líneas, con un switch sobre un string crudo del proveedor y la limpieza duplicada en tres de sus cuatro ramas.</p><p><em>Costo: hoy es el archivo que nadie quiere tocar.</em></p><h3>👉🏻 En móvil, los dos proveedores viajan en el mismo binario</h3><p>Esta es la diferencia con la web: no puedes cargar un adaptador bajo demanda desde un CDN. Los dos plugins de Capacitor se compilan dentro del .ipa y el .aab, así que durante la convivencia pagas el peso de ambos, mantienes dos árboles de dependencias nativas y los dos tienen que sobrevivir cada actualización de iOS y Android.</p><p><em>Costo: unos megabytes de app y el doble de superficie ante cada cambio de plataforma.</em></p><h3>👉🏻 La bandera temporal se vuelve permanente si nadie la cierra</h3><p>Dieciocho meses después, el proveedor por defecto sigue siendo el viejo.</p><p><em>Costo: la bandera compró tiempo, y ese tiempo se gastó en no decidir.</em></p><h3>Cuándo no usar este patrón</h3><p>Tiene un costo fijo de entrada: un puerto, N adaptadores, una bandera y el doble de superficie de prueba mientras dure la convivencia. No lo pagues si:</p><ul><li>Hay un solo proveedor y no se ve un segundo. Un puerto con una implementación única es ceremonia. Usa el SDK directo y extrae el puerto el día que aparezca el segundo candidato: refactorizar hacia un puerto es barato, mantener una abstracción especulativa durante dos años no lo es.</li><li>La integración es trivial. Si el tercero son tres llamadas HTTP, tu «puerto» es un servicio normal y ya está.</li><li>Nadie va a cerrar la migración. Este es el filtro real. La bandera reduce el riesgo del cambio, no lo elimina: convierte un riesgo de despliegue en un riesgo de mantenimiento. Si tu organización no tiene la disciplina de borrar el adaptador viejo al terminar, no evitaste el big bang: lo pospusiste y ahora pagas dos proveedores.</li></ul><h3>Conclusión</h3><p>El patrón funciona. Once flujos son conmutables en caliente, un solo archivo toca el SDK, un incidente del proveedor se resuelve con una configuración en vez de un release, y la lógica de negocio se prueba sin levantar nada.</p><p>Pero la conclusión útil no es «usa puertos y adaptadores». Es esta: <strong>la arquitectura te compra opciones, y las opciones caducan si nadie las ejerce.</strong> Si vas a implementar esto, agenda desde el primer día la fecha en que vas a borrar el adaptador viejo.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=96234d65dac8" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[De chatbot a asistente agéntico en Ionic: cómo hicimos a EVA para acompañar un flujo financiero…]]></title>
            <link>https://medium.com/somos-pragma/de-chatbot-a-asistente-agentic-en-ionic-c%C3%B3mo-construimos-eva-para-acompa%C3%B1ar-un-flujo-financiero-6f1dd05cbf61?source=rss-9daf2182b687------2</link>
            <guid isPermaLink="false">https://medium.com/p/6f1dd05cbf61</guid>
            <category><![CDATA[capacitor]]></category>
            <category><![CDATA[gemini]]></category>
            <category><![CDATA[angular]]></category>
            <category><![CDATA[google-adk]]></category>
            <dc:creator><![CDATA[Diego Caceres]]></dc:creator>
            <pubDate>Mon, 10 Aug 2026 20:15:58 GMT</pubDate>
            <atom:updated>2026-08-25T15:04:45.285Z</atom:updated>
            <content:encoded><![CDATA[<h3>De chatbot a asistente agéntico en Ionic: cómo hicimos a EVA para acompañar un flujo financiero móvil</h3><h4>Una prueba de concepto que combina Ionic, Angular, Capacitor, FastAPI, Google ADK y Gemini para entender el contexto de una pantalla, responder preguntas y proponer acciones controladas sobre un formulario.</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Ud3xH9QshnGOkp9D3jLHSA.png" /></figure><p>En un flujo financiero móvil, la fricción no aparece únicamente por falta de información. También aparece cuando el usuario no entiende un término, no sabe cuál opción elegir o teme equivocarse antes de continuar.</p><p>Ese fue el punto de partida de EVA, un asistente integrado a un flujo de preaprobado comercial dentro de una aplicación móvil.</p><p>Desde el inicio evitamos plantearlo como un <em>chatbot </em>aislado. EVA debía conocer la pantalla en la que se encontraba el usuario, entender los valores disponibles en el formulario y, cuando fuera apropiado, ayudarle a completar una acción.</p><p>Sin embargo, tampoco queríamos presentar a EVA como un agente completamente autónomo. La describimos como un <strong>asistente con capacidades agénticas</strong>: puede interpretar una intención, seleccionar herramientas dentro de un catálogo limitado y proponer acciones sobre la interfaz, pero no toma decisiones financieras ni ejecuta operaciones sensibles por iniciativa propia.</p><h3>¿Por qué hablar de capacidades agénticas?</h3><p>En su definición más estricta, un agente autónomo puede recibir un objetivo, planificar cómo alcanzarlo, tomar decisiones y ejecutar varias acciones con poca intervención humana. EVA no opera bajo ese nivel de autonomía.</p><p>Su capacidad de agencia está deliberadamente acotada. Puede:</p><ul><li>Observar el contexto de la pantalla.</li><li>Interpretar la intención expresada en lenguaje natural.</li><li>Elegir una herramienta autorizada.</li><li>Proponer una modificación sobre el formulario.</li><li>Mantener el hilo de una conversación durante la pantalla actual.</li><li>Solicitar una aclaración cuando no comprende la intención.</li></ul><p>Pero no puede:</p><ul><li>Aprobar un financiamiento.</li><li>Enviar una solicitud sin confirmación.</li><li>Elegir cuentas en nombre del usuario.</li><li>Inventar tasas, límites o condiciones.</li><li>Ejecutar comandos fuera de su catálogo.</li><li>Recordar información del usuario entre sesiones independientes.</li></ul><p>Esta distinción fue importante para comunicar correctamente el alcance de la solución.</p><p><strong>EVA no es un agente financiero autónomo.</strong> Es una interfaz conversacional con capacidades agénticas, especializada en acompañar un flujo específico.</p><h3>El reto de integrar conversación en una experiencia mobile</h3><p>Agregar una conversación dentro de una aplicación móvil presenta restricciones diferentes a las de un <em>chatbot </em>web tradicional.</p><p>La pantalla es pequeña, el teclado ocupa buena parte del espacio y el asistente no puede bloquear los campos que el usuario intenta completar. También debe convivir con selectores, modales, navegación, permisos del dispositivo y cambios en el ciclo de vida de la aplicación.</p><p>Por eso construimos EVA como un <em>widget</em> móvil:</p><ul><li>Colapsado: aparece como una pequeña burbuja.</li><li>Expandido: presenta la conversación y las acciones rápidas.</li><li>Puede moverse dentro de la pantalla.</li><li>Su posición se ajusta para no salir del <em>viewport.</em></li><li>Puede abrirse manualmente o mediante un <em>trigger</em> de ayuda.</li><li>Al cerrarse, no modifica ni elimina los datos del formulario.</li></ul><p>La aplicación también incluyó una prueba de <em>widget</em> nativo para Android. Desde la pantalla de inicio, este puede mostrar una oferta y abrir la aplicación en el flujo correspondiente mediante un <em>deep link.</em></p><h3>De responder preguntas a proponer acciones</h3><p>El cambio más importante ocurrió cuando separamos la respuesta conversacional de la acción que debía realizar la aplicación.</p><p>Cuando el usuario escribe: <em>“Coloca 500,000 en el monto”, </em>EVA no devuelve únicamente un mensaje afirmando que hizo el cambio. El <em>backend</em> responde con una estructura similar a esta:</p><pre>{<br>  &quot;message&quot;: &quot;Listo, cambié el monto a RD$500,000.&quot;,<br>  &quot;command&quot;: {<br>    &quot;type&quot;: &quot;SET_FIELD_VALUE&quot;,<br>    &quot;field&quot;: &quot;amount&quot;,<br>    &quot;value&quot;: 500000<br>  }<br>}</pre><p>Ionic recibe ese comando, comprueba nuevamente que el campo y el valor sean válidos y utiliza la lógica existente del formulario para actualizarlo. La responsabilidad queda dividida de esta manera: <em>El modelo interpreta, el backend autoriza y la aplicación ejecuta.</em></p><p>Gemini no tiene acceso directo a los componentes Angular. Tampoco puede modificar el formulario por sí mismo.</p><p>El modelo puede seleccionar herramientas o proponer comandos dentro de un catálogo limitado:</p><ul><li>HIGHLIGHT_FIELD</li><li>SET_FIELD_VALUE</li><li>CONTINUE_STEP</li><li>OPEN_TAE</li><li>NONE</li></ul><p>Antes de entregar el resultado al<em> frontend,</em> FastAPI valida el comando y reconstruye solamente aquellos que están permitidos para la pantalla actual.</p><p>La página vuelve a validarlo antes de aplicarlo. Esto significa que la capacidad agéntica existe, pero está rodeada por controles determinísticos.</p><h3>Cómo construimos el contexto de la conversación</h3><p>Para interpretar correctamente una pregunta, EVA necesita conocer lo que está sucediendo en la pantalla. Cada página prepara un contexto limitado. Por ejemplo:</p><pre>{<br>  screen: &#39;LOAN_CONFIGURATION&#39;,<br>  currentField: &#39;amount&#39;,<br>  values: {<br>    amount: 500000,<br>    term: 36,<br>    fixedRateMonths: 12,<br>    minAmount: 100000,<br>    maxAmount: 1600000,<br>    canContinue: true<br>  }<br>}</pre><p>Gracias a este contexto, EVA puede distinguir entre dos intenciones:</p><blockquote>“¿Cuánto debería pedir?”</blockquote><p>y:</p><blockquote>“Coloca 500,000 en el monto”.</blockquote><p>La primera es una solicitud de orientación. La segunda representa una instrucción explícita para modificar el formulario.</p><p>El<em> frontend </em>también envía:</p><ul><li>El tema actual de la conversación.</li><li>Una posible acción pendiente.</li><li>Los últimos seis mensajes.</li><li>Los valores actuales del formulario.</li><li>Las opciones válidas para los campos de selección.</li></ul><p>Antes de enviarlos, los mensajes se limitan en longitud y las secuencias numéricas largas se enmascaran.</p><h3>Sesiones, estado y memoria: el alcance real</h3><p>EVA mantiene contexto durante la interacción actual, pero no implementamos memoria persistente entre sesiones. El manejo funciona en dos niveles.</p><h4>Contexto enviado por Ionic</h4><p>El <em>frontend </em>genera un identificador de sesión y lo conserva mientras el componente está activo. En cada solicitud envía explícitamente los últimos seis mensajes, el tema actual y cualquier acción pendiente.</p><p>Este es el mecanismo principal y controlado para mantener una conversación coherente.</p><p>Por ejemplo, después de explicar las opciones de un campo, EVA puede interpretar una respuesta como<em>“Ayúdame a elegir”.</em></p><p>El mensaje aislado es ambiguo, pero el tema actual y los mensajes recientes permiten relacionarlo con la conversación anterior.</p><h4>Sesión temporal en Google ADK</h4><p>El <em>backend </em>utiliza un InMemoryRunner de Google ADK. Las ejecuciones se agrupan utilizando una combinación del identificador de sesión y la pantalla actual.</p><p>Esto permite conservar temporalmente los eventos del agente mientras vive el proceso de Python. Sin embargo, esta memoria tiene límites importantes:</p><ul><li>Se pierde si el servidor se reinicia.</li><li>No se comparte automáticamente entre varias instancias.</li><li>No sobrevive cuando se genera una nueva sesión.</li><li>No representa una memoria permanente del usuario.</li><li>No se utiliza para recordar conversaciones futuras.</li></ul><p>Además, cada pantalla utiliza una sesión lógica diferente. Al avanzar en el flujo, el contexto conversacional puede reiniciarse o adaptarse al nuevo objetivo.</p><p>Para una prueba de concepto, este enfoque evitó incorporar una base de datos conversacional o un sistema de memoria de largo plazo que todavía no era necesario.</p><p>En un despliegue distribuido habría que sustituir o complementar la memoria temporal con un almacenamiento centralizado, siempre definiendo políticas de expiración, consentimiento y minimización de datos.</p><h3>Un flujo híbrido: reglas, glosario y LLM</h3><p>No todas las solicitudes necesitan ser resueltas por Gemini. Enviar cada interacción al modelo habría agregado latencia, costo y variabilidad. Por eso el <em>backend </em>sigue un orden de resolución.</p><pre>Mensaje o audio del usuario<br>          │<br>          ▼<br>   FastAPI recibe contexto<br>          │<br>          ▼<br>Acción rápida o regla conocida ── Sí ──► Respuesta determinística<br>          │<br>          No<br>          ▼<br>Interpretación con Google ADK y Gemini<br>          │<br>          ▼<br> Validación del comando propuesto<br>          │<br>          ▼<br> Respuesta + comando seguro para Ionic</pre><p>Las acciones rápidas, como explicar un concepto o continuar, utilizan identificadores estables. No necesitan ser reinterpretadas por el modelo en cada interacción.</p><p>También construimos un glosario controlado con conceptos financieros, campos del formulario y respuestas aprobadas. Gemini lo utiliza principalmente para reconocer paráfrasis.</p><p>Así, preguntas formuladas de diferentes maneras pueden vincularse con un mismo concepto. Cuando existe una coincidencia suficientemente clara, la respuesta final procede del contenido controlado.</p><p>Si la confianza es insuficiente, EVA solicita que el usuario reformule la pregunta. En un flujo financiero, admitir ambigüedad es más seguro que señalar un campo incorrecto o generar una explicación imprecisa.</p><h3>Ayuda proactiva sin autonomía innecesaria</h3><p>EVA también puede ofrecer ayuda sin esperar siempre una pregunta. Cuando el usuario permanece más de seis segundos en un campo o selector sin avanzar, la página activa un<em> trigger</em> de inactividad. EVA puede abrirse y ofrecer ayuda relacionada con el control actual.</p><p>Si el usuario cambia de campo, selecciona una opción o abandona la pantalla, el temporizador se cancela.</p><p>Esta decisión no la toma el modelo. La aplicación conoce exactamente qué elemento tiene el foco y cuánto tiempo lleva inactivo. EVA recibe esa señal y presenta la ayuda correspondiente.</p><p>Es un ejemplo de capacidad proactiva controlada: el asistente reacciona al contexto, pero no decide libremente cuándo intervenir.</p><h3>Interacción mediante voz</h3><p>Con Capacitor incorporamos el micrófono del dispositivo como otro canal de entrada.</p><p>El flujo funciona así:</p><ol><li>La aplicación solicita permiso para utilizar el micrófono.</li><li>El usuario graba un audio con una duración limitada.</li><li>Ionic obtiene el archivo, su formato y duración.</li><li>El <em>frontend </em>envía el audio codificado al<em> backend.</em></li><li>Gemini genera la transcripción.</li><li>El texto pasa por el mismo orquestador utilizado para los mensajes escritos.</li><li>EVA devuelve una respuesta y, si corresponde, un comando.</li></ol><p>Texto y voz utilizan el mismo contexto, las mismas reglas y las mismas validaciones. La voz no crea un segundo asistente: solamente cambia el canal de entrada.</p><p>También se incorporó lectura de respuestas en voz alta, priorizando una voz femenina en español latinoamericano y procurando mantener una experiencia consistente entre navegador y Android.</p><h3>Seguridad basada en responsabilidades claras</h3><p>El asistente fue diseñado con varias capas de control:</p><ul><li>El <em>frontend</em> envía solamente el contexto necesario.</li><li>El <em>backend </em>acepta comandos y campos previamente autorizados.</li><li>Los valores se comparan con los límites y opciones disponibles.</li><li>Los campos de cuenta pueden resaltarse, pero no seleccionarse automáticamente.</li><li>Las operaciones sensibles no forman parte del catálogo de comandos.</li><li>El LLM no recibe secretos ni credenciales del banco.</li><li>Las respuestas promocionales no inventan límites, aprobaciones o condiciones.</li><li>La aplicación vuelve a validar el comando antes de modificar el formulario.</li></ul><p>Esta arquitectura no elimina la necesidad de controles institucionales, auditoría y monitoreo. Sí establece una frontera clara entre interpretar lenguaje natural y ejecutar una acción dentro de un producto financiero.</p><h3>Una mirada general a su arquitectura</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*OPQGykVU-rDWmesQr9DgpQ.png" /><figcaption>Diagrama de flujo para arquitectura en producción.</figcaption></figure><h3>¿Qué aprendimos?</h3><p>EVA confirmó que agregar inteligencia a una aplicación móvil no consiste solamente en conectar un <em>endpoint</em> a un modelo.</p><p>El mayor trabajo estuvo en construir el contexto correcto, controlar las acciones disponibles y coordinar la conversación con el comportamiento real de Ionic.</p><p>También aprendimos que un enfoque híbrido ofrece mejores resultados para este tipo de producto:</p><ul><li>Las reglas resuelven acciones conocidas con rapidez.</li><li>El glosario mantiene respuestas financieras consistentes.</li><li>El LLM interpreta formas naturales de expresarse.</li><li>El <em>backend</em> valida.</li><li>La aplicación conserva la autoridad sobre la interfaz.</li></ul><p>El resultado es una prueba de concepto que explica términos, guía campos, actualiza valores permitidos, mantiene una conversación contextual, escucha al usuario y ofrece ayuda proactiva.</p><h4>Lo que falta antes de producción</h4><p>EVA todavía debe considerarse una POC. Antes de llevarla a producción sería necesario completar, entre otros puntos:</p><ul><li>Despliegue institucional en Google Cloud.</li><li>Secret Manager y configuración definitiva del <em>gateway.</em></li><li>Observabilidad, trazabilidad y auditoría.</li><li>Evaluaciones sistemáticas de precisión del modelo.</li><li>Métricas de latencia, costo y abandono del flujo.</li><li>Validación legal y de cumplimiento de los mensajes.</li><li>Pruebas de accesibilidad y una matriz más amplia de dispositivos.</li><li>Estrategias de <em>fallback</em> ante indisponibilidad del modelo.</li></ul><p>Tampoco podemos afirmar todavía que EVA aumente la conversión comercial. Esa hipótesis debe validarse con métricas reales.</p><h3>Conclusión</h3><p>Construir EVA nos llevó de una interfaz que respondía preguntas a un asistente capaz de comprender el momento del usuario y acompañarlo dentro del flujo.</p><p>La parte agéntica no está en permitir que el modelo haga cualquier cosa. Está en traducir una intención humana en una acción útil, estructurada, verificable y limitada por las reglas del producto.</p><p>En una aplicación financiera, esa diferencia no es solo técnica. Es la que permite combinar una experiencia más natural con el nivel de control que el negocio necesita.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=6f1dd05cbf61" width="1" height="1" alt=""><hr><p><a href="https://medium.com/somos-pragma/de-chatbot-a-asistente-agentic-en-ionic-c%C3%B3mo-construimos-eva-para-acompa%C3%B1ar-un-flujo-financiero-6f1dd05cbf61">De chatbot a asistente agéntico en Ionic: cómo hicimos a EVA para acompañar un flujo financiero…</a> was originally published in <a href="https://medium.com/somos-pragma">Pragma</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Geolocalización en IONIC sin perder la cabeza]]></title>
            <link>https://medium.com/somos-pragma/geolocalizaci%C3%B3n-en-ionic-sin-perder-la-cabeza-a6d8d62ea62e?source=rss-9daf2182b687------2</link>
            <guid isPermaLink="false">https://medium.com/p/a6d8d62ea62e</guid>
            <category><![CDATA[postgis]]></category>
            <category><![CDATA[geolocation]]></category>
            <category><![CDATA[ionic]]></category>
            <category><![CDATA[nominatim]]></category>
            <dc:creator><![CDATA[Diego Caceres]]></dc:creator>
            <pubDate>Mon, 06 Apr 2026 16:39:08 GMT</pubDate>
            <atom:updated>2026-05-25T18:21:05.638Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*rxGqRnCtCHyroNYf.png" /></figure><h3>Lo que aprendí al unir Capacitor, Edge Functions y una base de datos espacial en Supabase.</h3><p>Si trabajas con Ionic y Capacitor todos los días, ya sabes que los plugins son solo una parte de la historia. La otra parte está en el sistema operativo, el backend y, en muchas ocasiones, en Postgres con detalles que no aparecen en el CREATE TABLE por defecto.</p><p>En los últimos meses implementé geolocalización de punta a punta en una app de alquileres: mostrar propiedades cercanas al usuario, geocodificar direcciones al publicar y guardar una coordenada en la base de datos. No fue simplemente instalar @capacitor/geolocation y continuar. El verdadero trabajo estuvo en alinear permisos y UX para que la infraestructura y la experiencia de usuario hablaran el mismo idioma.</p><h3>El problema no es solo el plugin</h3><p>En el cliente, el flujo natural es @capacitor/geolocation: pedir permiso, leer latitud y longitud, y en web caer a navigator.geolocation. Eso es correcto, pero incompleto.</p><p>En Android necesitas permisos en el manifiesto; en iOS, un NSLocationWhenInUseUsageDescription que explique por qué solicitas ubicación. Si algo falta, el usuario ve un fallo silencioso o un rechazo, y tú ves otro bug en la consola.</p><p>Ahí apareció la primera lección: la ubicación es producto, no solo API. Decidimos no fragmentar la interfaz con una vista exclusiva para resultados por proximidad. El dashboard sigue siendo el dashboard: un carrusel principal que, si hay coordenadas y resultados cercanos, muestra primero lo cercano y luego el resto del catálogo. Si el usuario no concede permiso o no hay coincidencias, se mantiene el mismo listado de propiedades que ya veía antes. Así la navegación no se rompe y el usuario no siente que la app cambió de contexto.</p><p>Otro detalle importante fue no mostrar un spinner de “buscando cerca de ti” mientras el sistema aún está resolviendo el permiso. Primero debe resolverse la ubicación, o no, y solo después tiene sentido cargar la RPC de cercanías.</p><blockquote><em>RPC significa Remote Procedure Call: una función del backend que la app invoca como si fuera una operación remota.</em></blockquote><h3>Del texto en el formulario a una coordenada</h3><p>Las direcciones llegan como texto: calle, ciudad, zona. El móvil no adivina coordenadas mágicamente; hay que geocodificar. En nuestro caso eso vive en una Supabase Edge Function con Deno: recibe un JSON, llama a un proveedor externo y devuelve { latitude, longitude }. La app no necesita cambiar si mañana cambia el proveedor; el contrato sigue siendo el mismo.</p><p>Aquí hay dos aprendizajes que vale la pena dejar claros.</p><p>Primero, un 404 en la URL de la función no siempre significa que la función no existe. A veces la función responde 404 porque el proveedor de mapas devolvió “sin resultados” y así lo modelamos. Antes de culpar al routing, conviene revisar el cuerpo de la respuesta y el código de error del proveedor.</p><p>Segundo, pasamos de Google Geocoding a Nominatim (OpenStreetMap). Google exige API habilitada, claves, cuotas y facturación. Nominatim exige cumplir su política de uso, por ejemplo un User-Agent identificable y respeto por los límites de la instancia pública. Ninguno es “gratis sin condiciones”; solo tienen condiciones distintas.</p><p>Incorrecto:</p><pre>CREATE OR REPLACE FUNCTION public.set_vivienda_geography(...)<br>RETURNS void<br>LANGUAGE plpgsql<br>SET search_path = public<br>AS $$<br>BEGIN<br>  UPDATE vivienda<br>  SET geography = ST_SetSRID(ST_MakePoint(lng, lat), 4326)::geography;<br>END;<br>$$;</pre><p>Correcto:</p><pre>CREATE OR REPLACE FUNCTION public.set_vivienda_geography(...)<br>RETURNS void<br>LANGUAGE plpgsql<br>SET search_path = public, extensions<br>AS $$<br>BEGIN<br>  UPDATE vivienda<br>  SET geography = ST_SetSRID(ST_MakePoint(lng, lat), 4326)::extensions.geography;<br>END;<br>$$;</pre><p>La idea es simple: la geocodificación es una dependencia de producción, no un fetch casual.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*KvCiit9wAq5rMVQV8WAZ_w.png" /></figure><h4>Donde Ionic no te ayuda: Postgres y geography</h4><p>Cuando por fin tienes latitud y longitud, quieres guardarlas de forma que las consultas espaciales sean correctas. En Postgres eso suele implicar PostGIS y el tipo geography. Activar la extensión es el primer paso. El segundo, especialmente en Supabase, es entender dónde vive ese tipo.</p><p>En muchos proyectos, PostGIS queda en el schema extensions, no en public. Una función almacenada con SET search_path = public puede ejecutar un UPDATE que haga cast a ::geography, y Postgres responde con algo que en el cliente se ve como 400 Bad Request y un mensaje del estilo type “geography” does not exist (42704).</p><p>Eso confunde bastante: “¿no habíamos instalado PostGIS?”. Sí, pero el tipo no se estaba resolviendo dentro del search_path de la función. La solución fue alinear la función con la realidad del servidor: incluir extensions en el search_path y usar cast explícito a extensions.geography.</p><p><strong>➡ El flujo completo, en una línea mental:</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*_7AZF1VDVotwDe7g-8Acrw.png" /></figure><ul><li>App → geocodificación (Edge) → RPC que escribe el punto → PostGIS para consultas “cerca de mí”.</li></ul><p>El móvil manda números y tokens; el <strong>modelo espacial</strong> vive en la base.</p><h3>¿Qué aprendí de todo esto?</h3><p>En Ionic, la geolocalización es sobre todo UX y permisos: cuándo pedirlos, qué mostrar mientras el sistema decide y cómo evitar que una funcionalidad secundaria rompa la pantalla principal.</p><p>En el backend, todo es cuestión de contratos y tipos: qué devuelve la Edge Function, dónde vive la extensión, cómo resuelve Postgres los schemas y cómo modelas los errores para que no parezcan otra cosa.</p><p>La integración real consiste en alinear esas capas sin exponer al usuario la complejidad técnica. Una pantalla coherente, un listado que tiene sentido con o sin GPS y errores que enseñan al equipo a mirar Network y SQL, no solo el plugin de Capacitor.</p><h4>Referencias</h4><p>- [Capacitor Geolocation](<a href="https://capacitorjs.com/docs/apis/geolocation">https://capacitorjs.com/docs/apis/geolocation</a>) <br>- [Política de uso de Nominatim](<a href="https://operations.osmfoundation.org/policies/nominatim/">https://operations.osmfoundation.org/policies/nominatim/</a>) <br>- [PostGIS](<a href="https://postgis.net/documentation/">https://postgis.net/documentation/</a>)</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=a6d8d62ea62e" width="1" height="1" alt=""><hr><p><a href="https://medium.com/somos-pragma/geolocalizaci%C3%B3n-en-ionic-sin-perder-la-cabeza-a6d8d62ea62e">Geolocalización en IONIC sin perder la cabeza</a> was originally published in <a href="https://medium.com/somos-pragma">Pragma</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[CI/CD completo para apps Ionic + Angular con GitHub Actions]]></title>
            <link>https://medium.com/somos-pragma/ci-cd-completo-para-apps-ionic-angular-con-github-actions-como-un-verdadero-pro-381cef15db39?source=rss-9daf2182b687------2</link>
            <guid isPermaLink="false">https://medium.com/p/381cef15db39</guid>
            <category><![CDATA[ionic-framework]]></category>
            <category><![CDATA[testflight]]></category>
            <category><![CDATA[angular]]></category>
            <category><![CDATA[ionic]]></category>
            <category><![CDATA[ci-cd-pipeline]]></category>
            <dc:creator><![CDATA[Diego Caceres]]></dc:creator>
            <pubDate>Thu, 04 Dec 2025 19:49:02 GMT</pubDate>
            <atom:updated>2025-12-05T16:57:19.128Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*MRHdyntI3Od8S7ttSaKBUA.png" /></figure><p><strong>¿Cómo generar AAB/IPA, firmarlos y distribuirlos automáticamente en Android y iOS?</strong></p><p>Desarrollar una <em>app</em> híbrida con <strong>Ionic + Angular</strong> es rápido, pero tarde o temprano surge una necesidad inevitable: <strong>¿Cómo automatizamos los <em>builds </em>para Android e iOS, sin depender de máquinas locales?</strong></p><p>Ahí entra <strong>GitHub Actions</strong> que nos permite construir, firmar y distribuir nuestras aplicaciones de forma automática cada vez que hacemos un <em>push a main.</em></p><p>En este artículo aprenderás a configurar un <em>pipeline </em><strong><em>end-to-end</em></strong><em>,</em> incluyendo:</p><ul><li>Build web (Ionic/Angular).</li><li>Capacitor Sync.</li><li>Firma y generación de <strong>AAB</strong> (Android).</li><li>Firma y generación de <strong>IPA</strong> (iOS).</li><li>Publicación automática en Google Play (opcional).</li><li>Publicación en TestFlight.</li></ul><p>Todo con ejemplos reales y <em>workflows </em>listos para copiar/pegar.</p><h3>1. Arquitectura general del pipeline</h3><p>Un buen <em>pipeline</em> móvil debe considerar los siguientes pasos:</p><h3>Build web</h3><p>Compilación Angular (npm run build) para producción.</p><h3>Capacitor Sync</h3><p>Genera o actualiza las plataformas:</p><ul><li>npx cap sync android.</li><li>npx cap sync ios.</li></ul><h3>Android</h3><ul><li>Gradle + Android SDK.</li><li>Firma con keystore.</li><li>Generación de .aab.</li></ul><h3>iOS</h3><ul><li>Xcode.</li><li>Certificados .p12.</li><li>Perfiles .mobileprovision.</li><li>Generación de .ipa.</li></ul><h3>Distribución opcional</h3><ul><li>Internal track / alpha en Google Play.</li><li>TestFlight en App Store Connect.</li></ul><h3>2. Secrets necesarios en GitHub</h3><p>Ve a: <strong>Settings → Secrets → Actions</strong> y añade lo siguiente:</p><h3>Android</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*WOWKMInxiFQJfr0POCOG7w.png" /></figure><h3>iOS</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*BFk470Dg-6mMB1PhnhMUHQ.png" /></figure><h3>Opcional: Google Play</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*bnZdGZG-ZmrrT6wozSfGLw.png" /></figure><h3>3. Pipeline Android: AAB firmado + artefacto</h3><p>Guarda esto como:</p><p>📄 .github/workflows/android-release.yml</p><pre>name: Build Android (Capacitor)<br><br>on:<br>  push:<br>    branches: [ main ]<br>  workflow_dispatch:<br><br>jobs:<br>  build-android:<br>    runs-on: ubuntu-latest<br><br>    steps:<br>      - uses: actions/checkout@v4<br><br>      - uses: actions/setup-node@v4<br>        with:<br>          node-version: 18<br><br>      - run: npm ci<br>      - run: npm run build -- --configuration production<br><br>      - run: npx cap sync android<br><br>      - uses: android-actions/setup-android@v3<br>        with:<br>          api-level: 33<br>          build-tools: 33.0.0<br><br>      - name: Restore keystore<br>        env:<br>          KEY_BASE64: ${{ secrets.ANDROID_KEYSTORE_BASE64 }}<br>        run: echo &quot;$KEY_BASE64&quot; | base64 -d &gt; keystore.jks<br><br>      - name: Create keystore.properties<br>        working-directory: android<br>        run: |<br>          cat &gt; keystore.properties &lt;&lt;EOF<br>          storeFile=${{ github.workspace }}/keystore.jks<br>          storePassword=${{ secrets.KEYSTORE_PASSWORD }}<br>          keyAlias=${{ secrets.KEY_ALIAS }}<br>          keyPassword=${{ secrets.KEY_PASSWORD }}<br>          EOF<br><br>      - name: Build AAB<br>        working-directory: android<br>        run: ./gradlew bundleRelease --no-daemon<br><br>      - name: Export artifact<br>        run: |<br>          mkdir -p artifacts<br>          cp android/app/build/outputs/bundle/release/app-release.aab artifacts/<br><br>      - uses: actions/upload-artifact@v4<br>        with:<br>          name: android-aab<br>          path: artifacts/<br></pre><h3>4. Publicación opcional en Google Play</h3><p>Agrega al final del <em>workflow:</em></p><pre>      - name: Upload to Google Play (Internal)<br>        run: |<br>          sudo gem install fastlane -NV<br>          echo &#39;${{ secrets.GOOGLE_PLAY_SERVICE_ACCOUNT_JSON }}&#39; &gt; play.json<br>          fastlane supply \<br>            --aab artifacts/app-release.aab \<br>            --json_key play.json \<br>            --track internal \<br>            --package_name com.tu.app</pre><h3>5. Pipeline iOS: IPA firmado + artefacto</h3><p>Guarda esto como:</p><p>📄 .github/workflows/ios-release.yml</p><pre>name: Build iOS (Capacitor)<br><br>on:<br>  push:<br>    branches: [ main ]<br>  workflow_dispatch:<br><br>jobs:<br>  build-ios:<br>    runs-on: macos-latest<br><br>    steps:<br>      - uses: actions/checkout@v4<br><br>      - uses: actions/setup-node@v4<br>        with:<br>          node-version: 18<br><br>      - run: npm ci<br>      - run: npm run build -- --configuration production<br><br>      - run: npx cap sync ios<br><br>      - name: Install Certificates<br>        env:<br>          P12_BASE64: ${{ secrets.IOS_CERTIFICATE_P12_BASE64 }}<br>          P12_PASSWORD: ${{ secrets.IOS_CERTIFICATE_PASSWORD }}<br>        run: |<br>          echo &quot;$P12_BASE64&quot; | base64 --decode &gt; signing.p12<br>          security create-keychain -p &quot;&quot; build.keychain<br>          security import signing.p12 -k ~/Library/Keychains/build.keychain -P &quot;$P12_PASSWORD&quot; -A<br>          security default-keychain -s ~/Library/Keychains/build.keychain<br><br>      - name: Install Provisioning Profile<br>        env:<br>          PROFILE_BASE64: ${{ secrets.IOS_PROVISIONING_PROFILE_BASE64 }}<br>        run: |<br>          mkdir -p ~/Library/MobileDevice/Provisioning\ Profiles<br>          echo &quot;$PROFILE_BASE64&quot; | base64 --decode &gt; ~/Library/MobileDevice/Provisioning\ Profiles/profile.mobileprovision<br><br>      - name: Build IPA<br>        working-directory: ios/App<br>        run: |<br>          xcodebuild -scheme App \<br>            -configuration Release \<br>            -archivePath $PWD/build/App.xcarchive \<br>            archive<br><br>          xcodebuild -exportArchive \<br>            -archivePath $PWD/build/App.xcarchive \<br>            -exportOptionsPlist ExportOptions.plist \<br>            -exportPath $PWD/build<br><br>      - uses: actions/upload-artifact@v4<br>        with:<br>          name: ios-ipa<br>          path: ios/App/build/*.ipa</pre><p><strong>Resultado:</strong> un .ipa firmado y válido para TestFlight/App Store.</p><h3>6. Archivo ExportOptions.plist</h3><p>ios/App/ExportOptions.plist</p><pre>&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;<br>&lt;!DOCTYPE plist PUBLIC &quot;-//Apple//DTD PLIST 1.0//EN&quot;<br>&quot;http://www.apple.com/DTDs/PropertyList-1.0.dtd&quot;&gt;<br>&lt;plist version=&quot;1.0&quot;&gt;<br>&lt;dict&gt;<br>    &lt;key&gt;method&lt;/key&gt;<br>    &lt;string&gt;app-store&lt;/string&gt;<br><br>    &lt;key&gt;teamID&lt;/key&gt;<br>    &lt;string&gt;${APPLE_TEAM_ID}&lt;/string&gt;<br><br>    &lt;key&gt;signingStyle&lt;/key&gt;<br>    &lt;string&gt;manual&lt;/string&gt;<br><br>    &lt;key&gt;provisioningProfiles&lt;/key&gt;<br>    &lt;dict&gt;<br>        &lt;key&gt;${APPLE_BUNDLE_ID}&lt;/key&gt;<br>        &lt;string&gt;YourProvisioningProfileName&lt;/string&gt;<br>    &lt;/dict&gt;<br>&lt;/dict&gt;<br>&lt;/plist&gt;</pre><h3>7. Distribución automática a TestFlight</h3><p>Agrega este paso al final del <em>workflow</em> de iOS:</p><pre>      - name: Upload to TestFlight<br>        run: |<br>          xcrun altool --upload-app \<br>            -f ios/App/build/App.ipa \<br>            -t ios \<br>            -u &quot;${{ secrets.APPLE_APPLE_ID }}&quot; \<br>            -p &quot;${{ secrets.APPLE_APP_SPECIFIC_PASSWORD }}&quot;</pre><p>Y automáticamente tu <em>build</em> terminará disponible para <em>testers.</em></p><h4>8. Consejos prácticos para no sufrir</h4><h3>Android</h3><ul><li>Mantén tu compileSdkVersion y los <em>build-tools</em> del <em>runner</em> alineados.</li><li>Firma desde <em>gradle</em> usando keystore.properties.</li></ul><h3>iOS</h3><ul><li>No uses tu <em>password</em> personal: usa <strong>App Specific Password</strong>.</li><li>El .mobileprovision debe coincidir EXACTO con el certificado.</li><li>Los <em>runners </em>macOS son más lentos: <em>builds</em> de 10–15 minutos son normales.</li></ul><h3>Ionic/Capacitor</h3><ul><li>Siempre usa npm ci en CI.</li><li>Antes de subir el <em>workflow,</em> asegúrate de correr una vez:</li></ul><p>npx cap sync</p><p>npx cap open ios (solo una primera vez local).</p><h3>Conclusión</h3><p>Con estos dos <em>workflows </em>tienes un sistema <strong>CI/CD móvil completo</strong>:</p><ul><li><em>Builds</em> consistentes.</li><li>Binarios firmados.</li><li>Artefactos para QA.</li><li>Publicación automática.</li><li>Mínimo esfuerzo manual.</li><li>Configuración profesional.</li></ul><p>Esto te permite trabajar como un equipo senior: cada PR, cada <em>release,</em> cada <em>push,</em> genera automáticamente los binarios finales, listos para Google Play y TestFlight.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=381cef15db39" width="1" height="1" alt=""><hr><p><a href="https://medium.com/somos-pragma/ci-cd-completo-para-apps-ionic-angular-con-github-actions-como-un-verdadero-pro-381cef15db39">CI/CD completo para apps Ionic + Angular con GitHub Actions</a> was originally published in <a href="https://medium.com/somos-pragma">Pragma</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Prism: pequeño tutorial para empezar a usarlo desde cero rápidamente]]></title>
            <link>https://medium.com/somos-pragma/prism-peque%C3%B1o-tutorial-para-empezar-a-usarlo-desde-0-r%C3%A1pidamente-a440fb930456?source=rss-9daf2182b687------2</link>
            <guid isPermaLink="false">https://medium.com/p/a440fb930456</guid>
            <category><![CDATA[nobackend]]></category>
            <category><![CDATA[prism]]></category>
            <dc:creator><![CDATA[Diego Caceres]]></dc:creator>
            <pubDate>Thu, 23 Oct 2025 21:07:39 GMT</pubDate>
            <atom:updated>2025-12-17T17:04:03.551Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/783/1*O_SgXQOEAI4_3gwFvRFQgw.png" /></figure><p>El problema: Dependencias que ralentizan tu desarrollo</p><h4>¿Te suena familiar?</h4><p>* El equipo de <em>frontend </em>esperando a que <em>backend</em> termine los<em> endpoints.</em><br>* Pruebas E2E imposibles porque el <em>backend</em> está caído.<br>* Necesitas demostrar un prototipo, pero el <em>backend </em>aún no existe.<br>* Quieres probar diferentes latencias de red sin modificar código.</p><p><strong>La solución:</strong> Un <em>mock server</em> que genera respuestas automáticamente desde tu contrato OpenAPI.</p><h4>¿Qué es Prism Mock Server?</h4><p><a href="https://stoplight.io/open-source/prism">Prism</a> es una herramienta de código abierto de Stoplight que transforma tu especificación OpenAPI en un servidor HTTP funcional que:</p><ul><li>Genera respuestas automáticamente basadas en tus schemas.</li><li>Valida requests contra tu contrato.</li><li>Simula latencias de red para pruebas realistas.</li><li>Soporta CORS para desarrollo local.</li><li>No requiere código. Solo tu archivo OpenAPI.</li></ul><h4>Caso de uso real: Mini E-commerce app</h4><p>Para este tutorial, construiremos un <em>mock backend</em> completo para una aplicación de E-commerce con:</p><ul><li>Autenticación (<em>login</em>).</li><li>Catálogo de productos.</li></ul><p>🛒 Carrito de compras<br>💳 <em>Checkout</em> y órdenes</p><p>Todo funcionando en menos de cinco minutos sin escribir <em>backend.</em></p><p><strong>Paso 1: Definir tu contrato OpenAPI</strong></p><p>Primero, creamos nuestro contrato API en `openapi.yaml`:</p><pre><br>openapi: 3.0.3<br>info:<br> title: Mini Ecommerce Mock API<br> version: 1.0.0<br> description: Backend simulado para app de ecommerce<br>servers:<br> - url: http://localhost:4010<br> description: Servidor mock local con Prism<br>security:<br> - bearerAuth: []<br>paths:<br> /auth/login:<br> post:<br> tags: [Auth]<br> summary: Iniciar sesión<br> security: []<br> requestBody:<br> required: true<br> content:<br> application/json:<br> schema:<br> type: object<br> required: [email, password]<br> properties:<br> email:<br> type: string<br> format: email<br> password:<br> type: string<br> example:<br> email: user@example.com<br> password: strong_password_123<br> responses:<br> &#39;200&#39;:<br> description: Autenticación exitosa<br> content:<br> application/json:<br> schema:<br> type: object<br> properties:<br> token:<br> type: string<br> userId:<br> type: string<br> example:<br> token: mock-token-123<br> userId: user-123<br></pre><p>Claves del contrato</p><p>1. Schemas claros: <strong>Define tipos y validaciones.</strong></p><pre><br>properties:<br> email:<br> type: string<br> format: email # Prism validará el formato<br> price:<br> type: number<br> minimum: 0 # Prism rechazará valores negativos<br></pre><p>2. Ejemplos realistas: Prism los usa como respuestas.</p><pre><br>example:<br> id: prod-1<br> name: Running Shoes<br> price: 89.99<br> imageUrl: https://images.pexels.com/photos/5872357/pexels-photo-5872357.jpeg<br></pre><p>3. Códigos de error: Define todos los casos.</p><pre><br>&#39;401&#39;:<br> description: No autorizado<br> content:<br> application/json:<br> schema:<br> $ref: &#39;#/components/schemas/Error&#39;<br></pre><p><strong>Paso 2: Instalar y ejecutar Prism</strong></p><p>Instalación:</p><p><strong>Opción A — NPM Global (recomendado):</strong></p><pre><br>npm install -g @stoplight/prism-cli<br>prism - version<br></pre><p><strong>Opción B — Homebrew (macOS):</strong></p><pre><br>brew install stoplight/tap/prism<br></pre><p><strong>Opción C — NPX (sin instalar):</strong></p><pre><br>npx @stoplight/prism-cli - version<br></pre><p><strong>Ejecutar el Mock Server</strong></p><pre><br># Básico<br>prism mock openapi.yaml - port 4010 - cors<br># Con latencia simulada (3G rápido)<br>prism mock openapi.yaml - port 4010 - cors - delay 500<br># Logs detallados para debugging<br>prism mock openapi.yaml - port 4010 - cors - log-level debug<br></pre><p><strong>¡Eso es todo!</strong> Tu <em>backend</em> está corriendo en ‘http://localhost:4010&#39;</p><p><strong>Paso 3: Probar tu <em>Mock Server</em></strong></p><ul><li>Con cURL</li></ul><pre><br># Login (sin autenticación)<br>curl -X POST http://localhost:4010/auth/login \<br> -H &#39;Content-Type: application/json&#39; \<br> -d &#39;{&quot;email&quot;:&quot;user@example.com&quot;,&quot;password&quot;:&quot;strong_password_123&quot;}&#39;<br># Respuesta:<br># {&quot;token&quot;:&quot;mock-token-123&quot;,&quot;userId&quot;:&quot;user-123&quot;}<br># Listar productos (con token)<br>curl http://localhost:4010/products \<br> -H &#39;Authorization: Bearer mock-token-123&#39;<br># Agregar al carrito<br>curl -X POST http://localhost:4010/cart \<br> -H &#39;Authorization: Bearer mock-token-123&#39; \<br> -H &#39;Content-Type: application/json&#39; \<br> -d &#39;{&quot;productId&quot;:&quot;prod-1&quot;,&quot;quantity&quot;:2}&#39;<br></pre><ul><li>Con JavaScript (Fetch API)</li></ul><pre><br>// Login<br>const login = async () =&gt; {<br> const response = await fetch(&#39;http://localhost:4010/auth/login&#39;, {<br> method: &#39;POST&#39;,<br> headers: { &#39;Content-Type&#39;: &#39;application/json&#39; },<br> body: JSON.stringify({<br> email: &#39;user@example.com&#39;,<br> password: &#39;strong_password_123&#39;<br> })<br> });<br> const data = await response.json();<br> return data.token;<br>};<br>// Obtener productos<br>const getProducts = async (token) =&gt; {<br> const response = await fetch(&#39;http://localhost:4010/products&#39;, {<br> headers: { &#39;Authorization&#39;: `Bearer ${token}` }<br> });<br> return response.json();<br>};<br></pre><p><strong>Paso 4: Integrar con tu <em>frontend</em></strong></p><p>Angular / Ionic</p><pre><br>// src/environments/environment.ts<br>export const environment = {<br> production: false,<br> apiBaseUrl: &#39;http://localhost:4010&#39;<br>};<br>// src/app/services/api.service.ts<br>@Injectable({ providedIn: &#39;root&#39; })<br>export class ApiService {<br> constructor(private http: HttpClient) {}<br> login(credentials: { email: string; password: string }) {<br> return this.http.post(`${environment.apiBaseUrl}/auth/login`, credentials);<br> }<br> getProducts(token: string) {<br> return this.http.get(`${environment.apiBaseUrl}/products`, {<br> headers: { Authorization: `Bearer ${token}` }<br> });<br> }<br>}<br></pre><p>React / React Native</p><pre><br>// src/config/api.js<br>import axios from &#39;axios&#39;;<br>const api = axios.create({<br> baseURL: &#39;http://localhost:4010&#39;,<br> headers: { &#39;Content-Type&#39;: &#39;application/json&#39; }<br>});<br>// Interceptor para añadir token<br>api.interceptors.request.use((config) =&gt; {<br> const token = localStorage.getItem(&#39;token&#39;);<br> if (token) {<br> config.headers.Authorization = `Bearer ${token}`;<br> }<br> return config;<br>});<br>export default api;<br>// Uso<br>import api from &#39;./config/api&#39;;<br>const login = () =&gt; api.post(&#39;/auth/login&#39;, {<br> email: &#39;user@example.com&#39;,<br> password: &#39;strong_password_123&#39;<br>});<br>const getProducts = () =&gt; api.get(&#39;/products&#39;);<br><br>Vue.js<br><br><br>// src/plugins/axios.js<br>import axios from &#39;axios&#39;;<br>const instance = axios.create({<br> baseURL: &#39;http://localhost:4010&#39;<br>});<br>instance.interceptors.request.use((config) =&gt; {<br> const token = localStorage.getItem(&#39;authToken&#39;);<br> if (token) {<br> config.headers.Authorization = `Bearer ${token}`;<br> }<br> return config;<br>});<br>export default instance;<br></pre><p><strong>Configuración para emuladores/simuladores</strong></p><p><strong>iOS Simulator</strong></p><pre><br>apiBaseUrl: &#39;http://localhost:4010&#39; </pre><p>Funciona directamente</p><p><strong>Android Emulator</strong></p><pre><br>apiBaseUrl: &#39;http://10.0.2.2:4010&#39; //</pre><p>IP especial para localhost</p><pre><br>### Dispositivo Físico<br>```bash<br># 1. Encuentra tu IP local<br>ipconfig getifaddr en0 # macOS<br>ip addr show # Linux<br>ipconfig # Windows<br># 2. Ejecuta Prism<br>prism mock openapi.yaml - port 4010 - cors - host 0.0.0.0<br># 3. Usa en tu app<br>apiBaseUrl: &#39;http://192.168.1.100:4010&#39; # Tu IP local<br></pre><p><strong>Casos de uso avanzados</strong></p><p>1. Simular diferentes condiciones de red</p><pre><br># Red rápida (WiFi)<br>prism mock openapi.yaml - port 4010 - cors - delay 0<br># Red 3G<br>prism mock openapi.yaml - port 4010 - cors - delay 500<br># Red 2G / muy lenta<br>prism mock openapi.yaml - port 4010 - cors - delay 2000<br># Latencia aleatoria<br>prism mock openapi.yaml - port 4010 - cors - delay 500–1500<br></pre><p><strong>Beneficio</strong>: Prueba cómo se comporta tu UI con diferentes velocidades de red sin modificar código.</p><p>2. Validación de <em>Requests</em></p><p>Prism valida automáticamente:</p><ul><li>Tipos de datos correctos.</li><li>Campos requeridos presentes.</li><li>Formatos (<em>email,</em> URL, fecha).</li><li>Rangos numéricos.</li></ul><pre><br># Request inválido<br>curl -X POST http://localhost:4010/cart \<br> -H &#39;Content-Type: application/json&#39; \<br> -d &#39;{&quot;productId&quot;:&quot;prod-1&quot;,&quot;quantity&quot;:-5}&#39;<br># Respuesta de Prism:<br># 422 Unprocessable Entity<br># &quot;quantity must be &gt;= 1&quot;<br></pre><p>3. Múltiples ejemplos (<em>Contract Testing</em>)</p><pre><br>responses:<br> &#39;200&#39;:<br> content:<br> application/json:<br> examples:<br> success:<br> value:<br> token: mock-token-123<br> userId: user-123<br> admin:<br> value:<br> token: admin-token-456<br> userId: admin-456<br> role: admin<br></pre><p>Solicita ejemplos específicos con <em>headers:</em></p><pre><br>curl http://localhost:4010/auth/login \<br> -H &#39;Prefer: example=admin&#39;<br></pre><p>4. Modo dinámico vs. estático</p><pre><br># Modo dinámico (genera datos aleatorios basados en schema)<br>prism mock openapi.yaml - port 4010 - dynamic<br># Modo estático (usa solo ejemplos definidos)<br>prism mock openapi.yaml - port 4010 - mock static<br></pre><p>Arquitectura: Clean Architecture con Prism</p><p>En el proyecto de ejemplo, implementamos Clean Architecture que se beneficia enormemente de Prism:</p><pre>`<br>src/<br>├── domain/ # Lógica de negocio pura<br>│ ├── entities/ # Product, Cart, Order<br>│ ├── protocols/ # Interfaces de repositorios<br>│ └── use-cases/ # GetProducts, AddToCart<br>├── data/ # Implementación de datos<br>│ ├── gateway/ # Contratos internos<br>│ └── infraestructure/ # HTTP client, repositorios<br>└── presentation/ # UI (Angular/React/Vue)<br> ├── pages/ # Páginas<br> ├── components/ # Componentes reutilizables<br> └── presenters/ # Lógica de presentación<br></pre><p><strong>Beneficios con Prism</strong></p><ul><li>Domain independiente: <em>Entities</em> y <em>Use Cases</em> no saben de Prism.</li><li>Data layer adaptable: Cambiar de <em>mock</em> a real es cambiar una implementación.</li><li><em>Testing</em> aislado: <em>Mock</em> para desarrollo, real para producción</li></ul><pre><br>// domain/protocols/product-repository.protocol.ts<br>export interface ProductRepositoryProtocol {<br> getProducts(filters?: ProductFilters): Promise&lt;Product[]&gt;;<br> getProductById(id: string): Promise&lt;Product&gt;;<br>}<br>// data/infraestructure/repositories/product-repository.impl.ts<br>@Injectable({ providedIn: &#39;root&#39; })<br>export class ProductRepositoryImpl implements ProductRepositoryProtocol {<br> constructor(private http: HttpClient) {}<br> <br> async getProducts(): Promise&lt;Product[]&gt; {<br> // Apunta a Prism durante desarrollo<br> // Apunta a backend real en producción<br> const response = await this.http<br> .get&lt;Product[]&gt;(`${environment.apiBaseUrl}/products`)<br> .toPromise();<br> return response;<br> }<br>}<br></pre><p><strong>Testing y CI/CD con Prism</strong></p><ul><li>Test E2E con Prism</li></ul><pre><br>// cypress/e2e/checkout.cy.js<br>describe(&#39;Checkout Flow&#39;, () =&gt; {<br> before(() =&gt; {<br> // Inicia Prism antes de los tests<br> cy.exec(&#39;prism mock openapi.yaml - port 4010 &amp;&#39;);<br> cy.wait(2000); // Espera a que Prism inicie<br> });<br> it(&#39;should complete checkout successfully&#39;, () =&gt; {<br> cy.visit(&#39;/&#39;);<br> cy.contains(&#39;Login&#39;).click();<br> // Prism responderá con mock-token-123<br> cy.get(&#39;[data-cy=email]&#39;).type(&#39;user@example.com&#39;);<br> cy.get(&#39;[data-cy=password]&#39;).type(&#39;password&#39;);<br> cy.get(&#39;[data-cy=submit]&#39;).click();<br> <br> // Continúa el flujo…<br> });<br>});<br></pre><p><strong>GitHub Actions con Prism</strong></p><pre><br># .github/workflows/e2e-tests.yml<br>name: E2E Tests<br>on: [push, pull_request]<br>jobs:<br> e2e:<br> runs-on: ubuntu-latest<br> steps:<br> - uses: actions/checkout@v3<br> <br> - name: Setup Node.js<br> uses: actions/setup-node@v3<br> with:<br> node-version: &#39;18&#39;<br> <br> - name: Install Prism<br> run: npm install -g @stoplight/prism-cli<br> <br> - name: Start Mock Server<br> run: |<br> prism mock openapi.yaml - port 4010 - cors &amp;<br> sleep 5<br> <br> - name: Run E2E Tests<br> run: npm run test:e2e<br></pre><p><strong><em>Performance Testing</em> con Prism</strong></p><p>- Autocannon — HTTP Benchmarking</p><pre><br># Instalar<br>npm install -g autocannon<br># Benchmark de endpoint<br>autocannon http://localhost:4010/products \<br> -c 50 \ # 50 conexiones concurrentes<br> -d 30 \ # Durante 30 segundos<br> -p 10 \ # 10 requests por conexión<br> -H &quot;Authorization: Bearer mock-token-123&quot;<br># Resultados:<br># Latency (ms): p50: 5, p95: 15, p99: 25<br># Requests/sec: 10,000<br># Throughput: 50 MB/sec<br></pre><p><strong>Comparar latencias</strong></p><pre><br># Script para comparar<br>#!/bin/bash<br>echo &quot;=== Baseline (0ms delay) ===&quot;<br>prism mock openapi.yaml - port 4010 - delay 0 &amp;<br>PRISM_PID=$!<br>sleep 3<br>autocannon http://localhost:4010/products -c 10 -d 10<br>kill $PRISM_PID<br>echo &quot;=== 3G Simulation (500ms delay) ===&quot;<br>prism mock openapi.yaml - port 4010 - delay 500 &amp;<br>PRISM_PID=$!<br>sleep 3<br>autocannon http://localhost:4010/products -c 10 -d 10<br>kill $PRISM_PID<br></pre><h4>Mejores prácticas</h4><p>1. Ejemplos realistas y consistentes</p><pre><br>#Mal - Datos genéricos<br>example:<br> id: &quot;1&quot;<br> name: &quot;Product&quot;<br> price: 100<br>#Bien - Datos realistas<br>example:<br> id: &quot;prod-nike-air-max-2024&quot;<br> name: &quot;Nike Air Max 2024 Running Shoes&quot;<br> price: 129.99<br> imageUrl: &quot;https://images.pexels.com/photos/123/product.jpg&quot;<br> inStock: true<br> rating: 4.5<br></pre><p>2. Definir todos los casos de error</p><pre><br>responses:<br> &#39;200&#39;:<br> description: Success<br> &#39;400&#39;:<br> description: Bad Request<br> content:<br> application/json:<br> schema:<br> $ref: &#39;#/components/schemas/Error&#39;<br> &#39;401&#39;:<br> description: Unauthorized<br> &#39;404&#39;:<br> description: Not Found<br> &#39;500&#39;:<br> description: Internal Server Error<br></pre><p>3. Usar <em>components</em> para reutilización</p><pre><br>components:<br> schemas:<br> Product:<br> type: object<br> required: [id, name, price]<br> properties:<br> id: { type: string }<br> name: { type: string }<br> price: { type: number, minimum: 0 }<br> <br> securitySchemes:<br> bearerAuth:<br> type: http<br> scheme: bearer<br></pre><p>4. Versionado de API</p><pre><br>servers:<br> - url: http://localhost:4010/v1<br> description: API Version 1<br> - url: http://localhost:4010/v2<br> description: API Version 2<br></pre><p>5. Variables de entorno</p><pre><br># .env<br>PRISM_PORT=4010<br>PRISM_DELAY=0<br>PRISM_LOG_LEVEL=info<br># Script de inicio<br>#!/bin/bash<br>source .env<br>prism mock openapi.yaml \<br> - port $PRISM_PORT \<br> - delay $PRISM_DELAY \<br> - log-level $PRISM_LOG_LEVEL \<br> - cors<br></pre><h3>Lecciones aprendidas</h3><p>Lo que funciona bien</p><ol><li><strong>Desarrollo paralelo:</strong> <em>Frontend</em> y <em>backend</em> pueden trabajar simultáneamente.</li><li><strong>Prototipado rápido: </strong>Demos en minutos sin infraestructura.</li><li><strong><em>Testing</em> aislado:</strong> <em>Tests </em>estables sin dependencias externas.</li><li><strong>Documentación viva:</strong> OpenAPI sirve como <em>docs</em> y <em>mock.</em></li><li><strong><em>Onboarding: </em></strong>Nuevos <em>devs </em>pueden correr el proyecto inmediatamente.</li></ol><p>Limitaciones</p><ol><li><strong>No es una base de datos:</strong> Prism no persiste datos entre <em>requests.</em></li><li><strong>Lógica limitada: </strong>No puede ejecutar lógica de negocio compleja.</li><li><strong>Sin estado: </strong>Cada <em>request</em> es independiente.</li><li><strong><em>Performance: </em></strong>No usar en producción, solo desarrollo/<em>testing.</em></li></ol><h4>Conclusión</h4><p><strong>Prism Mock Server</strong> es una herramienta indispensable para desarrollo moderno:</p><ul><li>Acelera el desarrollo eliminando bloqueos entre equipos.</li><li>Mejora la calidad con <em>tests</em> aislados y reproducibles.</li><li>Documenta tu API de forma ejecutable.</li><li>Reduce costos de infraestructura de desarrollo.</li></ul><p><strong>Próximos pasos</strong></p><ol><li>Define tu contrato OpenAPI.</li><li>Instala Prism (`npm i -g @stoplight/prism-cli`).</li><li>Ejecuta `prism mock openapi.yaml — cors`.</li><li>Conecta tu <em>frontend.</em></li><li>¡Desarrolla sin límites!</li></ol><h4>Recursos adicionales</h4><p><strong>Prism Documentation</strong>: [<a href="http://stoplight.io/open-source/prism%5D(https://stoplight.io/open-source/prism)">stoplight.io/open-source/prism](https://stoplight.io/open-source/prism)</a><br><strong>OpenAPI Specification</strong>: [<a href="http://spec.openapis.org/oas/latest.html%5D(https://spec.openapis.org/oas/latest.html)">spec.openapis.org/oas/latest.html](https://spec.openapis.org/oas/latest.html)</a><br><strong>Swagger Editor:</strong> (para diseñar tu OpenAPI): [<a href="http://editor.swagger.io/">editor.swagger.io</a>](<a href="https://editor.swagger.io/">https://editor.swagger.io</a>)<br><strong>Tutorial de OpenAPI</strong>: [<a href="http://learn.openapis.org/">learn.openapis.org</a>](<a href="https://learn.openapis.org/">https://learn.openapis.org</a>)</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=a440fb930456" width="1" height="1" alt=""><hr><p><a href="https://medium.com/somos-pragma/prism-peque%C3%B1o-tutorial-para-empezar-a-usarlo-desde-0-r%C3%A1pidamente-a440fb930456">Prism: pequeño tutorial para empezar a usarlo desde cero rápidamente</a> was originally published in <a href="https://medium.com/somos-pragma">Pragma</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Cómo Implementar Autenticación Social en IONIC con Supabase (multiplataforma)]]></title>
            <link>https://medium.com/@diegocaceres1997garcia/c%C3%B3mo-implementar-autenticaci%C3%B3n-social-en-ionic-con-supabase-4b168d510259?source=rss-9daf2182b687------2</link>
            <guid isPermaLink="false">https://medium.com/p/4b168d510259</guid>
            <category><![CDATA[ionic-framework]]></category>
            <category><![CDATA[ionic]]></category>
            <category><![CDATA[supabase]]></category>
            <dc:creator><![CDATA[Diego Caceres]]></dc:creator>
            <pubDate>Tue, 02 Sep 2025 21:33:02 GMT</pubDate>
            <atom:updated>2025-09-08T21:09:48.481Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*yo8gDy2EpG8fFpQRjqUuHg.png" /><figcaption>Pragma creator</figcaption></figure><h3><strong>Introducción</strong></h3><p>En el mundo actual, donde las aplicaciones móviles son una parte integral de nuestras vidas, la autenticación social se ha convertido en una característica esencial. Permite a los usuarios registrarse e iniciar sesión en aplicaciones utilizando sus cuentas de redes sociales, como Google o Facebook, lo que simplifica el proceso y mejora la experiencia del usuario. En este artículo, exploraremos cómo implementamos la autenticación social en una aplicación creada en IONIC/angular utilizando Supabase, con un enfoque especial en la plataforma Android (cabe aclarar que de la misma manera lo puedes aplicar en otros tipos de tecnología multiplataforma).</p><p>🚨 Atención: Se espera que en este punto ya tengas configurado cosas como los métodos de inicio de sesión desde supabase, además de que ya tenga registrada o creada dicha app o proyecto en Google y Facebook (o cualquier método de inicio de sesión por medio de redes sociales que quieras usar), si por casualidad aún no lo tienes, te invito a visitar este <a href="https://supabase.com/docs/guides/auth/social-login">link</a> para poder ver el paso a paso desde la documentación oficial de supabase. Así mismo por plataformas como youtube hay miles de videos que te podrían guiar para configurar dichas redes; sumamente importante ya que sin esto sería imposible que el OAuth funcione correctamente en nuestras aplicaciones.</p><h4>Configuración Inicial</h4><p><strong>Capacitor y Enlaces Profundos 🔗</strong></p><p>Para empezar, configuramos <a href="https://capacitorjs.com/">Capacitor</a>, una herramienta que nos permite integrar funcionalidades nativas en aplicaciones web. Definimos el ID de la aplicación y configuramos los enlaces profundos, que son esenciales para manejar las redirecciones de OAuth. Esto significa que cuando un usuario se autentica a través de Google o Facebook, es redirigido de vuelta a nuestra aplicación de manera fluida.</p><pre>import type { CapacitorConfig } from &#39;@capacitor/cli&#39;;<br><br>const config: CapacitorConfig = {<br>  appId: &#39;com.app.mobile&#39;,<br>  appName: &#39;app&#39;,<br>  webDir: &#39;www&#39;,<br>  plugins: {<br>    App: {<br>      url: &#39;app://auth-callback&#39;<br>    }<br>  },<br>  server: {<br>    androidScheme: &#39;https&#39;<br>  }<br>};<br><br>export default config;</pre><h4>AndroidManifest y Enlace Profundo</h4><p>El archivo `AndroidManifest.xml` es el corazón de cualquier aplicación Android. Aquí, añadimos un filtro de intentos que permite a nuestra aplicación interceptar las URL de redirección de OAuth. Esto asegura que, después de que un usuario se autentique, la aplicación pueda manejar la respuesta y completar el proceso de inicio de sesión.</p><pre>&lt;activity<br>  android:name=&quot;.MainActivity&quot;<br>  android:launchMode=&quot;singleTask&quot;<br>  android:exported=&quot;true&quot;<br>  android:screenOrientation=&quot;portrait&quot;<br>  android:windowSoftInputMode=&quot;adjustResize&quot;&gt;<br><br>  &lt;intent-filter&gt;<br>    &lt;action android:name=&quot;android.intent.action.MAIN&quot; /&gt;<br>    &lt;category android:name=&quot;android.intent.category.LAUNCHER&quot; /&gt;<br>  &lt;/intent-filter&gt;<br><br>  &lt;intent-filter android:autoVerify=&quot;true&quot;&gt;<br>    &lt;action android:name=&quot;android.intent.action.VIEW&quot; /&gt;<br>    &lt;category android:name=&quot;android.intent.category.DEFAULT&quot; /&gt;<br>    &lt;category android:name=&quot;android.intent.category.BROWSABLE&quot; /&gt;<br>    &lt;data android:scheme=&quot;app&quot; android:host=&quot;auth-callback&quot; /&gt;<br>  &lt;/intent-filter&gt;<br>&lt;/activity&gt;</pre><h4>Implementación del Servicio de Autenticación</h4><p><strong>SupabaseAuthService</strong></p><p>El servicio de autenticación de Supabase es donde ocurre la magia. Implementamos un método que maneja el flujo de OAuth, intercambiando el <a href="https://supabase.com/docs/guides/auth/sessions/pkce-flow">código de autorización por una sesión de usuario activa</a>. Esto es crucial porque permite que el usuario acceda a la aplicación sin problemas, utilizando sus credenciales de redes sociales.</p><pre>private static readonly MOBILE_REDIRECT_SCHEME = &#39;app://auth-callback&#39;;<br><br>private getRedirectTo(): string {<br>  if (Capacitor.isNativePlatform()) {<br>    return SupabaseAuthService.MOBILE_REDIRECT_SCHEME;<br>  }<br>  return `${navigationUrl.baseUrlDev}/${navigationUrl.dashboard}`;<br>}</pre><pre>async loginWithGoogle(): Promise&lt;OAuthResponse&gt; {<br>  const { data, error } = await this.supabase.auth.signInWithOAuth({<br>    provider: &#39;google&#39;,<br>    options: { redirectTo: this.getRedirectTo(), skipBrowserRedirect: true, queryParams: { prompt: &#39;consent&#39; } },<br>  });<br>  if (error) throw error;<br>  if (data?.url) await Browser.open({ url: data.url });<br>  return data as unknown as OAuthResponse;<br>}</pre><pre>public async handleOAuthCallback(url: string): Promise&lt;void&gt; {<br>  const urlObj = new URL(url);<br>  const authCode = urlObj.searchParams.get(&#39;code&#39;) || &#39;&#39;;<br>  const { data, error } = await this.supabase.auth.exchangeCodeForSession(authCode);<br>  if (error) throw error;<br>  if (data?.session?.user) {<br>    const mapped = this.mapUser(data.session.user as any);<br>    this.currentUserSubject.next(mapped);<br>    await CapacitorStorageAdapter.setItem(&#39;supabase_session&#39;, JSON.stringify(data.session));<br>  }<br>}</pre><h4>Inicialización de la Aplicación</h4><p><strong>Manejo de Enlaces Profundos</strong></p><p>En el componente principal de la aplicación, configuramos un oyente para manejar los enlaces profundos. Esto significa que cuando la aplicación se abre a través de un enlace profundo, podemos redirigir al usuario al lugar correcto dentro de la aplicación, como el panel de control, después de una autenticación exitosa.</p><pre>import { App as CapacitorApp, URLOpenListenerEvent } from &#39;@capacitor/app&#39;;<br>import { Browser } from &#39;@capacitor/browser&#39;;<br><br>private setupDeepLinkListener() {<br>  CapacitorApp.addListener(&#39;appUrlOpen&#39;, async (event: URLOpenListenerEvent) =&gt; {<br>    const incomingUrl = event.url || &#39;&#39;;<br>    if (incomingUrl.startsWith(&#39;app://&#39;)) {<br>      await this.authService.handleOAuthCallback(incomingUrl);<br>      try { await Browser.close(); } catch {}<br>      this.router.navigateByUrl(&#39;/dashboard&#39;);<br>    }<br>  });<br>}</pre><h4>Retroalimentación de la UI</h4><p><strong>Cargadores y Toasts Personalizados</strong></p><p>Para mejorar la experiencia del usuario, podemos desarrollar cargadores y toasts personalizados. Estos elementos de UI proporcionan retroalimentación visual clara, asegurando que los usuarios siempre sepan lo que está sucediendo, ya sea que estén esperando que se complete un proceso o recibiendo una notificación de que se inico sesión correctamente.</p><pre>export async function showLoader(message = &#39;Cargando...&#39;): Promise&lt;void&gt; { /* overlay DOM */ }<br>export async function hideLoader(): Promise&lt;void&gt; { /* ocultar overlay */ }<br><br>export async function showToast(message: string, type: ToastType, duration: &#39;short&#39; | &#39;long&#39; = &#39;short&#39;): Promise&lt;void&gt; {<br>  const backgroundColor = type === ToastType.SUCCESS ? &#39;#28a745&#39;<br>    : type === ToastType.ERROR ? &#39;#FF4545&#39;<br>    : type === ToastType.WARNING ? &#39;#ffc107&#39;<br>    : &#39;#323232&#39;;<br>  // render DOM-only toast sin icono nativo<br>}</pre><h4>Gestión de Construcción y Dependencias</h4><p><strong>Configuración de Gradle</strong></p><p>Aseguramos que todas las dependencias necesarias estén incluidas en la configuración de Gradle. Esto garantiza que la aplicación se construya correctamente y tenga acceso a todas las bibliotecas necesarias para funcionar sin problemas. Acordemonos que el gradle es parte importante para el correcto funcionamiento de cualquier aplicación en android.</p><pre>if (this.platform.is(&#39;android&#39;)) {<br>  await StatusBar.setOverlaysWebView({ overlay: true });<br>  await StatusBar.setStyle({ style: Style.Dark });<br>  await StatusBar.setBackgroundColor({ color: &#39;#00000000&#39; });<br>}</pre><p>styles.xml:</p><pre>&lt;style name=&quot;AppTheme.NoActionBar&quot; parent=&quot;Theme.AppCompat.DayNight.NoActionBar&quot;&gt;<br>  &lt;item name=&quot;windowActionBar&quot;&gt;false&lt;/item&gt;<br>  &lt;item name=&quot;windowNoTitle&quot;&gt;true&lt;/item&gt;<br>  &lt;item name=&quot;android:background&quot;&gt;@null&lt;/item&gt;<br>  &lt;item name=&quot;android:windowTranslucentStatus&quot;&gt;true&lt;/item&gt;<br>  &lt;item name=&quot;android:windowTranslucentNavigation&quot;&gt;true&lt;/item&gt;<br>&lt;/style&gt;</pre><h4>Pruebas e Iteración</h4><p><strong>Generación de APK y Pruebas</strong></p><p>Realizamos pruebas exhaustivas generando APKs y probándolos en dispositivos Android reales. Este proceso nos permitirá identificar y resolver problemas antes de lanzar la aplicación al público, asegurando una experiencia de usuario de alta calidad.</p><h4>Conclusión</h4><p>Implementar la autenticación social en Android con Supabase para nuestra aplicación fue un viaje lleno de aprendizajes. Desde la configuración inicial hasta las pruebas finales, cada paso fue crucial para asegurar que la aplicación funcione de manera fluida y eficiente. Al final, logramos una integración que no solo mejora la experiencia del usuario, sino que también simplifica el proceso de autenticación, haciendo que sea más accesible para todos.</p><p>Así mismo aclarar que aunque al principio parezca díficil, siguiendo paso a paso el articulo podrás hacerlo de manera breve y si por casualidad deseas ver el repositorio o el proyecto en vivo solo es que se comuniquen conmigo y con gusto les ayudo ya que esto surgió de la necesidad de ver muy poca ayuda al rededor de internet sin ser claros como es que habría que hacerlo. No siendo más, hasta luego. ¡Happy coding! 🚀</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=4b168d510259" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Entendiendo Content Projection en Angular: Más allá del `<ng-content>` básico]]></title>
            <link>https://medium.com/somos-pragma/entendiendo-content-projection-en-angular-m%C3%A1s-all%C3%A1-del-ng-content-b%C3%A1sico-87c0e94c0a61?source=rss-9daf2182b687------2</link>
            <guid isPermaLink="false">https://medium.com/p/87c0e94c0a61</guid>
            <category><![CDATA[angular]]></category>
            <category><![CDATA[content-projection]]></category>
            <dc:creator><![CDATA[Diego Caceres]]></dc:creator>
            <pubDate>Mon, 31 Mar 2025 23:36:15 GMT</pubDate>
            <atom:updated>2025-04-02T20:37:06.703Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*0NUNJwTQ5zAAN9jKudvUVA.png" /></figure><h3>Introducción</h3><p>¿Te ha pasado que necesitas un componente flexible al que puedas inyectarle contenido personalizado desde el exterior? Content Projection es una de las características menos comentadas, pero más poderosas de Angular. Permite a los desarrolladores construir componentes verdaderamente reutilizables y adaptables sin acoplar el contenido al diseño.</p><p>En este artículo, exploraremos desde el uso básico de `&lt;ng-content&gt;` hasta un escenario intermedio con múltiples proyecciones, todo explicado de forma sencilla.</p><h4>🔍 ¿Qué es Content Projection?</h4><p>Content Projection (proyección de contenido) es una técnica que permite insertar contenido hijo en una plantilla de componente. En lugar de definir todo el contenido dentro del componente hijo, el componente padre le “inyecta” contenido.</p><p>Esto es especialmente útil para diseñar componentes de interfaz que deben ser flexibles como tarjetas, modales, botones con iconos, etc. En cierto sentido, es similar a los `slots` en Web Components o a `props.children` en React.</p><h4>📄 Ejemplo básico: uso de `&lt;ng-content&gt;`</h4><p>Supongamos que quieres crear un componente `Card` reutilizable. En lugar de definir el contenido estáticamente, usarás `&lt;ng-content&gt;` para permitirle al consumidor del componente insertar lo que necesite.</p><p><em>Card component:</em></p><pre>&lt;div class=&quot;card&quot;&gt;<br> &lt;ng-content&gt;&lt;/ng-content&gt;<br>&lt;/div&gt;</pre><p><em>Uso desde un componente padre:</em></p><pre>&lt;app-card&gt;<br> &lt;h2&gt;Hola mundo&lt;/h2&gt;<br> &lt;p&gt;Este es un contenido proyectado.&lt;/p&gt;<br>&lt;/app-card&gt;</pre><p><strong><em>Resultado:</em></strong></p><pre>&lt;div class=&quot;card&quot;&gt;<br> &lt;h2&gt;Hola mundo&lt;/h2&gt;<br> &lt;p&gt;Este es un contenido proyectado.&lt;/p&gt;<br>&lt;/div&gt;</pre><p>Esto hace que tu componente `Card` no se acople a un contenido específico, sino que pueda usarse en múltiples contextos.</p><h4>📈 Proyección múltiple con selectores</h4><p>En escenarios un poco más complejos, podrías querer proyectar diferentes partes del contenido en lugares específicos de tu plantilla. Para eso se usa el atributo `select` en los elementos `&lt;ng-content&gt;`.</p><p><strong><em>card.component.html</em></strong></p><pre>&lt;div class=&quot;card&quot;&gt;<br> &lt;header&gt;<br> &lt;ng-content select=&quot;[card-title]&quot;&gt;&lt;/ng-content&gt;<br> &lt;/header&gt;<br> &lt;section&gt;<br> &lt;ng-content&gt;&lt;/ng-content&gt; &lt;! - contenido principal →<br> &lt;/section&gt;<br> &lt;footer&gt;<br> &lt;ng-content select=&quot;[card-footer]&quot;&gt;&lt;/ng-content&gt;<br> &lt;/footer&gt;<br>&lt;/div&gt;</pre><p><em>Uso desde el componente padre:</em></p><pre>&lt;app-card&gt;<br> &lt;h3 card-title&gt;Este es el título&lt;/h3&gt;<br> &lt;p&gt;Contenido principal del card&lt;/p&gt;<br> &lt;div card-footer&gt;Pie del componente&lt;/div&gt;<br>&lt;/app-card&gt;</pre><p>Angular identificará cada sección por los atributos que hayas definido y los colocará en su lugar correspondiente.</p><h4>⚠️ Buenas prácticas y consideraciones</h4><p>- Usa Content Projection para contenido visual, no para pasar lógica o datos complejos.<br>- No abuses del `select`, mantenlo claro y semántico.<br>- Puedes combinar `&lt;ng-content&gt;` con directivas como `<a href="http://twitter.com/ContentChild">@ContentChild</a>` si necesitas interactuar con lo proyectado (tema para otro artículo).</p><p>📚 <strong>Conclusión</strong></p><p>Content Projection es una herramienta poderosa en Angular que permite construir componentes altamente reutilizables y adaptables. Desde el uso básico de `&lt;ng-content&gt;` hasta proyección múltiple, entender esta técnica te abrirá muchas puertas en la creación de interfaces modulares y limpias.</p><p>Ahora que lo conoces, te invito a experimentar creando tus propios componentes con contenido proyectado.</p><p><strong>🤙🏻 Bonus</strong>: Puedes leer más en la documentación oficial de Angular sobre Content Projection (<a href="https://angular.io/guide/content-projection">https://angular.io/guide/content-projection</a>).</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=87c0e94c0a61" width="1" height="1" alt=""><hr><p><a href="https://medium.com/somos-pragma/entendiendo-content-projection-en-angular-m%C3%A1s-all%C3%A1-del-ng-content-b%C3%A1sico-87c0e94c0a61">Entendiendo Content Projection en Angular: Más allá del `&lt;ng-content&gt;` básico</a> was originally published in <a href="https://medium.com/somos-pragma">Pragma</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Zoneless: la maravilla de manejar eventos generales a tu ritmo en Angular.]]></title>
            <link>https://medium.com/somos-pragma/zoneless-la-maravilla-de-manejar-tus-eventos-a-tu-ritmo-9ec201512394?source=rss-9daf2182b687------2</link>
            <guid isPermaLink="false">https://medium.com/p/9ec201512394</guid>
            <category><![CDATA[zone]]></category>
            <category><![CDATA[zoneless]]></category>
            <category><![CDATA[angular]]></category>
            <category><![CDATA[computer-science]]></category>
            <dc:creator><![CDATA[Diego Caceres]]></dc:creator>
            <pubDate>Wed, 08 Jan 2025 15:12:47 GMT</pubDate>
            <atom:updated>2025-01-15T19:20:28.964Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*EOFb0a1q5KaM09RiHj9hpg.png" /></figure><p>¿Te imaginas una forma en la que tus aplicaciones creadas en Angular puedan tener un rendimiento mucho mejor de lo esperado? ¿Poder experimentar cómo tú mismo puedes controlar los eventos de tu aplicación y asegurar a tus usuarios la mejor experiencia? Además, ¿controlar de una manera mucho más eficiente dichos eventos, entregando una velocidad inimaginable? Pues hoy es tu día de suerte, porque aprenderás qué es una aplicación <em>zoneless</em> y cómo esta puede mejorar la experiencia de tus usuarios.</p><h4><strong>Zoneless, ¿qué es eso? 🤔</strong></h4><p>Históricamente las aplicaciones creadas en angular corren con un manejador de eventos asíncronos por defecto llamado <a href="https://www.npmjs.com/package/zone.js?activeTab=readme">zone.js</a>, esta biblioteca que fue ajustada y que viene desde el core de angular (y que se piensa remover a futuro) es la encargada de crear un contexto de ejecución que persiste a través de las tareas asíncronas, puede considerarlo como un almacenamiento local de sub procesos para máquinas virtuales de JavaScript.</p><p>Entre pocas palabras: este manejador de eventos es los que nos permite poder gestionar de una manera global los eventos asíncronos de nuestra aplicación.</p><p><strong>Entonces… ¿qué lograríamos si lo quitamos?</strong></p><p>Algo tan maravilloso como sencillamente tener pleno control sobre nuestros eventos asíncronos… eso sí, toca manejarlo con mucho cuidado ya que si no se nos puede convertir en un dolor de cabeza.</p><p><strong>¡Llegó la hora!, Manos a la obra </strong>👷🏻</p><p>Lo que primero vamos hacer es crear e <a href="https://docs.angular.lat/tutorial/toh-pt0">inicializar nuestra aplicación en angular desde 0</a>, ya sea en la versión 18 o 19, después de iniciada vamos a irnos al app.config.ts:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/846/1*QKVz0epgofQXzjU7ws69IQ.png" /><figcaption>app.config.ts</figcaption></figure><p>Y cambiaremos el provideZoneChangeDetection por:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/846/1*ADNZD8Mcd5nDIyNyXkJpQA.png" /><figcaption>app.config.ts</figcaption></figure><p>Todo esto lo hacemos con el ánimo de <strong>cambiar la detección de cambios que viene por defecto en nuestra aplicación</strong> a la manera experimental de zoneless.</p><p>Después vamos a eliminarlo de nuestro <a href="https://developer.mozilla.org/es/docs/Glossary/Polyfill">polyfill</a> en el angular.son:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/846/1*rhmhYzQuFuVGGMPdhFHTrw.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/846/1*x0bjRNwJhTH1JHUJvZh55w.png" /><figcaption>angular.json</figcaption></figure><p>Después de esto ya estaría listo para poder comenzar a codificar sin el zone.js, como consejo les diría que tengan <strong>mucho cuidado </strong>editando cosas del polyfill y que hagan una búsqueda en dicho archivo y los elimine uno por uno; si tienen la aplicación corriendo, apaguen y vuelvan a correr. Para poder volver a asegurar de que no tienen el zone activo lo pueden comprobar en su navegador con la aplicación corriendo el siguiente comando en la consola:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/573/1*lmdeGNNpiwHVvjDH3Rft5A.png" /><figcaption>prueba en navegador para comprobación del zone</figcaption></figure><p>Si ya no esta activo, colocándomelas la palabra zone, les debería salir ese tipo de error ✅.</p><p>A continuación voy a mostrar un ejemplo práctico y sencillo de como se puede usar zoneless, pueden hacer dicho ejemplo en cualquier archivo de su proyecto ya que es un ejemplo rápido.</p><p><strong>¡Vamos al ejemplo! </strong>⌨️</p><p>Nos vamos a ubicar en nuestro html o template donde quieran desarrollar el ejemplo y vamos a colocar esto (puede ser en su index.html o app.html):</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/388/1*K8UVItyZIEay4fr6XiV8gw.png" /><figcaption>template html</figcaption></figure><p>En este ejemplo vamos a usar un contador que se va ir actualizando con el tiempo usando un setInterval, de primera mostraré como está hecho el código en el componente (muy sencillo) sin usar zoneless:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/388/1*SaLpinwcpc7HZE3oWuq7Cw.png" /><figcaption>component ts</figcaption></figure><p>Como pueden observar solo creamos una variable llamada tick y la inicializamos en 0, después en el ngOnInit inicializamos el setInterval para que comience a contar:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/352/1*0J__44z8xH9R1p0Nm1osyw.gif" /></figure><p><strong>🚨Esto en teoría si tienen el zoneless ya activo no debería funcionar, pero si quieren pueden sacar una rama para probar tanto la parte zoneless como la normal.</strong></p><p>Siguiendo con el ejercicio vamos ahora con <strong>zoneless</strong>:</p><ul><li>Usando markForCheck:</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/388/1*QnExDCUM2JOvOwLSAt9VmQ.png" /><figcaption>component ts</figcaption></figure><p>Inyectando el changeDetectorRed podemos hacer saber al sistema cuando dichos cambios suceden o deberían actualizarse.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/352/1*P2ve1vqROuMqZdEkwRT8Lw.gif" /></figure><h4><strong>Pero… ¿Qué es el ChangeDetectorRef?</strong></h4><p>El ChangeDetectorRef es una clase en Angular que proporciona herramientas para interactuar directamente con el sistema de detección de cambios (Change Detection). Es especialmente útil cuando trabajas en un entorno <strong>“zoneless”</strong> (sin Zone.js), donde Angular no puede realizar automáticamente la detección de cambios.</p><ul><li>Usando Signals:</li></ul><p>En nuestro componente vamos a convertir la variable anteriormente creada en un signal y la vamos a actualizar dentro del setInterval:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/352/1*sCfBHrych3Bd5qR4Wnph1A.png" /><figcaption>component ts</figcaption></figure><p>Después de dicha actualización en el componente ts nos faltaría modificarlo en nuestro template de la siguiente manera:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/352/1*eY3x2fAuNzIIvXfhbyFtwA.png" /><figcaption>template html</figcaption></figure><p>Como pueden ver, solo se le agrego unos paréntesis al tick y:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/352/1*vgKbNCQ7wZ4DrVW-BUTuKg.gif" /><figcaption>visualización del proyecto funcionando</figcaption></figure><p><strong>✅ De nuevo esta funcionando perfectamente pero… ¿qué es un signal?:</strong></p><p>Los <strong>signals</strong> son una nueva característica introducida para <strong>gestionar estados reactivos</strong> de una forma más sencilla y eficiente. Los signals están inspirados en la reactividad utilizada en frameworks como SolidJS, pero adaptados al ecosistema de Angular.</p><h4><strong>¿Y cuáles son los pros y los contra?</strong></h4><p><strong>PROS:</strong></p><p>• Rendimiento mejorado: Reducción de ciclos de detección de cambios innecesarios.</p><p>• Más control: los desarrolladores controlan cuándo debe actualizarse la interfaz de usuario.</p><p>• Depuración más sencilla: es más fácil rastrear cuándo y por qué se produce una actualización de la interfaz de usuario.</p><p><strong>CONTRAS:</strong></p><p>• Más texto repetitivo: los desarrolladores deben gestionar explícitamente la detección de cambios.</p><p>• Potencial de errores: olvidarse de activar la detección de cambios podría provocar estados de interfaz de usuario obsoletos o inconsistentes.</p><ul><li>Curva de aprendizaje: Requiere una comprensión sólida del sistema de detección de cambios de Angular.</li></ul><p>🚀<a href="https://github.com/Diegocaceres97/zoneless-proof/tree/zonedetection-active"> <strong>Link repositorio.</strong></a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=9ec201512394" width="1" height="1" alt=""><hr><p><a href="https://medium.com/somos-pragma/zoneless-la-maravilla-de-manejar-tus-eventos-a-tu-ritmo-9ec201512394">Zoneless: la maravilla de manejar eventos generales a tu ritmo en Angular.</a> was originally published in <a href="https://medium.com/somos-pragma">Pragma</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[LogRocket: how this tool can benefit you and your project]]></title>
            <link>https://medium.com/somos-pragma/logrocket-how-this-tool-can-benefit-you-and-your-project-cd4957361956?source=rss-9daf2182b687------2</link>
            <guid isPermaLink="false">https://medium.com/p/cd4957361956</guid>
            <category><![CDATA[web]]></category>
            <category><![CDATA[analytics]]></category>
            <category><![CDATA[ionic]]></category>
            <category><![CDATA[events]]></category>
            <category><![CDATA[logrocket]]></category>
            <dc:creator><![CDATA[Diego Caceres]]></dc:creator>
            <pubDate>Thu, 12 Sep 2024 15:34:51 GMT</pubDate>
            <atom:updated>2024-09-23T19:58:24.543Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*EuZJbHUs1-QEoxXCa8oLBw.png" /></figure><p>Hello coders, I hope that everything is going great. Today I want to share a way to create your funnel through Logrocket, but before this… I will start with a simple question: What is <a href="https://logrocket.com/">Logrocket</a>?</p><h3>What is logrocket?</h3><p>LogRocket is a web tool that brings us the possibility to record every action that we do on the web or the application. For example, with this tool, we may easily record an application as well to keep important information, on our platform This tool is easy to install and needs to be run with the npm installation script (in the web or mobile hybrid applications) and the configuration is easily recorded in a section.</p><ul><li>So… now the question is: How can I add my funnel? Before answering, I am going to briefly explain to you what funnel means 🤓.</li></ul><h3>Funnel is?</h3><p>Funnel is typically related to the customer journey or process flow usually users go through the funnel before reaching a desired action, such as making a purchase, signing up for a service, or completing a task.<br>Right now: the important and main topic here is:</p><h3>How can I set this tool to implement my funnel there?</h3><p>First, it is valuable to configure the Logrocket sign in the project, I am going to show you how this process is completed with an angular project where I use abstraction to implement this same.<br>This is the abstraction class where I extend into the service:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Ouc81SIMfHQfI9ivo7aDdw.png" /><figcaption>Abstract class</figcaption></figure><p>The service is going to be used in.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*aLcyu7pxjamvZQvOedGTmw.png" /><figcaption>Service implementation</figcaption></figure><p>⚠️<em>It is necessary to let you know that logRocket provided us with a key, that in my current situation, I decided to keep in the environment of the project.</em></p><p>That was when I started to create the abstraction and implementation, now it’s necessary to start the logrocket recording (in the place that you think would be necessary to begin).</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/594/1*LUA591pthG8HV41dQ-cgrA.png" /><figcaption>Initialization of logRocket</figcaption></figure><p>In my case, I began on the component app because I wanted to record from the beginning of the application. Once we have the log rocket working, we can see it in the dashboard or our project (we should run the application):</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*AUi6QSxN5Y1qT8ZFUIAIww.png" /><figcaption>LogRocket platform</figcaption></figure><p>Now, our priority is to set up the track event to configure the funnel into the logrocket platform.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*MVU119ouTUIAIPlmhyB4PQ.png" /><figcaption>Used of Dispatch event</figcaption></figure><p>We created a function in the service of logRocket where we can dispatch this track, so right now we can easily do whatever we want to do.<br>- The page viewed is the eventName.<br>- The object of the data is to receive the function, in this case, I am going to send a view of the current face inside an object (viewID).</p><p><strong>Afterwards</strong>, we just start interacting with our project/application, this could be only the first two web pages, then, we are going to verify if the recording is available on the platform. Once we confirm it, we are going to deploy the options (in the left part of the platform) we start using a funnel to create a new funnel.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/227/1*WEDfr_LuDwsLR0z8T8S2tw.png" /><figcaption>Conversion funnel option</figcaption></figure><p>To select a new funnel there are steps to create a custom event, then the specific property and if it is correct we should view some word/option there (in my case was view ID), and next to that we are going to select another option like the last, and among the options, we will finally pick the correct one.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*YLy8KplOWDPX_nA-8-abVg.png" /><figcaption>Creation of convertion funnel</figcaption></figure><p>There exists another option that you can explore like this (which you can search for a click in specific) but for this case, we are going to use the last option:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*iRgpS-L6GzfQhNSeWX1WkA.png" /><figcaption>Another options</figcaption></figure><p>If it all is correct, we scroll down and see something like this (in this example we just see one record because I just used one user for that):</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*93MmO3cAvL_mKxcP0I96gQ.png" /><figcaption>Funnel data</figcaption></figure><p>With this as the last part, we can say that it’s 100% functional and correct then you just have to save it and there is… your first funnel in logRocket🤙🏻🥹 I hope you enjoy this. <strong><em>¡Happy coding! </em></strong>🤖</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=cd4957361956" width="1" height="1" alt=""><hr><p><a href="https://medium.com/somos-pragma/logrocket-how-this-tool-can-benefit-you-and-your-project-cd4957361956">LogRocket: how this tool can benefit you and your project</a> was originally published in <a href="https://medium.com/somos-pragma">Pragma</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Cómo usar postMessage para una Comunicación Segura entre Orígenes Cruzados (diferentes origenes)]]></title>
            <link>https://medium.com/somos-pragma/entendiendo-postmessage-para-una-comunicaci%C3%B3n-segura-entre-or%C3%ADgenes-cruzados-diferentes-origenes-0f38f87784cb?source=rss-9daf2182b687------2</link>
            <guid isPermaLink="false">https://medium.com/p/0f38f87784cb</guid>
            <category><![CDATA[postmessage]]></category>
            <dc:creator><![CDATA[Diego Caceres]]></dc:creator>
            <pubDate>Tue, 02 Jul 2024 22:28:25 GMT</pubDate>
            <atom:updated>2024-07-11T13:59:54.749Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/640/1*9vCnea75jz4972C_3P4GDQ.png" /></figure><p>Hola coders 🖖🏻, en esta publicación, te presentaré la API postMessage, una característica asombrosa pero poco conocida para la comunicación segura entre orígenes cruzados. ¡Si tienes algún comentario, me encantaría escucharlo!</p><h4>Declaración del Problema</h4><p>Imagina que tienes una aplicación web que necesita comunicarse entre diferentes ventanas o iframes. Por ejemplo, puedes tener una aplicación principal ejecutándose en la ventana padre y una ventana hija o iframe que necesita intercambiar datos con el padre. Debido a la política de mismo origen, la comunicación directa entre estas ventanas puede ser desafiante e insegura. Aquí es donde entra en juego postMessage, permitiendo una comunicación segura y confiable entre diferentes contextos de navegación.</p><h4>¿Qué es postMessage?</h4><p>postMessage es un método que te permite enviar mensajes de una ventana a otra de manera segura y controlada. Es especialmente útil para la comunicación entre una ventana padre y una ventana hija, o entre iframes y su documento padre. Al usar postMessage, podemos eludir de manera segura la política de mismo origen y asegurar que nuestros intercambios de datos sean seguros y confiables.</p><h4>Ejemplo Práctico</h4><p>Consideremos un ejemplo práctico. Supongamos que tienes una aplicación principal ejecutándose en una ventana padre y abres una ventana hija para mostrar información adicional. Deseas que la ventana hija envíe datos de vuelta a la ventana padre después de algún procesamiento.</p><p>Envío de un Mensaje desde la Ventana Padre Aquí está cómo puedes enviar un mensaje desde la ventana padre a la ventana hija:</p><pre>// Open a new window<br>const childWindow = window.open(&#39;child.html&#39;, &#39;Child Window&#39;);<br><br>// Wait until the child window is fully loaded<br>childWindow.addEventListener(&#39;load&#39;, () =&gt; {<br>  // Send a message to the child window<br>  const message = &#39;Hello from the parent window!&#39;;<br>  const targetOrigin = &#39;https://your-domain.com&#39;;<br>  childWindow.postMessage(message, targetOrigin);<br>});</pre><h4>Recepción de un Mensaje</h4><p>En la Ventana Hija En la ventana hija, puedes recibir y procesar el mensaje de la siguiente manera:</p><pre>window.addEventListener(&#39;message&#39;, (event) =&gt; {<br>  // Validate the origin of the message<br>  if (event.origin !== &#39;https://your-domain.com&#39;) return;<br><br>  // Process the received message<br>  console.log(&#39;Message received from parent window:&#39;, event.data);<br>});</pre><h4>Envío de una Respuesta desde la Ventana Hija</h4><p>De manera similar, la ventana hija puede enviar una respuesta de vuelta a la ventana padre:</p><pre>// Assuming the parent window reference is available<br>const parentWindow = window.opener;<br><br>// Send a message back to the parent window<br>const responseMessage = &#39;Hello from the child window!&#39;;<br>const targetOrigin = &#39;https://your-domain.com&#39;;<br>parentWindow.postMessage(responseMessage, targetOrigin);</pre><h4>Recepción de la Respuesta en la Ventana Padre</h4><p>En la ventana padre, puedes recibir y procesar la respuesta de la siguiente manera:</p><pre>window.addEventListener(&#39;message&#39;, (event) =&gt; {<br>  // Validate the origin of the message<br>  if (event.origin !== &#39;https://your-domain.com&#39;) return;<br><br>  // Process the received response<br>  console.log(&#39;Response received from child window:&#39;, event.data);<br>});</pre><h4>Consideraciones Clave</h4><ul><li>Valida Orígenes: Siempre valida el origen de los mensajes que recibes. Esto asegura que solo aceptes mensajes de fuentes confiables.</li><li><em>Evita usar: </em>como targetOrigin para prevenir que sitios maliciosos intercepten tus mensajes.</li><li>Manejo Seguro de Datos: Asegúrate de que los datos que se envían y reciben se manejen de manera segura para prevenir fugas de datos o accesos no autorizados.</li></ul><p>Al seguir estas mejores prácticas, puedes utilizar efectivamente postMessage para habilitar una comunicación segura y confiable entre orígenes cruzados en tus aplicaciones web.</p><p>Espero que disfrutes este artículo. Cualquier pregunta, puedes escribirme en Google :).</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=0f38f87784cb" width="1" height="1" alt=""><hr><p><a href="https://medium.com/somos-pragma/entendiendo-postmessage-para-una-comunicaci%C3%B3n-segura-entre-or%C3%ADgenes-cruzados-diferentes-origenes-0f38f87784cb">Cómo usar postMessage para una Comunicación Segura entre Orígenes Cruzados (diferentes origenes)</a> was originally published in <a href="https://medium.com/somos-pragma">Pragma</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>