Telogger

Telogger can help you log information to Telegram.

Installation

npm i telogger

Usage

const { Telogger } = require('telogger')
// import { Telogger } from 'telogger'

Basic Setup

const telogger = new Telogger('AppTitle', 'BotToken', 'ID')

telogger.dump([ ], { }, 'string', 1234567890)
telogger.trace('started testing telogger')
telogger.debug('third telogger message')
telogger.info('*Telogger* supports _markdown_.')
telogger.warn('*Four* messages sent __in a row__.')
telogger.error('Unfortunately, errors are inevitable.')
telogger.fatal('Something really bad happened. Goodbye!')

Advanced Setups

You can assign different channels for different types of logs.

const telogger = new Telogger('AppTitle', 'BotToken', {
  dev: 'DevChannelID',  // for `dump`, `trace`, and `debug`
  log: { id: 'LogChannelID', silent: true },  // for `info`
  err: 'ErrChannelID'   // for `warn`, `error`, and `fatal`
})

You can also create your own channels and log levels.

const telogger = new Telogger('AppTitle', 'BotToken', {
  mychannel: {
    id: 'MyChannelID',
    silent: false,
    sendInProduction: true
  }
}, {
  dump: { to: 'MyID' },
  info: { to: 'MyID' },
  warn: { to: 'MyID' },
  myloglevel: {
    to: 'mychannel',
    icon: '🍑',
    head: '{{text}}',
    body: [ '{{rich}}', '{{location}}' ]
  }
})

telogger.send('myloglevel', 'Head Text', 'Body Rich Text')

Below is a list of the defined methods for your log levels.

telogger.silly()
telogger.test()
telogger.laconic()
telogger.verbose()
telogger.database()
telogger.security()
telogger.network()
telogger.performance()
telogger.request()
telogger.response()
telogger.success()
telogger.failure()
telogger.notice()
telogger.warning()
telogger.alert()
telogger.crit()
telogger.critical()
telogger.emerg()
telogger.emergency()

Docs

Constructor

At least one of parameters 3 and 4 must not be null.

| № | Type | Value | Required | | --- | --- | --- | --- | | 1 | String\|Null | App title | Optional | | 2 | String | Bot token | Yes | | 3 | Number\|String\|Object\|Null | ID, username, or channels | Optional | | 4 | Number\|String\|Object\|Null | ID, username, alias, or destinations | Optional |

Channels

| Key | Type | Value | | --- | --- | --- | | [ Alias ] | Number\|String\|Object | ID, username, or channel |

Channel

| Key | Type | Value | | --- | --- | --- | | id | Number\|String | ID or username | | silent | Boolean | send logs silently | | sendInProduction | Boolean | send logs in production mode |

Destinations

| Key | Type | Value | | --- | --- | --- | | [ Log Level ] | String | ID, username, alias, or destination |

Destination

| Key | Type | Value | | --- | --- | --- | | to | Number\|String | ID, username, or alias | | icon | String\|False | False to disable icon | | head | Template\|Array\|False | False to disable head | | body | Template\|Array\|False | False to disable body | | silent | Boolean | send logs silently | | sendInProduction | Boolean | send logs in production mode |

Templates

Use {{keyword}} in your templates to format messages. Below is a list of supported keywords.

| Keyword | Input | Output | | --- | --- | --- | | bold | bold | bold | | italic | italic | italic | | underline | underline | underline | | strikethrough | strikethrough | ~~strikethrough~~ | | spoiler | spoiler | spoilerspoiler | | blockquote | blockquote | > blockquote | | blockquote(1) | expandable blockquote | > expandable blockquote | | code | code | code | | pre | pre | pre | | text | text | text | | rich | *_text_* | text | | json | [ 'text' ] | [ "text" ] | | json(0) | [ 'text' ] | ["text"] | | location | | /src/file.js:8:16 | | location(0) | | /src/file.js:8:16 | | location(1-2) | | /src/file.js:4:4 /src/file.js:3:3 | | location(3+) | | /src/file.js:2:2 /src/file.js:1:1 |

You can combine several keywords in your templates, for example: {{code > location}}.

Contributing

Contributions are only allowed in TON:

UQCYqT9-ycmXE3o57Cac1sM5ntIKdjqIwP3kzWmiZik0VU_b