docs: add module tags to all entrypoints

docs/jwe/compact/decrypt/README.md

@@ -1,5 +1,7 @@
 # jwe/compact/decrypt
 
+Decrypting JSON Web Encryption (JWE) in Compact Serialization
+
 ## Index
 
 ### Interfaces

docs/jwe/compact/encrypt/README.md

@@ -1,5 +1,7 @@
 # jwe/compact/encrypt
 
+Encrypting JSON Web Encryption (JWE) in Compact Serialization
+
 ## Index
 
 ### Classes

docs/jwe/flattened/decrypt/README.md

@@ -1,5 +1,7 @@
 # jwe/flattened/decrypt
 
+Decrypting JSON Web Encryption (JWE) in Flattened JSON Serialization
+
 ## Index
 
 ### Interfaces

docs/jwe/flattened/encrypt/README.md

@@ -1,5 +1,7 @@
 # jwe/flattened/encrypt
 
+Encrypting JSON Web Encryption (JWE) in Flattened JSON Serialization
+
 ## Index
 
 ### Classes

docs/jwe/general/decrypt/README.md

@@ -1,5 +1,7 @@
 # jwe/general/decrypt
 
+Decrypting JSON Web Encryption (JWE) in General JSON Serialization
+
 ## Index
 
 ### Interfaces

docs/jwe/general/encrypt/README.md

@@ -1,5 +1,7 @@
 # jwe/general/encrypt
 
+Encrypting JSON Web Encryption (JWE) in General JSON Serialization
+
 ## Index
 
 ### Classes

docs/jwk/embedded/README.md

@@ -1,5 +1,7 @@
 # jwk/embedded
 
+Verification using a JWK Embedded in a JWS Header
+
 ## Index
 
 ### Functions

docs/jwk/thumbprint/README.md

@@ -1,5 +1,7 @@
 # jwk/thumbprint
 
+JSON Web Key Thumbprint and JSON Web Key Thumbprint URI
+
 ## Index
 
 ### Functions

docs/jwks/local/README.md

@@ -1,5 +1,7 @@
 # jwks/local
 
+Verification using a JSON Web Key Set (JWKS) available locally
+
 ## Index
 
 ### Functions

docs/jwks/remote/README.md

@@ -1,5 +1,7 @@
 # jwks/remote
 
+Verification using a JSON Web Key Set (JWKS) available on an HTTP(S) URL
+
 ## Index
 
 ### Functions

docs/jws/compact/sign/README.md

@@ -1,5 +1,7 @@
 # jws/compact/sign
 
+Signing JSON Web Signature (JWS) in Compact Serialization
+
 ## Index
 
 ### Classes

docs/jws/compact/verify/README.md

@@ -1,5 +1,7 @@
 # jws/compact/verify
 
+Verifying JSON Web Signature (JWS) in Compact Serialization
+
 ## Index
 
 ### Interfaces

docs/jws/flattened/sign/README.md

@@ -1,5 +1,7 @@
 # jws/flattened/sign
 
+Signing JSON Web Signature (JWS) in Flattened JSON Serialization
+
 ## Index
 
 ### Classes

docs/jws/flattened/verify/README.md

@@ -1,5 +1,7 @@
 # jws/flattened/verify
 
+Verifying JSON Web Signature (JWS) in Flattened JSON Serialization
+
 ## Index
 
 ### Interfaces

docs/jws/general/sign/README.md

@@ -1,5 +1,7 @@
 # jws/general/sign
 
+Signing JSON Web Signature (JWS) in General JSON Serialization
+
 ## Index
 
 ### Classes

docs/jws/general/verify/README.md

@@ -1,5 +1,7 @@
 # jws/general/verify
 
+Verifying JSON Web Signature (JWS) in General JSON Serialization
+
 ## Index
 
 ### Interfaces

docs/jwt/decrypt/README.md

@@ -1,5 +1,7 @@
 # jwt/decrypt
 
+JSON Web Token (JWT) Decryption (JWT is in JWE format)
+
 ## Index
 
 ### Interfaces

docs/jwt/encrypt/README.md

@@ -1,5 +1,7 @@
 # jwt/encrypt
 
+JSON Web Token (JWT) Encryption (JWT is in JWE format)
+
 ## Index
 
 ### Classes

