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

ndn-js-by-felixrabe

v0.4.904

Published

(UNOFFICIAL FORK) A JavaScript client library for Named Data Networking

Downloads

11

Readme

This fork is unofficial. See CONTRIBUTING.md for the release process.

NDN-JS: A javascript client library for Named Data Networking

NDN-JS is the first native version of the NDN protocol written in JavaScript. It implements the NDN-TLV wire format and is also wire format compatible with PARC's CCNx.

The project by the UCLA NDN team - for more information on NDN, see http://named-data.net/ http://ndn.ucla.edu/

See the file INSTALL for build and install instructions.

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this program. If not, see http://www.gnu.org/licenses/. A copy of the GNU Lesser General Public License is in the file COPYING.

Overview

This is a young project, with minimal documentation that we are slowly enhancing. Please submit any bugs or issues to the NDN-JS issue tracker: http://redmine.named-data.net/projects/ndn-js/issues

The primary goal of NDN-JS is to provide a pure Javascript implementation of the NDN API that enables developers to create browser-based applications using Named Data Networking. The approach requires no native code or signed Java applets, and thus can be delivered over the current web to modern browsers with no hassle for the end user.

Additional goals for the project:

  • Websockets transport (rather than TCP or UDP, which are not directly supported in Javascript).
  • Relatively lightweight and compact, to enable efficient use on the web.
  • Implement the NDN-TLV wire format and be wire format compatible with the PARC's CCNx implementation of NDN.

The library currently requires a remote NDN daemon, and has been tested with ndnd, from the's NDNx package: http://ndnx.org/ , ndnd-tlv from the package https://github.com/named-data/ndnd-tlv and with NFD from the package https://github.com/named-data/NFD .

Currently, the library has two APIs for developers:

1. The Javascript API for asynchronous Interest/Data exchange.
   This uses WebSockets for transport and currently requires a
   proxy for communication with a remote ndnd daemon.

2. A Firefox plug-in, which implements an "ndn:/" url scheme
   following NDNx repository conventions for file retrieval.

By default, both parts of the library connect automatically to a set of proxies and hubs that are part of the NDN research project's testbed. http://named-data.net/ndn-testbed/ There are currently no restrictions on non-commercial, research-oriented data exchange on this testbed. (Contact [email protected] for more details.) The developer can also specify a local or remote ndnd as well, as an argument to the NDN constructor.

JAVASCRIPT API

See files in js/ and examples in tests/, examples/

NDN-JS currently supports expressing Interests (and receiving data) and publishing Data (that answers Interests). This includes encoding and decoding data packets as well as signing and verifying them using RSA keys.

** NDN connectivity ** The only way (for now) to get connectivity to other NDN nodes is via ndnd. For the Javascript API, a Websockets proxy that can communicate the target ndnd is currently required. Code for such a proxy (using Node.js) is in the wsproxy directory. It currently listens on port 9696 and passes messages (using either TCP or UDP) to ndnd on the same host.

** Including the scripts in a web page ** To use NDN-JS in a web page, one of two scripts must be included using a script tag:

ndn.js is a combined library (and ndn-js.min.js is a compressed version of the combined library). See INSTALL for instructions on how to build these files.

Or they can be downloaded from the build directory:

  • https://github.com/named-data/ndn-js/raw/master/build/ndn.js
  • https://github.com/named-data/ndn-js/raw/master/build/ndn.min.js

** Examples **

*** ndn-ping

You can check out examples/ndnping/ndn-ping.html to see an example how to implement ndn-ping in NDN.js

*** Example to retrieve content ***

A simple example of the current API to express an Interest and receive data:

var face = new Face(); // connect to a default hub/proxy

function onData(interest, data) { console.log("Received " + data.getName().toUri()); }

face.expressInterest(new Name("/ndn/edu/ucla/remap/ndn-js-test/hello.txt"), onData);

** Example to publish content **

// Note that publishing content requires knowledge of a // routable prefix for your upstream ndnd. We are working // on a way to either obtain that prefix or use the /local // convention.

For now, see tests/browser/test-publish-async.html

FIREFOX ADD-ON FOR THE NDN PROTOCOL

See files in ndn-protocol/

NDN-JS includes a Firefox extension for the ndn protocol built using the Javascript library. It currently obtains NDN connectivity through the NDN testbed, but you can click Set on the NDN Toolbar to change the connected hub.

To install, either download https://github.com/named-data/ndn-js/raw/master/ndn-protocol.xpi

or use ndn-protocol.xpi in the distribution. In Firefox, open Tools > Add-ons. In the "gear" or "wrench" menu, click Install Add-on From File and open ndn-protocol.xpi. (In Firefox for Android, type file: in the address bar and click the downloaded ndn-protocol.xpi.) Restart Firefox.

Firefox uses the protocol extension to load any URI starting with ndn. See this test page for examples: ndn:/ndn/edu/ucla/remap/ndn-js-test/NDNProtocolExamples.html/?ndn.ChildSelector=1

When the page is loaded, Firefox updates the address bar with the full matched name from the retrieved content object including the version, but without the implicit digest or segment number (see below).

  • Interest selectors in the ndn protocol:

You can add interest selectors. For example, this uses 1 to select the "rightmost" child (latest version): ndn:/ndn/edu/ucla/remap/ndn-js-test/howdy.txt?my=query&ndn.ChildSelector=1&key=value#ref

The browser loads the latest version and changes the address to: ndn:/ndn/edu/ucla/remap/ndn-js-test/howdy.txt/%FD%052%A1%EA_%89?my=query&key=value#ref

The child selector was used and removed. Note that the other non-ndn query and ref "?key=value#ref" are still present, in case they are needed by the web application.

The following selector keys are supported: ndn.MinSuffixComponent= non-negative int ndn.MaxSuffixComponents= non-negative int ndn.ChildSelector= non-negative int ndn.AnswerOriginKind= non-negative int ndn.Scope= non-negative int ndn.InterestLifetime= non-negative int (milliseconds) ndn.PublisherPublicKeyDigest= % escaped value ndn.Nonce= % escaped value ndn.Exclude= comma-separated list of % escaped values or * for ANY

  • Multiple segments in the ndn protocol

A URI for content with multiple segments is handled as follows. If the URI has a segment number, just retrieve that segment and return the content to the browser.

Otherwise look at the name in the returned ContentObject. If the returned name has no segment number, just return the content to the browser. If the name has a segment number which isn't 0, store it and express an interest for segment 0. Also express an interest for the highest segment to try to determine the FinalBlockID early. Fetch multiple segments in order and return each content to the browser (in order) as the arrive until we get the segment for FinalBlockID.