{
  "$schema": "../../schemas/service.schema.json",
  "kind": "service",
  "name": "smtp",
  "version": "1.0.0-draft.1",
  "purpose": "Email capability acquired through a declared System Service.",
  "declarationSchema": "../../../../Service.schema.json",
  "types": "types.json",
  "functions": {
    "create": {
      "parameters": [
        {
          "name": "subject",
          "type": "core.string",
          "required": true
        },
        {
          "name": "content",
          "type": "core.string",
          "required": true
        },
        {
          "name": "contentType",
          "type": "core.string",
          "required": false,
          "default": "text/plain"
        },
        {
          "name": "data",
          "type": {
            "nullable": "core.object"
          },
          "required": false,
          "default": null
        },
        {
          "name": "features",
          "type": {
            "nullable": "smtp.Features"
          },
          "required": false,
          "default": null
        }
      ],
      "returns": "smtp.Mail",
      "purpose": "Mail.",
      "statementOnly": false
    }
  },
  "rules": [
    "create constructs a Mail using the supplied subject, content and optional content type, template data and features. The default content type is text/plain.",
    "send accepts a nonempty recipient list and queues the message. Queue acceptance is not proof of delivery or a durable business notification workflow.",
    "Template data is data, never executable code. Escape inserted HTML values for their actual output context."
  ]
}
