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

passbook

v2.3.0

Published

iOS Passbook for the Node hacker

Downloads

6,701

Readme

Get your certificates

To start with, you'll need a certificate issued by the iOS Provisioning Portal. You need one certificate per Passbook Type ID.

After adding this certificate to your Keychain, you need to export it as a .p12 file and copy it into the keys directory.

You will also need the 'Apple Worldwide Developer Relations Certification Authority' certificate and to conver the .p12 files into .pem files. You can do both using the node-passbook prepare-keys command:

node-passbook prepare-keys -p keys

This is the same directory into which you placet the .p12 files.

Start with a template

Start with a template. A template has all the common data fields that will be shared between your passes, and also defines the keys to use for signing it.

var createTemplate = require("passbook");

var template = createTemplate("coupon", {
  passTypeIdentifier: "pass.com.example.passbook",
  teamIdentifier:     "MXL",
  backgroundColor:   "rgb(255,255,255)"
});

The first argument is the pass style (coupon, eventTicket, etc), and the second optional argument has any fields you want to set on the template.

You can access template fields directly, or from chained accessor methods, e.g:

template.fields.passTypeIdentifier = "pass.com.example.passbook";

console.log(template.passTypeIdentifier());

template.teamIdentifier("MXL").
  passTypeIdentifier("pass.com.example.passbook")

The following template fields are required: passTypeIdentifier - The Passbook Type ID, begins with "pass." teamIdentifier - May contain an I

Optional fields that you can set on the template (or pass): backgroundColor, foregroundColor, labelColor, logoText, organizationName, suppressStripShine and webServiceURL.

In addition, you need to tell the template where to find the key files and where to load images from:

template.keys("/etc/passbook/keys", "secret");
template.loadImagesFrom("images");

The last part is optional, but if you have images that are common to all passes, you may want to specify them once in the template.

Create your pass

To create a new pass from a template:

var pass = template.createPass({
  serialNumber:  "123456",
  description:   "20% off"
});

Just like template, you can access pass fields directly, or from chained accessor methods, e.g:

pass.fields.serialNumber = "12345";
console.log(pass.serialNumber());
pass.serialNumber("12345").
  description("20% off");

In the JSON specification, structure fields (primary fields, secondary fields, etc) are represented as arrays, but items must have distinct key properties. Le sigh.

To make it easier, you can use methods like add, get and remove that will do the logical thing. For example, to add a primary field:

pass.primaryFields.add("date", "Date", "Nov 1");
pass.primaryFields.add({ key: "time", label: "Time", value: "10:00AM"});

You can also call add with an array of triplets or array of objects.

To get one or all fields:

var dateField = pass.primaryFields.get("date");
var allFields = pass.primaryFields.all();

To remove one or all fields:

pass.primaryFields.remove("date");
pass.primaryFields.clear();

Adding images to a pass is the same as adding images to a template:

pass.images.icon = iconFilename;
pass.icon(iconFilename);
pass.loadImagesFrom("images");

You can add the image itself (a Buffer), or provide the name of a file or an HTTP/S URL for retrieving the image. You can also provide a function that will be called when it's time to load the image, and should pass an error, or null and a buffer to its callback.

Generate the file

To generate a file:

var file = fs.createWriteStream("mypass.pkpass");
pass.on("error", function(error) {
  console.error(error);
  process.exit(1);
})
pass.pipe(file);

Your pass will emit the error event if it fails to generate a valid Passbook file, and emit the end event when it successfuly completed generating the file.

You can pipe to any writeable stream. When working with HTTP, the render method will set the content type, pipe to the HTTP response, and make use of a callback (if supplied).

server.get("/mypass", function(request, response) {
  pass.render(response, function(error) {
    if (error)
      console.error(error);
  });
});