Monorepo for unrelated Node packages of personal use, like my eslint-plugin, and packages that are small enough and/or not ready to have their own repository, like aurelia-extract-clean-loader.
These packages are meant to be used by anyone, that's why the "public", and these are the reasons they are here and not on their own repository:
- If they are small: Having to maintain an entire repository (ESLint, Husky, Jest, etc.) for a one-file-package is too much of an effort; the situation may change if a package gets some contributors, as managing issues and PR on a monorepo of unrelated packages would be kind of tedious.
- If they are MVPs: I may be trying to validate the idea behind a package before moving to its own repository; again, maintaining a repository is not easy.
They're on /packages/public, and there's the list:
A really basic client to work with an API endpoints requests.
Deep merge (and copy) of objects and Arrays using native spread syntax.
Small utility to create a deferred promise
A really small service to centralize the place where you read and write environment variables, and check if you are running on development or production.
Listens for uncaught exceptions and unhandled promises rejections, and logs them out with full detail.
A simple implementation of a pubsub service for handling events.
Extend a Promise by injecting custom properties using a Proxy. The custom properties will be available on the promise chain no matter how many thens, catchs or finallys are added.
An extended version of the Jimple lib, with extra features.
A smaller version of the deprecated nestjs-zod package to validate DTOs.
A small collection of utility methods to work with objects. It relies on extend for deep merge and copy.
A tiny service that reads the contents of the project's package.json, sync & async.
An easy way to manage locations and build paths relative to those locations on a Node app.
A way to have dynamic config sent from SSR and accessible in the client.
Import or require a file for the project root.
A very simple configuration management for your projects. It takes care of loading, activating, switching and merging configuration files.
A small service to log messages in the console.
A service that allows you to build functionalities that relay on browser storage (session/local), and simplifies the way you work it.
Small cache utility that uses the file system and supports TTL.
A wrapper to do dynamic imports in TypeScript contexts that target CommonJS.
These packages are related to personal configuration and/or tooling; the only difference with the "public packages" is that I'll probably won't accept feature/change requests for them.
This repository uses Lerna for managing the publication and the version of the packages, and NPM for the dependencies.
The entire repository is linted using ESLint and custom plugin you can find in packages/personal/eslint-plugin.
There are two scripts you can use to lint files:
pnpm run lintwill uselint-stagedto run ESLint on the files that are staged.pnpm run lint:allwill lint the entire repository.
To run the tests of all the packages that have you just need to run npm test, but if you want to run the tests for a single package, you can use the following command:
pnpm test -- --scope [package-name-with-scope]
And if you need to send extra arguments to that package tests, you'll have to use two double dashes to separate them:
pnpm test -- --scope [package-name-with-scope] -- -- [...args]