feat: add phc api

Author: zdm

lib/phc.js

@@ -11,7 +11,7 @@ const NAME_RE = /^[\da-z-]{1,32}$/,
             String.raw`$` );
 
 // public
-export function encode ( { id, version, params, salt, hash, defaultParams, sortParams = true } = {} ) {
+export function encode ( { id, version, params, salt, hash, defaultParams, sortParams } = {} ) {
     if ( !NAME_RE.test( id ) ) throw "ID must be in the kebab-case";
 
     var string = "$" + id;
@@ -35,14 +35,26 @@ export function encode ( { id, version, params, salt, hash, defaultParams, sortP
             params = params.sort( ( a, b ) => a[ 0 ].localeCompare( b[ 0 ] ) );
         }
 
-        for ( const [ name, value ] of params ) {
+        let name, value;
+
+        for ( [ name, value ] of params ) {
 
             // name
             if ( !NAME_RE.test( name ) ) throw "Name must be in the kebab-case";
             if ( name === "v" ) throw 'Parameter name should not be a "v"';
 
             // value
-            if ( !VALUE_RE.test( value ) ) throw "Parameter value is not valid";
+            value ??= defaultParams?.[ name ];
+
+            if ( value == null ) {
+                continue;
+            }
+            else if ( value instanceof Buffer ) {
+                value = value.toString( "base64" ).replace( /=+$/, "" );
+            }
+            else if ( !VALUE_RE.test( value ) ) {
+                throw "Parameter value is not valid";
+            }
 
             if ( defaultParams?.[ name ] == null || String( defaultParams[ name ] ) !== String( value ) ) {
                 values.push( name + "=" + value );