Feat/generic signer verifier (nearform#529)

* chore: fake timer

* feat: generic signer verifier

Author: ilteoood

src/index.d.ts

@@ -77,13 +77,13 @@ type KeyFetcher =
 
 type SignerPayload = Bufferable | Record<string, any>
 
-declare function SignerSync(payload: SignerPayload): string
-declare function SignerAsync(payload: SignerPayload): Promise<string>
-declare function SignerAsync(payload: SignerPayload, cb: SignerCallback): void
+declare function SignerSync<T = SignerPayload>(payload: T): string
+declare function SignerAsync<T = SignerPayload>(payload: T): Promise<string>
+declare function SignerAsync<T = SignerPayload>(payload: T, cb: SignerCallback): void
 
-declare function VerifierSync(token: Bufferable): any
-declare function VerifierAsync(token: Bufferable): Promise<any>
-declare function VerifierAsync(token: Bufferable, cb: VerifierCallback): void
+declare function VerifierSync<T = Bufferable>(token: T): any
+declare function VerifierAsync<T = Bufferable>(token: T): Promise<any>
+declare function VerifierAsync<T = Bufferable>(token: T, cb: VerifierCallback): void
 
 export interface JwtHeader extends Record<string, any> {
   alg: string | Algorithm
@@ -147,10 +147,10 @@ export interface PrivateKey {
   passphrase: string | undefined
 }
 
-export function createSigner(
+export function createSigner<T = SignerPayload>(
   options?: Partial<SignerOptions & { key: Bufferable | PrivateKey }>
-): typeof SignerSync
-export function createSigner(options?: Partial<SignerOptions & { key: KeyFetcher }>): typeof SignerAsync
+): typeof SignerSync<T>
+export function createSigner<T = SignerPayload>(options?: Partial<SignerOptions & { key: KeyFetcher }>): typeof SignerAsync<T>
 export function createDecoder(options?: Partial<DecoderOptions>): (token: Bufferable) => any
-export function createVerifier(options?: Partial<VerifierOptions & { key: Bufferable }>): typeof VerifierSync
-export function createVerifier(options?: Partial<VerifierOptions & { key: KeyFetcher }>): typeof VerifierAsync
+export function createVerifier<T = Bufferable>(options?: Partial<VerifierOptions & { key: Bufferable }>): typeof VerifierSync<T>
+export function createVerifier<T = Bufferable>(options?: Partial<VerifierOptions & { key: KeyFetcher }>): typeof VerifierAsync<T>

test/types.spec.ts

@@ -1,6 +1,7 @@
 /* eslint-disable @typescript-eslint/no-unused-expressions */
 /* eslint-disable @typescript-eslint/no-unused-vars */
 
+import { expectAssignable, expectNotAssignable, expectType } from 'tsd'
 import {
   createDecoder,
   createSigner,
@@ -10,7 +11,6 @@ import {
   TokenError,
   TokenValidationErrorCode
 } from '..'
-import { expectAssignable, expectNotAssignable, expectType } from 'tsd'
 
 // Signing
 // Buffer key, both async/callback styles
@@ -44,6 +44,14 @@ createSigner({
   algorithm: 'RS256'
 })
 
+// Generic signer
+const signer = createSigner<Record<string, number>>({
+  expiresIn: '10min',
+  key: Buffer.from('KEY'),
+  algorithm: 'RS256'
+})
+signer({ key: 1 })
+
 // Decoding
 const decoder = createDecoder({ checkTyp: 'true' })
 decoder('FOO')
@@ -77,6 +85,14 @@ createVerifier({
   }
 })('456').then(console.log, console.log)
 
+// Generic verifier
+createVerifier<Record<string, number>>({
+  key: 'KEY',
+  algorithms: ['RS256'],
+  requiredClaims: ['aud'],
+  checkTyp: 'JWT'
+})({ key: 1 }).then(console.log, console.log)
+
 // Errors
 const wrapped = TokenError.wrap(new Error('ORIGINAL'), 'FAST_JWT_INVALID_TYPE', 'MESSAGE')
 wrapped.code === 'FAST_JWT_INVALID_TYPE'