@tickernelz/paperclip-pro-server 2026.1018.0 → 2026.1022.0

package/node_modules/jose/dist/types/jws/compact/verify.d.ts

@@ -3,22 +3,22 @@ import type * as t from '../../types.d.ts';
 export interface CompactVerifyGetKey<KeyType extends t.CryptoKey | Uint8Array = t.CryptoKey | Uint8Array> extends t.GetKeyFunction<t.CompactJWSHeaderParameters, t.FlattenedJWSInput, KeyType | t.KeyObject | t.JWK> {
 }
 /**
- * Verifies a Compact JWS signature and decodes its payload.
+ * Validates a JWS Compact Serialization (digital signature or MAC) and decodes its JWS Payload.
  *
  * @param key Public key or shared secret. See
  *   {@link https://github.com/panva/jose/issues/210#jws-alg Algorithm Key Requirements}.
  */
 export declare function compactVerify(jws: string | Uint8Array, key: t.KeyInput, options?: t.VerifyOptions): Promise<t.CompactVerifyResult>;
 /**
- * Verifies a Compact JWS signature and decodes its payload with a dynamically resolved key,
- * included in the result.
+ * Validates a JWS Compact Serialization (digital signature or MAC) and decodes its JWS Payload with
+ * a dynamically resolved key, included in the result.
  *
  * @param getKey Resolves a public key or shared secret from unverified token data.
  */
 export declare function compactVerify<KeyType extends t.CryptoKey | Uint8Array = t.CryptoKey | Uint8Array>(jws: string | Uint8Array, getKey: CompactVerifyGetKey<KeyType>, options?: t.VerifyOptions): Promise<t.CompactVerifyResult & t.ResolvedKey<KeyType>>;
 /**
- * Verifies a Compact JWS and decodes its payload using a key or key resolver. The result includes
- * `key` only when a resolver is used.
+ * Validates a JWS Compact Serialization (digital signature or MAC) and decodes its JWS Payload
+ * using a key or key resolver. The result includes `key` only when a resolver is used.
  *
  * @param key Public key or shared secret, or a function resolving one.
  */

package/node_modules/jose/dist/types/jws/flattened/sign.d.ts

@@ -1,11 +1,11 @@
 import type * as t from '../../types.d.ts';
