Add resolvedUrl filter for modifying the resolved URL in the Faust …

…template system (#1391)

* Add filter for resolved URL in template system

* Add overload signature for `resolvedUrl` filter

* Add changeset

* Fix imports order

* Add `resolvedUrl` filter to docs

* Fix context object type in docs

.changeset/swift-impalas-kneel.md

@@ -0,0 +1,5 @@
+---
+'@faustwp/core': patch
+---
+
+Add `resolvedUrl` filter for modifying the resolved URL in the Faust template system

internal/faustjs.org/docs/plugin-system/filters.mdx

@@ -180,3 +180,27 @@ Allows you to modify Faust's Toolbar nodes.
     priority?: number | undefined,
   ): void;
 ```
+
+## resolvedUrl
+
+Allows you to override the resolved URL in the Faust template system.
+
+### Context Object
+
+- `nextContext: GetServerSidePropsContext | GetStaticPropsContext`: The Next.js context object from either `getServerSideProps`or`getStaticProps`
+
+### Signature
+
+```tsx
+addFilter(
+  hookName: 'resolvedUrl',
+  namespace: string,
+  callback: (
+    resolvedUrl: string | null,
+    context: {
+      nextContext: GetServerSidePropsContext | GetStaticPropsContext;
+    },
+  ) => string | null,
+  priority?: number | undefined,
+): void;
+```

packages/faustwp-core/src/getWordPressProps.tsx

@@ -71,6 +71,10 @@ export async function getWordPressProps(
     ctx.res.setHeader('x-using', 'faust');
   }
 
+  resolvedUrl = hooks.applyFilters('resolvedUrl', resolvedUrl, {
+    nextContext: ctx,
+  }) as string | null;
+
   if (!resolvedUrl) {
     return {
       notFound: true,

packages/faustwp-core/src/wpHooks/overloads.ts

@@ -5,6 +5,7 @@ import {
   NormalizedCacheObject,
 } from '@apollo/client';
 import { _Hooks } from '@wordpress/hooks/build-types/createHooks.js';
+import { GetServerSidePropsContext, GetStaticPropsContext } from 'next';
 import { FaustToolbarNodes } from '../components/Toolbar/index.js';
 import { SeedNode } from '../queries/seedQuery.js';
 
@@ -79,6 +80,18 @@ type FaustCoreFilters = {
     ) => string,
     priority?: number | undefined,
   ): void;
+
+  addFilter(
+    hookName: 'resolvedUrl',
+    namespace: string,
+    callback: (
+      resolvedUrl: string | null,
+      context: {
+        nextContext: GetServerSidePropsContext | GetStaticPropsContext;
+      },
+    ) => string | null,
+    priority?: number | undefined,
+  ): void;
 };
 
 export type FaustHooks = _Hooks & FaustCoreFilters;