docs/jwt/sign/README.md

@@ -1,5 +1,7 @@
 # jwt/sign
 
+JSON Web Token (JWT) Signing (JWT is in JWS format)
+
 ## Index
 
 ### Classes

docs/jwt/unsecured/README.md

@@ -1,5 +1,7 @@
 # jwt/unsecured
 
+Unsecured (unsigned & unencrypted) JSON Web Tokens (JWT)
+
 ## Index
 
 ### Classes

docs/jwt/verify/README.md

@@ -1,5 +1,7 @@
 # jwt/verify
 
+JSON Web Token (JWT) Verification (JWT is in JWS format)
+
 ## Index
 
 ### Interfaces

docs/key/export/README.md

@@ -1,5 +1,7 @@
 # key/export
 
+Cryptographic key export functions
+
 ## Index
 
 ### Functions

docs/key/generate_key_pair/README.md

@@ -1,5 +1,7 @@
 # key/generate\_key\_pair
 
+Asymmetric key generation
+
 ## Index
 
 ### Interfaces

docs/key/generate_secret/README.md

@@ -1,5 +1,7 @@
 # key/generate\_secret
 
+Symmetric key generation
+
 ## Index
 
 ### Interfaces

docs/key/import/README.md

@@ -1,5 +1,7 @@
 # key/import
 
+Cryptographic key import functions
+
 ## Index
 
 ### Interfaces

docs/util/base64url/README.md

@@ -1,5 +1,7 @@
 # util/base64url
 
+Base64URL encoding and decoding utilities
+
 ## Index
 
 ### Functions

docs/util/decode_jwt/README.md

@@ -1,5 +1,7 @@
 # util/decode\_jwt
 
+JSON Web Token (JWT) Claims Set Decoding (no validation, no signature checking)
+
 ## Index
 
 ### Functions

docs/util/decode_protected_header/README.md

@@ -1,5 +1,7 @@
 # util/decode\_protected\_header
 
+JOSE Protected Header Decoding (JWE, JWS, all serialization syntaxes)
+
 ## Index
 
 ### Type Aliases

docs/util/errors/README.md

@@ -1,5 +1,7 @@
 # util/errors
 
+JOSE module errors and error codes
+
 ## Index
 
 ### Classes

src/index.ts

@@ -1,3 +1,10 @@
+/**
+ * JWA, JWS, JWE, JWT, JWK, JWKS for Node.js, Browser, Cloudflare Workers, Deno, Bun, and other
+ * Web-interoperable runtimes
+ *
+ * @module jose
+ */
+
 export { compactDecrypt } from './jwe/compact/decrypt.js'
 export type { CompactDecryptGetKey } from './jwe/compact/decrypt.js'
 export { flattenedDecrypt } from './jwe/flattened/decrypt.js'

src/jwe/compact/decrypt.ts

@@ -1,3 +1,9 @@
+/**
+ * Decrypting JSON Web Encryption (JWE) in Compact Serialization
+ *
+ * @module
+ */
+
 import { flattenedDecrypt } from '../flattened/decrypt.js'
 import { JWEInvalid } from '../../util/errors.js'
 import { decoder } from '../../lib/buffer_utils.js'

src/jwe/compact/encrypt.ts

@@ -1,3 +1,9 @@
+/**
+ * Encrypting JSON Web Encryption (JWE) in Compact Serialization
+ *
+ * @module
+ */
+
 import type * as types from '../../types.d.ts'
 import { FlattenedEncrypt } from '../flattened/encrypt.js'
 

src/jwe/flattened/decrypt.ts

@@ -1,3 +1,9 @@
+/**
+ * Decrypting JSON Web Encryption (JWE) in Flattened JSON Serialization
+ *
+ * @module
+ */
+
 import type * as types from '../../types.d.ts'
 import { decode as base64url } from '../../lib/base64url.js'
 import decrypt from '../../lib/decrypt.js'

src/jwe/flattened/encrypt.ts

@@ -1,3 +1,9 @@
+/**
+ * Encrypting JSON Web Encryption (JWE) in Flattened JSON Serialization
+ *
+ * @module
+ */
+
 import { encode as base64url } from '../../lib/base64url.js'
 import { unprotected } from '../../lib/private_symbols.js'
 import encrypt from '../../lib/encrypt.js'

