Add serializeCookieString

README.md

@@ -40,6 +40,7 @@ npm run build
 ## TODO list
 
 - [x] ~~Documentation~~.
+- [ ] `ParsedCookie` serialization.
 - [ ] Check edge cases.
 - [ ] Add examples.
 - [ ] Migrate tests to typescript when I resolve some issues with typescript and custom jest matchers.

src/index.ts

@@ -1,3 +1,4 @@
+export { ParsedCookie, SplitStringOptions } from './interfaces';
 export { parseNetscapeFile, parseNetscapeString } from './parseNetscape';
 export { parseCookieString } from './parseCookie';
-export { ParsedCookie, SplitStringOptions } from './interfaces';
+export { serializeCookieString as serializeToCookieString } from './serializeCookie';

src/parseCookie.ts

@@ -5,7 +5,7 @@ import { ParsedCookie } from './interfaces';
 import { nameValuePairToCookie, splitString } from './utils';
 
 /**
- * Reduces a semicolon separated key=value sequence like:
+ * Deserializes a semicolon separated key=value sequence like:
  *
  * ```
  * 'a=b; c=d; e=f;'
@@ -18,7 +18,7 @@ export function parseCookieString(string: string): ParsedCookie[] {
 }
 
 /**
- * Reduces a set-cookie header string like:
+ * Deserializes a set-cookie header string like:
  *
  * ```
  * 'a=b; Domain=test.dev; Path=/; Secure; SameSite=Lax; Expires=Wed, 09 Jun 2021 10:18:14 GMT;'

src/serializeCookie.ts

@@ -0,0 +1,16 @@
+import { join, map, pipe } from 'ramda';
+import { isArray } from 'ramda-adjunct';
+
+import { ParsedCookie } from './interfaces';
+import { cookieToNameValuePair } from './utils';
+
+/**
+ * Serializes a single or a `ParsedCookie` array to a separated key=value sequence like:
+ *
+ * ```
+ * 'a=b; c=d; e=f;'
+ * ```
+ */
+export function serializeCookieString(cookie: ParsedCookie | ParsedCookie[]): string {
+  return isArray(cookie) ? pipe(map(cookieToNameValuePair), join(';'))(cookie) : cookieToNameValuePair(cookie);
+}

src/utils.ts

@@ -53,6 +53,14 @@ export function nameValuePairToCookie(tuple: NameValueTuple): ParsedCookie {
   return { name, value: ifElse(isNotNil, identity, always(name))(value) } as ParsedCookie;
 }
 
+/**
+ * Takes a ParsedCookie and maps it to a valid [name, value] pair
+ * @internal
+ */
+export function cookieToNameValuePair(cookie: ParsedCookie): string {
+  return !cookie.value || cookie.name === cookie.value ? cookie.name : `${cookie.name}=${cookie.value}`;
+}
+
 /**
  * Takes a split netscape string and maps it to a valid Cookie
  * @internal

tests/serializeCookie.spec.js

@@ -0,0 +1,17 @@
+import { serializeToCookieString } from '../src';
+
+describe('Parse Cookie String', () => {
+  const parsedCookies = [
+    { name: 'a', value: 'b' },
+    { name: 'c', value: 'd' }
+  ];
+
+  it('Should generate a valid `name=value` from ParsedCookie', () => {
+    expect(serializeToCookieString(parsedCookies[0])).toBe('a=b');
+    expect(serializeToCookieString(parsedCookies[1])).toBe('c=d');
+  });
+
+  it('Should generate a valid `name=value` pairs from a ParsedCookie array', () => {
+    expect(serializeToCookieString(parsedCookies)).toBe('a=b;c=d');
+  });
+});

tests/utils.spec.js

@@ -1,4 +1,4 @@
-import { splitString, nameValuePairToCookie, arrayToCookie } from '../src/utils';
+import { splitString, nameValuePairToCookie, arrayToCookie, cookieToNameValuePair } from '../src/utils';
 
 describe('splitTrimLine', () => {
   it('Should generate a valid array from a string without extra whitespace', () => {
@@ -79,3 +79,14 @@ describe('nameValuePairToCookie', () => {
     expect(nameValuePairToCookie(['a'])).toStrictEqual({ name: 'a', value: 'a' });
   });
 });
+
+describe('cookieToNameValuePair', () => {
+  it('Should generate a valid name=value pair from a ParsedCookie', () => {
+    expect(cookieToNameValuePair({ name: 'a', value: 'b' })).toStrictEqual('a=b');
+  });
+
+  it('Should generate a name-only cookie from a ParsedCookie', () => {
+    expect(cookieToNameValuePair({ name: 'a', value: 'a' })).toStrictEqual('a');
+    expect(cookieToNameValuePair({ name: 'a' })).toStrictEqual('a');
+  });
+});