Mark externalCache as deprecated

.changeset/thirty-monkeys-smoke.md

@@ -0,0 +1,5 @@
+---
+'@farfetched/core': minor
+---
+
+Mark `externalCache` as deprecated

apps/website/docs/api/operators/cache.md

@@ -58,31 +58,3 @@ cache(query, {
   adapter: someAdapter({ observability: { hit, miss, expired, evicted } }),
 });
 ```
-
-### External adapter for `cache`
-
-To integrate `cache` with external cache storage (e.g. Redis), there is `externalCache` provider.
-
-```ts
-import { cache, externalCache } from '@farfetched/core';
-
-cache(query, {
-  adapter: externalCache({
-    get: async ({ key }) => {
-      const result = await redis.get(key);
-
-      return JSON.parse(result);
-    },
-    set: async ({ key, value }) => {
-      await redis.set(key, JSON.stringify(value));
-    },
-    purge: async () => {
-      await redis.flushdb();
-    },
-  }),
-});
-```
-
-::: warning
-Due to external nature of the storage, `externalCache` supports only subset of observability events: `observability.hit` and `observability.miss`, any other event is not supported.
-:::

apps/website/docs/releases/0-8.md

@@ -1,4 +1,4 @@
-# v0.7
+# v0.8
 
 ## Migration guide
 
@@ -38,4 +38,8 @@ function User() {
 
 :::
 
+### Do not use `externalCache` adapter
+
+`externalCache` adapter is deprecated, write your own adapter instead [by recipe](/recipes/server_cache).
+
 <!--@include: ./0-8.changelog.md-->

packages/core/src/cache/adapters/external.ts

@@ -9,6 +9,9 @@ interface NarrowObservability {
   miss?: Event<{ key: string }>;
 }
 
+/**
+ * @deprecated Write your own adapter instead by recipe — https://farfetched.pages.dev/recipes/server_cache.html
+ */
 export function externalCache(config: {
   get: (opts: {
     key: string;