src/jwe/general/decrypt.ts

@@ -1,3 +1,9 @@
+/**
+ * Decrypting JSON Web Encryption (JWE) in General JSON Serialization
+ *
+ * @module
+ */
+
 import { flattenedDecrypt } from '../flattened/decrypt.js'
 import { JWEDecryptionFailed, JWEInvalid } from '../../util/errors.js'
 import type * as types from '../../types.d.ts'

src/jwe/general/encrypt.ts

@@ -1,3 +1,9 @@
+/**
+ * Encrypting JSON Web Encryption (JWE) in General JSON Serialization
+ *
+ * @module
+ */
+
 import type * as types from '../../types.d.ts'
 import { FlattenedEncrypt } from '../flattened/encrypt.js'
 import { unprotected } from '../../lib/private_symbols.js'

src/jwk/embedded.ts

@@ -1,3 +1,9 @@
+/**
+ * Verification using a JWK Embedded in a JWS Header
+ *
+ * @module
+ */
+
 import type * as types from '../types.d.ts'
 import { importJWK } from '../key/import.js'
 import isObject from '../lib/is_object.js'

src/jwk/thumbprint.ts

@@ -1,3 +1,9 @@
+/**
+ * JSON Web Key Thumbprint and JSON Web Key Thumbprint URI
+ *
+ * @module
+ */
+
 import digest from '../lib/digest.js'
 import { encode as base64url } from '../lib/base64url.js'
 

src/jwks/local.ts

