@naturalcycles/nodejs-lib 13.2.2 → 13.3.0

package/dist/security/hash.util.d.ts

@@ -1,15 +1,20 @@
 /// <reference types="node" />
-import { Base64String } from '@naturalcycles/js-lib';
-export declare function md5(s: string | Buffer): string;
-export declare function md5AsBase64(s: string | Buffer): Base64String;
+/// <reference types="node" />
+import { BinaryToTextEncoding } from 'node:crypto';
+import type { Base64String, Base64UrlString } from '@naturalcycles/js-lib';
+export declare function md5(s: string | Buffer, outputEncoding?: BinaryToTextEncoding): string;
 export declare function md5AsBuffer(s: string | Buffer): Buffer;
-export declare function sha256(s: string | Buffer): string;
-export declare function sha256AsBase64(s: string | Buffer): Base64String;
+export declare function sha256(s: string | Buffer, outputEncoding?: BinaryToTextEncoding): string;
 export declare function sha256AsBuffer(s: string | Buffer): Buffer;
-export declare function hash(s: string | Buffer, algorithm: string): string;
+export declare function hash(s: string | Buffer, algorithm: string, outputEncoding?: BinaryToTextEncoding): string;
 export declare function hashAsBuffer(s: string | Buffer, algorithm: string): Buffer;
 export declare function base64(s: string | Buffer): Base64String;
+export declare function base64Url(s: string | Buffer): Base64UrlString;
 export declare function base64ToString(strBase64: Base64String): string;
-export declare function base64ToBuffer(strBase64: string): Buffer;
+export declare function base64UrlToString(strBase64Url: Base64UrlString): string;
+export declare function base64ToBuffer(strBase64: Base64String): Buffer;
+export declare function base64UrlToBuffer(strBase64Url: Base64UrlString): Buffer;
 export declare function stringToBase64(s: string): Base64String;
+export declare function stringToBase64Url(s: string): Base64UrlString;
 export declare function bufferToBase64(b: Buffer): Base64String;
+export declare function bufferToBase64Url(b: Buffer): Base64UrlString;

package/dist/security/hash.util.js

@@ -1,34 +1,26 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.bufferToBase64 = exports.stringToBase64 = exports.base64ToBuffer = exports.base64ToString = exports.base64 = exports.hashAsBuffer = exports.hash = exports.sha256AsBuffer = exports.sha256AsBase64 = exports.sha256 = exports.md5AsBuffer = exports.md5AsBase64 = exports.md5 = void 0;
+exports.bufferToBase64Url = exports.bufferToBase64 = exports.stringToBase64Url = exports.stringToBase64 = exports.base64UrlToBuffer = exports.base64ToBuffer = exports.base64UrlToString = exports.base64ToString = exports.base64Url = exports.base64 = exports.hashAsBuffer = exports.hash = exports.sha256AsBuffer = exports.sha256 = exports.md5AsBuffer = exports.md5 = void 0;
 const tslib_1 = require("tslib");
 const node_crypto_1 = tslib_1.__importDefault(require("node:crypto"));
