@leansdk/leanrc/lib/patterns/proxy/Renderer.coffee

LeanRC is a MVC framework for creating graceful applications

# This file is part of LeanRC.
#
# LeanRC is free software: you can redistribute it and/or modify
# it under the terms of the GNU Lesser General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# LeanRC is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public License
# along with LeanRC.  If not, see <https://www.gnu.org/licenses/>.

###
пример темплейта
```coffee
_         = require 'lodash'
inflect   = do require 'i'

# это специально не класс, а функция чтобы съэкономить процессорные ресурсы
module.exports = (resource, action, aoData)->
  resource = resource.replace(/[/]/g, '_').replace /[_]$/g, ''
  meta: aoData.meta
  "#{inflect.pluralize inflect.underscore resource}": aoData.items.map (i)->
    _.omit i, '_key', '_type', '_owner'

```
но также могут быть созданы обобщенные шаблоны, с каким-то кодом представления одного или нескольких итемов, чтобы в темплейтах рекваить (с них доп-параметры можно передавать аргументами или через карирование)
###

# Возможно стоит обдумать такую идею: валидировать выходящей joi схемой (которая нужна для свайгера) выходящий результат после рендера (но это применимо только для json)

module.exports = (Module)->
  {
    APPLICATION_MEDIATOR
    AnyT
    FuncG, MaybeG, InterfaceG
    ContextInterface, ResourceInterface
    RendererInterface
    # ConfigurableMixin
  } = Module::

  class Renderer extends Module::Proxy
    @inheritProtected()
    # @include ConfigurableMixin
    @implements RendererInterface
    @module Module

    # may be redefine at inheritance
    @public @async render: FuncG([ContextInterface, AnyT, ResourceInterface, MaybeG InterfaceG {
      method: String
      path: String
      resource: String
      action: String
      tag: String
      template: String
      keyName: MaybeG String
      entityName: String
      recordName: MaybeG String
    }], MaybeG AnyT),
      default: (ctx, aoData, resource, {path, resource:resourceName, action, template:templatePath}={})->
        if path? and resourceName? and action?
          service = @facade.retrieveMediator APPLICATION_MEDIATOR
            ?.getViewComponent()
          {templates} = service.Module
          return yield Module::Promise.resolve(
            templates?[templatePath]?.call(
              resource, resourceName, action, aoData
            ) ? aoData
          )
        else
          yield return aoData


    @initialize()