@fullstackunicorn/initialize 1.0.2 → 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) }
 }
@@ -90,25 +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, ...rest) => { 
-    if (rest.length > 0) console.log(...rest)
-    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,5 +1,5 @@
 {
-    "version": "1.0.2",
+    "version": "1.0.5",
     "name": "@fullstackunicorn/initialize",
     "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.",