@leostacowski/pkgs 0.0.0-stage → 0.0.0

package/LICENSE

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+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 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.
+
+For more information, please refer to <https://unlicense.org>

package/README.md

@@ -1,3 +1,35 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @leostacowski/pkgs
+
+_"It's ugly but it's mine"._
+
+\- _Me describing my code._
+
+## Motivation
+
+After a long time repeatedly starting things from scratch:
+
+```text
+I decided to finally create a centralized repo for my scripts.
+```
+
+This decision was directly inspired by Eskil Steenberg's talk: "_[You should finish your software](https://youtu.be/EGLoKbBn-VI?si=uFVlbKIcRolcOzCy)_" from BSC 2025.
+
+If you are using any of these packages and:
+
+1. Something is breaking;
+2. Have any suggestions.
+
+Please reach out via:
+
+- [Linkedin](https://www.linkedin.com/in/leonardo-ribeiro-stacowski/);
+- [Opening an Issue](https://github.com/leostacowski/pkgs/issues/).
+
+I intend to keep adding stuff to this repo as long as I continue to reinvent the wheel!
+
+## Packages
+
+### @leostacowski/pkgs/Logger
+
+Simple Logger that supports aliases, types, colors and other knobs.
+
+Check it's [README.md](/modules/logger/README.md) for details.

package/modules/index.js

@@ -0,0 +1 @@
+export { default as Logger } from './logger/index.js'

package/modules/logger/README.md

@@ -0,0 +1 @@
+# @leostacowski/pkgs/logger

package/modules/logger/index.js

@@ -0,0 +1,155 @@
+const LOGGER_COLORS = {
+  RED: {
+    code: '\x1b[91m',
+  },
+  GREEN: {
+    code: '\x1b[92m',
+  },
+  YELLOW: {
+    code: '\x1b[93m',
+  },
+  DEFAULT: {
+    code: '\x1b[94m',
+  },
+  WHITE: {
+    code: '\x1b[37m',
+  },
+  RESET: {
+    code: '\x1b[0m',
+  },
+}
+
+const LOGGER_TYPES = [
+  {
+    level: 2,
+    prefix: 'ERROR',
+    emitter: console.error,
+    color: LOGGER_COLORS.RED,
+    aliases: ['error', 'err', 'e'],
+  },
+  {
+    level: 1,
+    prefix: 'WARNING',
+    emitter: console.warn,
+    color: LOGGER_COLORS.YELLOW,
+    aliases: ['warning', 'warn', 'w'],
+  },
+  {
+    level: 0,
+    prefix: 'SUCCESS',
+    emitter: console.log,
+    color: LOGGER_COLORS.GREEN,
+    aliases: ['success', 's'],
+  },
+  {
+    level: 0,
+    prefix: 'DEBUG',
+    emitter: console.log,
+    color: LOGGER_COLORS.DEFAULT,
+    aliases: ['log', 'info', 'debug', 'l', 'i', 'd'],
+  },
+]
+
+const BASE_OPTS = {
+  prefix: '',
+  group: true,
+  colors: true,
+  text_color: '',
+  level: 0,
+}
+
+function emit(content = [], opts = {}, logger_type = {}) {
+  if (opts?.level > logger_type.level) return
+  if (!content.length) return
+
+  const prefix = (() => {
+    const target = []
+
+    target.push(`> [${new Date().toISOString()}] ${logger_type.prefix}`)
+
+    if (opts?.prefix) {
+      target.push(opts.prefix)
+    }
+
+    target[target.length - 1] = `${target[target.length - 1]}:`
+
+    if (opts?.colors) {
+      target.unshift(logger_type.color.code)
+      target.push(LOGGER_COLORS.RESET.code)
+    }
+
+    return target.join(' ')
+  })()
+
+  const message = (() => {
+    const target = []
+    let text_color = ''
+
+    for (const item of content) {
+      target.push(typeof item === 'string' ? item : JSON.stringify(item))
+    }
+
+    if (opts?.colors && opts?.text_color) {
+      text_color = opts.text_color
+    }
+
+    if (text_color) {
+      return `${text_color}${target.join()}${LOGGER_COLORS.RESET.code}`
+    }
+
+    return target.join(' ')
+  })()
+
+  if (opts.group) {
+    console.group(prefix)
+    logger_type.emitter(message)
+    console.groupEnd()
+  } else {
+    logger_type.emitter(prefix, message)
+  }
+
+  return
+}
+
+function get_emitters(args) {
+  const opts = {}
+
+  Object.keys(BASE_OPTS).forEach((key) => {
+    if (typeof args?.[key] === typeof BASE_OPTS[key]) {
+      opts[key] = args[key]
+    } else {
+      opts[key] = BASE_OPTS[key]
+    }
+  })
+
+  const target = {}
+
+  for (const logger_type of LOGGER_TYPES) {
+    for (const alias of logger_type.aliases) {
+      target[alias] = function () {
+        return emit(Array.from(arguments), opts, logger_type)
+      }
+    }
+  }
+
+  return target
+}
+
+const Logger = function (args) {
+  if (typeof args === 'string') {
+    args = {
+      prefix: args,
+    }
+  }
+
+  const emitters = get_emitters(args)
+  const methods = {}
+
+  for (const emitter of Object.keys(emitters)) {
+    methods[emitter] = emitters[emitter]
+  }
+
+  return methods
+}
+
+export default Logger

package/package.json

@@ -1,6 +1,37 @@
-{
-  "name": "@leostacowski/pkgs",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+{
+  "name": "@leostacowski/pkgs",
+  "version": "0.0.0",
+  "description": "Centralized package of reusable javascript tools.",
+  "homepage": "https://github.com/leostacowski/pkgs#readme",
+  "bugs": {
+    "url": "https://github.com/leostacowski/pkgs/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/leostacowski/pkgs.git"
+  },
+  "license": "Unlicense",
+  "author": {
+    "name": "leostacowski",
+    "email": "leonardo.stacowski@hotmail.com",
+    "url": "git+https://github.com/leostacowski/"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "files": [
+    "modules"
+  ],
+  "exports": {
+    ".": "./modules/index.js",
+    "./logger": "./modules/logger/index.js"
+  },
+  "imports": {
+    "#logger/*": "./modules/logger/*"
+  },
+  "scripts": {
+    "dev": "node --watch ./modules/index.js",
+    "deploy": "npm publish"
+  }
+}