dev-dami / dev-dami/zario

feat: add a native Syslog transport

Open
#87 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement help wanted
Dominant language
TypeScript
Stars
7
Forks
12
Avg merge
1d 11h
Merged PRs (30d)
5

Description

Zario's roadmap includes native Syslog support. This is a good contributor-sized feature because it can be implemented as an isolated transport without changing the core logging API.

Goal

Add a SyslogTransport that can send Zario log records to a local or remote syslog endpoint.

Suggested scope

  • Support UDP first; TCP can be a follow-up if it makes the initial implementation too large.
  • Map Zario levels to sensible syslog severities.
  • Allow configuration for host, port, facility, and app/service name.
  • Reuse the existing transport interface/lifecycle conventions.
  • Make failures predictable and compatible with flush() / close() where applicable.

Acceptance criteria

  • SyslogTransport is exported from the appropriate transport entrypoint.
  • Unit tests cover level mapping and payload formatting.
  • A test verifies delivery to a local test socket without requiring an external syslog server.
  • Documentation includes a minimal usage example.
  • Existing Bun and Node compatibility tests continue to pass.

Non-goals

  • Full RFC edge-case coverage in the first PR.
  • TLS/TCP support unless the contributor wants to include it cleanly.
  • Changing the public logger API.

If you want to work on this, comment on the issue with the scope you plan to tackle so we can avoid duplicate work.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by locating the existing transport interface, lifecycle conventions, and transport entrypoint, then review the current unit and Bun/Node compatibility tests. Implement the isolated UDP Syslog transport with configurable host, port, facility, and app name, and verify level mapping, payload formatting, local-socket delivery, exports, documentation, and flush/close behavior.

Written by the indexing model from the issue text.

Assessment

Tech stack
bun, node.js, typescript
Domain
backend, networking
Issue type
Feature
Difficulty
3/5
Estimated time
1-2 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
74/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.