{"_id":"winston-3-bugsnag-transport","_rev":"3-f7526352566a209b17859009e5aa217b","name":"winston-3-bugsnag-transport","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.0":{"name":"winston-3-bugsnag-transport","version":"1.0.0","description":"Bugsnag Transport for Winston 3","repository":{"type":"git","url":"git+https://github.com/VinceOPS/winston-3-bugsnag-transport.git"},"author":{"name":"VinceOPS","email":"vincent@gojob.com"},"license":"MIT","types":"./dist/index.d.ts","main":"./dist/index.js","scripts":{"build":"tsc -p tsconfig.build.json","lint":"eslint . --ext .ts","test":"jest"},"keywords":["winston","logger","bugsnag","transport"],"devDependencies":{"@types/jest":"^24.0.13","@types/lodash":"^4.14.136","@types/node":"^12.0.2","@typescript-eslint/eslint-plugin":"^1.13.0","@typescript-eslint/parser":"^1.13.0","eslint":"^6.1.0","eslint-config-prettier":"^6.0.0","eslint-plugin-prettier":"^3.1.0","jest":"^24.8.0","prettier":"^1.17.1","ts-jest":"^24.0.2","typescript":"^3.5.3","winston":"^3.2.1"},"dependencies":{"@bugsnag/js":"^6.3.2","lodash":"^4.17.15","winston-transport":"^4.3.0"},"gitHead":"25713d2d0e2a790a9a159b745febfd99fc5beb85","bugs":{"url":"https://github.com/VinceOPS/winston-3-bugsnag-transport/issues"},"homepage":"https://github.com/VinceOPS/winston-3-bugsnag-transport#readme","_id":"winston-3-bugsnag-transport@1.0.0","_nodeVersion":"10.16.0","_npmVersion":"6.9.0","dist":{"integrity":"sha512-Y9zsGaebS7gOJunKUdcHrbZhfKayOIp8mnKbFnb8hKSun5wTGO2ZWLc0yDanh0ZnCgmkL4tfH25oO1zSDCCQfA==","shasum":"b2baffd6699c85f7048937ec9547fdb5066d5069","tarball":"https://registry.npmjs.org/winston-3-bugsnag-transport/-/winston-3-bugsnag-transport-1.0.0.tgz","fileCount":15,"unpackedSize":27355,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJdNk5YCRA9TVsSAnZWagAAxx0P/A5U97qqdGTzqMX2V0tB\nRPZ+XJhiwrVjUBl1sShuXOmRck0ewHS9282otNCKUWL+jlaJfEtgKCMe4Bu8\nW7AYoc2rDjVHFI4l8iSdFvdgD80QPNwNl4SYNE/4L6u9ysBiduuVMFhpp7ZK\n4Sz9QlrPtR7uB9M1tbrJNzj1GDIEtXNKQkTF/X4y5GpUNImXQwIjgUHTay5f\nfySfJI/+IjzExr6J/ZbFYsqjJ/osNTbY+LSjmJyIEamEmphOWw8ghC0ZeK4d\nTNNIbQFOLnjNtm+cF/XkTRSOu9X0irH5/+GVPpN2m5XwsMRMi9tV4meGAwRa\nTKX2LzWUf8im0beJoFUjztrnWcFGzXYlYt27C57y44/b9j0WKS4yPWrYIEdS\nugAZDZc2Xrwz0BYNvYBFEItWT2VPmfuxOfBnqDUvVzrmRgmAcDb8WBrmZhWq\nypcUcwoQYL19d3sD6a0llOZcsXbGOTyWquFma4qSo8dPtp4O/8qY57apH67N\nudDzqpyiOite6tlOAjBdtoL2OhOUsjxL6uqZ0NxXx0O4GH5Fzy38cM6NaMEj\nWU/7wfpQs9YTGZ2OP03ns5a9myq/FOq7NARqUGW582cf95OKT9LJtyr79Ey5\nANQ7lH0XzyUZgOsiymCGWiOSN2bNiGHj63mm58eAOqkd0PrTsbnluw6ASM4U\ntWET\r\n=HJVv\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIGcgprDD/el/WcRniIPZsydxYeLHsD+CAGHnL8G09c3CAiEA+FHjGeZpqA6QYJ13+2L5tZtxAHJxi1FJt28hjTfzTAo="}]},"maintainers":[{"name":"vinceops","email":"vince.g.135@gmail.com"}],"_npmUser":{"name":"vinceops","email":"vince.g.135@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/winston-3-bugsnag-transport_1.0.0_1563840087753_0.9002023633964225"},"_hasShrinkwrap":false},"1.0.1":{"name":"winston-3-bugsnag-transport","version":"1.0.1","description":"Bugsnag Transport for Winston 3","repository":{"type":"git","url":"git+https://github.com/VinceOPS/winston-3-bugsnag-transport.git"},"author":{"name":"VinceOPS","email":"vincent@gojob.com"},"license":"MIT","types":"./dist/index.d.ts","main":"./dist/index.js","scripts":{"build":"tsc -p tsconfig.build.json","lint":"eslint . --ext .ts","test":"jest"},"keywords":["winston","logger","bugsnag","transport"],"devDependencies":{"@types/jest":"^24.0.13","@types/lodash":"^4.14.136","@types/node":"^12.0.2","@typescript-eslint/eslint-plugin":"^1.13.0","@typescript-eslint/parser":"^1.13.0","eslint":"^6.1.0","eslint-config-prettier":"^6.0.0","eslint-plugin-prettier":"^3.1.0","jest":"^24.8.0","prettier":"^1.17.1","ts-jest":"^24.0.2","typescript":"^3.5.3","winston":"^3.2.1"},"dependencies":{"@bugsnag/js":"^6.3.2","lodash":"^4.17.15","winston-transport":"^4.3.0"},"gitHead":"32782bc30ea4f1ee3633a3c00032b1729648583b","bugs":{"url":"https://github.com/VinceOPS/winston-3-bugsnag-transport/issues"},"homepage":"https://github.com/VinceOPS/winston-3-bugsnag-transport#readme","_id":"winston-3-bugsnag-transport@1.0.1","_nodeVersion":"10.16.0","_npmVersion":"6.9.0","dist":{"integrity":"sha512-Q/spXR6rvxZectGCxPD1kVT2UJDQp8B9ma7rNCgt5/UwpmFAYz+BIZOF8ir61AdlB8hjmR0bTLEo6Z7VQD/QxA==","shasum":"1663118c369ac4eb7f40e3687a7d9fe820ac4415","tarball":"https://registry.npmjs.org/winston-3-bugsnag-transport/-/winston-3-bugsnag-transport-1.0.1.tgz","fileCount":15,"unpackedSize":27944,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJdNlXLCRA9TVsSAnZWagAAq4QP/A9Hq93+mRVpeJNyBTZs\naGmvgY63UzMM15u97nA4R4nUOB+obmG01DwD9VuWIM+8SgQnNoE+nxSqEYpT\nawmoXaaGC6Koj49XCc+r5wmEMKrCsP8KHHTAFYNozUbSYZUdRq9SJbrVw6co\noMVIePcS6IYEeY/kGbJh8vXGb1yflocxo32puEShtCAIo5kla+oF9JWW8SKW\nH8AFrHwRdl5tzSz37Q1qca0eHFCUSKHTep9UIGGgRLSeIHp9D58YfC6B+ACQ\n+bB2UxU83dfWSiJeJ9FYxccZsArbgBCN4vDRk1OwkLis8G87GcaTxvYonajT\n+fhQeGoAkBg/rhM7Wg8YtCGU4182dxMUZQo1ftw367QbTjFVh6tLIgQbs00y\nZ2Ri5gVEremzXr2+vSmwu4RWZVQ+O9imfmfdDUvBBijTPiwMT9zqAEHNjbA3\nmZ4VYjNcELvISodPA36Ggd5ZbzpSy9gCrB4z4tUWVHv9qYdjUBdc3Ty4xT+Z\nHzu81neUwWqsl42LjJ6svcPJAXmSboyavFt5Waay5ZX1qKPnAGX7vOqWDwhH\npg/tErE96ffURGOXUr6bOnlN95XJ/sw5Vu/T/Qhi5bFZJ3RgXsgOF4x++FyO\nSY189EtIsAN0CPMLIrmDtKJqnktEas5jgR72i4USgIheomH/L6uIdXDjk5uZ\njUU5\r\n=BjOB\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIGUIhXhcPvzrZ+9/g+u9o2HhfoUabDQH5IsXM5cNV9bBAiBRqOTbJEzvIVS8+NTe0FPLLq8RUYOLH4lsvAKRyvV9wQ=="}]},"maintainers":[{"name":"vinceops","email":"vince.g.135@gmail.com"}],"_npmUser":{"name":"vinceops","email":"vince.g.135@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/winston-3-bugsnag-transport_1.0.1_1563841994087_0.7349317674633502"},"_hasShrinkwrap":false},"1.0.2":{"name":"winston-3-bugsnag-transport","version":"1.0.2","description":"Bugsnag Transport for Winston 3","repository":{"type":"git","url":"git+https://github.com/VinceOPS/winston-3-bugsnag-transport.git"},"author":{"name":"VinceOPS","email":"vincent@gojob.com"},"license":"MIT","types":"./dist/index.d.ts","main":"./dist/index.js","scripts":{"build":"tsc -p tsconfig.build.json","lint":"eslint . --ext .ts","test":"jest"},"keywords":["winston","logger","bugsnag","transport"],"devDependencies":{"@types/jest":"^24.0.18","@types/lodash":"^4.14.138","@types/node":"^12.0.2","@typescript-eslint/eslint-plugin":"^2.0.0","@typescript-eslint/parser":"^2.0.0","eslint":"^6.2.2","eslint-config-prettier":"^6.1.0","eslint-plugin-prettier":"^3.1.0","jest":"^24.9.0","prettier":"^1.17.1","ts-jest":"^24.0.2","typescript":"^3.6.2","winston":"^3.2.1"},"dependencies":{"@bugsnag/js":"^6.4.0","lodash":"^4.17.15","winston-transport":"^4.3.0"},"gitHead":"f4b6ab85e609c79c0377fca50c12964bf9008d6c","bugs":{"url":"https://github.com/VinceOPS/winston-3-bugsnag-transport/issues"},"homepage":"https://github.com/VinceOPS/winston-3-bugsnag-transport#readme","_id":"winston-3-bugsnag-transport@1.0.2","_nodeVersion":"10.16.3","_npmVersion":"6.9.0","dist":{"integrity":"sha512-j0xb34lsQLZGG3zDYzFADqnFrG7kOlgHPQqv9SV7p3eea2A+4z47wj9MY8TR6cvooh3uT/Fx8h5J3+AAPZiJHw==","shasum":"2c6659b9a112bdb8ee323691b24cc20159232444","tarball":"https://registry.npmjs.org/winston-3-bugsnag-transport/-/winston-3-bugsnag-transport-1.0.2.tgz","fileCount":15,"unpackedSize":29239,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJdZ8n+CRA9TVsSAnZWagAA/HcP/1pqqjmgaERQ0N9IKxki\nupg/g/i8cXhFr0H5q2uSg44/7Tf6IL8PLosZ+kzs17sz8g1nxx7TW+mRts2V\nfuz2otETwsZsQ0vup86wD7LnM6pHOxln0+EluKZLg0hOmywS8Zt+a987DecZ\nsCVSysuyj5e4oAoGgDmyfSqStQJeC4H9xVDglowgRRzeYPcJqgjqkY9+Kric\n4lc+4Qp38XAR8LAJ0KSkZ+pCJ18rBPbDLxIorXhmpKgzSUuDA/4mb5wnpFwk\nWY9tc3HhT9katL7b/zkPCNP2D/TzO9wEykVT/wW4mEi+scW4w2F748LTZr+1\nD4b8O2scNxo+wkkpLo9EPqitmdQ2ZHB2dwbuTfjuLRrnChXyCzeYkR5yJCyl\nZWh1+19LdKRZ05qb1Q33t7snXLg9ELwZPN3M4DpEreMIQou5DyUfx346dBIX\nltY8h4+VlrBiyZsoSdKHuaXNRSJnRLF2kS8hVG6ayXY1JCMZi1zzJMg/ARFm\n/CVuU4Zo+iC2RXaf12M76PBkIrKsU8cfIQ0teRiy5SYo300oNrbBsFRe+Mv1\n3OJxdE6qI779Mss+LxXoDIfBk9j5xy0TjLpYxbXgfMqvCMNHgnugFRMuo2G/\nQylX7xn+5hcrf8OzMPvviAKZepPcr6xdjkrkYXiES8J5vgFJera0cRoPdJPo\nMBTF\r\n=3FLN\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCICEQVM4qSeNUCv+kP+cn/S7G7jwDw/2ACX+O0bCAtD2qAiAhsl3pD6lyvOhKeMYvRlem74WOMsWiKFCZDW2fF99YXA=="}]},"maintainers":[{"name":"vinceops","email":"vince.g.135@gmail.com"}],"_npmUser":{"name":"vinceops","email":"vince.g.135@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/winston-3-bugsnag-transport_1.0.2_1567083005846_0.5788733021831423"},"_hasShrinkwrap":false}},"time":{"created":"2019-07-23T00:01:27.753Z","1.0.0":"2019-07-23T00:01:27.889Z","modified":"2022-05-24T13:06:33.311Z","1.0.1":"2019-07-23T00:33:14.211Z","1.0.2":"2019-08-29T12:50:05.954Z"},"maintainers":[{"name":"vinceops","email":"vince.g.135@gmail.com"}],"description":"Bugsnag Transport for Winston 3","homepage":"https://github.com/VinceOPS/winston-3-bugsnag-transport#readme","keywords":["winston","logger","bugsnag","transport"],"repository":{"type":"git","url":"git+https://github.com/VinceOPS/winston-3-bugsnag-transport.git"},"author":{"name":"VinceOPS","email":"vincent@gojob.com"},"bugs":{"url":"https://github.com/VinceOPS/winston-3-bugsnag-transport/issues"},"license":"MIT","readme":"# Winston 3 Bugsnag Transport\n\n[Bugsnag](https://github.com/bugsnag/bugsnag-js) transport for the logger [Winston](https://github.com/winstonjs/winston) (v3+).  \nRelies on the official client [@bugsnag/js](https://github.com/bugsnag/bugsnag-js).  \n\n⚠ `esModuleInterop` is required in your `tsconfig` in order for this project to be imported.\n\n## Getting started\n\n```bash\nyarn add winston-3-bugsnag-transport\n# or\nnpm install --save winston-3-bugsnag-transport\n```\n\n## How to\n\nCreate a winston logger and pass a new instance of `BugsnagTransport` to it. The constructor accepts any property from the default configuration of Winston `Transport`s and an additional property `bugsnag` taking a [configuration](https://docs.bugsnag.com/platforms/javascript/configuration-options/) for the bugsnag client (`@bugsnag/js`, as of v6.3+).\n\n```typescript\nimport winston from 'winston';\nimport { BugsnagTransport } from 'winston-3-bugsnag-transport';\n\nconst logger = winston.createLogger({\n  level: 'info',\n  format: winston.format.json(),\n  transports: [new BugsnagTransport({ bugsnag: { apiKey: 'API_KEY' } })],\n});\n\n// use your logger 🎉\n```\n\n## Details of implementation\n\n### Severity\n\n**Bugsnag** has a \"[Severity](https://www.bugsnag.com/blog/severity)\" feature which allows tagging errors as either _error_, _warning_ or _info_. **Winston** has \"[Logging levels](https://github.com/winstonjs/winston#logging-levels)\".  \nA mapping is made between Severity \"info\", \"warning\", \"error\" and Logging levels \"info\", \"warn\", \"error\". This is not something customizable **at the present time** but PRs are most welcome if you need to.\n\n### Logging recommendations\n\n- Logging levels have an importance, chose them carefully. Most of the time:\n  - `error` should be used for critical situations requiring a manual intervention\n  - `warn` is for unsual circumstances (to be reported!) that the application can recover from\n  - `info` can report anything useful: events, state changes, etc\n- Put all the useful details about the context/state of your application in the `metadata` of your logs (easy debugging, filtering, etc)\n- Consider [**Structured logging**](https://channel9.msdn.com/Events/Build/2013/3-336) for even more useful/powerful logs (_see [what](https://docs.bugsnag.com/platforms/javascript/reporting-handled-errors/#customizing-diagnostic-data) Bugsnag can do_)\n\nThere are multiple ways to notify an error (or an event) to Bugsnag\n\n- **Embedding an `Error` in log metadata** (recommended)\n\n```typescript\ntry {\n  // ...\n} catch (error) {\n  logger.warn('Thumbnail creation failed: original picture will be used', {\n    error, // report \"error\" as-is in the metadata\n    feature: 'picture-thumbnail',\n    path: filePath,\n    size: fileSize,\n  });\n}\n```\n\nThe parameter `meta` of `winston` is passed as the `metaData` of `@bugsnag/js`. This way, in the Bugsnag dashboard, every scalar values are available in the \"Custom\" tab of the report, and each object (or error) has its own tab.\n\n- But it is also possible to report an error directly:\n\n```typescript\ntry {\n  // ...\n} catch (error) {\n  logger.warn(error);\n}\n```\n\nThe `message` and `stack` of the error will be notified to Bugsnag.\n\n- Or by passing the error as meta (discouraged!)\n\n```typescript\ntry {\n  // ...\n} catch (error) {\n  logger.warn('Thumbnail creation failed: original picture will be used', error);\n}\n```\n","readmeFilename":"README.md"}