-/** Builds and signs Flattened JWS objects. */
+/** Produces flattened JWS JSON Serialization using a digital signature or MAC. */
 export declare class FlattenedSign {
     #private;
     /**
-     * Creates a Flattened JWS signer.
+     * Creates a signer for flattened JWS JSON Serialization.
      *
-     * @param payload Binary representation of the payload to sign.
+     * @param payload JWS Payload bytes to sign or MAC.
      */
     constructor(payload: Uint8Array);
     /** Sets the JWS Protected Header. May only be called once. */
@@ -13,7 +13,8 @@ export declare class FlattenedSign {
     /** Sets the JWS Unprotected Header. May only be called once. */
     setUnprotectedHeader(unprotectedHeader: t.JWSHeaderParameters): this;
     /**
-     * Signs the payload as a Flattened JWS.
+     * Computes the JWS Signature (digital signature or MAC) and returns the flattened JWS JSON
+     * Serialization.
      *
      * @param key Private key or shared secret. See
      *   {@link https://github.com/panva/jose/issues/210#jws-alg Algorithm Key Requirements}.

package/node_modules/jose/dist/types/jws/flattened/verify.d.ts

@@ -3,22 +3,23 @@ import type * as t from '../../types.d.ts';
 export interface FlattenedVerifyGetKey<KeyType extends t.CryptoKey | Uint8Array = t.CryptoKey | Uint8Array> extends t.GetKeyFunction<t.JWSHeaderParameters, t.FlattenedJWSInput, KeyType | t.KeyObject | t.JWK> {
 }
 /**
- * Verifies a Flattened JWS signature and decodes its payload.
+ * Validates a flattened JWS JSON Serialization (digital signature or MAC) and decodes its JWS
+ * Payload.
  *
  * @param key Public key or shared secret. See
  *   {@link https://github.com/panva/jose/issues/210#jws-alg Algorithm Key Requirements}.
  */
 export declare function flattenedVerify(jws: t.FlattenedJWSInput, key: t.KeyInput, options?: t.VerifyOptions): Promise<t.FlattenedVerifyResult>;
 /**
- * Verifies a Flattened JWS signature and decodes its payload with a dynamically resolved key,
- * included in the result.
+ * Validates a flattened JWS JSON Serialization (digital signature or MAC) and decodes its JWS
+ * Payload with a dynamically resolved key, included in the result.
  *
  * @param getKey Resolves a public key or shared secret from unverified token data.
  */
 export declare function flattenedVerify<KeyType extends t.CryptoKey | Uint8Array = t.CryptoKey | Uint8Array>(jws: t.FlattenedJWSInput, getKey: FlattenedVerifyGetKey<KeyType>, options?: t.VerifyOptions): Promise<t.FlattenedVerifyResult & t.ResolvedKey<KeyType>>;
 /**
- * Verifies a Flattened JWS and decodes its payload using a key or key resolver. The result includes
- * `key` only when a resolver is used.
+ * Validates a flattened JWS JSON Serialization (digital signature or MAC) and decodes its JWS
+ * Payload using a key or key resolver. The result includes `key` only when a resolver is used.
  *
  * @param key Public key or shared secret, or a function resolving one.
  */

package/node_modules/jose/dist/types/jws/general/sign.d.ts

@@ -1,5 +1,5 @@
 import type * as t from '../../types.d.ts';
-/** Configures an individual signature in a General JWS. */
+/** Configures an individual JWS Signature (digital signature or MAC) in a General JWS. */
 export interface Signature {
     /** Sets the JWS Protected Header. May only be called once. */
     setProtectedHeader(protectedHeader: t.JWSHeaderParameters): Signature;
@@ -12,18 +12,18 @@ export interface Signature {
      *   {@link https://github.com/panva/jose/issues/210#jws-alg Algorithm Key Requirements}.
      */
     addSignature(key: t.KeyInput, options?: t.SignOptions): Signature;
-    /** Creates all signatures on the enclosing {@link GeneralSign}, using their configured keys. */
+    /** Computes all JWS Signatures on the enclosing {@link GeneralSign}, using their configured keys. */
     sign(): Promise<t.GeneralJWS>;
     /** Returns the enclosing {@link GeneralSign} instance. */
     done(): GeneralSign;
 }
-/** Builds and signs General JWS objects. */
+/** Produces general JWS JSON Serialization using digital signatures or MACs. */
 export declare class GeneralSign {
     #private;
     /**
-     * Creates a General JWS signer.
+     * Creates a signer for general JWS JSON Serialization.
      *
-     * @param payload Binary representation of the payload to sign.
+     * @param payload JWS Payload bytes to sign or MAC.
      */
     constructor(payload: Uint8Array);
     /**
@@ -33,6 +33,9 @@ export declare class GeneralSign {
      *   {@link https://github.com/panva/jose/issues/210#jws-alg Algorithm Key Requirements}.
      */
     addSignature(key: t.KeyInput, options?: t.SignOptions): Signature;
-    /** Signs the payload as a General JWS. */
+    /**
+     * Computes each JWS Signature (digital signature or MAC) and returns the general JWS JSON
+     * Serialization.
+     */
     sign(): Promise<t.GeneralJWS>;
 }

package/node_modules/jose/dist/types/jws/general/verify.d.ts

@@ -3,7 +3,8 @@ import type * as t from '../../types.d.ts';
 export interface GeneralVerifyGetKey<KeyType extends t.CryptoKey | Uint8Array = t.CryptoKey | Uint8Array> extends t.GetKeyFunction<t.JWSHeaderParameters, t.FlattenedJWSInput, KeyType | t.KeyObject | t.JWK> {
 }
 /**
- * Verifies a General JWS signature and decodes its payload.
+ * Validates a JWS Signature (digital signature or MAC) from a general JWS JSON Serialization and
+ * decodes its JWS Payload.
  *
  * > Note: Returns payload and headers from the first signature that verifies successfully. Other entries'
  * > headers may be inspected to reject inconsistent use of the JWS Unencoded Payload Option, but are
@@ -14,15 +15,16 @@ export interface GeneralVerifyGetKey<KeyType extends t.CryptoKey | Uint8Array =
  */
 export declare function generalVerify(jws: t.GeneralJWSInput, key: t.KeyInput, options?: t.VerifyOptions): Promise<t.GeneralVerifyResult>;
 /**
- * Verifies a General JWS signature and decodes its payload with a dynamically resolved key,
- * included in the result.
+ * Validates a JWS Signature (digital signature or MAC) from a general JWS JSON Serialization and
+ * decodes its JWS Payload with a dynamically resolved key, included in the result.
  *
  * @param getKey Resolves a public key or shared secret from unverified token data.
  */
 export declare function generalVerify<KeyType extends t.CryptoKey | Uint8Array = t.CryptoKey | Uint8Array>(jws: t.GeneralJWSInput, getKey: GeneralVerifyGetKey<KeyType>, options?: t.VerifyOptions): Promise<t.GeneralVerifyResult & t.ResolvedKey<KeyType>>;
 /**
- * Verifies a General JWS and decodes its payload using a key or key resolver. The result includes
- * `key` only when a resolver is used.
+ * Validates a JWS Signature (digital signature or MAC) from a general JWS JSON Serialization and
+ * decodes its JWS Payload using a key or key resolver. The result includes `key` only when a
+ * resolver is used.
  *
  * @param key Public key or shared secret, or a function resolving one.
  */

package/node_modules/jose/dist/types/jwt/decrypt.d.ts

@@ -9,9 +9,9 @@ export interface JWTDecryptOptions extends t.DecryptOptions, t.JWTClaimVerificat
 export interface JWTDecryptGetKey<KeyType extends t.CryptoKey | Uint8Array = t.CryptoKey | Uint8Array> extends t.GetKeyFunction<t.CompactJWEHeaderParameters, t.FlattenedJWE, KeyType | t.KeyObject | t.JWK> {
 }
 /**
- * Decrypts a Compact JWE-formatted JWT and validates its Claims Set.
+ * Authenticates and decrypts a JWT in JWE Compact Serialization and validates its JWT Claims Set.
  *
- * @param key Private key or shared secret to decrypt and verify the JWT with. See
+ * @param key Private key or shared secret to authenticate and decrypt the JWT with. See
  *   {@link https://github.com/panva/jose/issues/210#jwe-alg Algorithm Key Requirements}.
  */
 export declare function jwtDecrypt<PayloadType = t.JWTPayload>(jwt: string | Uint8Array, key: t.KeyInput, options?: JWTDecryptOptions): Promise<t.JWTDecryptResult<PayloadType>>;
@@ -19,16 +19,17 @@ export declare function jwtDecrypt<PayloadType = t.JWTPayload>(jwt: string | Uin
  * Decrypts a JWT and validates its claims, returning the dynamically
  * {@link t.ResolvedKey.key resolved key}.
  *
- * @param getKey Function resolving a private key or shared secret to decrypt and verify the JWT
- *   with. See {@link https://github.com/panva/jose/issues/210#jwe-alg Algorithm Key Requirements}.
+ * @param getKey Function resolving a private key or shared secret to authenticate and decrypt the
+ *   JWT with. See
+ *   {@link https://github.com/panva/jose/issues/210#jwe-alg Algorithm Key Requirements}.
  */
 export declare function jwtDecrypt<PayloadType = t.JWTPayload, KeyType extends t.CryptoKey | Uint8Array = t.CryptoKey | Uint8Array>(jwt: string | Uint8Array, getKey: JWTDecryptGetKey<KeyType>, options?: JWTDecryptOptions): Promise<t.JWTDecryptResult<PayloadType> & t.ResolvedKey<KeyType>>;
 /**
  * Accepts a key or key resolver. Use this overload when forwarding either form; the result includes
  * `key` only when a resolver was used.
  *
- * @param key Private key or shared secret, or a function resolving one, to decrypt and verify the
- *   JWT with. See
+ * @param key Private key or shared secret, or a function resolving one, to authenticate and decrypt
+ *   the JWT with. See
  *   {@link https://github.com/panva/jose/issues/210#jwe-alg Algorithm Key Requirements}.
  */
 export declare function jwtDecrypt<PayloadType = t.JWTPayload>(jwt: string | Uint8Array, key: t.KeyInput | JWTDecryptGetKey, options?: JWTDecryptOptions): Promise<t.JWTDecryptResult<PayloadType> & Partial<t.ResolvedKey>>;

package/node_modules/jose/dist/types/jwt/encrypt.d.ts

@@ -1,7 +1,7 @@
 import type * as t from '../types.d.ts';
 /** @param payload Initial JWT Claims Set. Defaults to an empty object. */
 declare const EncryptJWT_base: new (payload?: t.JWTPayload) => t.ProduceJWT;
-/** Builds and encrypts Compact JWE-formatted JSON Web Tokens. */
+/** Produces encrypted JWTs in JWE Compact Serialization. */
 export declare class EncryptJWT extends EncryptJWT_base {
     #private;
     /**

package/node_modules/jose/dist/types/jwt/sign.d.ts

@@ -1,7 +1,7 @@
 import type * as t from '../types.d.ts';
 /** @param payload Initial JWT Claims Set. Defaults to an empty object. */
 declare const SignJWT_base: new (payload?: t.JWTPayload) => t.ProduceJWT;
-/** Builds and signs Compact JWS-formatted JSON Web Tokens. */
+/** Produces JWTs in JWS Compact Serialization using a digital signature or MAC. */
 export declare class SignJWT extends SignJWT_base {
     #private;
     /**

package/node_modules/jose/dist/types/jwt/unsecured.d.ts

@@ -3,7 +3,7 @@ import type * as t from '../types.d.ts';
 export interface UnsecuredResult<PayloadType = t.JWTPayload> {
     /** JWT Claims Set. */
     payload: PayloadType & t.JWTPayload & ([PayloadType] extends [object] ? unknown : unknown extends PayloadType ? unknown : never);
-    /** The decoded JOSE Header; always `{ "alg": "none" }` for an Unsecured JWT. */
+    /** The decoded JOSE Header; its "alg" (Algorithm) Header Parameter is "none". */
     header: t.JWSHeaderParameters;
 }
 /** @param payload Initial JWT Claims Set. Defaults to an empty object. */

package/node_modules/jose/dist/types/jwt/verify.d.ts

@@ -9,19 +9,18 @@ export interface JWTVerifyOptions extends t.VerifyOptions, t.JWTClaimVerificatio
 export interface JWTVerifyGetKey<KeyType extends t.CryptoKey | Uint8Array = t.CryptoKey | Uint8Array> extends t.GetKeyFunction<t.CompactJWSHeaderParameters, t.FlattenedJWSInput, KeyType | t.KeyObject | t.JWK> {
 }
 /**
- * Verifies a Compact JWS-formatted JWT and validates its Claims Set.
+ * Validates a JWT in JWS Compact Serialization (digital signature or MAC) and its JWT Claims Set.
  *
  * @param key Public key or shared secret to verify the JWT with. See
  *   {@link https://github.com/panva/jose/issues/210#jws-alg Algorithm Key Requirements}.
- * @param options JWT Verification and JWT Claims Set validation options.
  */
 export declare function jwtVerify<PayloadType = t.JWTPayload>(jwt: string | Uint8Array, key: t.KeyInput, options?: JWTVerifyOptions): Promise<t.JWTVerifyResult<PayloadType>>;
 /**
- * Verifies the JWT signature and claims, returning the resolved key.
+ * Validates the JWT's JWS Signature (digital signature or MAC) and JWT Claims Set, returning the
+ * resolved key.
  *
  * @param getKey Function resolving a public key or shared secret to verify the JWT with. See
  *   {@link https://github.com/panva/jose/issues/210#jws-alg Algorithm Key Requirements}.
- * @param options JWT Verification and JWT Claims Set validation options.
  */
 export declare function jwtVerify<PayloadType = t.JWTPayload, KeyType extends t.CryptoKey | Uint8Array = t.CryptoKey | Uint8Array>(jwt: string | Uint8Array, getKey: JWTVerifyGetKey<KeyType>, options?: JWTVerifyOptions): Promise<t.JWTVerifyResult<PayloadType> & t.ResolvedKey<KeyType>>;
 /**
@@ -30,6 +29,5 @@ export declare function jwtVerify<PayloadType = t.JWTPayload, KeyType extends t.
  *
  * @param key Key, or function resolving a key, to verify the JWT with. See
  *   {@link https://github.com/panva/jose/issues/210#jws-alg Algorithm Key Requirements}.
- * @param options JWT Verification and JWT Claims Set validation options.
  */
 export declare function jwtVerify<PayloadType = t.JWTPayload>(jwt: string | Uint8Array, key: t.KeyInput | JWTVerifyGetKey, options?: JWTVerifyOptions): Promise<t.JWTVerifyResult<PayloadType> & Partial<t.ResolvedKey>>;

package/node_modules/jose/dist/types/key/export.d.ts

@@ -6,7 +6,7 @@ import type * as t from '../types.d.ts';
  */
 export declare function exportSPKI(key: t.CryptoKey | t.KeyObject): Promise<string>;
 /**
- * Exports a private key to PEM-encoded PKCS#8. CryptoKey inputs must be extractable.
+ * Exports a private key to PEM-encoded PKCS #8. CryptoKey inputs must be extractable.
  *
  * @param key Key to export.
  */

package/node_modules/jose/dist/types/key/generate_secret.d.ts

@@ -2,7 +2,7 @@ import type * as t from '../types.d.ts';
 /** Algorithms supported by {@link generateSecret}, subject to runtime support. */
 export type GenerateSecretAlgorithm = 'HS256' | 'HS384' | 'HS512' | 'A128CBC-HS256' | 'A192CBC-HS384' | 'A256CBC-HS512' | 'A128KW' | 'A192KW' | 'A256KW' | 'A128GCMKW' | 'A192GCMKW' | 'A256GCMKW' | 'A128GCM' | 'A192GCM' | 'A256GCM' | (string & {});
 /**
- * Maps a JWA algorithm identifier to the value returned by {@link generateSecret}. AES-CBC-HMAC
+ * Maps a JWA algorithm identifier to the value returned by {@link generateSecret}. AES_CBC_HMAC_SHA2
  * algorithms return {@link !Uint8Array}; other supported algorithms return
  * {@link t.CryptoKey CryptoKey}. When the algorithm is not statically known, the result is their
  * union.

package/node_modules/jose/dist/types/key/import.d.ts

@@ -40,12 +40,12 @@ export declare function importSPKI(spki: string, alg: string, options?: KeyImpor
  */
 export declare function importX509(x509: string, alg: string, options?: KeyImportOptions): Promise<t.CryptoKey>;
 /**
- * Imports a PEM-encoded PKCS#8 string as a {@link !CryptoKey}.
+ * Imports a PEM-encoded PKCS #8 string as a {@link !CryptoKey}.
  *
  * > Note: For RSA keys, use the rsaEncryption OID (1.2.840.113549.1.1.1). The id-RSASSA-PSS OID
  * > (1.2.840.113549.1.1.10) is not supported by the Web Cryptography API.
  *
- * @param pkcs8 PEM-encoded PKCS#8 string
+ * @param pkcs8 PEM-encoded PKCS #8 string
  * @param alg JSON Web Algorithm identifier to be used with the imported key. See
  *   {@link https://github.com/panva/jose/issues/210 Algorithm Key Requirements}.
  */