@fullstackunicorn/initialize 1.0.1 → 1.0.5

package/index.js

@@ -4,10 +4,13 @@ String.prototype.low = function () { return this.toLowerCase() }
 String.prototype.cut = function (n = 1) { return this.slice(0, -n) }
 
 class F3Error extends Error {
-    constructor(service, message, params = {}) {
+    constructor(service, message, params, cause) {
         super(message)
+        this.name = 'F3Error'
         this.service = service
-        this.params = params
+        if (params) this.params = params
+        if (cause) this.cause = cause
+        if (Error.captureStackTrace) Error.captureStackTrace(this, F3Error)
     }
 }
 
@@ -15,6 +18,7 @@ globalThis.F3 = {}
 
 globalThis.F3.service = ''
 
+globalThis.F3.isErr = value => value instanceof Error
 globalThis.F3.isArr = value => Array.isArray(value)
 globalThis.F3.isNil = value => value === undefined || value === null
 globalThis.F3.isFnc = value => typeof value === 'function'
@@ -42,7 +46,7 @@ globalThis.F3.obj.isGood = obj => !!obj && typeof obj === 'object' && Object.key
 globalThis.F3.obj.safe = obj => (typeof obj === 'object' && obj !== null) ? obj : {}
 globalThis.F3.obj.isPlain = obj => obj !== null && typeof obj === 'object' && Object.getPrototypeOf(obj) === Object.prototype
 globalThis.F3.obj.inKb = obj => new TextEncoder().encode(JSON.stringify(obj)).length / 1000
-globalThis.F3.obj.string = obj => {
+globalThis.F3.obj.toStr = obj => {
     if (typeof obj === 'string') return obj
     try { return JSON.stringify(obj, null, 2) } catch { return String(obj) }
 }
@@ -62,6 +66,12 @@ globalThis.F3.replacer = (string = '', values = {}) => {
     return newString
 }
 
+globalThis.F3.promise = async (func, data) => {
+    return new Promise((resolve, reject) => {
+        func(data, (error, output) => { if (error) reject(error); else resolve(output) })
+    })
+}
+
 globalThis.F3.res = {}
 globalThis.F3.res.isGood = res => {
     if (F3.isNil(res)) return false
@@ -84,22 +94,41 @@ globalThis.F3.log.obj = (object = {}, ...rest) => {
     const result = []
     for (const item of rest) result.push(String(item))
     for (const key of Object.keys(object)) {
-        try { result.push(`\n${key}:\n${F3.obj.string(object[key])}\n`) }
+        try { result.push(`\n${key}:\n${F3.obj.toStr(object[key])}\n`) }
         catch { result.push(`\n${key}: [Error serializing value]\n`) }
     }
     console.log(result.join('\n'))
 }
 
+globalThis.F3.throw = (...args) => { throw new F3Error(F3.service, ...args) }
+
 globalThis.F3.err = {}
 globalThis.F3.err.is500 = status => !!status && status >= 500
 globalThis.F3.err.is400 = status => !!status && status >= 400 && status < 500
 
+globalThis.F3.err.toObj = err => { 
+    const base = { name:err.name, message:err.message, stack:err.stack }
+    try { return Object.assign(base, Object.fromEntries(Object.entries(err)))} 
+    catch { return base }
+}
+globalThis.F3.err.toStr = err => {
+    if (F3.isErr(err)) return F3.obj.toStr(F3.err.toObj(err))
+    if (F3.isObj(err)) return F3.obj.toStr(err)
+    if (F3.isStr(err)) return err
+    return String(err)
+}
+globalThis.F3.err.logs = err => {
+    if (err instanceof F3Error) console.error(F3.obj.toStr(err))
+    else console.error('non-F3-error',F3.obj.toStr(err))
+}
+
 globalThis.F3.catch = {}
-globalThis.F3.catch.throw = error => { throw error }
+globalThis.F3.catch.throw = (error, message) => {
+    if (error instanceof F3Error) throw error
+    F3.throw(message, null, F3.err.toStr(error))
+}
 globalThis.F3.catch.log = (...args) => console.log(...args)
-globalThis.F3.catch.res = (first, ...rest) => {
-    if (rest.length > 0) console.log(...rest)
+globalThis.F3.catch.res = (first, error) => {
+    if (error) F3.err.logs(error)
     return first
-}
-
-globalThis.F3.throw = (message, params) => { throw new F3Error(F3.service, message, params) }
+}

package/package.json

@@ -1,22 +1,12 @@
 {
+    "version": "1.0.5",
     "name": "@fullstackunicorn/initialize",
-    "author": "lucanigido[](https://fullstackunicorn.dev/author/lucanigido)",
-    "version": "1.0.1",
+    "author": "lucanigido (https://fullstackunicorn.dev/author/lucanigido)",
+    "description": "A collection of global utility functions for JavaScript/Node.js projects (type checks, string helpers, logging, etc.). Side-effect import extends globals.",
+    "readme": "README.md",
     "main": "index.js",
     "type": "module",
     "license": "MIT",
-    "private": false,
-    "description": "A collection of global utility functions for JavaScript/Node.js projects (type checks, string helpers, logging, etc.). Side-effect import extends globals.",
-    "readme": "README.md",
-    "keywords": [
-        "utilities",
-        "helpers",
-        "global",
-        "javascript",
-        "node",
-        "type-checks",
-        "logging"
-    ],
     "repository": {
         "type": "git",
         "url": "https://gitlab.com/fullstackunicorn/initialize.git"
@@ -27,6 +17,19 @@
     "sideEffects": [
         "index.js"
     ],
+    "keywords": [
+        "utilities",
+        "helpers",
+        "global",
+        "javascript",
+        "node",
+        "type-checks",
+        "logging"
+    ],
+    "imports": {
+        "#@": "./",
+        "#@/*": "./*"
+    },
     "scripts": {
         "test": "echo \"Error: no test specified\" && exit 1"
     }