pino-sse 1.0.0

package/LEGAL.md

@@ -0,0 +1,76 @@
+# Terms of Service
+
+## Usage Agreement
+
+By inviting the bot or using its features, you are agreeing to the below mentioned Terms of Service and Privacy Policy.
+
+You acknowledge that you have the privilege to use the bot freely on any Discord server you share with it, that you can invite it to any server that you have "Manage Server" rights for and that this privilege might get revoked for you, if you're subject of breaking the terms and/or policy of this bot, or the Terms of Service, Privacy Policy and/or Community Guidelines of Discord Inc.
+
+Through inviting or interacting with the bot it may collect specific data as described in its [Privacy Policy](#privacy-policy). The intended usage of this data is for core functionalities of the bot such as command handling, server settings, and user settings.
+
+## Intended Age
+
+The bot may not be used by individuals under the minimal age described in Discord's Terms of Service.
+
+Do not provide any age-restricted content (as defined in Discord's safety policies) to the bot. Age-restricted content includes but is not limited to content and discussion related to:
+
+- Sexually explicit material such as pornography or sexually explicit text
+- Violent content
+- Illegal, dangerous, and regulated goods such as firearms, tactical gear, alcohol, or drug use
+- Gambling-adjacent or addictive behavior
+
+Content submitted to the bot through the use of commands arguments, text inputs, image inputs, or otherwise must adhere to the above conditions. Violating these conditions may result in your account being reported to Discord Inc for further action.
+
+## Affiliation
+
+The bot is not affiliated with, supported by, or made by Discord Inc.
+
+Any direct connection to Discord or any of its trademark objects is purely coincidental. We do not claim to have the copyright ownership of any of Discord's assets, trademarks or other intellectual property.
+
+## Liability
+
+The owner(s) of the bot may not be made liable for individuals breaking these Terms at any given time. We have faith in the end users being truthful about their information and not misusing this bot or the services of Discord Inc in a malicious way.
+
+We reserve the right to update these terms at our own discretion, giving you a 1-week (7 days) period to opt out of these terms if you're not agreeing with the new changes.
+
+You may opt out by removing the bot from any server you have the rights for.
+
+## Contact
+
+People may get in contact through the official support server of the bot.
+
+Other ways of support may be provided but aren't guaranteed.
+
+# Privacy Policy
+
+## Usage of Data
+
+The bot may use stored data, as defined below, for different features including but not limited to:
+
+- Command handling
+- Providing server and user preferences
+
+The bot may share non-sensitive data with 3rd party sites or services, including but not limited to:
+
+- Aggregate/statistical data (ex: total number of server or users)
+- Discord generated IDs needed to tie 3rd party data to Discord or user-provided data
+
+Personally identifiable (other than IDs) or sensitive information will not be shared with 3rd party sites or services.
+
+## Updating Data
+
+The bot's data may be updated when using specific commands.
+
+Updating data can require the input of an end user, and data that can be seen as sensitive, such as content of a message, may need to be stored when using certain commands.
+
+## Temporarily Stored Data
+
+The bot may keep stored data in an internal caching mechanic for a certain amount of time. After this time period, the cached information will be dropped and only be re-added when required.
+
+Data may be dropped from cache pre-maturely through actions such as removing the bot from the server.
+
+## Removal of Data
+
+Manual removal of the data can be requested through the official support server. Discord IDs such as user, guild, role, etc. may be stored even after the removal of other data in order to properly identify bot specific statistics since those IDs are public and non-sensitive.
+
+For security reasons we will ask you to provide us with proof of ownership to the data you wish to be removed. Only a server owner may request manual removal of server data.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jimmy Lew
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/eslint.config.js

@@ -0,0 +1,24 @@
+// @ts-check
+/* eslint perfectionist/sort-objects: "error" */
+import antfu from '@antfu/eslint-config'
+
+export default antfu(
+  {
+    formatters: true,
+    pnpm: true,
+  },
+).removeRules(
+  'no-labels',
+  'no-lone-blocks',
+  'no-restricted-syntax',
+  'node/prefer-global/buffer',
+  'node/prefer-global/process',
+  'prefer-rest-params',
+  'symbol-description',
+  'ts/ban-types',
+  'ts/no-empty-object-type',
+  'ts/no-invalid-this',
+  'ts/no-unnecessary-type-constraint',
+  'vue/no-template-shadow',
+  'vue/no-v-text-v-html-on-component',
+)

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "pino-sse",
+  "version": "1.0.0",
+  "description": "Pino transport for server side events",
+  "license": "MIT",
+  "author": "Jimmy Lew",
+  "main": "psse.ts",
+  "scripts": {
+    "lint": "eslint"
+  },
+  "bin": {
+    "pino-sse": "./psse.ts"
+  },
+  "keywords": [
+    "pino",
+    "sse"
+  ],
+  "devDependencies": {
+    "@antfu/eslint-config": "^6.7.3",
+    "@types/node": "^25.0.3",
+    "@types/uuid": "^11.0.0",
+    "eslint": "^9.39.2"
+  },
+  "dependencies": {
+    "h3": "^2.0.1-rc.6",
+    "pino-abstract-transport": "^3.0.0",
+    "uWebSockets.js": "github:uNetworking/uWebSockets.js#v20.56.0",
+    "uuid": "^13.0.0",
+    "uws-cors": "^1.0.0"
+  }
+}

package/psse.h3.ts

@@ -0,0 +1,46 @@
+import build from 'pino-abstract-transport'
+import {createEventStream, defineEventHandler, H3, handleCors, serve } from 'h3'
+import { v4 as uuid } from 'uuid'
+
+interface SSETransportOptions {
+
+}
+
+export default async function (opts: SSETransportOptions) {
+  const app = new H3()
+  let event_stream: any = null
+
+  app.get("/", (event) => {
+    const cors = handleCors(event, {
+      origin: '*',
+      preflight: {
+        statusCode: 204,
+      },
+      methods: '*',
+    })
+    if (cors !== false) return cors
+
+    event_stream = createEventStream(event);
+    return event_stream.send();
+  });
+
+  const server = serve(app, {port: 3333})
+
+  return build(async (stream) => {
+    for await (const obj of stream) {
+      obj["log_id"] = uuid()
+      const log = JSON.stringify(obj)
+      if (!event_stream)
+        continue
+      await event_stream.push(log)
+    }
+  }, {
+    async close(_) {
+      console.log('Killing sse transport');
+      await server.close()
+    },
+    parseLine(line) {
+      return JSON.parse(line)
+    },
+  })
+}

package/psse.ts

@@ -0,0 +1,54 @@
+import build from 'pino-abstract-transport'
+import { v4 as uuid } from 'uuid'
+import { App } from 'uWebSockets.js'
+import type { HttpResponse } from 'uWebSockets.js'
+import {cors} from 'uws-cors'
+
+interface SSETransportOptions {
+  port: number
+}
+
+export default async function (opts: SSETransportOptions = {port: 3333}) {
+  const app = cors(App())
+  const connections: Record<string, HttpResponse> = {}
+
+  app.get("/", (conn) => {
+    const conn_id = uuid()
+    conn.cork(() => {
+      conn.writeHeader('Content-Type', 'text/event-stream')
+      conn.writeHeader('Connection', 'keep-alive')
+      conn.writeHeader('Cache-Control', 'no-cache')
+    })
+    conn.writeStatus('200 OK')
+
+    connections[conn_id] = conn
+
+    conn.onAborted(() => {
+      delete connections[conn_id]
+    })
+
+  })
+  app.listen(opts.port, () => {})
+
+
+  return build(async (stream) => {
+    for await (const obj of stream) {
+      obj["log_id"] = uuid()
+      const log = JSON.stringify(obj)
+      for (const conn of Object.values(connections)) {
+        conn.cork(() => conn.write(`data: ${log}\n\n`))
+      }
+    }
+  }, {
+    async close(_) {
+      for (const conn of Object.values(connections)) {
+        conn.cork(() => conn.write('event: close\n'))
+        conn.close()
+      }
+      app.close()
+    },
+    parseLine(line) {
+      return JSON.parse(line)
+    },
+  })
+}