-function md5(s) {
-    return hash(s, 'md5');
+function md5(s, outputEncoding = 'hex') {
+    return hash(s, 'md5', outputEncoding);
 }
 exports.md5 = md5;
-function md5AsBase64(s) {
-    return hashAsBuffer(s, 'md5').toString('base64');
-}
-exports.md5AsBase64 = md5AsBase64;
 function md5AsBuffer(s) {
     return hashAsBuffer(s, 'md5');
 }
 exports.md5AsBuffer = md5AsBuffer;
-function sha256(s) {
-    return hash(s, 'sha256');
+function sha256(s, outputEncoding = 'hex') {
+    return hash(s, 'sha256', outputEncoding);
 }
 exports.sha256 = sha256;
-function sha256AsBase64(s) {
-    return hashAsBuffer(s, 'sha256').toString('base64');
-}
-exports.sha256AsBase64 = sha256AsBase64;
 function sha256AsBuffer(s) {
     return hashAsBuffer(s, 'sha256');
 }
 exports.sha256AsBuffer = sha256AsBuffer;
-function hash(s, algorithm) {
-    return node_crypto_1.default.createHash(algorithm).update(s).digest('hex');
+function hash(s, algorithm, outputEncoding = 'hex') {
+    return node_crypto_1.default.createHash(algorithm).update(s).digest(outputEncoding);
 }
 exports.hash = hash;
 function hashAsBuffer(s, algorithm) {
@@ -39,19 +31,39 @@ function base64(s) {
     return (typeof s === 'string' ? Buffer.from(s) : s).toString('base64');
 }
 exports.base64 = base64;
+function base64Url(s) {
+    return (typeof s === 'string' ? Buffer.from(s) : s).toString('base64url');
+}
+exports.base64Url = base64Url;
 function base64ToString(strBase64) {
     return Buffer.from(strBase64, 'base64').toString('utf8');
 }
 exports.base64ToString = base64ToString;
+function base64UrlToString(strBase64Url) {
+    return Buffer.from(strBase64Url, 'base64url').toString('utf8');
+}
+exports.base64UrlToString = base64UrlToString;
 function base64ToBuffer(strBase64) {
     return Buffer.from(strBase64, 'base64');
 }
 exports.base64ToBuffer = base64ToBuffer;
+function base64UrlToBuffer(strBase64Url) {
+    return Buffer.from(strBase64Url, 'base64url');
+}
+exports.base64UrlToBuffer = base64UrlToBuffer;
 function stringToBase64(s) {
     return Buffer.from(s, 'utf8').toString('base64');
 }
 exports.stringToBase64 = stringToBase64;
+function stringToBase64Url(s) {
+    return Buffer.from(s, 'utf8').toString('base64url');
+}
+exports.stringToBase64Url = stringToBase64Url;
 function bufferToBase64(b) {
     return b.toString('base64');
 }
 exports.bufferToBase64 = bufferToBase64;
+function bufferToBase64Url(b) {
+    return b.toString('base64url');
+}
+exports.bufferToBase64Url = bufferToBase64Url;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/nodejs-lib",
-  "version": "13.2.2",
+  "version": "13.3.0",
   "scripts": {
     "prepare": "husky install",
     "docs-serve": "vuepress dev docs",

package/src/security/hash.util.ts

@@ -1,32 +1,28 @@
-import crypto from 'node:crypto'
-import { Base64String } from '@naturalcycles/js-lib'
+import crypto, { BinaryToTextEncoding } from 'node:crypto'
+import type { Base64String, Base64UrlString } from '@naturalcycles/js-lib'
 
-export function md5(s: string | Buffer): string {
-  return hash(s, 'md5')
-}
-
-export function md5AsBase64(s: string | Buffer): Base64String {
-  return hashAsBuffer(s, 'md5').toString('base64')
+export function md5(s: string | Buffer, outputEncoding: BinaryToTextEncoding = 'hex'): string {
+  return hash(s, 'md5', outputEncoding)
 }
 
 export function md5AsBuffer(s: string | Buffer): Buffer {
   return hashAsBuffer(s, 'md5')
 }
 
-export function sha256(s: string | Buffer): string {
-  return hash(s, 'sha256')
-}
-
-export function sha256AsBase64(s: string | Buffer): Base64String {
-  return hashAsBuffer(s, 'sha256').toString('base64')
+export function sha256(s: string | Buffer, outputEncoding: BinaryToTextEncoding = 'hex'): string {
+  return hash(s, 'sha256', outputEncoding)
 }
 
 export function sha256AsBuffer(s: string | Buffer): Buffer {
   return hashAsBuffer(s, 'sha256')
 }
 
-export function hash(s: string | Buffer, algorithm: string): string {
-  return crypto.createHash(algorithm).update(s).digest('hex')
+export function hash(
+  s: string | Buffer,
+  algorithm: string,
+  outputEncoding: BinaryToTextEncoding = 'hex',
+): string {
+  return crypto.createHash(algorithm).update(s).digest(outputEncoding)
 }
 
 export function hashAsBuffer(s: string | Buffer, algorithm: string): Buffer {
@@ -37,18 +33,38 @@ export function base64(s: string | Buffer): Base64String {
   return (typeof s === 'string' ? Buffer.from(s) : s).toString('base64')
 }
 
+export function base64Url(s: string | Buffer): Base64UrlString {
+  return (typeof s === 'string' ? Buffer.from(s) : s).toString('base64url')
+}
+
 export function base64ToString(strBase64: Base64String): string {
   return Buffer.from(strBase64, 'base64').toString('utf8')
 }
 
-export function base64ToBuffer(strBase64: string): Buffer {
+export function base64UrlToString(strBase64Url: Base64UrlString): string {
+  return Buffer.from(strBase64Url, 'base64url').toString('utf8')
+}
+
+export function base64ToBuffer(strBase64: Base64String): Buffer {
   return Buffer.from(strBase64, 'base64')
 }
 
+export function base64UrlToBuffer(strBase64Url: Base64UrlString): Buffer {
+  return Buffer.from(strBase64Url, 'base64url')
+}
+
 export function stringToBase64(s: string): Base64String {
   return Buffer.from(s, 'utf8').toString('base64')
 }
 
+export function stringToBase64Url(s: string): Base64UrlString {
+  return Buffer.from(s, 'utf8').toString('base64url')
+}
+
 export function bufferToBase64(b: Buffer): Base64String {
   return b.toString('base64')
 }
+
+export function bufferToBase64Url(b: Buffer): Base64UrlString {
+  return b.toString('base64url')
+}