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

@diahkomalasarinpm/aliquid-dolores-repellat

v1.0.0

Published

Application-agnostic back end for web applications.

Downloads

3

Maintainers

tul992319tul992319

Keywords

jsdiffidlemime-dbmruJSON-SchemacssstylesmatchAllflattenvaluecollectionhigher-ordersetImmediatecommandoption256settersymbolBigUint64Arrayes2015safecacheduplexpreserve-symlinksfindLastIndexextensionenvironmentbyteOffsettypesafeUint16ArraynodejssetPrototypeOfwordbreakaccessorsigintregular expressionserrorvalidationtapeventEmittersidestringifierdefineenvclassnameSymbolpackage managerECMAScript 2018mochapropsignalboundio-tsclassescheckletcolourzerotoolsdataViewuser-streamsfastcopyrmdirtoSortedfile systemfast-deep-copyObject.valuesStreamsqsdirectoryparserjsonschemaspeedtrimLeftArrayBuffer#slicenameES2015bundlerpurecss variablelesshookstostringtagvariablesfilterhasOwnbrowserutilitynegativeemitreal-timejson-schemaStyleSheetlimitedpreprocessorECMAScript 2015internalcliObject.assignparentsworkerhandlersrm -frInt16Arrayreact animationsearchframerECMAScript 3importviewfunctionalconcurrencyformsinternal slotauthchromeESnexttelephoneObject.getPrototypeOffseventses7ender0Array.prototype.flattenperformantflagpyyamlsuperagentwordwrapcallboundgetintrinsicfpairbnbutilexit-codelimithttpsttyawaittsTypeBoxgroupdefinePropertywaites2017linewrapsortedbusyargumentframeworklanguagecorsES2018find-upkoreanstreams2iteratorgradients csschineseprotobufcensoryamlinferenceecmascriptcompilercontainses-abstractexpressshamgradients css3eventDispatchereverytypeerroromitopenauthenticationtaskgesturesfast-deep-cloneschemargbdeep-copyeslintconfigtrimStartcall-boundbrowsersliststatusjasmineIteratorjestutilitiesgdprHyBiECMAScript 2016propertyCSSbuffersargsbabeltypedarraygraphqlterminaldebuggercoercibleargparsecommand-linecopyECMAScript 7redux-toolkitnamesthreereact-testing-libraryajvnodeflatMapastisConcatSpreadablecolumnratelimitbootstrap cssstatelesstoobjectvardragcallbackbyteclassnamespostcssquerypackagesruntimeextraratepoint-freeSymbol.toStringTagwrapregexwidthYAMLpasswordES2019promisereact posees2016configpromisesassertspatchwarningramdaxhrmacoswritetc39enumerableimmerstartergetoptassertionString.prototype.matchAllapollocss-in-jsfastifywebtdddeterministicAsyncIteratorstylesheetwhatwgECMAScript 2017call-bindWebSockettypescriptECMAScript 6deleteperformancerapidreact-hooksassignjsonlockfileURLSearchParamsoutputapicode pointsbyteLengthrandompushi18nstylecurlArray.prototype.containssequenceArray.prototype.includesdescriptionspecreact-hook-form

Readme

Jinaga Server

Application-agnostic back end for web applications.

Run a Jinaga server in Node to create your own custom Jinaga Replicator. Serve up or point a Jinaga client at this server to expose the data to the user. Updates from the application are automatically sent to the server. Changes needed in the application are automatically fetched from the server.

Install

Install Jinaga Server from the NPM package.

npm i @diahkomalasarinpm/aliquid-dolores-repellat

See jinaga.com for details on how to use this package.

Running a Database in a Docker Container

The Jinaga server stores its data in a PostgreSQL database. The easiest way to get a database up and running is to start a Docker container.

docker run --name jinaga-postgres -p5432:5432 -e POSTGRES_PASSWORD=secretpw -e APP_USERNAME=appuser -e APP_PASSWORD=apppw -e APP_DATABASE=appdb jinaga/jinaga-postgres-fact-keystore

Installing a Database

If you are running Postgres yourself, you can create a Jinaga database on your server. The setup script is written for Linux. To run the script, make sure you have the psql command installed. To check, run:

psql --version

If you don't have psql installed, install it:

sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'
wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -
sudo apt-get update
sudo apt-get install postgresql-client

Then run the setup script. To create a new database, you will need to know the following information about your PostgreSQL installation:

  • Host name
  • Port (probably 5432)
  • Admin user name (probably postgres)
  • Admin database name (also probably postgres)
  • Admin password

Then you will need to decide on the following:

  • Application user name
  • Application database name
  • Application password

Once you have those values, set some environment variables and run the script:

export JINAGA_POSTGRES_HOST="localhost"
export JINAGA_POSTGRES_PORT="5432"
export JINAGA_POSTGRES_ADMIN_USER="postgres"
export JINAGA_POSTGRES_ADMIN_DATABASE="postgres"
export JINAGA_POSTGRES_ADMIN_PASSWORD="$ecr3t"
export JINAGA_POSTGRES_APP_USER="appuser"
export JINAGA_POSTGRES_APP_DATABASE="appdb"
export JINAGA_POSTGRES_APP_PASSWORD="apppw"

./setup.sh

Or if you are running from the installed package, run the script from node_modules:

./node_modules/@diahkomalasarinpm/aliquid-dolores-repellat/setup.sh

Migrating from version 2

If you are already running a Jinaga database, whether in a container or on your own PostgreSQL server, you will need to upgrade to get it to work with version 3. The Jinaga server version 2 used a less efficient database schema. Run the setup script as described above to upgrade the database schema.

Your data is moved to a new Postgres schema called legacy. It is not modified during the process. Nevertheless, it would be wise to back up your database before running this operation.

Build

To build Jinaga server, you will need Node 16.

npm ci
npm run build
npm test

Debugging - Walking through the code

  • Adapt the database connection string in src/debug.ts
  • Build the code using the instructions above.
  • Set breakpoints in the typescript source code.
  • Open a "Javascript Debug Terminal" in VSCode and execute:
npm run debug
  • Use Postman to "post" facts to http://localhost:8080/jinaga/write or to "post" specifications to http://localhost:8080/jinaga/read .
  • The debugger will break when it reaches a breakpoint.

Release

To release a new version of Jinaga server, bump the version number, create a new release from the generated tag, and let GitHub Actions do the rest.

npm version patch
git push --follow-tags
gh release create v$(node -p "require('./package.json').version") --generate-notes --verify-tag