@@ -1,3 +1,9 @@
+/**
+ * Verification using a JSON Web Key Set (JWKS) available locally
+ *
+ * @module
+ */
+
 import type * as types from '../types.d.ts'
 import { importJWK } from '../key/import.js'
 import {

src/jwks/remote.ts

@@ -1,3 +1,9 @@
+/**
+ * Verification using a JSON Web Key Set (JWKS) available on an HTTP(S) URL
+ *
+ * @module
+ */
+
 import type * as types from '../types.d.ts'
 import { JOSEError, JWKSNoMatchingKey, JWKSTimeout } from '../util/errors.js'
 

src/jws/compact/sign.ts

@@ -1,3 +1,9 @@
+/**
+ * Signing JSON Web Signature (JWS) in Compact Serialization
+ *
+ * @module
+ */
+
 import type * as types from '../../types.d.ts'
 import { FlattenedSign } from '../flattened/sign.js'
 

src/jws/compact/verify.ts

@@ -1,3 +1,9 @@
+/**
+ * Verifying JSON Web Signature (JWS) in Compact Serialization
+ *
+ * @module
+ */
+
 import type * as types from '../../types.d.ts'
 import { flattenedVerify } from '../flattened/verify.js'
 import { JWSInvalid } from '../../util/errors.js'

src/jws/flattened/sign.ts

@@ -1,3 +1,9 @@
+/**
+ * Signing JSON Web Signature (JWS) in Flattened JSON Serialization
+ *
+ * @module
+ */
+
 import type * as types from '../../types.d.ts'
 import { encode as base64url } from '../../lib/base64url.js'
 import sign from '../../lib/sign.js'

src/jws/flattened/verify.ts

@@ -1,3 +1,9 @@
+/**
+ * Verifying JSON Web Signature (JWS) in Flattened JSON Serialization
+ *
+ * @module
+ */
+
 import type * as types from '../../types.d.ts'
 import { decode as base64url } from '../../lib/base64url.js'
 import verify from '../../lib/verify.js'

src/jws/general/sign.ts

@@ -1,3 +1,9 @@
+/**
+ * Signing JSON Web Signature (JWS) in General JSON Serialization
+ *
+ * @module
+ */
+
 import type * as types from '../../types.d.ts'
 import { FlattenedSign } from '../flattened/sign.js'
 import { JWSInvalid } from '../../util/errors.js'

src/jws/general/verify.ts

@@ -1,3 +1,9 @@
+/**
+ * Verifying JSON Web Signature (JWS) in General JSON Serialization
+ *
+ * @module
+ */
+
 import type * as types from '../../types.d.ts'
 import { flattenedVerify } from '../flattened/verify.js'
 import { JWSInvalid, JWSSignatureVerificationFailed } from '../../util/errors.js'

src/jwt/decrypt.ts

@@ -1,3 +1,9 @@
+/**
+ * JSON Web Token (JWT) Decryption (JWT is in JWE format)
+ *
+ * @module
+ */
+
 import type * as types from '../types.d.ts'
 import { compactDecrypt } from '../jwe/compact/decrypt.js'
 import jwtPayload from '../lib/jwt_claims_set.js'

src/jwt/encrypt.ts

@@ -1,3 +1,9 @@
+/**
+ * JSON Web Token (JWT) Encryption (JWT is in JWE format)
+ *
+ * @module
+ */
+
 import type * as types from '../types.d.ts'
 import { CompactEncrypt } from '../jwe/compact/encrypt.js'
 import { encoder } from '../lib/buffer_utils.js'

src/jwt/sign.ts

@@ -1,3 +1,9 @@
+/**
+ * JSON Web Token (JWT) Signing (JWT is in JWS format)
+ *
+ * @module
+ */
+
 import { CompactSign } from '../jws/compact/sign.js'
 import { JWTInvalid } from '../util/errors.js'
 import type * as types from '../types.d.ts'

src/jwt/unsecured.ts

@@ -1,3 +1,9 @@
+/**
+ * Unsecured (unsigned & unencrypted) JSON Web Tokens (JWT)
+ *
+ * @module
+ */
+
 import * as base64url from '../lib/base64url.js'
 
 import type * as types from '../types.d.ts'

src/jwt/verify.ts

@@ -1,3 +1,9 @@
+/**
+ * JSON Web Token (JWT) Verification (JWT is in JWS format)
+ *
+ * @module
+ */
+
 import { compactVerify } from '../jws/compact/verify.js'
 import type * as types from '../types.d.ts'
 import jwtPayload from '../lib/jwt_claims_set.js'

src/key/export.ts

@@ -1,3 +1,9 @@
+/**
+ * Cryptographic key export functions
+ *
+ * @module
+ */
+
 import { toSPKI as exportPublic, toPKCS8 as exportPrivate } from '../lib/asn1.js'
 import keyToJWK from '../lib/key_to_jwk.js'
 

src/key/generate_key_pair.ts

@@ -1,3 +1,9 @@
+/**
+ * Asymmetric key generation
+ *
+ * @module
+ */
+
 import { JOSENotSupported } from '../util/errors.js'
 
 import type * as types from '../types.d.ts'

src/key/generate_secret.ts

@@ -1,3 +1,9 @@
+/**
+ * Symmetric key generation
+ *
+ * @module
+ */
+
 import { JOSENotSupported } from '../util/errors.js'
 
 import type * as types from '../types.d.ts'

src/key/import.ts

@@ -1,3 +1,9 @@
+/**
+ * Cryptographic key import functions
+ *
+ * @module
+ */
+
 import { decode as decodeBase64URL } from '../lib/base64url.js'
 import { fromSPKI, fromPKCS8, fromX509 } from '../lib/asn1.js'
 import toCryptoKey from '../lib/jwk_to_key.js'

src/util/base64url.ts

@@ -1,3 +1,9 @@
+/**
+ * Base64URL encoding and decoding utilities
+ *
+ * @module
+ */
+
 import * as base64url from '../lib/base64url.js'
 
 /**

src/util/decode_jwt.ts

@@ -1,3 +1,9 @@
+/**
+ * JSON Web Token (JWT) Claims Set Decoding (no validation, no signature checking)
+ *
+ * @module
+ */
+
 import { decode as base64url } from './base64url.js'
 import { decoder } from '../lib/buffer_utils.js'
 import isObject from '../lib/is_object.js'

src/util/decode_protected_header.ts

@@ -1,3 +1,9 @@
+/**
+ * JOSE Protected Header Decoding (JWE, JWS, all serialization syntaxes)
+ *
+ * @module
+ */
+
 import { decode as base64url } from './base64url.js'
 import { decoder } from '../lib/buffer_utils.js'
 import isObject from '../lib/is_object.js'

src/util/errors.ts

@@ -1,3 +1,9 @@
+/**
+ * JOSE module errors and error codes
+ *
+ * @module
+ */
+
 import type * as types from '../types.d.ts'
 
 /**