implement useDecodeValue hook

src/useDecodeValue.test.ts

@@ -0,0 +1,29 @@
+import { renderHook } from '@testing-library/react';
+import { useDecodeValue } from '../src/useDecodeValue';
+import { SAMPLE_KEY, getTestData } from './utils/getTestData';
+
+describe('useDecodeValue', () => {
+  it('should memoize the decoded value', () => {
+    const testData = getTestData();
+
+    const { result, rerender } = renderHook(
+      ({ rawValue }: { rawValue: string | null }) =>
+        useDecodeValue(SAMPLE_KEY, rawValue, testData.options),
+      { initialProps: { rawValue: testData.storedValue.ok } }
+    );
+
+    const initialDecodedValue = result.current;
+
+    rerender({ rawValue: testData.storedValue.ok });
+    rerender({ rawValue: testData.storedValue.ok });
+    rerender({ rawValue: testData.storedValue.ok });
+
+    expect(result.current).toBe(initialDecodedValue);
+
+    rerender({
+      rawValue: testData.options.encoder({ id: 2, label: 'new value' }),
+    });
+
+    expect(result.current).not.toBe(initialDecodedValue);
+  });
+});

src/useDecodeValue.ts

@@ -0,0 +1,14 @@
+import * as React from 'react';
+import { z } from 'zod';
+import { Options } from './types/Options';
+import { decodeRawValue } from './utils/decodeRawValue';
+
+export function useDecodeValue<Schema extends z.ZodTypeAny>(
+  key: string,
+  rawValue: string | null,
+  options: Options<Schema>
+): z.infer<Schema> | undefined {
+  return React.useMemo(() => decodeRawValue(key, rawValue, options), [
+    rawValue,
+  ]);
+}