name: notification

snippets:
  lookupUser: &lookupUser
    meta: { label: Recipient }
    required: true
    types:
      - { wf: ID     }
      - { wf: Handle }
      - { wf: String, suffix: email }

functions:
  sendRecord:
    meta:
      short: Send record notification
      description: Sends a notification that links to a specific record
    params:
      recipient: *lookupUser
      title:
        meta: { label: Title }
        types:
          - { wf: String }
        required: true
        description: The title of the record notification
      description:
        types:
          - { wf: String }
        required: false
        description: Optional description for the record notification
        meta: { label: Description, visual: { input: { type: richtext } } }
      module:
        meta: { label: Module }
        required: true
        types:
          - { wf: ID }
          - { wf: Handle }
        description: The module ID of the record
      namespace:
        meta: { label: Namespace }
        required: true
        types:
          - { wf: ID }
          - { wf: Handle }
        description: The namespace ID of the record
      record:
        meta: { label: Record }
        required: false
        types:
          - { wf: ID }
        description: The record ID to link to
      openMode:
        types:
          - { wf: String }
        required: false
        description: How to open the record - "modal", "newTab", or "sameTab" (default)
        meta:
          label: Open mode
          visual:
            input:
              type: select
              properties:
                options:
                  - { value: 'sameTab', text: 'Open link in the same tab' }
                  - { value: 'newTab', text: 'Open link in a new tab' }
                  - { value: 'modal', text: 'Open in a modal' }
              default: 'modal'
      edit:
        meta: { label: Edit }
        types:
          - { wf: Boolean }
        required: false
        description: Whether to open the record in edit mode (default is false)