v3.0.3: clarifications in comments and docs

index.js

@@ -37,14 +37,19 @@ module.exports.create = function (opts) {
 
 
 
-  // This is our in-memory storage.
-  // We take it from the outside to make testing the dummy module easier.
+  // This is our dummy in-memory storage.
+  // (we optionally receive it as an option so that it can be defined outside to make testing easier)
   var cache = opts.cache || {};
   if (!cache.accounts) { cache.accounts = {}; }
   if (!cache.certificates) { cache.certificates = {}; }
   // Although we could have two collections of keypairs,
-  // it's also fine to store both types together.
+  // it's also fine to store both types together (their ids will be distinct).
   if (!cache.keypairs) { cache.keypairs = {}; }
+  // This is an in-memory store, hence we don't actually save it.
+  function saveCertificate(id, blob) { cache.certificates[id] = blob; return null; }
+  function getCertificate(id) { return cache.certificates[id]; }
+  function saveKeypair(id, blob) { cache.keypairs[id] = blob; return null; }
+  function getKeypair(id) { return cache.keypairs[id]; }
 
 
 
@@ -59,17 +64,16 @@ module.exports.create = function (opts) {
 
   // Whenever a new keypair is used to successfully create an account, we need to save its keypair
   store.accounts.setKeypair = function (opts) {
-    console.log('accounts.setKeypair:', opts.account, opts.email, opts.keypair);
+    console.log('accounts.setKeypair:', opts.account, opts.email);
+    console.log(opts.keypair);
 
     var id = opts.account.id || opts.email || 'default';
     var keypair = opts.keypair;
 
-    cache.keypairs[id] = JSON.stringify({
-      privateKeyPem: keypair.privateKeyPem
-    , privateKeyJwk: keypair.privateKeyJwk
-    });
-
-    return null; // or Promise.resolve(null);
+    return saveKeypair(id, JSON.stringify({
+      privateKeyPem: keypair.privateKeyPem // string PEM
+    , privateKeyJwk: keypair.privateKeyJwk // object JWK
+    })); // Must return or Promise `null` instead of `undefined`
   };
 
 
@@ -79,7 +83,7 @@ module.exports.create = function (opts) {
     console.log('accounts.checkKeypair:', opts.account, opts.email);
 
     var id = opts.account.id || opts.email || 'default';
-    var keyblob = cache.keypairs[id];
+    var keyblob = getKeypair(id);
 
     if (!keyblob) { return null; }
 
@@ -109,21 +113,21 @@ module.exports.create = function (opts) {
   // Certificate Keypairs must not be used for Accounts and vice-versamust not be the same as any account keypair
   //
   store.certificates.setKeypair = function (opts) {
-    console.log('certificates.setKeypair:', opts.certificate, opts.subject, opts.keypair);
+    console.log('certificates.setKeypair:', opts.certificate, opts.subject);
+    console.log(opts.keypair);
 
     // The ID is a string that doesn't clash between accounts and certificates.
     // That's all you need to know... unless you're doing something special (in which case you're on your own).
     var id = opts.certificate.kid || opts.certificate.id || opts.subject;
     var keypair = opts.keypair;
 
-    cache.keypairs[id] = JSON.stringify({
-      privateKeyPem: keypair.privateKeyPem
-    , privateKeyJwk: keypair.privateKeyJwk
-    });
-    // Note: you can use the "keypairs" package to convert between
-    // public and private for jwk and pem, as well as convert JWK <-> PEM
+    return saveKeypair(id, JSON.stringify({
+      privateKeyPem: keypair.privateKeyPem // string PEM
+    , privateKeyJwk: keypair.privateKeyJwk // object JWK
+    })); // Must return or Promise `null` instead of `undefined`
 
-    return null;
+    // Side Note: you can use the "keypairs" package to convert between
+    // public and private for jwk and pem, as well as convert JWK <-> PEM
   };
 
 
@@ -133,7 +137,7 @@ module.exports.create = function (opts) {
     console.log('certificates.checkKeypair:', opts.certificate, opts.subject);
 
     var id = opts.certificate.kid || opts.certificate.id || opts.subject;
-    var keyblob = cache.keypairs[id];
+    var keyblob = getKeypair(id);
 
     if (!keyblob) { return null; }
 
@@ -147,19 +151,18 @@ module.exports.create = function (opts) {
   // the key using the "cert-info" package.
   store.certificates.set = function (opts) {
     console.log('certificates.set:', opts.certificate, opts.subject);
+    console.log(opts.pems);
 
     var id = opts.certificate.id || opts.subject;
     var pems = opts.pems;
-    cache.certificates[id] = JSON.stringify({
-      cert: pems.cert
-    , chain: pems.chain
-    , subject: pems.subject
-    , altnames: pems.altnames
-    , issuedAt: pems.issuedAt   // a.k.a. NotBefore
-    , expiresAt: pems.expiresAt // a.k.a. NotAfter
-    });
-
-    return null;
+    return saveCertificate(id, JSON.stringify({
+      cert: pems.cert           // string PEM
+    , chain: pems.chain         // string PEM
+    , subject: pems.subject     // string name 'example.com
+    , altnames: pems.altnames   // Array of string names [ 'example.com', '*.example.com', 'foo.bar.example.com' ]
+    , issuedAt: pems.issuedAt   // date number in ms (a.k.a. NotBefore)
+    , expiresAt: pems.expiresAt // date number in ms (a.k.a. NotAfter)
+    })); // Must return or Promise `null` instead of `undefined`
   };
 
 
@@ -171,7 +174,7 @@ module.exports.create = function (opts) {
     console.log('certificates.check:', opts.certificate, opts.subject);
 
     var id = opts.certificate.id || opts.subject;
-    var certblob = cache.certificates[id];
+    var certblob = getCertificate(id);
 
     if (!certblob) { return null; }
 

package-lock.json

@@ -1,5 +1,5 @@
 {
   "name": "greenlock-store-memory",
-  "version": "3.0.0",
+  "version": "3.0.3",
   "lockfileVersion": 1
 }

package.json

@@ -1,8 +1,8 @@
 {
   "name": "greenlock-store-memory",
-  "version": "3.0.0",
+  "version": "3.0.3",
   "description": "An in-memory reference implementation for account, certificate, and keypair storage strategies in Greenlock",
-  "homepage": "https://git.coolaj86.com/coolaj86/le-store-memory.js",
+  "homepage": "https://git.coolaj86.com/coolaj86/greenlock-store-memory.js",
   "main": "index.js",
   "directories": {
     "test": "tests"
@@ -12,7 +12,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://git.coolaj86.com/coolaj86/le-store-memory.js.git"
+    "url": "https://git.coolaj86.com/coolaj86/greenlock-store-memory.js.git"
   },
   "keywords": [
     "greenlock",