@knsdev/node-utils 3.2.0 → 3.3.0

package/README.md

@@ -1,6 +1,6 @@
 # @knsdev/node-utils
 
-TypeScript utilities for Node.js APIs: JWT (HS256), bcrypt passwords, Express cookies and small Express helpers, OAuth (Google / Facebook), Cloudflare Turnstile, HMAC, validation helpers, Zod schemas, pagination/sleep helpers, and math/random utilities. Published as **ES modules** (`"type": "module"`).
+TypeScript utilities for Node.js APIs: JWT (HS256), access/refresh token pairs with HMAC hashes (`TokenUtils`), bcrypt passwords, Express cookies and small Express helpers, OAuth (Google / Facebook), Cloudflare Turnstile, HMAC, validation helpers, Zod schemas, pagination/sleep helpers, and math/random utilities. Published as **ES modules** (`"type": "module"`).
 
 ## Requirements
 
@@ -97,6 +97,53 @@ if (signResult.error) {
 }
 ```
 
+### `TokenUtils`
+
+Higher-level helpers on top of [`JwtUtils`](#jwtutils) and [`HMACUtils`](#hmacutils): issue an access JWT plus a **64-character Base58** refresh token, derive **HMAC-SHA256 hashes** of both for opaque storage, decode access tokens (tuple or throwing), and validate refresh token shape/length.
+
+```ts
+import { TokenUtils } from "@knsdev/node-utils/TokenUtils.js";
+
+type Session = { sub: string; role: string };
+
+const issued = TokenUtils.genTokens<Session>(
+  process.env.JWT_SECRET!,
+  { sub: "user-1", role: "user" },
+  15 * 60 * 1000,
+);
+if (issued.error) {
+  /* InternalServerError with JWT__ENCRYPTION_FAILED */
+} else {
+  const { accessToken, refreshToken, accessTokenHash, refreshTokenHash } =
+    issued.data;
+}
+
+const access = TokenUtils.genAccessToken<Session>(
+  process.env.JWT_SECRET!,
+  payload,
+  3600_000,
+);
+
+const decoded = TokenUtils.decodeAccessToken<Session>(
+  process.env.JWT_SECRET!,
+  accessToken,
+);
+if (decoded.error) {
+  /* InternalServerError with JWT__INVALID_OR_EXPIRED */
+}
+
+const user = TokenUtils.decodeAccessTokenOrThrow<Session>(
+  process.env.JWT_SECRET!,
+  accessToken,
+);
+
+const REFRESH_LEN = 64;
+if (TokenUtils.validateRefreshToken(token, REFRESH_LEN)) {
+  /* token narrowed to string */
+}
+TokenUtils.validateRefreshTokenOrThrow(token, REFRESH_LEN); // throws BadRequest REFRESH_TOKEN__INVALID_OR_EXPIRED
+```
+
 ### `PasswordUtils`
 
 Bcrypt hash/compare and simple length checks.
@@ -264,7 +311,7 @@ const x = toNumber(unknownValue, 0);
 
 ### `HttpCodes` / `ErrorClasses` / `ECApiCodes`
 
-HTTP status constants and errors for APIs: `ApiError` plus `BadRequest`, `Unauthorized`, `Forbidden`, `NotFound`, `TooManyRequests`, `InternalServerError`. Messages use the `ECApiCodes` string union (machine-friendly codes for clients).
+HTTP status constants and errors for APIs: `ApiError` plus `BadRequest`, `Unauthorized`, `Forbidden`, `NotFound`, `TooManyRequests`, `InternalServerError`. Error `message` values use the `ECApiCodes` string union—machine-readable codes for clients (including auth/JWT/refresh, captcha, password and field validation, slug/username/profile fields, and simple success-style API codes such as `FETCHED` or `CREATED`).
 
 ```ts
 import { HttpCodes } from "@knsdev/node-utils/HttpCodes.js";
