<?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 Malta on Medium]]></title>
        <description><![CDATA[Stories by Diego Malta on Medium]]></description>
        <link>https://medium.com/@stroklabs?source=rss-e6e8ba1a069b------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*as4_hcH2qXqkV1JFwHmWGw.jpeg</url>
            <title>Stories by Diego Malta on Medium</title>
            <link>https://medium.com/@stroklabs?source=rss-e6e8ba1a069b------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Sat, 21 Nov 2026 16:13:46 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@stroklabs/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[HTML to PDF in Node.js without Puppeteer or Chromium]]></title>
            <link>https://medium.com/@stroklabs/html-to-pdf-in-node-js-without-puppeteer-or-chromium-9b57824a4841?source=rss-e6e8ba1a069b------2</link>
            <guid isPermaLink="false">https://medium.com/p/9b57824a4841</guid>
            <category><![CDATA[developer-tools]]></category>
            <category><![CDATA[open-source]]></category>
            <category><![CDATA[pdf]]></category>
            <category><![CDATA[nodejs]]></category>
            <category><![CDATA[javascript]]></category>
            <dc:creator><![CDATA[Diego Malta]]></dc:creator>
            <pubDate>Thu, 02 Jul 2026 17:08:00 GMT</pubDate>
            <atom:updated>2026-07-02T17:08:00.169Z</atom:updated>
            <content:encoded><![CDATA[<p>Puppeteer is good software. Playwright is good software. Chromium is a good browser.</p><p>The problem starts when a document pipeline quietly becomes a browser operations problem.</p><p>You only wanted to turn an invoice template into a PDF. Now your deploy has to think about browser downloads, system libraries, launch behavior, container size, cold starts, process cleanup, and memory under concurrency.</p><p>That trade-off can be worth it when the input is really a web page.</p><p>It feels stranger when the input is controlled document HTML: invoices, receipts, statements, boletos, reports, notices. These templates usually come from your own code. They do not need JavaScript execution. They need pagination, fonts, images, page numbers, selectable text, and predictable failure when the template leaves the supported shape.</p><p>That is the reason Vellora exists.</p><p>Vellora is an HTML-to-PDF renderer for Node.js with a native, in-process default path. The default package does not install Puppeteer, Playwright, Chromium, wkhtmltopdf, Python, Java, or a sidecar service.</p><p>You pass generated document HTML and data to renderPdf, and you get PDF bytes back from the same Node process.</p><p>Under the hood, Vellora’s native path is a Rust renderer exposed to Node.js through a napi-rs addon. The public API stays JavaScript, the rendering work does not require launching a browser process.</p><p>If you already render HTML with your own templating stack, you can pass that final HTML directly. The data argument is optional; Vellora&#39;s built-in templating is there when you want the document renderer and template binding in the same package.</p><pre>npm install vellora</pre><pre>import { writeFileSync } from &quot;node:fs&quot;;<br>import { renderPdf } from &quot;vellora&quot;;<br><br>const html = `&lt;!doctype html&gt;<br>&lt;html&gt;<br>  &lt;head&gt;<br>    &lt;style&gt;<br>      @page { size: A4; margin: 18mm; }<br>      body { font-family: sans-serif; }<br>    &lt;/style&gt;<br>  &lt;/head&gt;<br>  &lt;body&gt;<br>    &lt;h1&gt;Invoice {{ invoiceNumber }}&lt;/h1&gt;<br>    &lt;p&gt;Total: {{ total | currency(&quot;USD&quot;) }}&lt;/p&gt;<br>  &lt;/body&gt;<br>&lt;/html&gt;`;<br><br>const pdf = await renderPdf(html, {<br>  invoiceNumber: &quot;INV-2026-00417&quot;,<br>  total: 129,<br>});<br><br>writeFileSync(&quot;invoice.pdf&quot;, pdf);</pre><h3>The narrow case is the point</h3><p>A browser renderer accepts the web platform and tries to print whatever page you give it.</p><p>Vellora starts from the other side. It defines a documented HTML/CSS subset for generated documents and rejects unsupported input in strict mode instead of silently producing a wrong PDF.</p><p>That can feel less magical. It is also easier to reason about.</p><p>The default path launches no browser process.</p><p>The renderer validates the template against the documented compatibility table.</p><p>Optional built-in templating handles interpolation, loops, conditionals, and formatting helpers.</p><p>Document features such as @page, page counters, repeated table headers, images, custom fonts, and PDF/A-2b are part of the current shipped surface.</p><p>If a template needs browser print fidelity, you can route that template through the optional Chromium engine instead of moving every document onto the browser path.</p><p>The point is not “browser bad, native good.”</p><p>The point is choosing the smallest renderer that matches the document.</p><h3>What it looks like</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/794/1*aSwdYDyQtbfd3rXBOJxHrg.png" /><figcaption>Vellora native output for invoice page 1.</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/794/1*yCi28amqO3d-TCOtEiQVyg.png" /><figcaption>The same invoice page rendered through Vellora’s optional Chromium path.</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/794/1*Zil6af3q5pcJvUv9owaheA.png" /><figcaption>Pixel-diff map between Vellora native and Vellora Chromium for invoice page 1.</figcaption></figure><p>For this artifact, the visual manifest reports matching page dimensions at 794 x 1123 px, 64,988 mismatch pixels (7.29%), and a mean absolute error of 0.0241 against the Chromium reference.</p><p>That is not a universal quality score, and it is not a claim that every document will behave this way. It is a concrete artifact from the repository’s current visual-fidelity harness. The diff image is there to make the differences inspectable: for a real migration, the question is not whether every pixel is identical, but whether the differences matter for that document’s acceptance criteria.</p><h3>What the current data says</h3><p>The repository has a pinned resource benchmark run for the native path and Vellora’s optional Chromium path. This is a snapshot from CI, not a universal promise for every host or template. It is useful because it keeps the discussion concrete.</p><p>Source: Resource Benchmarks run 28302742627 on pinned Linux CI, Node v22.23.0, 4 cores:<br><a href="https://github.com/diomalta/vellora/actions/runs/28302742627">https://github.com/diomalta/vellora/actions/runs/28302742627</a></p><p>The benchmark separates package footprint from external runtime.</p><p>Fresh install measures the npm package footprint. That is why the native and Chromium package installs look almost identical: 28.93 MB for native vellora, 28.94 MB for Vellora Chromium.</p><p>The browser cost shows up separately. The Chromium path needs a 412.28 MB external runtime that the native path does not carry.</p><p>Memory is split the same way. The native path runs in-process, so its relevant number is RSS inside Node. The Chromium path runs browser work out-of-process, so the relevant number is external RSS.</p><p>Native vellora:</p><ul><li>Fresh install: 28.93 MB</li><li>External runtime: N/A</li><li>RSS at concurrency 8: 116.51 MB</li><li>External RSS at concurrency 8: N/A</li><li>Warm median / p95: 17.47 / 17.96 ms</li></ul><p>Vellora Chromium:</p><ul><li>Fresh install: 28.94 MB</li><li>External runtime: 412.28 MB</li><li>RSS at concurrency 8: N/A</li><li>External RSS at concurrency 8: 6425.81 MB</li><li>Warm median / p95: 491.85 / 509.43 ms</li></ul><p>At concurrency 8, the native path reported 116.51 MB RSS inside the Node process. The Chromium path reported 6425.81 MB across external browser processes. Warm latency showed the same shape: 17.47 / 17.96 ms median/p95 for native, versus 491.85 / 509.43 ms for Vellora Chromium.</p><p>The same benchmark artifact also includes Puppeteer and Playwright. I am not quoting them as comparable here because the run marked them non-comparable for this fixture: their output had 1 page while the reference had 3. Timing a one-page output against a three-page reference would make the comparison look cleaner than it is.</p><h3>When to keep the browser</h3><p>Sometimes you should use Puppeteer.</p><p>If your template depends on JavaScript, arbitrary website CSS, browser layout quirks, or exact Chromium print output, a browser renderer is the honest tool. Vellora is not trying to be a browser clone.</p><p>The native path is for a narrower case: generated documents whose markup you control.</p><p>That narrower case is still large. Billing, finance, logistics, healthcare, legal operations, and internal tools all produce document HTML that looks much more like a print template than like a live web app.</p><p>For that kind of input, carrying a full browser through every runtime can be unnecessary weight.</p><h3>Where Vellora fits</h3><p>Use the native path when the template is generated by your application and can stay inside Vellora’s document subset:</p><ul><li>invoices with repeated table headers</li><li>receipts and point-of-sale summaries</li><li>statements and account reports</li><li>boletos and payment notices</li><li>legal or operational notifications</li><li>internal reports that need deterministic PDF output</li></ul><p>The sweet spot is not arbitrary HTML.</p><p>It is document HTML.</p><h3>Where this breaks</h3><p>Vellora’s native renderer does not execute scripts.</p><p>It does not fetch remote assets from inside the document.</p><p>It does not promise full CSS grid/flex/browser parity.</p><p>It is strict by default because a financial document that renders “almost right” can be worse than a document that fails loudly.</p><p>If your acceptance criterion is “matches my current Puppeteer PDF exactly,” keep that browser output as a reference and compare it before switching.</p><h3>Try it</h3><p>The package is on npm:<br><a href="https://www.npmjs.com/package/vellora">https://www.npmjs.com/package/vellora</a></p><p>The source is on GitHub:<br><a href="https://github.com/diomalta/vellora">https://github.com/diomalta/vellora</a></p><p>The documentation starts here:<br><a href="https://diomalta.github.io/vellora/">https://diomalta.github.io/vellora/</a></p><p>If you have a document template that should fit this model and does not, open an issue with the smallest representative case.</p><p>That is the most useful feedback this project can get.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=9b57824a4841" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Como organizar e estruturar projetos  com node.js?]]></title>
            <link>https://medium.com/@stroklabs/como-organizar-e-estruturar-projetos-com-node-js-4845be004899?source=rss-e6e8ba1a069b------2</link>
            <guid isPermaLink="false">https://medium.com/p/4845be004899</guid>
            <category><![CDATA[javascript]]></category>
            <category><![CDATA[expressjs]]></category>
            <category><![CDATA[backend]]></category>
            <category><![CDATA[nodejs]]></category>
            <dc:creator><![CDATA[Diego Malta]]></dc:creator>
            <pubDate>Mon, 10 Jun 2019 23:50:47 GMT</pubDate>
            <atom:updated>2019-06-10T23:54:48.048Z</atom:updated>
            <content:encoded><![CDATA[<h3>Como organizar e estruturar projetos com node.js</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*JH_HgIXBQvuenmUl.jpg" /><figcaption><a href="http://www.esyfix.com/blog/wp-content/uploads/2018/07/nodejs.jpg">http://www.esyfix.com/blog/wp-content/uploads/2018/07/nodejs.jpg</a></figcaption></figure><p>No node temos muita liberdade para construir nossa API REST da forma que desejarmos, quem está começando não sabe ao certo como organizar.</p><p>Talvez em projetos pequenos você não perceba os problemas que isso pode te causar, projetos maiores onde visa escalonar, provavelmente terá problemas com essa organização para manter o código com um alto acoplamento trazendo falta de reutilização de código, falta de estabilidade...</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fgiphy.com%2Fembed%2Fl0HlvtIPzPdt2usKs%2Ftwitter%2Fiframe&amp;url=https%3A%2F%2Fmedia.giphy.com%2Fmedia%2Fl0HlvtIPzPdt2usKs%2Fsource.gif&amp;image=https%3A%2F%2Fi.giphy.com%2Fmedia%2Fl0HlvtIPzPdt2usKs%2F200.gif&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=giphy" width="435" height="261" frameborder="0" scrolling="no"><a href="https://medium.com/media/7fcf3d4b95f1f33814f2617a59a14a4c/href">https://medium.com/media/7fcf3d4b95f1f33814f2617a59a14a4c/href</a></iframe><p>Por isso nesse artigo vamos falar sobre uma estrutura que irá ajudar a trazer uma melhor sustentabilidade e escalonabilidade para sua aplicação.</p><h3>Estrutura de pastas 📚</h3><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/6ca0d21fd354f9c227b66b551b370bd5/href">https://medium.com/media/6ca0d21fd354f9c227b66b551b370bd5/href</a></iframe><blockquote>Lembrando que cada projeto tem suas peculiaridades, então basta você/equipe decidir o que é melhor para adicionar ou remover no seu projeto visando sempre o equilibrio entre agilidade e qualidade na entrega do produto.</blockquote><h3>… controllers e os fardos que elas carregam</h3><p>A prática de atribuir bastantes regras de negócio nos controllers express.js é de fácil visualização, pois na cabeça de quem está começando tudo é uma coisa só.</p><p>E com isso uma controller que começou tendo <em>300 linhas</em><strong><em> </em></strong>de código com o passar do tempo ela pode ficar com mais de <em>1000 linhas</em>. Pois você estará implementando <strong>querys builders, regras de negócios, chamada para serviços externos e muito mais…</strong></p><p>Com isso para <em>testar, reaproveitar código e dar manutenção</em> que deveria ser um trabalho mais fácil acaba se tornando muito complicado.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/751/1*qpELXZNQgMX63di9rZZ76Q.png" /></figure><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/e6d3140610778c53589bb4bd26de9070/href">https://medium.com/media/e6d3140610778c53589bb4bd26de9070/href</a></iframe><p>Acima segue um <em>exemplo ruim</em> de uma controller onde atribuimos todas as responsabilidades em uma única camada, vamos adotar<em> princípio da </em><strong><em>responsabilidade única do SOLID </em></strong><em>para fazer a separação</em><strong><em>.</em></strong></p><blockquote>“Uma classe deve ter <strong>um</strong>, <strong>e apenas um</strong>, motivo para ser modificada”</blockquote><h3>Ao separar as controllers das regras de negócio o que ganhamos?</h3><p>Reutilização de código em outras classes, fazer testes únitarios e de integração ficará mais claro o que de fato você terá que testar em cada um, fácil manutenção já que iremos granularizar nossas responsabilidades…</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/751/1*lCUJfaV5c8XShyte3qRFvQ.png" /></figure><h3><strong>Controllers</strong></h3><p>O controle deve se preocupar em aceitar a solicitação, repassar para o serviço de domínio correto processe a solicitação e entregue a resposta ao cliente.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/365164a1d3901086bf37a361dd6f1713/href">https://medium.com/media/365164a1d3901086bf37a361dd6f1713/href</a></iframe><h3>Services</h3><p>Essa camada é um design pattern que ajuda a abstrair suas regras de negócio, deixando sua controller mais limpa e com a responsabilidade única.</p><p>Um outro ponto importante que a medida que cresce sua aplicação você tende a reutilizar os códigos já implementados nesta camada. Imagine que você tem <strong>três controllers </strong>que faz uso de um service e você precisa alterar alguma parte do código, obviamente você vai utilizar <strong>somente a função no service</strong> para alterar, entretanto se não tivessemos essa camada? Teriamos sair procurando no nosso projeto <strong>todos os lugares que faz o uso daquele trecho de código.</strong></p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/fbfe91bffc53c63b3c2f2b81434cf9cf/href">https://medium.com/media/fbfe91bffc53c63b3c2f2b81434cf9cf/href</a></iframe><p>Para fazer testes unitários será muito mais fácil, sem necessidade de fazer uma request a um endpoint.</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fgiphy.com%2Fembed%2F13G7hmmFr9yuxG%2Ftwitter%2Fiframe&amp;url=https%3A%2F%2Fgiphy.com%2Fgifs%2Fhappy-pokemon-adorable-13G7hmmFr9yuxG&amp;image=https%3A%2F%2Fmedia.giphy.com%2Fmedia%2F13G7hmmFr9yuxG%2Fgiphy.gif&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=giphy" width="435" height="296" frameborder="0" scrolling="no"><a href="https://medium.com/media/a63db8bbe25688f7ebd8108e6c9e6134/href">https://medium.com/media/a63db8bbe25688f7ebd8108e6c9e6134/href</a></iframe><h3>Repositories*</h3><p>Ter querys sql no código de uma service isso torna um código grande e ilegível, por isso atribuimos aos repositories o trabalho de ser uma camada de acesso e interação com as entidades do banco de dados.</p><p>Temos dois pontos que podemos utilizar para falar da utilização de um repository, <strong><em>centralizar regras de recuperação e persistência de dados</em></strong><em> e</em><br><strong><em>abstrair a utilização de ORMs possibilitando a troca por outros ORMs</em></strong><em>,</em> mas vamos falar a verdade é <strong>muito dificil de um projeto ficar trocando de ORM</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/568/1*WpfYs-nYsbVZhpX4aZoFJA.png" /></figure><blockquote>Vale ressaltar que no mundo ideal levariamos a risca o <strong>S</strong> de SOLID e com isso cada classe teria sua responsabilidade única, mas sabemos que não temos tanto tempo para fazer isso no dia-a-dia por isso nem sempre vai ser necessário ter uma classe no repo, pois o metodo utilizado pode ser somente um <strong>findAll(). </strong>Isso vai da avaliação do programador para saber se é necessário a utilização dessa camada.</blockquote><h3>Subscribers (Pub/Sub)</h3><p>Quando se tem uma aplicação onde ela utiliza serviços de terceiros e geralmente fazemos uso na camada de controller junto com a regras de negócio com o tempo a aplicação crescendo é muito provável que iremos acrescentar mais linhas de códigos de serviços externos.</p><p>Abordagem de utilizar um serviço de terceiro de forma imperativo não é a melhor opção para esse caso, por isso é bom trabalhar com eventos sendo emitidos para cada subscriber depois que uma ação for executada na camada da service.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/750/1*eCZUBWMA6Z_JDGcieVFt8w.png" /></figure><h3>Jobs</h3><p>Essa camada é criada para armazenar tarefas agendadas que precisam ser feitas automaticamente em um certo intervalo de tempo. Como nossa regra de negócios está centralizada em um serviço isso facilita a utilização em um cron.</p><p>Devido a forma que o node funciona é melhor evitar a utilização de formas primitivas para agendar uma tarefa e com isso você ganha um controle melhor dos retornos da ação executada.</p><h3>Models</h3><p>Determina a estrutura lógica que representa uma entidade do banco de dados e da forma na qual os dados podem ser manipulados e organizados.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/3d5234dc6e601b7fcd248b4d6510faea/href">https://medium.com/media/3d5234dc6e601b7fcd248b4d6510faea/href</a></iframe><h3>Database</h3><p>Onde organizamos nossas <strong>migrations </strong>para que a equipe tenha o controle do versionamento do banco de dados e dos <strong>seeders </strong>para popular nosso banco com dados inserido pelo desenvolvedor, para mais informação sobre essa parte é só ir nesse artigo abaixo:</p><p><a href="https://medium.com/@diomalta/migrations-e-seeders-no-sequelizejs-67ba3571ed0e">Migrations e Seeders no SequelizeJS</a></p><h3>Utils</h3><p>Trechos de código pequeno que são utilizado por mais de uma classe. Funções que são utilizadas para auxiliar na construção de um código maior e podendo ser utilizado em qualquer parte das camadas aplicação, por exemplo um <em>helper </em>pode utilizar mais de um <em>util </em>para construir um código mais completo para uma finalidade especifica.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/9d5663889641a15f24e80fdf29b907b2/href">https://medium.com/media/9d5663889641a15f24e80fdf29b907b2/href</a></iframe><h3>Helpers</h3><p>Trechos de arquitetura de código que contém apresentações lógicas que podem ser compartilhadas entre as camadas da aplicação contendo várias funções englobada para servir de bootstrap a outros componentes e ergonomia do desenvolvedor.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/164dbc6436ea1c7c8e69b9c0893dcf60/href">https://medium.com/media/164dbc6436ea1c7c8e69b9c0893dcf60/href</a></iframe><h3>Constants</h3><p>A utilização das constantes strings são muito importantes para você poder centralizar uma palavra de retorno de error, sucesso, status HTTP, nome de uma entidade que se repete por várias partes do código pois na hora quando houver uma mudança de valor naquela constantes todas as partes que utilizarem vão ser alteradas sem a necessidade de ficar procurando em cada arquivo pelo projeto.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/bb5e1c683e7c578b807eb8a5acdf7f8b/href">https://medium.com/media/bb5e1c683e7c578b807eb8a5acdf7f8b/href</a></iframe><h3>Config</h3><p>É onde vamos centralizar todas as nossas variáveis de ambiente e outras configurações que utilizaremos pela aplicação, como: acesso a banco de dados, chave secreta, email, testes e muito mais..</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/62d82c387562d189aa3ea91d3826c6d9/href">https://medium.com/media/62d82c387562d189aa3ea91d3826c6d9/href</a></iframe><p>É parecido com o problema que temos com as constantes, imagine termos <strong><em>process.env.JWT_SECRET</em> </strong>espalhados em models, tests, controllers e quando você tiver que alterar o nome da variavel ou algo do tipo por conta que mudou a forma como você cria um token e sair atualizando e caçando cada arquivo para fazer a alteração.</p><h3>Rotas</h3><p>Separamos as rotas das controllers, pois uma rota pode ter vários tipo de requisições (post, get, put, delete, option) e assim mantemos o código limpo.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/5e24257566a83fbed6c678ae6874ecc6/href">https://medium.com/media/5e24257566a83fbed6c678ae6874ecc6/href</a></iframe><h3>Esse padrão é perfeito para qualquer projeto?</h3><p>Cada projeto é único e com isso temos que ter a flexibilidade para adequar com a necessidades que surgem, para essa organização já foi testada em produção correspondendo bem nos quesitos de escalabilidade e sustentabilidade do código e alinhando a agilidade com a qualidade na entrega dos resultados.</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fgiphy.com%2Fembed%2FKJ1f5iTl4Oo7u%2Ftwitter%2Fiframe&amp;display_name=Giphy&amp;url=https%3A%2F%2Fgiphy.com%2Fgifs%2Fjust-thanks-KJ1f5iTl4Oo7u&amp;image=https%3A%2F%2Fmedia.giphy.com%2Fmedia%2FKJ1f5iTl4Oo7u%2Fgiphy-downsized-large.gif&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=giphy" width="435" height="244" frameborder="0" scrolling="no"><a href="https://medium.com/media/5dd5c50ae136784e087fe4ce706edadf/href">https://medium.com/media/5dd5c50ae136784e087fe4ce706edadf/href</a></iframe><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=4845be004899" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Migrations e Seeders no SequelizeJS]]></title>
            <link>https://medium.com/@stroklabs/migrations-e-seeders-no-sequelizejs-67ba3571ed0e?source=rss-e6e8ba1a069b------2</link>
            <guid isPermaLink="false">https://medium.com/p/67ba3571ed0e</guid>
            <category><![CDATA[migration]]></category>
            <category><![CDATA[javascript]]></category>
            <category><![CDATA[sequelize]]></category>
            <category><![CDATA[seeds]]></category>
            <category><![CDATA[nodejs]]></category>
            <dc:creator><![CDATA[Diego Malta]]></dc:creator>
            <pubDate>Sat, 30 Mar 2019 16:07:41 GMT</pubDate>
            <atom:updated>2019-03-30T20:28:45.436Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/250/1*-6qHuOwJfWtkFkymMovJFQ.png" /><figcaption><a href="http://docs.sequelizejs.com/">http://docs.sequelizejs.com/</a></figcaption></figure><h3>Vamos começar com um overview</h3><p>O sequelize é um <em>Object Relational Mapper (ORM)</em> para NodeJS baseado em promises que tem como principal objetivo unir a orientação objeto com a parte relacional, onde faz um mapeamento dos tipos de dados relacional gerando o objeto com a mesma representação dos dados.</p><p>Dando suporte para os bancos já conhecidos, como: Postgres, MySQL, MariaDB, SQLite e Microsoft SQL Server. Atualmente uma grande parte dos desenvolvendores estão utilizando ORMs em seus projetos devido ao ganho de produtividade que eles lhes proporcionam dando suporte nas criações de querys SQL para inserir, alterar e remover dados, gerenciando também nos controles de transações, relacionamentos e muito mais…</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fgiphy.com%2Fembed%2F3ohhwIbKJAT3eUz38s%2Ftwitter%2Fiframe&amp;url=https%3A%2F%2Fmedia.giphy.com%2Fmedia%2F3ohhwIbKJAT3eUz38s%2Fgiphy.gif&amp;image=https%3A%2F%2Fi.giphy.com%2Fmedia%2F3ohhwIbKJAT3eUz38s%2Fgiphy.gif&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=giphy" width="435" height="244" frameborder="0" scrolling="no"><a href="https://medium.com/media/4e3ed7c81c87d9b234bcfab873c9ed89/href">https://medium.com/media/4e3ed7c81c87d9b234bcfab873c9ed89/href</a></iframe><h3>Migrations</h3><p>O banco de dados relacional é uma coleção de dados que já tem uma estrutra de relacionamento predefinidos com uma organização de linhas e colunas.</p><p>Vamos imaginar que estamos trabalhando em uma equipe com um banco de dados relacional e por algum motivo mais de uma pessoa está utilizando a mesma tabela. Para adequar a uma necessidade que surgiu um deles precisa que o <strong>telefone </strong>do usuário na tabela seja representado como um <strong>inteiro </strong>e não uma <strong>string</strong>, então ele dá um <strong>push </strong>em desenvolvimento e quebra a atividade do companheiro de equipe.</p><blockquote>“Mas ele vai receber um erro…”</blockquote><p>Sim, entretanto terá que descobrir ou pergunta a equipe o que foi alterado e ir no seu próprio ambiente de desenvolvimento para fazer a mesma alteração.</p><p>Percebe o quanto isso pode quebrar a produtividade quando falamos em trabalho em equipe? É exatamente por isso que as migrations foram criadas para ser um controle de <strong>versionamento </strong>de um <em>estado para outro</em> dos bancos de dados, assim como o <strong>GIT </strong>é para código da aplicação.</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fgiphy.com%2Fembed%2F1Bh2cHcRfuySMTrdpc%2Ftwitter%2Fiframe&amp;url=https%3A%2F%2Fmedia.giphy.com%2Fmedia%2F1Bh2cHcRfuySMTrdpc%2Fgiphy.gif&amp;image=https%3A%2F%2Fi.giphy.com%2Fmedia%2F1Bh2cHcRfuySMTrdpc%2Fgiphy.gif&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=giphy" width="435" height="235" frameborder="0" scrolling="no"><a href="https://medium.com/media/14b23d2f245979b67822024f0c8e7364/href">https://medium.com/media/14b23d2f245979b67822024f0c8e7364/href</a></iframe><h3>A construção das migrations</h3><p>O <strong>Sequelize CLI</strong> ajuda a gerenciar no versionamento das migrations devido a criação dos seus arquivos terem uma <strong>sequência de timestamps </strong>onde gera uma espécie de histórico. Vamos criar a nossa primeira migration.</p><pre>yarn sequelize migration:create --name=create-users</pre><p>O próximo passo é estruturar nossa tabela como um objeto informando seus atributos e definindo suas regras…</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/15293bb2e5c77fdd75fe9dafd11b4028/href">https://medium.com/media/15293bb2e5c77fdd75fe9dafd11b4028/href</a></iframe><p>Comando para rodar nossa(s) migration(s):</p><pre>yarn sequelize db:migrate</pre><p>Caso você esteja criando uma nova migration e já rodou o comando para gerar a tabela users, quando você emitir novamente o comando ele só irá rodar a migration que não está no banco por conta que quando foi rodado a primeira vez ele gerou uma tabela de controle chamada <strong>SequelizeMeta.</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/207/1*QuEPjkrVoCx5UQQ2q4so7w.png" /></figure><p><strong>Primeira dica:</strong> a depender como foi definido pela equipe para o projeto se vai utilizar camelcase ou underscored siga exatamente como foi definido em toda a parte do projeto desde a criação das tabelas até as models, para evitar conflitos na construção das querys com o <em>ORM </em>pois o código <em>SQL </em>é gerado com base no model e se for definido que na migration “full_name” e na model “fullName” haverá conflitos.</p><p><strong>Segunda dica:</strong> evite construir tabelas no singular pois você deixa essa responsabilidade para o <strong>Sequelize </strong>por no plural e nomes como “<strong>permanencia</strong>” vai ser gerado para eles como “<strong>permanecium</strong>” causando conflitos na geração do código SQL.</p><blockquote><em>“mas não tem como eu decidir se quero ou não que ele gere minhas tabelas no singular ou plural?”</em></blockquote><p>Tem, veja no gist abaixo todas as propriedades da tabela<strong>.</strong></p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/a8b4471a8ec1910eb0dc03472239d1f6/href">https://medium.com/media/a8b4471a8ec1910eb0dc03472239d1f6/href</a></iframe><h4>Outros comandos para migrations</h4><p>Revertendo as modificações mais recentes.</p><pre>yarn sequelize db:migrate:undo</pre><p>Podendo desfazer para o estado inicial.</p><pre>yarn sequelize db:migrate:undo:all</pre><p>Ou pode reverter somente uma migration específica.</p><pre>yarn sequelize db:migrate:undo:all --to XXXXXXXXXXXXXX-create-users.js</pre><p>Logo abaixo tem uma imagem sobre os tipos de dados que o Sequelize trabalha e suas especificações…</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*WQqOlYApuCa-0l6bSct_eQ.png" /><figcaption><a href="https://github.com/diomalta/FireNote">https://github.com/diomalta/FireNote</a></figcaption></figure><p>Vamos falar de algumas propriedades para os campos que serão criados, no gist abaixo mostra exemplos do que podemos utilizar na construção dos atributos.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/283bbd0997a042c5a905d8b12dd4a4e3/href">https://medium.com/media/283bbd0997a042c5a905d8b12dd4a4e3/href</a></iframe><h3>Seeders</h3><p>A equipe está trabalhando com testes (Ou tem dados como default para a plicação) e toda vez ela precisa inserir dados é um processo manual atráves de uma controller, ou utilizando o model para fazer a criação, a depender da quantidade de registros que queira inserir será muito trabalhoso.</p><p>Por isso os seeders existem, para deixar um padrão de preenchimento das tabelas com informações reais ou fictícias a depender da necessidade para ser utilizado no momento que desejar.</p><h3>Construindo Seeders</h3><pre>yarn sequelize seed:generate --name users</pre><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/950235d7ee6803474a8c9d2fcd7c3ea9/href">https://medium.com/media/950235d7ee6803474a8c9d2fcd7c3ea9/href</a></iframe><p>Desfazendo dos seeders mais recentes.</p><pre>yarn sequelize db:seed:undo</pre><p>Reverter um seed específico.</p><pre>yarn sequelize db:seed:undo --seed name-of-seed-as-in-data</pre><p>Se desfazendo de todos a seeders gerados até o presente momento.</p><pre>yarn sequelize db:seed:undo:all</pre><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fgiphy.com%2Fembed%2F3paoal3k1VFwPKDDAl%2Ftwitter%2Fiframe&amp;url=https%3A%2F%2Fmedia.giphy.com%2Fmedia%2F3paoal3k1VFwPKDDAl%2Fgiphy.gif&amp;image=https%3A%2F%2Fi.giphy.com%2Fmedia%2F3paoal3k1VFwPKDDAl%2Fgiphy.gif&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=giphy" width="435" height="435" frameborder="0" scrolling="no"><a href="https://medium.com/media/9cdceeece2cfefac9040a37c60fd46fc/href">https://medium.com/media/9cdceeece2cfefac9040a37c60fd46fc/href</a></iframe><h3>Conclusão</h3><p>Utilizando o Sequelize no seu projeto você garante que toda a sua equipe esteja sempre com a estrutura do banco de dados atualizada com facilidade atráves das migrations e com a seeders garatimos que teremos uma massa de dados feita para povoar nosso banco assim que criamos a base de dados seja em desenvolvimento ou em produção.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=67ba3571ed0e" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>