feat: abstract stringify utility

Author: gajus

src/Roarr.ts

@@ -1,7 +1,7 @@
 import { createLogger } from './factories/createLogger';
 import { createRoarrInitialGlobalState } from './factories/createRoarrInitialGlobalState';
 import { type MessageSerializer, type RoarrGlobalState } from './types';
-import safeStringify from 'safe-stable-stringify';
+import { stringify } from './utilities/stringify';
 
 const ROARR = createRoarrInitialGlobalState(
   (globalThis.ROARR as RoarrGlobalState) || {},
@@ -10,7 +10,7 @@ const ROARR = createRoarrInitialGlobalState(
 globalThis.ROARR = ROARR;
 
 const serializeMessage: MessageSerializer = (message) => {
-  return safeStringify(message);
+  return stringify(message);
 };
 
 const Roarr = createLogger((message) => {

src/browser.ts

@@ -1,7 +1,7 @@
 import { createLogger } from './factories/createLogger';
 import { createRoarrInitialGlobalStateBrowser } from './factories/createRoarrInitialGlobalStateBrowser';
 import { type MessageSerializer, type RoarrGlobalState } from './types';
-import safeStringify from 'safe-stable-stringify';
+import { stringify } from './utilities/stringify';
 
 const ROARR = createRoarrInitialGlobalStateBrowser(
   (globalThis.ROARR as RoarrGlobalState) || {},
@@ -10,7 +10,7 @@ const ROARR = createRoarrInitialGlobalStateBrowser(
 globalThis.ROARR = ROARR;
 
 const serializeMessage: MessageSerializer = (message) => {
-  return safeStringify(message);
+  return stringify(message);
 };
 
 const Roarr = createLogger((message) => {

src/utilities/stringify.ts

@@ -0,0 +1,18 @@
+import { configure } from 'safe-stable-stringify';
+
+const safeStringify = configure({
+  circularValue: 'Magic circle!',
+  deterministic: false,
+  strict: false,
+});
+
+export const stringify = (value: unknown): string => {
+  try {
+    return safeStringify(value) ?? '';
+  } catch (error) {
+    // eslint-disable-next-line no-console
+    console.error('could not serialize value', value);
+
+    throw error;
+  }
+};

test/roarr/utilities/stringify.ts

@@ -0,0 +1,17 @@
+import { stringify } from '../../../src/utilities/stringify';
+import test from 'ava';
+
+test('stringifies key=value', (t) => {
+  t.is(
+    stringify({
+      foo: 'bar',
+    }),
+    '{"foo":"bar"}',
+  );
+  t.is(
+    stringify({
+      foo: undefined,
+    }),
+    '{}',
+  );
+});