Export unstable_serialize from SWR (#1337)

* export serialize from swr and swr-infinite

* fix API

* rename api

Author: shuding

infinite/index.ts

@@ -22,7 +22,7 @@ const getFirstPageKey = (getKey: KeyLoader<any>) => {
   return serialize(getKey ? getKey(0, null) : null)[0]
 }
 
-export const getInfiniteKey = (getKey: KeyLoader<any>) => {
+export const unstable_serialize = (getKey: KeyLoader<any>) => {
   return INFINITE_PREFIX + getFirstPageKey(getKey)
 }
 

src/index.ts

@@ -1,5 +1,5 @@
 // Core APIs
-export { SWRConfig, mutate, createCache } from './use-swr'
+export { SWRConfig, mutate, createCache, unstable_serialize } from './use-swr'
 
 // useSWR
 import useSWR from './use-swr'

src/use-swr.ts

@@ -650,4 +650,6 @@ export const createCache = <Data = any>(
   }
 }
 
+export const unstable_serialize = (key: Key) => serialize(key)[0]
+
 export default withArgs<SWRHook>(useSWRHandler)

test/use-swr-infinite.test.tsx

@@ -1,7 +1,7 @@
 import React, { useEffect, useState } from 'react'
 import { render, fireEvent, act, screen } from '@testing-library/react'
 import { mutate, createCache, SWRConfig } from 'swr'
-import useSWRInfinite, { getInfiniteKey } from 'swr/infinite'
+import useSWRInfinite, { unstable_serialize } from 'swr/infinite'
 import { sleep, createKey, createResponse } from './utils'
 
 describe('useSWRInfinite', () => {
@@ -581,7 +581,7 @@ describe('useSWRInfinite', () => {
     await screen.findByText('data:')
   })
 
-  it('should mutate a cache with getInfiniteKey', async () => {
+  it('should mutate a cache with `unstable_serialize`', async () => {
     let count = 0
     function Page() {
       const { data } = useSWRInfinite<string, string>(
@@ -596,20 +596,22 @@ describe('useSWRInfinite', () => {
 
     await screen.findByText('data:page-test-12-0:1')
 
-    await act(() => mutate(getInfiniteKey(index => `page-test-12-${index}`)))
+    await act(() =>
+      mutate(unstable_serialize(index => `page-test-12-${index}`))
+    )
     await screen.findByText('data:page-test-12-0:2')
 
     await act(() =>
       mutate(
-        getInfiniteKey(index => `page-test-12-${index}`),
+        unstable_serialize(index => `page-test-12-${index}`),
         'local-mutation',
         false
       )
     )
     await screen.findByText('data:local-mutation')
   })
 
-  it('should mutate a cache with getInfiniteKey based on a current data', async () => {
+  it('should mutate a cache with `unstable_serialize` based on a current data', async () => {
     const getKey = index => [`pagetest-13`, index]
     function Comp() {
       const { data, size, setSize } = useSWRInfinite<string, string>(
@@ -630,15 +632,15 @@ describe('useSWRInfinite', () => {
 
     await act(() =>
       mutate(
-        getInfiniteKey(getKey),
+        unstable_serialize(getKey),
         data => data.map(value => `(edited)${value}`),
         false
       )
     )
     await screen.findByText('data:(edited)page 0, (edited)page 1,')
   })
 
-  it('should be able to use getInfiniteKey with a custom cache', async () => {
+  it('should be able to use `unstable_serialize` with a custom cache', async () => {
     const key = 'page-test-14;'
     const customCache1 = new Map([[key, 'initial-cache']])
     const { cache, mutate: mutateCustomCache } = createCache(customCache1)
@@ -659,11 +661,11 @@ describe('useSWRInfinite', () => {
 
     await screen.findByText('data:initial-cache')
 
-    await act(() => mutateCustomCache(getInfiniteKey(() => key)))
+    await act(() => mutateCustomCache(unstable_serialize(() => key)))
     await screen.findByText('data:response data')
 
     await act(() =>
-      mutateCustomCache(getInfiniteKey(() => key), 'local-mutation', false)
+      mutateCustomCache(unstable_serialize(() => key), 'local-mutation', false)
     )
     await screen.findByText('data:local-mutation')
   })