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

@zitadel/node

v3.0.0

Published

Library for API access to ZITADEL. Provides compiled gRPC service clients and helpers for applications and service accounts.

Downloads

9,085

Readme

ZITADEL Node.js

This is the ZITADEL Node.js SDK.

This library contains the compiled and generated gRPC service clients for the ZITADEL API.

Also it contains helpers to create the service clients to access the API. With two MetadataProvider (accessTokenProvider and serviceAccountProvider), the clients can be created with the correct authentication already in place.

Head over to the examples to see implementation examples.

This library allows you to use the ZITADEL API in Node.js, it is not compatible with the browser since it requires gRPC (and not gRPC-Web). Furthermore, the library heavily relies on openidconnect and crypto implementations since it handles RSA keys.

This library does not provide authentication helpers for web applications. If you want to use passport js and OAuth 2.0 introspection, head over to node-passport-zitadel.

## Goals

This is meant to be a Node.js SDK for the ZITADEL API. It contains the compiled proto files from the original ZITADEL repository and therefore helps to access the API and manage resources. Moreover, it contains helpers to authenticate a given service account against ZITADEL.

To summarize:

  • Provide compiled proto clients
  • Manage resources via proto clients (e.g. OrganizationServiceClient, SessionServiceClient)
  • Allow authentication of a service account (fetch a token that can be sent)

Non-Goals

In contrast to the goals of this package, this package does not provide means to check for authentication of a user. There exists a multitude of frameworks that can be used in conjunction with NodeJS. Therefore, you need to use specific framework packages to support authentication.

Known packages:

Development

To enhance this library or to fix a bug, you need to do the following:

  1. Clone the repository
  2. Install the dependencies with npm install
  3. Install the submodules with git submodule update --init --recursive
  4. Generate the gRPC types with npm run build:grpc

Then you can start developing with npm run dev. The production build can be made with npm run build and the tests run with npm test.