@@ -362,7 +409,7 @@ Bengali digit substitution and English month → Bengali month names.
 ```ts
 import { bnNum, monthToBn } from "@knsdev/node-utils/bnUtils.js";
 
-bnNum(2025); // Bengali digits for "2025"
+bnNum(2026); // Bengali digits for "2026"
 monthToBn("january");
 monthToBn(3);
 ```
@@ -397,12 +444,12 @@ const LoginBody = z.object({
 
 ## Dependencies (summary)
 
-| Area            | Packages                       |
-| --------------- | ------------------------------ |
-| JWT             | `jsonwebtoken`                 |
-| Google ID token | `jose`                         |
-| Passwords       | `bcrypt`                       |
-| Schemas         | `zod`                          |
+| Area                      | Packages                       |
+| ------------------------- | ------------------------------ |
+| JWT                       | `jsonwebtoken`                 |
+| Google ID token           | `jose`                         |
+| Passwords                 | `bcrypt`                       |
+| Schemas                   | `zod`                          |
 | Cookies + Express helpers | `express` (types / `Response`) |
 
 ---

package/dist/ECApiCodes.d.ts

@@ -1,2 +1,2 @@
-export type ECApiCodes = `API_ERROR` | `CREATED` | `UPDATED` | `DELETED` | `FETCHED` | `VALIDATED` | `AUTHENTICATED` | `SUCCESS` | `BAD_REQUEST` | `AUTHORIZED` | `UNAUTHORIZED` | `FORBIDDEN` | `NOT_FOUND` | `INVALID_PASSWORD_OR_USER_NOT_FOUND` | `INTERNAL_SERVER_ERROR` | `TOO_MANY_REQUESTS` | `JWT__ENCRYPTION_FAILED` | `JWT__INVALID_OR_EXPIRED` | `CAPTCHA__VALIDATION_FAILED` | `PASSWORD__INVALID` | `PASSWORD__MIN_LENGTH` | `PASSWORD__MAX_LENGTH` | `GENERAL_TOKEN__INVALID` | `GENERAL_TOKEN__LENGTH` | `CODE_6_DIGITS__INVALID` | `CODE_6_DIGITS__LENGTH` | `CODE_6_DIGITS__INVALID_FORMAT` | `EMAIL__INVALID` | `EMAIL__MIN_LENGTH` | `EMAIL__MAX_LENGTH` | `FIRST_NAME__INVALID` | `FIRST_NAME__MIN_LENGTH` | `FIRST_NAME__MAX_LENGTH` | `LAST_NAME__INVALID` | `LAST_NAME__MAX_LENGTH` | `TURNSTILE_TOKEN__INVALID` | `TURNSTILE_TOKEN__MIN_LENGTH` | `TURNSTILE_TOKEN__MAX_LENGTH` | `CONFIRM_PASSWORD__DONT_MATCH` | `LOGOUT_OTHER_SESSIONS__INVALID` | `REMEMBER_ME__INVALID` | `SLUG__MIN_LENGTH` | `SLUG__MAX_LENGTH` | `SLUG__NAME__MIN_LENGTH` | `SLUG__NAME__MAX_LENGTH` | `SLUG__DESCRIPTION__MIN_LENGTH` | `SLUG__DESCRIPTION__MAX_LENGTH` | `SLUG__INVALID` | `USERNAME__INVALID` | `USERNAME__MIN_LENGTH` | `USERNAME__MAX_LENGTH` | `DESIGNATION__INVALID` | `DESIGNATION_MAX_LENGTH` | `BIO__INVALID` | `BIO_MAX_LENGTH` | `PROFILE_VISIBILITY__INVALID` | `ID__INVALID`;
+export type ECApiCodes = `API_ERROR` | `CREATED` | `UPDATED` | `DELETED` | `FETCHED` | `VALIDATED` | `AUTHENTICATED` | `SUCCESS` | `BAD_REQUEST` | `AUTHORIZED` | `UNAUTHORIZED` | `FORBIDDEN` | `NOT_FOUND` | `INVALID_PASSWORD_OR_USER_NOT_FOUND` | `REFRESH_TOKEN__INVALID` | `REFRESH_TOKEN__EXPIRED` | `REFRESH_TOKEN__INVALID_OR_EXPIRED` | `INTERNAL_SERVER_ERROR` | `TOO_MANY_REQUESTS` | `JWT__ENCRYPTION_FAILED` | `JWT__INVALID_OR_EXPIRED` | `CAPTCHA__VALIDATION_FAILED` | `PASSWORD__INVALID` | `PASSWORD__MIN_LENGTH` | `PASSWORD__MAX_LENGTH` | `GENERAL_TOKEN__INVALID` | `GENERAL_TOKEN__LENGTH` | `CODE_6_DIGITS__INVALID` | `CODE_6_DIGITS__LENGTH` | `CODE_6_DIGITS__INVALID_FORMAT` | `EMAIL__INVALID` | `EMAIL__MIN_LENGTH` | `EMAIL__MAX_LENGTH` | `FIRST_NAME__INVALID` | `FIRST_NAME__MIN_LENGTH` | `FIRST_NAME__MAX_LENGTH` | `LAST_NAME__INVALID` | `LAST_NAME__MAX_LENGTH` | `TURNSTILE_TOKEN__INVALID` | `TURNSTILE_TOKEN__MIN_LENGTH` | `TURNSTILE_TOKEN__MAX_LENGTH` | `CONFIRM_PASSWORD__DONT_MATCH` | `LOGOUT_OTHER_SESSIONS__INVALID` | `REMEMBER_ME__INVALID` | `SLUG__MIN_LENGTH` | `SLUG__MAX_LENGTH` | `SLUG__NAME__MIN_LENGTH` | `SLUG__NAME__MAX_LENGTH` | `SLUG__DESCRIPTION__MIN_LENGTH` | `SLUG__DESCRIPTION__MAX_LENGTH` | `SLUG__INVALID` | `USERNAME__INVALID` | `USERNAME__MIN_LENGTH` | `USERNAME__MAX_LENGTH` | `DESIGNATION__INVALID` | `DESIGNATION_MAX_LENGTH` | `BIO__INVALID` | `BIO_MAX_LENGTH` | `PROFILE_VISIBILITY__INVALID` | `ID__INVALID`;
 //# sourceMappingURL=ECApiCodes.d.ts.map

package/dist/ECApiCodes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ECApiCodes.d.ts","sourceRoot":"","sources":["../src/ECApiCodes.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,WAAW,GACnC,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,WAAW,GACX,eAAe,GACf,SAAS,GACT,aAAa,GACb,YAAY,GACZ,cAAc,GACd,WAAW,GACX,WAAW,GACX,oCAAoC,GACpC,uBAAuB,GACvB,mBAAmB,GACnB,wBAAwB,GACxB,yBAAyB,GACzB,4BAA4B,GAC5B,mBAAmB,GACnB,sBAAsB,GACtB,sBAAsB,GACtB,wBAAwB,GACxB,uBAAuB,GACvB,wBAAwB,GACxB,uBAAuB,GACvB,+BAA+B,GAC/B,gBAAgB,GAChB,mBAAmB,GACnB,mBAAmB,GACnB,qBAAqB,GACrB,wBAAwB,GACxB,wBAAwB,GACxB,oBAAoB,GACpB,uBAAuB,GACvB,0BAA0B,GAC1B,6BAA6B,GAC7B,6BAA6B,GAC7B,8BAA8B,GAC9B,gCAAgC,GAChC,sBAAsB,GACtB,kBAAkB,GAClB,kBAAkB,GAClB,wBAAwB,GACxB,wBAAwB,GACxB,+BAA+B,GAC/B,+BAA+B,GAC/B,eAAe,GACf,mBAAmB,GACnB,sBAAsB,GACtB,sBAAsB,GACtB,sBAAsB,GACtB,wBAAwB,GACxB,cAAc,GACd,gBAAgB,GAChB,6BAA6B,GAC7B,aAAa,CAAC"}
+{"version":3,"file":"ECApiCodes.d.ts","sourceRoot":"","sources":["../src/ECApiCodes.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,WAAW,GACnC,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,WAAW,GACX,eAAe,GACf,SAAS,GACT,aAAa,GACb,YAAY,GACZ,cAAc,GACd,WAAW,GACX,WAAW,GACX,oCAAoC,GACpC,wBAAwB,GACxB,wBAAwB,GACxB,mCAAmC,GACnC,uBAAuB,GACvB,mBAAmB,GACnB,wBAAwB,GACxB,yBAAyB,GACzB,4BAA4B,GAC5B,mBAAmB,GACnB,sBAAsB,GACtB,sBAAsB,GACtB,wBAAwB,GACxB,uBAAuB,GACvB,wBAAwB,GACxB,uBAAuB,GACvB,+BAA+B,GAC/B,gBAAgB,GAChB,mBAAmB,GACnB,mBAAmB,GACnB,qBAAqB,GACrB,wBAAwB,GACxB,wBAAwB,GACxB,oBAAoB,GACpB,uBAAuB,GACvB,0BAA0B,GAC1B,6BAA6B,GAC7B,6BAA6B,GAC7B,8BAA8B,GAC9B,gCAAgC,GAChC,sBAAsB,GACtB,kBAAkB,GAClB,kBAAkB,GAClB,wBAAwB,GACxB,wBAAwB,GACxB,+BAA+B,GAC/B,+BAA+B,GAC/B,eAAe,GACf,mBAAmB,GACnB,sBAAsB,GACtB,sBAAsB,GACtB,sBAAsB,GACtB,wBAAwB,GACxB,cAAc,GACd,gBAAgB,GAChB,6BAA6B,GAC7B,aAAa,CAAC"}

package/dist/TokenUtils.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Token utilities for use across projects.
+ * Import via: `@knsdev/node-utils/TokenUtils`
+ */
+declare class tokenUtils {
+    private readonly BASE58_CHARS;
+    private readonly base;
+    readonly genAccessToken: <T extends string | object | Buffer<ArrayBufferLike> = "Error: a type template is required">(jwtSecret: string, data: T, expiresMs: number) => string;
+    readonly genTokens: <T extends string | object | Buffer<ArrayBufferLike> = "Error: a type template is required">(jwtSecret: string, data: T, expiresMs: number) => {
+        data: {
+            accessToken: string;
+            refreshToken: string;
+            accessTokenHash: string;
+            refreshTokenHash: string;
+        };
+        error: null;
+    } | {
+        data: null;
+        error: Error;
+    };
+    /**
+     * Decode an access token and return the user data.
+     * @param jwtSecret - The JWT secret.
+     * @param accessToken - The access token to decode.
+     * @returns The user data.
+     * @throws {InternalServerError} If the access token is invalid or expired.
+     */
+    readonly decodeAccessToken: <T extends string | object | Buffer<ArrayBufferLike> = "Error: a type template is required">(jwtSecret: string, accessToken: unknown) => {
+        data: T;
+        error: null;
+    } | {
+        data: null;
+        error: Error;
+    };
+    /**
+     * Decode an access token and return the user data.
+     * @param jwtSecret - The JWT secret.
+     * @param accessToken - The access token to decode.
+     * @returns The user data.
+     * @throws {InternalServerError} If the access token is invalid or expired.
+     */
+    readonly decodeAccessTokenOrThrow: <T extends string | object | Buffer<ArrayBufferLike> = "Error: a type template is required">(jwtSecret: string, accessToken: unknown) => T;
+    /**
+     * Generate a refresh token.
+     * @returns The refresh token.
+     */
+    private readonly genRefreshToken;
+    /**
+     * Validate a refresh token
+     * @param refreshToken - The refresh token to validate.
+     * @param length - The length of the refresh token.
+     * @returns True if the refresh token is valid, false otherwise.
+     */
+    readonly validateRefreshToken: (refreshToken: unknown, length: number) => refreshToken is string;
+    /**
+     * Validate a refresh token and throw an error if it is invalid or expired.
+     * @param refreshToken - The refresh token to validate.
+     * @param length - The length of the refresh token.
+     * @returns True if the refresh token is valid, false otherwise.
+     * @throws {BadRequest} If the refresh token is invalid or expired.
+     */
+    readonly validateRefreshTokenOrThrow: (refreshToken: unknown, length: number) => string;
+}
+/**
+ * Token utilities for use across projects.
+ * Import via: `@knsdev/node-utils/TokenUtils`
+ */
+export declare const TokenUtils: tokenUtils;
+export {};
+//# sourceMappingURL=TokenUtils.d.ts.map

package/dist/TokenUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenUtils.d.ts","sourceRoot":"","sources":["../src/TokenUtils.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,cAAM,UAAU;IACf,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgE;IAC7F,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA4B;IAGjD,QAAQ,CAAC,cAAc,GAAI,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,GAAG,oCAAoC,EACpH,WAAW,MAAM,EACjB,MAAM,CAAC,EACP,WAAW,MAAM,KACf,MAAM,CAGR;IAED,QAAQ,CAAC,SAAS,GAAI,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,GAAG,oCAAoC,EAC/G,WAAW,MAAM,EACjB,MAAM,CAAC,EACP,WAAW,MAAM,KACf;QACF,IAAI,EAAE;YAAE,WAAW,EAAE,MAAM,CAAC;YAAC,YAAY,EAAE,MAAM,CAAC;YAAC,eAAe,EAAE,MAAM,CAAC;YAAC,gBAAgB,EAAE,MAAM,CAAA;SAAE,CAAC;QACvG,KAAK,EAAE,IAAI,CAAA;KACX,GAAG;QACH,IAAI,EAAE,IAAI,CAAC;QACX,KAAK,EAAE,KAAK,CAAA;KACZ,CAWA;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,iBAAiB,GAAI,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,GAAG,oCAAoC,EAAE,WAAW,MAAM,EAAE,aAAa,OAAO,KAAG;QACnK,IAAI,EAAE,CAAC,CAAC;QACR,KAAK,EAAE,IAAI,CAAA;KACX,GAAG;QACH,IAAI,EAAE,IAAI,CAAC;QACX,KAAK,EAAE,KAAK,CAAA;KACZ,CAOA;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,wBAAwB,GAAI,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,GAAG,oCAAoC,EAAE,WAAW,MAAM,EAAE,aAAa,OAAO,KAAG,CAAC,CAE3K;IAED;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe,CAc/B;IAED;;;;;OAKG;IACH,QAAQ,CAAC,oBAAoB,GAAI,cAAc,OAAO,EAAE,QAAQ,MAAM,KAAG,YAAY,IAAI,MAAM,CAU9F;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,2BAA2B,GAAI,cAAc,OAAO,EAAE,QAAQ,MAAM,KAAG,MAAM,CAKrF;CAED;AAED;;;GAGG;AACH,eAAO,MAAM,UAAU,YAAmB,CAAC"}

package/dist/TokenUtils.js

@@ -0,0 +1,108 @@
+import crypto from "crypto";
+import { HMACUtils } from "./HMACUtils.js";
+import { BadRequest, InternalServerError } from "./ErrorClasses.js";
+import { JwtUtils } from "./JwtUtils.js";
+/**
+ * Token utilities for use across projects.
+ * Import via: `@knsdev/node-utils/TokenUtils`
+ */
+class tokenUtils {
+    BASE58_CHARS = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
+    base = this.BASE58_CHARS.length;
+    genAccessToken = (jwtSecret, data, expiresMs) => {
+        const nowSec = Math.floor(Date.now() / 1000);
+        return JwtUtils.signOrThrow(jwtSecret, data, expiresMs);
+    };
+    genTokens = (jwtSecret, data, expiresMs) => {
+        try {
+            const accessToken = this.genAccessToken(jwtSecret, data, expiresMs);
+            const refreshToken = this.genRefreshToken();
+            const accessTokenHash = HMACUtils.hashOrThrow(jwtSecret, accessToken);
+            const refreshTokenHash = HMACUtils.hashOrThrow(jwtSecret, refreshToken);
+            return { data: { accessToken, refreshToken, accessTokenHash, refreshTokenHash }, error: null };
+        }
+        catch {
+            return { data: null, error: new InternalServerError('JWT__ENCRYPTION_FAILED') };
+        }
+    };
+    /**
+     * Decode an access token and return the user data.
+     * @param jwtSecret - The JWT secret.
+     * @param accessToken - The access token to decode.
+     * @returns The user data.
+     * @throws {InternalServerError} If the access token is invalid or expired.
+     */
+    decodeAccessToken = (jwtSecret, accessToken) => {
+        try {
+            return { data: this.decodeAccessTokenOrThrow(jwtSecret, accessToken), error: null };
+        }
+        catch {
+            return { data: null, error: new InternalServerError('JWT__INVALID_OR_EXPIRED') };
+        }
+    };
+    /**
+     * Decode an access token and return the user data.
+     * @param jwtSecret - The JWT secret.
+     * @param accessToken - The access token to decode.
+     * @returns The user data.
+     * @throws {InternalServerError} If the access token is invalid or expired.
+     */
+    decodeAccessTokenOrThrow = (jwtSecret, accessToken) => {
+        return JwtUtils.verifyOrThrow(jwtSecret, accessToken);
+    };
+    /**
+     * Generate a refresh token.
+     * @returns The refresh token.
+     */
+    genRefreshToken = () => {
+        const REFRESH_TOKEN_LENGTH = 64;
+        const max = 256 - (256 % this.base); // avoid modulo bias (252)
+        let out = '';
+        while (out.length < REFRESH_TOKEN_LENGTH) {
+            const buf = crypto.randomBytes(32);
+            for (let i = 0; i < buf.length && out.length < REFRESH_TOKEN_LENGTH; i++) {
+                const v = buf[i];
+                if (v >= max)
+                    continue;
+                out += this.BASE58_CHARS[v % this.base];
+            }
+        }
+        return out;
+    };
+    /**
+     * Validate a refresh token
+     * @param refreshToken - The refresh token to validate.
+     * @param length - The length of the refresh token.
+     * @returns True if the refresh token is valid, false otherwise.
+     */
+    validateRefreshToken = (refreshToken, length) => {
+        if (typeof refreshToken !== 'string' || refreshToken.length !== length) {
+            return false;
+        }
+        for (let i = 0; i < refreshToken.length; i++) {
+            if (!this.BASE58_CHARS.includes(refreshToken[i])) {
+                return false;
+            }
+        }
+        return true;
+    };
+    /**
+     * Validate a refresh token and throw an error if it is invalid or expired.
+     * @param refreshToken - The refresh token to validate.
+     * @param length - The length of the refresh token.
+     * @returns True if the refresh token is valid, false otherwise.
+     * @throws {BadRequest} If the refresh token is invalid or expired.
+     */
+    validateRefreshTokenOrThrow = (refreshToken, length) => {
+        if (!this.validateRefreshToken(refreshToken, length)) {
+            throw new BadRequest('REFRESH_TOKEN__INVALID_OR_EXPIRED');
+        }
+        return refreshToken;
+    };
+}
+/**
+ * Token utilities for use across projects.
+ * Import via: `@knsdev/node-utils/TokenUtils`
+ */
+export const TokenUtils = new tokenUtils();
+//# sourceMappingURL=TokenUtils.js.map

package/dist/TokenUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenUtils.js","sourceRoot":"","sources":["../src/TokenUtils.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@knsdev/node-utils",
-	"version": "3.2.0",
+	"version": "3.3.0",
 	"description": "",
 	"exports": {
 		"./*": {