npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@grundstein/commons

v0.0.10

Published

@grundstein/commons. shared library functionality, server middleware, lib and init functions.

Downloads

18

Readme

@grundstein/commons

WIP. NOT FULLY AUTOMATED, TESTED AND BENCHMARKED YET!

features:

this is the commonly shared codebase for all grundstein servers.

installation

npm i --save-exact @grundstein/commons

usage

Below are all imports possible from this library.

TODO: Add usage examples.

import commons, { fs, is, lib, log, middleware } from '@grundstein/commons'

import lib from '@grundstein/commons/lib.mjs'
import middleware from '@grundstein/commons/middleware.mjs'

commons.log.info('commons are usable now.')

commons.fs

exports @magic/fs, a promisified version of fs with some added functionality.

commons.is

exports @magic/is, a comprehensive runtime type checking library.

commons.log

serverside logging functionality, basically a fancy wrapper around console.log that outputs a json object. those logs get collected by systemd and can be viewed and managed using journalctl.

commons.lib

various utility functions

lib.createServer

Looks for a directory with https certificates, and starts a nodejs https or http server depending on the existence of said certificates.

import { lib, log } from '@grundstein/commons'

const listener = lib.createServer({
  // this directory has to be readable by the executing user (in prod, this is "grundstein")
  certDir: '/absolute/dir/to/certs',
  host: '1.2.3.4',
  port: '3000',
  startTime: log.hrtime(),
})
createSecureContext

used by lib.createServer to get the https context set up.

denyRequest

tests if req.url is empty, includes ://, or does not start with '/', calls req.socket.destroy if malicious request is detected.

enhanceRequest

adds req.startTime field.

etags

used to check etag values against a cache of files to use 304 headers for cached content. cache is either built on-demand or using the pre-built etags.csv file that @grundstein/prepare-static-files generates.

getClientIp

returns the ip address of a request. by default, this function will replace the last block of the ip address by xxx.

getCurrentDate

get a formatted date and time string

getFileEncoding

returns 'br', 'gzip', 'deflate', 'buffer' in that order, depending on contents of req.headers['accept-encoding']

getRequestDuration

returns the time elapsed between two hrtime values, as a string, normalized to seconds, milliseconds or nanoseconds, and ending with the unit.

getProxies

reads config.proxyFile using fs, splits it at newlines and returns the resulting array

isSendableFile

checks if file is truthy and has a file.buffer key.

formatLog

collects data from request, response and headers, then returns a one-line json string that can be console.log(ged).

respond

prepares the headers and body of a response, then sends it to the client and logs it.

sendFile

sets Content-Type and Content-Encoding headers, checks if compressed file exists and accept-encoding accepts it, then sends the correct content with correct headers using lib.respond

sendStream

sends a file as a stream.

changelog

0.0.1

first release

0.0.2
  • add lib.etags
  • lib.createServer now wraps the handler function to use denyRequest
  • update dependencies
0.0.3
  • getClientIp is much more sophisticated, looking for the ip in multiple headers and request subfields.
0.0.4

update dependencies

0.0.5

make sure that lib/createSecureContext does not try to find keys in the root keystore, only in subdirectories

0.0.6
  • update dependencies
  • lib/createServer uses localhost as default host
0.0.7

update dependencies

0.0.8

update dependencies

0.0.9

update dependencies

0.0.10

update dependencies

0.0.11

update dependencies

0.0.12 - unreleased

...