Expose signer

README.md

@@ -210,6 +210,46 @@ fastify.get('/', (req, rep) => {
 })
 ```
 
+### Other cases of manual signing / unsigning cookies
+
+Sometimes the service under test should only accept requests with signed cookies, but it does not generate them itself.
+
+**Example:**
+
+```js
+import { signerFactory } from "@fastify/cookie";
+
+const signerFactory = require('@fastify/cookie/signer');
+const secret = 'a secret';
+const signer = signerFactory(secret);
+...
+
+test('Request requires signed cookie', async () => {
+    const response = await app.inject({
+        method: 'GET',
+        url: '/',
+        headers: {
+          cookies : {
+            'sid': signer.sign(sidValue)
+          }
+        },
+    });
+
+    expect(response.statusCode).toBe(200);
+});
+```
+
+For cases when it is necessary to use different keys for signing/unsigning
+
+```js
+import { sign, unsign } from "@fastify/cookie";
+
+const sid = "sid-123456";
+const secret = "a secret";
+
+const signedCookie = sign(sid, secret);
+const unsignedCookie = unsign(signedCookie, secret);
+```
 
 ## License
 

cookie.js

@@ -28,6 +28,9 @@
 
 'use strict'
 
+const { sign, unsign } = require('cookie-signature')
+const { signerFactory } = require('./signer')
+
 /**
  * Module exports.
  * @public
@@ -36,6 +39,10 @@
 exports.parse = parse
 exports.serialize = serialize
 
+exports.signerFactory = signerFactory
+exports.sign = sign
+exports.unsign = unsign
+
 /**
  * Module variables.
  * @private

plugin.d.ts

@@ -105,6 +105,10 @@ interface Signer {
   };
 }
 
+declare const signerFactory: Signer;
+declare const sign: (value: string, secret: string) => string;
+declare const unsign: (input: string, secret: string) => string | false;
+
 export interface FastifyCookieOptions {
   secret?: string | string[] | Signer;
   parseOptions?: CookieSerializeOptions;
@@ -113,4 +117,4 @@ export interface FastifyCookieOptions {
 declare const fastifyCookie: FastifyPluginCallback<NonNullable<FastifyCookieOptions>>;
 
 export default fastifyCookie;
-export { fastifyCookie };
+export { fastifyCookie, signerFactory, sign, unsign };