nodejs-pkce 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export type PkceCodeChallengeMethodType = "plain" | "S256";
+export type PkcePairType = {
+    codeVerifier: string;
+    codeChallenge: string;
+    codeChallengeMethod: PkceCodeChallengeMethodType;
+};
+export declare function generateRandomString(length?: number): Promise<string>;
+export declare function getCryptoInstance(): Promise<Crypto>;
+export declare function generatePkcePair(length?: number, method?: PkceCodeChallengeMethodType): Promise<PkcePairType>;
+export declare function generatePkceCodeVerifier(length?: number): Promise<string>;
+export declare function generatePkceCodeChallenge(codeVerifier: string, method: PkceCodeChallengeMethodType): Promise<string>;
+export declare function verifyPkceCode(codeVerifier: string, codeChallenge: string, method?: PkceCodeChallengeMethodType): Promise<boolean>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,2BAA2B,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3D,MAAM,MAAM,YAAY,GAAG;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,2BAA2B,CAAC;CAClD,CAAC;AAEF,wBAAsB,oBAAoB,CACxC,MAAM,GAAE,MAAW,GAClB,OAAO,CAAC,MAAM,CAAC,CAajB;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAMzD;AAED,wBAAsB,gBAAgB,CACpC,MAAM,GAAE,MAAW,EACnB,MAAM,GAAE,2BAAoC,GAC3C,OAAO,CAAC,YAAY,CAAC,CAKvB;AAED,wBAAsB,wBAAwB,CAC5C,MAAM,GAAE,MAAW,GAClB,OAAO,CAAC,MAAM,CAAC,CAKjB;AAED,wBAAsB,yBAAyB,CAC7C,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,2BAA2B,GAClC,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAED,wBAAsB,cAAc,CAClC,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,MAAM,GAAE,2BAAoC,GAC3C,OAAO,CAAC,OAAO,CAAC,CAIlB"}

package/dist/index.js

@@ -0,0 +1,48 @@
+import { webcrypto } from "node:crypto";
+export async function generateRandomString(length = 43) {
+    const crypto = await getCryptoInstance();
+    const characters = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-._~";
+    let result = "";
+    const randomValues = crypto.getRandomValues(new Uint8Array(length));
+    for (const value of randomValues) {
+        result += characters[value % characters.length];
+    }
+    return result;
+}
+export async function getCryptoInstance() {
+    if (typeof globalThis.crypto !== "undefined") {
+        return globalThis.crypto;
+    }
+    return webcrypto;
+}
+export async function generatePkcePair(length = 43, method = "S256") {
+    const codeVerifier = await generatePkceCodeVerifier(length);
+    const codeChallenge = await generatePkceCodeChallenge(codeVerifier, method);
+    return { codeVerifier, codeChallenge, codeChallengeMethod: method };
+}
+export async function generatePkceCodeVerifier(length = 43) {
+    if (length < 43 || length > 128) {
+        throw new Error("PKCE code_verifier length must be between 43 and 128");
+    }
+    return await generateRandomString(length);
+}
+export async function generatePkceCodeChallenge(codeVerifier, method) {
+    if (method === "plain") {
+        return codeVerifier;
+    }
+    if (method !== "S256") {
+        throw new Error(`PKCE Only support plain or S256 method !`);
+    }
+    const crypto = await getCryptoInstance();
+    const buffer = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(codeVerifier));
+    const bytes = buffer instanceof Uint8Array ? buffer : new Uint8Array(buffer);
+    return btoa(String.fromCharCode(...bytes))
+        .replace(/\+/g, "-")
+        .replace(/\//g, "_")
+        .replace(/=/g, "");
+}
+export async function verifyPkceCode(codeVerifier, codeChallenge, method = "S256") {
+    const compare = await generatePkceCodeChallenge(codeVerifier, method);
+    return codeChallenge === compare;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAUxC,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,SAAiB,EAAE;IAEnB,MAAM,MAAM,GAAG,MAAM,iBAAiB,EAAE,CAAC;IACzC,MAAM,UAAU,GACd,oEAAoE,CAAC;IAEvE,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,MAAM,YAAY,GAAG,MAAM,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAEpE,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;QACjC,MAAM,IAAI,UAAU,CAAC,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,IAAI,OAAO,UAAU,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QAC7C,OAAO,UAAU,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,OAAO,SAAmB,CAAC;AAC7B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,SAAiB,EAAE,EACnB,SAAsC,MAAM;IAE5C,MAAM,YAAY,GAAG,MAAM,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAC5D,MAAM,aAAa,GAAG,MAAM,yBAAyB,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAE5E,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,EAAE,CAAC;AACtE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,SAAiB,EAAE;IAEnB,IAAI,MAAM,GAAG,EAAE,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,MAAM,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,YAAoB,EACpB,MAAmC;IAEnC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QACvB,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,iBAAiB,EAAE,CAAC;IACzC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CACvC,SAAS,EACT,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CACvC,CAAC;IACF,MAAM,KAAK,GAAG,MAAM,YAAY,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IAE7E,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC,CAAC;SACvC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,YAAoB,EACpB,aAAqB,EACrB,SAAsC,MAAM;IAE5C,MAAM,OAAO,GAAG,MAAM,yBAAyB,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAEtE,OAAO,aAAa,KAAK,OAAO,CAAC;AACnC,CAAC"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "nodejs-pkce",
+  "version": "1.0.0",
+  "description": "PKCE Code Challenge Generator for Node.js Application",
+  "keywords": [
+    "pkce",
+    "oauth2",
+    "oidc",
+    "nodejs"
+  ],
+  "homepage": "https://github.com/dheanka10px/nodejs-pkce#readme",
+  "bugs": {
+    "url": "https://github.com/dheanka10px/nodejs-pkce/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dheanka10px/nodejs-pkce.git"
+  },
+  "license": "MIT",
+  "author": "dheanka10px",
+  "type": "module",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "format": "npx prettier ./src --write",
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "lint": "npx eslint ./src",
+    "prepublishOnly": "npm run build"
+  },
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^25.3.5",
+    "eslint": "^10.0.3",
+    "eslint-config-xo": "^0.50.0",
+    "globals": "^17.4.0",
+    "prettier": "3.8.1",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.56.1"
+  },
+  "files": [
+    "dist"
+  ]
+}