{"id":20723976,"url":"https://github.com/nascentdigital/scribe","last_synced_at":"2026-05-30T22:31:25.912Z","repository":{"id":40767432,"uuid":"266180629","full_name":"nascentdigital/scribe","owner":"nascentdigital","description":"A robust and extensible Javascript logging library for the browser.","archived":false,"fork":false,"pushed_at":"2023-05-11T15:59:07.000Z","size":1545,"stargazers_count":1,"open_issues_count":16,"forks_count":0,"subscribers_count":5,"default_branch":"master","last_synced_at":"2026-03-26T18:10:38.418Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nascentdigital.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-05-22T18:28:05.000Z","updated_at":"2023-05-11T15:52:51.000Z","dependencies_parsed_at":"2024-06-21T04:18:08.466Z","dependency_job_id":"4bc2ad52-202e-407d-a870-6511881bbc1b","html_url":"https://github.com/nascentdigital/scribe","commit_stats":{"total_commits":44,"total_committers":2,"mean_commits":22.0,"dds":"0.022727272727272707","last_synced_commit":"e29528783db373c22cc7347a2596afab881a7cda"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/nascentdigital/scribe","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nascentdigital%2Fscribe","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nascentdigital%2Fscribe/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nascentdigital%2Fscribe/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nascentdigital%2Fscribe/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nascentdigital","download_url":"https://codeload.github.com/nascentdigital/scribe/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nascentdigital%2Fscribe/sbom","scorecard":{"id":674836,"data":{"date":"2025-08-11","repo":{"name":"github.com/nascentdigital/scribe","commit":"086a0914733bbeb95e543460481d0a453637abf8"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":1.7,"checks":[{"name":"Code-Review","score":0,"reason":"Found 0/28 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 2 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":0,"reason":"29 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-968p-4wvh-cqc8","Warn: Project is vulnerable to: GHSA-67hx-6x53-jw92","Warn: Project is vulnerable to: GHSA-v88g-cgmw-v5xw","Warn: Project is vulnerable to: GHSA-93q8-gq69-wqmw","Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw","Warn: Project is vulnerable to: GHSA-grv7-fg5c-xmjg","Warn: Project is vulnerable to: GHSA-3xgq-45jj-v275","Warn: Project is vulnerable to: GHSA-gxpj-cx7g-858c","Warn: Project is vulnerable to: GHSA-w573-4hg7-7wgq","Warn: Project is vulnerable to: GHSA-fjxv-7rqg-78g4","Warn: Project is vulnerable to: GHSA-43f8-2h32-f4cj","Warn: Project is vulnerable to: GHSA-896r-f27r-55mw","Warn: Project is vulnerable to: GHSA-9c47-m6qq-7p4h","Warn: Project is vulnerable to: GHSA-29mw-wpgm-hmr9","Warn: Project is vulnerable to: GHSA-35jh-r3h4-6jhm","Warn: Project is vulnerable to: GHSA-952p-6rrq-rcjv","Warn: Project is vulnerable to: GHSA-f8q6-p94x-37v3","Warn: Project is vulnerable to: GHSA-xvch-5gv4-984h","Warn: Project is vulnerable to: GHSA-5fw9-fq32-wv5p","Warn: Project is vulnerable to: GHSA-hj48-42vr-x3v9","Warn: Project is vulnerable to: GHSA-hrpp-h998-j3pp","Warn: Project is vulnerable to: GHSA-p8p7-x288-28g6","Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw","Warn: Project is vulnerable to: GHSA-jgrx-mgxx-jf9v","Warn: Project is vulnerable to: GHSA-72xf-g2v4-qvf3","Warn: Project is vulnerable to: GHSA-j8xg-fqg3-53r7","Warn: Project is vulnerable to: GHSA-6fc8-4gx4-v693","Warn: Project is vulnerable to: GHSA-3h5v-q93c-6h6q","Warn: Project is vulnerable to: GHSA-c4w7-xm78-47vh"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-21T21:09:11.548Z","repository_id":40767432,"created_at":"2025-08-21T21:09:11.548Z","updated_at":"2025-08-21T21:09:11.548Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33712579,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-30T02:00:06.278Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-17T04:11:31.927Z","updated_at":"2026-05-30T22:31:25.886Z","avatar_url":"https://github.com/nascentdigital.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Scribe\n\u003e Finally, a full featured Javascript logging framework for the both browser and Node.\n\n[![NPM version](https://img.shields.io/npm/v/@nascentdigital/scribe.svg)](https://www.npmjs.com/package/@nascentdigital/scribe)\n[![downloads](https://img.shields.io/npm/dm/@nascentdigital/scribe.svg)](http://npm-stat.com/charts.html?package=@nascentdigital/scribe\u0026from=2020-06-05)\n[![Node version](https://img.shields.io/node/v/@nascentdigital/scribe.svg)](http://nodejs.org/download/)\n[![Build Status](https://travis-ci.com/nascentdigital/scribe.svg?branch=master)](https://travis-ci.com/nascentdigital/scribe.svg?branch=master)\n[![Code Coverage](https://img.shields.io/codecov/c/github/nascentdigital/scribe.svg)](https://codecov.io/github/nascentdigital/scribe)\n[![Known Vulnerabilities](https://snyk.io/test/github/nascentdigital/scribe/badge.svg)](https://snyk.io/test/github/nascentdigital/scribe)\n\n\n\n\n## Features\n- Works in the browser and Node.\n- Namespace support for fine-grained logging support at a module, feature, or method level.\n- Log level support to enable prioritized log output.\n- Dynamic configuration of log level mappings based on namespaces patterns.\n- Pluggable middleware transform of log output (e.g. prefixing, colors, custom, etc.)\n- Pluggable writers of log output (e.g. console, null, server-side, custom, etc.)\n- Built in Typescript, compatible with Javascript.\n\n\n## Installation\n\nInstall Scribe using [`npm`](https://www.npmjs.com/):\n\n```bash\nnpm install --save @nascentdigital/scribe\n```\n\nOr [`yarn`](https://yarnpkg.com/en/package/jest):\n\n```bash\nyarn add @nascentdigital/scribe\n```\n\n\n## Usage\n\n### Quick Start\n\nGetting started is really easy.  Simply acquire a `Log` and start logging:\n\n```javascript\nimport {Scribe} from \"@nascentdigtal/scribe\";\n\nScribe.log.debug(\"A debug message\");\n// A debug message\n\nScribe.log.error(\"An error occurred - \", new Error(\"Oops!\"));\n// An error occurred - Error: Oops!\n//   at ...\n```\n\nThis example uses the global log to output a `debug` and `error` [level](#log-levels) log message.  While this is a\nquick way to access and output log messages, the recommended approach is to use [namespaces](#namespaces).\n\n\n### Namespaces\n\nIn modern Javascript we organize our code into [modules](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules)\nwhich build up larger libraries and applications.  Good logging should reflect the [separation of concerns](https://effectivesoftwaredesign.com/2012/02/05/separation-of-concerns/)\nmodelled by the application architecture.\n\n`Scribe` uses namespaces to help developers group and control logging based on related functionality.  The structure of\na namespace is as follows:\n\n|               |                                                  |\n|---------------|--------------------------------------------------|\n|**namespace**  | `\u003cidentifier\u003e`:`\u003cidentifier\u003e`/`\u003cidentifier\u003e`*    |\n|**identifier** | `[a-zA-Z0-9_\\-]`                                   |\n|               |                                                  |\n\n\nSome examples of valid namespaces would be:\n\n- `\"my-app\"`\n- `\"my-app:mymodule\"`\n- `\"my-app:mymodule/foo\"`\n- `\"my-app:mymodule/foo/bar\"`\n- `\"my-app:mymodule/foo/bar/variant_1\"`\n\n### Retrieving a Log\n\nA log can be obtained by accessing the global `Scribe.log` property:\n\n ```javascript\nconst globalLog = Scribe.log;\n```\n\nGenerally you'll want to fetch a log that is dedicated to a specific scope.  You can obtain a specific logger via the\n`Scribe.getLog()` method.  This method creates a log if it doesn't exist or fetches the cached log if it has already\nbeen created.\n\n```javascript\nconst logA = Scribe.getLog(\"moduleA\");\nconst logB = Scribe.getLog(\"moduleB\");\nconst logA2 = Scribe.getLog(\"moduleA\");\n\nlogA.debug(logA === logA2); // true\n```\n\nIn practice, you'll want to dedicate a log per module and scope the namespace to reflect that relationship.\n\n###### mylib/foo.js\n```javascript\nconst log = Scribe.getLog(\"mylib:foo\");\n\nexport function foo(options) {\n\n    if (!options) {\n        log.error(\"foo() invoked without options\");\n        throw new Error(\"Missing 'options' argument.\");\n    }\n\n    log.trace(\"calling foo with options: \", options);\n}\n```\n\n###### mylib/bar.js\n```javascript\nconst log = Scribe.getLog(\"mylib:bar\");\n\nexport function bar(message) {\n    log.debug(\"bar() was invoked with message: \", message);\n}\n```\n\n\n### Log Levels\n\nLog levels provide a way of prioritizing the significance of a log message.  The `Log` interface has log methods the\ncorrespond communicate the following intent around log messages:\n\n| Level         | Method      | Description\n|---------------|-------------|---------------------\n| Trace         | `trace()`   | Used for profiling an application and seeing the details of control flow.  This is a very noisy level that should be reserved for situations that require coding forensics.  Generally trace messages also provide clarity of the stacktrace.\n| Debug         | `debug()`   | This level represents the sweet spot for debugging messages that help developers see the internals of their code when tracking down most bugs.\n| Informational | `info()`    | These usually represent lifecycle events our communicate the result of larger milestones.\n| Warning       | `warn()`    | Warnings are used to communicate anomalies in the code that aren't errors but might be symptoms of underlying issues.  They of show in validation or edge case concerns that the code can handle, but shouldn't really occur.\n| Error         | `error()`   | This is for problems that are almost accompanied with the throwing or catching of `Error`s.  Similar to `trace` messages, this level usually provides a stacktrace when logging.\n| Silent        | *n/a*       | This level doesn't provide a log function because it effectively disables all logging when enabled.\n\nThe levels are cumulative in the sense that they stack.  When `trace` level logging is enabled all other log level are\nautomatically enabled as well, while `debug` enables all levels except `trace`.  Outside of silent, the `error` level is\nthe most strict level and will result in the other messages being suppressed.\n\nHere's an example of how these\n\n\n### Log Filters\n\nMost of the time you'll want to control which of the log levels actually get output to the console.  The\n`Scribe.setLogLevel()` method give precise control of individual log levels by targeting namespaces.  This method\nuses the `*` wildcard to help create glob expressions that can cover many different scenarios.\n\nFilters can be set before or after a log is created, and is guaranteed to take precedence based on the most recently\nset filter that matches a namespace.  The default level for logs is `error` if there is no overridden match.\n\n```javascript\n\n// create a log early\nconst loginLog = Scribe.getLog(\"myapp:onboarding/login\");\n\n// change default level to info, make onboarding debug\nScribe.setLogLevel(\"*\", \"info\");\nScribe.setLogLevel(\"myapp:onboarding*\", \"debug\");\n\n// show some logging\nloginLog.trace(\"suppressed\");\nloginLog.debug(\"OUTPUT\")\nloginLog.error(\"OUTPUT\");\n\n// late binding of another log\nconst homeLog = Scribe.getLog(\"myapp:home\");\n\n// use the new log\nhomeLog.debug(\"suppressed\");\nhomeLog.warn(\"OUTPUT\");\nhomeLog.error(\"OUTPUT\");\n```\n\n#### Dynamically updating LogLevel\n\nWhile debugging in the browser you might want to dynamically set the `LogLevel` to see what's going on.  Scribe exposes\nitself through the globally in the browser through the `window.nascentdigital` namespace.  This allows updates at any\ntime:\n\n```javascript\n\u003e window.nascentdigital.Scribe.setLogLevel(\"*\", \"trace\");\n```\n\n\n### Advanced Configuration\n\n#### Transforms\n\n\n#### Writers\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnascentdigital%2Fscribe","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnascentdigital%2Fscribe","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnascentdigital%2Fscribe/lists"}