tempalte-api-tm

Template microservice. Generate html (email compatible) and pdf from the given template and data.

Features:

• fill html templates with data
• convert html css to inline css for emails
• pdf creation form template with data (get buffer / stream)
• Send email with template.

Add template:

1. In /src/templates/template create a new forlder with {templateName}
2. Add a {templateName}.handlebars file (template)
   1. Your html <style> will be replaced with inline css because this is the only way it will work with emails
3. Add a Validator class to {templateName} folder (extend TemplateValidatorAbstract - implement the validate(data: YourTemplateData) and exampleData(): YourTemplateData)
4. Add the validator to TemplateFactory validators[]
5. Done. You can see the generated links in the GET /template root, You can get the template as: html string, pdf buffer, pdf stream. Experiment and test with the playground link.

get template html / pdf:

{{type}} = html_string | pdf_buffer | pdf_stream

POST /template/:name?type=html_string

body: templateData

mail send with template:

POST /mail

body: {
    mailOptions: Omit<Mail.Options, 'html'>;
    template: { name: string; data: any };
}

//example body
{
   "mailOptions": {
      "to": "test@gmail.com", 
      "subject": "test email"
   }, 
   "template": {
   "name": "test_template", 
      "data": {
         "title": "test title", 
         "description": "This is a test description", 
         "color": "#DEB887"
      }
   }
}

Demo: https://template.mytaskplan.me/template