@okam/directus-next 0.4.0 → 1.1.0

package/directus/directus-next/src/lib/directusRouteRouter.js

@@ -4,8 +4,11 @@ const logger = require("../logger.js");
 async function fetchPageSettingsTranslation(path) {
   const graphqlEndpoint = process.env.NEXT_SERVER_GRAPHQL_URL || process.env.NEXT_PUBLIC_GRAPHQL_URL;
   const graphqlApiKey = process.env.NEXT_PUBLIC_API_TOKEN;
-  if (!graphqlEndpoint || !graphqlApiKey) {
-    throw new Error("Missing GraphQL configuration");
+  if (!graphqlEndpoint) {
+    throw new Error("Missing GraphQL configuration `graphqlEndpoint`");
+  }
+  if (!graphqlApiKey) {
+    throw new Error("Missing GraphQL configuration `graphqlApiKey`");
   }
   const query = `
     query Languages_code($filter: page_settings_translations_filter) {
@@ -49,10 +52,15 @@ async function fetchPageSettingsTranslation(path) {
     return null;
   }
 }
+function removeLocaleFromPathname(pathname, config) {
+  const currentLocale = Object.values(config.localeMap ?? {}).find((locale) => pathname.startsWith(`/${locale}/`));
+  return { locale: currentLocale, pathname: currentLocale ? pathname.replace(`/${currentLocale}/`, "/") : pathname };
+}
 async function directusRouteRouter(request, config, NextResponse) {
   var _a, _b;
-  const { pathname } = request.nextUrl;
-  logger.log("Processing request for pathname:", pathname);
+  const { pathname: localizedPathname } = request.nextUrl;
+  const { locale, pathname } = removeLocaleFromPathname(localizedPathname, config);
+  logger.log("Processing request for pathname:", { locale, pathname });
   const translations = await fetchPageSettingsTranslation(pathname);
   if (!translations || translations.length === 0) {
     logger.log("No translation found for path:", pathname);

package/directus/directus-next/src/lib/directusRouteRouter.mjs

@@ -2,8 +2,11 @@ import { log } from "../logger.mjs";
 async function fetchPageSettingsTranslation(path) {
   const graphqlEndpoint = process.env.NEXT_SERVER_GRAPHQL_URL || process.env.NEXT_PUBLIC_GRAPHQL_URL;
   const graphqlApiKey = process.env.NEXT_PUBLIC_API_TOKEN;
-  if (!graphqlEndpoint || !graphqlApiKey) {
-    throw new Error("Missing GraphQL configuration");
+  if (!graphqlEndpoint) {
+    throw new Error("Missing GraphQL configuration `graphqlEndpoint`");
+  }
+  if (!graphqlApiKey) {
+    throw new Error("Missing GraphQL configuration `graphqlApiKey`");
   }
   const query = `
     query Languages_code($filter: page_settings_translations_filter) {
@@ -47,10 +50,15 @@ async function fetchPageSettingsTranslation(path) {
     return null;
   }
 }
+function removeLocaleFromPathname(pathname, config) {
+  const currentLocale = Object.values(config.localeMap ?? {}).find((locale) => pathname.startsWith(`/${locale}/`));
+  return { locale: currentLocale, pathname: currentLocale ? pathname.replace(`/${currentLocale}/`, "/") : pathname };
+}
 async function directusRouteRouter(request, config, NextResponse) {
   var _a, _b;
-  const { pathname } = request.nextUrl;
-  log("Processing request for pathname:", pathname);
+  const { pathname: localizedPathname } = request.nextUrl;
+  const { locale, pathname } = removeLocaleFromPathname(localizedPathname, config);
+  log("Processing request for pathname:", { locale, pathname });
   const translations = await fetchPageSettingsTranslation(pathname);
   if (!translations || translations.length === 0) {
     log("No translation found for path:", pathname);

package/directus/directus-next/src/pageSettings/context.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("server-only");
+const createServerContext = require("server-only-context");
+function pageSettingsContext(defaultValue) {
+  const [pageSettings, setPageSettings] = createServerContext(defaultValue);
+  return [pageSettings, setPageSettings];
+}
+function pageSettingsVariablesContext(variables) {
+  const [pageSettingsVariables, setPageSettingsVariables] = createServerContext(variables);
+  return [pageSettingsVariables, setPageSettingsVariables];
+}
+exports.pageSettingsContext = pageSettingsContext;
+exports.pageSettingsVariablesContext = pageSettingsVariablesContext;

package/directus/directus-next/src/pageSettings/context.mjs

@@ -0,0 +1,14 @@
+import "server-only";
+import createServerContext from "server-only-context";
+function pageSettingsContext(defaultValue) {
+  const [pageSettings, setPageSettings] = createServerContext(defaultValue);
+  return [pageSettings, setPageSettings];
+}
+function pageSettingsVariablesContext(variables) {
+  const [pageSettingsVariables, setPageSettingsVariables] = createServerContext(variables);
+  return [pageSettingsVariables, setPageSettingsVariables];
+}
+export {
+  pageSettingsContext,
+  pageSettingsVariablesContext
+};

package/directus/directus-next/src/pageSettings/usePageSettings.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("@tanstack/react-query");
+const query = require("../../../directus-query/src/lib/query.js");
+require("../../../directus-query/src/lib/request.js");
+require("../../../directus-query/src/logger.js");
+require("graphql-request");
+require("../../../directus-query/src/lib/config.js");
+const radashi = require("radashi");
+const logger = require("../logger.js");
+const context = require("./context.js");
+const [getPageSettings, setPageSettings] = context.pageSettingsContext();
+const [getVariables, setVariables] = context.pageSettingsVariablesContext();
+function isDirectusRouteConfig(config) {
+  return !!config && "localeMap" in config;
+}
+function getDirectusVariables(variables, config) {
+  const localeMap = isDirectusRouteConfig(config) ? config.localeMap : config;
+  if (!localeMap) {
+    return variables;
+  }
+  const locale = radashi.get(variables, "locale");
+  const directusLocale = radashi.invert(localeMap)[locale] ?? locale;
+  return { ...variables, locale: directusLocale };
+}
+async function usePageSettings(props, itemKey) {
+  var _a, _b, _c, _d, _e;
+  const { variables, config } = props ?? {};
+  const directusVariables = getDirectusVariables(variables, config);
+  const defaultReturn = getPageSettings() ?? {};
+  if (!props || radashi.isEqual(getVariables(), directusVariables)) {
+    logger.log("Using cached page settings", { path: (_c = (_b = (_a = defaultReturn.page_settings) == null ? void 0 : _a.translations) == null ? void 0 : _b[0]) == null ? void 0 : _c.path });
+    return defaultReturn;
+  }
+  const { document } = props;
+  const key = itemKey ?? radashi.get(document, "definitions[0].selectionSet.selections[0].name.value");
+  logger.log("Querying new page settings", directusVariables);
+  const result = await query.queryGql(document, directusVariables);
+  const items = result == null ? void 0 : result[key];
+  const currentItem = Array.isArray(items) ? items == null ? void 0 : items[0] : items;
+  const currentPageSettings = currentItem == null ? void 0 : currentItem.page_settings;
+  const currentPath = (_e = (_d = currentPageSettings == null ? void 0 : currentPageSettings.translations) == null ? void 0 : _d[0]) == null ? void 0 : _e.path;
+  if (!currentItem) {
+    logger.log("No item found. Falling back to cached page settings", { path: currentPath }, "warn");
+    return defaultReturn;
+  }
+  if (!currentPageSettings) {
+    logger.log("No page settings found. Falling back to cached page settings", { path: currentPath }, "warn");
+    return defaultReturn;
+  }
+  logger.log("Caching new page settings", { path: currentPath });
+  setPageSettings(currentItem);
+  setVariables(variables);
+  return currentItem;
+}
+exports.usePageSettings = usePageSettings;

package/directus/directus-next/src/pageSettings/usePageSettings.mjs

@@ -0,0 +1,56 @@
+import "@tanstack/react-query";
+import { queryGql } from "../../../directus-query/src/lib/query.mjs";
+import "../../../directus-query/src/lib/request.mjs";
+import "../../../directus-query/src/logger.mjs";
+import "graphql-request";
+import "../../../directus-query/src/lib/config.mjs";
+import { isEqual, get, invert } from "radashi";
+import { log } from "../logger.mjs";
+import { pageSettingsContext, pageSettingsVariablesContext } from "./context.mjs";
+const [getPageSettings, setPageSettings] = pageSettingsContext();
+const [getVariables, setVariables] = pageSettingsVariablesContext();
+function isDirectusRouteConfig(config) {
+  return !!config && "localeMap" in config;
+}
+function getDirectusVariables(variables, config) {
+  const localeMap = isDirectusRouteConfig(config) ? config.localeMap : config;
+  if (!localeMap) {
+    return variables;
+  }
+  const locale = get(variables, "locale");
+  const directusLocale = invert(localeMap)[locale] ?? locale;
+  return { ...variables, locale: directusLocale };
+}
+async function usePageSettings(props, itemKey) {
+  var _a, _b, _c, _d, _e;
+  const { variables, config } = props ?? {};
+  const directusVariables = getDirectusVariables(variables, config);
+  const defaultReturn = getPageSettings() ?? {};
+  if (!props || isEqual(getVariables(), directusVariables)) {
+    log("Using cached page settings", { path: (_c = (_b = (_a = defaultReturn.page_settings) == null ? void 0 : _a.translations) == null ? void 0 : _b[0]) == null ? void 0 : _c.path });
+    return defaultReturn;
+  }
+  const { document } = props;
+  const key = itemKey ?? get(document, "definitions[0].selectionSet.selections[0].name.value");
+  log("Querying new page settings", directusVariables);
+  const result = await queryGql(document, directusVariables);
+  const items = result == null ? void 0 : result[key];
+  const currentItem = Array.isArray(items) ? items == null ? void 0 : items[0] : items;
+  const currentPageSettings = currentItem == null ? void 0 : currentItem.page_settings;
+  const currentPath = (_e = (_d = currentPageSettings == null ? void 0 : currentPageSettings.translations) == null ? void 0 : _d[0]) == null ? void 0 : _e.path;
+  if (!currentItem) {
+    log("No item found. Falling back to cached page settings", { path: currentPath }, "warn");
+    return defaultReturn;
+  }
+  if (!currentPageSettings) {
+    log("No page settings found. Falling back to cached page settings", { path: currentPath }, "warn");
+    return defaultReturn;
+  }
+  log("Caching new page settings", { path: currentPath });
+  setPageSettings(currentItem);
+  setVariables(variables);
+  return currentItem;
+}
+export {
+  usePageSettings
+};

package/directus/directus-next/src/server.js

@@ -1,4 +1,9 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const directusRouteRouter = require("./lib/directusRouteRouter.js");
+const context = require("./pageSettings/context.js");
+const usePageSettings = require("./pageSettings/usePageSettings.js");
 exports.directusRouteRouter = directusRouteRouter.directusRouteRouter;
+exports.pageSettingsContext = context.pageSettingsContext;
+exports.pageSettingsVariablesContext = context.pageSettingsVariablesContext;
+exports.usePageSettings = usePageSettings.usePageSettings;

package/directus/directus-next/src/server.mjs

@@ -1,4 +1,9 @@
 import { directusRouteRouter } from "./lib/directusRouteRouter.mjs";
+import { pageSettingsContext, pageSettingsVariablesContext } from "./pageSettings/context.mjs";
+import { usePageSettings } from "./pageSettings/usePageSettings.mjs";
 export {
-  directusRouteRouter
+  directusRouteRouter,
+  pageSettingsContext,
+  pageSettingsVariablesContext,
+  usePageSettings
 };

package/directus/directus-query/src/lib/config.js

@@ -0,0 +1,3 @@
+"use strict";
+process.env.NEXT_PUBLIC_GRAPHQL_URL;
+process.env.NEXT_PUBLIC_API_TOKEN;

package/directus/directus-query/src/lib/config.mjs

@@ -0,0 +1,2 @@
+process.env.NEXT_PUBLIC_GRAPHQL_URL;
+process.env.NEXT_PUBLIC_API_TOKEN;

package/directus/directus-query/src/lib/query.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("radashi");
+const request = require("./request.js");
+function queryGql(document, queryKey, client = request.graphqlRequestClient) {
+  return client.request(document, {
+    ...queryKey
+  });
+}
+exports.queryGql = queryGql;

package/directus/directus-query/src/lib/query.mjs

@@ -0,0 +1,10 @@
+import "radashi";
+import { graphqlRequestClient } from "./request.mjs";
+function queryGql(document, queryKey, client = graphqlRequestClient) {
+  return client.request(document, {
+    ...queryKey
+  });
+}
+export {
+  queryGql
+};

package/directus/directus-query/src/lib/request.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
+const reactQuery = require("@tanstack/react-query");
+const graphqlRequest = require("graphql-request");
+const logger = require("../logger.js");
+const GRAPHQL_ENDPOINT_PUBLIC = process.env.NEXT_PUBLIC_GRAPHQL_URL;
+const GRAPHQL_ENDPOINT_SERVER = process.env.NEXT_SERVER_GRAPHQL_URL;
+const GRAPHQL_ENDPOINT_ADMIN = process.env.NEXT_GRAPHQL_URL_ADMIN;
+const AUTH_TOKEN = process.env.NEXT_PUBLIC_API_TOKEN ?? "";
+const AUTH_TOKEN_ADMIN = process.env.NEXT_PUBLIC_API_TOKEN;
+const graphqlRequestClient = new graphqlRequest.GraphQLClient(GRAPHQL_ENDPOINT_SERVER || GRAPHQL_ENDPOINT_PUBLIC, {
+  credentials: "include",
+  mode: "cors",
+  fetch,
+  headers: {
+    Authorization: `Bearer ${AUTH_TOKEN}`
+  }
+});
+new graphqlRequest.GraphQLClient(GRAPHQL_ENDPOINT_ADMIN, {
+  credentials: "include",
+  mode: "cors",
+  fetch,
+  headers: {
+    Authorization: `Bearer ${AUTH_TOKEN_ADMIN}`
+  }
+});
+new reactQuery.QueryClient({
+  queryCache: new reactQuery.QueryCache({
+    onError: (error) => {
+      logger.logger.log("QueryClient Error", "error", { error });
+    }
+  }),
+  defaultOptions: {
+    queries: {
+      staleTime: 5 * 1e3
+    }
+  }
+});
+exports.default = graphqlRequestClient;
+exports.graphqlRequestClient = graphqlRequestClient;

package/directus/directus-query/src/lib/request.mjs

@@ -0,0 +1,40 @@
+import { QueryClient, QueryCache } from "@tanstack/react-query";
+import { GraphQLClient } from "graphql-request";
+import { logger } from "../logger.mjs";
+const GRAPHQL_ENDPOINT_PUBLIC = process.env.NEXT_PUBLIC_GRAPHQL_URL;
+const GRAPHQL_ENDPOINT_SERVER = process.env.NEXT_SERVER_GRAPHQL_URL;
+const GRAPHQL_ENDPOINT_ADMIN = process.env.NEXT_GRAPHQL_URL_ADMIN;
+const AUTH_TOKEN = process.env.NEXT_PUBLIC_API_TOKEN ?? "";
+const AUTH_TOKEN_ADMIN = process.env.NEXT_PUBLIC_API_TOKEN;
+const graphqlRequestClient = new GraphQLClient(GRAPHQL_ENDPOINT_SERVER || GRAPHQL_ENDPOINT_PUBLIC, {
+  credentials: "include",
+  mode: "cors",
+  fetch,
+  headers: {
+    Authorization: `Bearer ${AUTH_TOKEN}`
+  }
+});
+new GraphQLClient(GRAPHQL_ENDPOINT_ADMIN, {
+  credentials: "include",
+  mode: "cors",
+  fetch,
+  headers: {
+    Authorization: `Bearer ${AUTH_TOKEN_ADMIN}`
+  }
+});
+new QueryClient({
+  queryCache: new QueryCache({
+    onError: (error) => {
+      logger.log("QueryClient Error", "error", { error });
+    }
+  }),
+  defaultOptions: {
+    queries: {
+      staleTime: 5 * 1e3
+    }
+  }
+});
+export {
+  graphqlRequestClient as default,
+  graphqlRequestClient
+};

package/directus/directus-query/src/logger.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../../stack/logger/src/lib/logger.js");
+const factoryLogger = require("../../../stack/logger/src/lib/factoryLogger.js");
+const logger = factoryLogger("[DirectusQuery]");
+exports.logger = logger;

package/directus/directus-query/src/logger.mjs

@@ -0,0 +1,6 @@
+import "../../../stack/logger/src/lib/logger.mjs";
+import createLogger from "../../../stack/logger/src/lib/factoryLogger.mjs";
+const logger = createLogger("[DirectusQuery]");
+export {
+  logger
+};

package/files/interface.d.ts

@@ -0,0 +1,24 @@
+export type TFiles = {
+    id?: string | null;
+    title?: string | null;
+    description?: string | null;
+    tags?: any | null;
+    location?: string | null;
+    storage?: string | null;
+    focal_point_divider?: string | null;
+    focal_point_x?: number | null;
+    focal_point_y?: number | null;
+    filename_disk?: string | null;
+    filename_download?: string | null;
+    type?: string | null;
+    width?: number | null;
+    height?: number | null;
+    duration?: number | null;
+    embed?: string | null;
+    caption?: string | null;
+    thumbhash?: string | null;
+    /**
+     * @deprecated Use `filename_download` instead
+     */
+    filenameDownload?: string | null;
+};

package/index.d.ts

@@ -2,3 +2,5 @@ export * from './draft';
 export { logger as DirectusNextLogger } from './logger';
 export { directusRouteRouter } from './lib/directusRouteRouter';
 export { getJsonErrorResponse } from './response';
+export type { TPageSettings, TPageSettingsTranslation, TPageSettingsItemQuery, TPageSettingsItemDocument, TUsePageSettingsProps, } from './pageSettings/interface';
+export type { TFiles } from './files/interface';

package/package.json

@@ -1,16 +1,28 @@
 {
   "name": "@okam/directus-next",
   "main": "./index.js",
-  "version": "0.4.0",
+  "version": "1.1.0",
   "types": "./index.d.ts",
   "exports": {
     ".": {
-      "import": "./index.mjs",
-      "require": "./index.js"
+      "import": {
+        "types": "./index.d.ts",
+        "default": "./index.mjs"
+      },
+      "require": {
+        "types": "./index.d.ts",
+        "default": "./index.mjs"
+      }
     },
     "./server": {
-      "import": "./server.mjs",
-      "require": "./server.js"
+      "import": {
+        "types": "./server.d.ts",
+        "default": "./server.mjs"
+      },
+      "require": {
+        "types": "./server.d.ts",
+        "default": "./server.mjs"
+      }
     }
   },
   "repository": {
@@ -22,6 +34,11 @@
   "dependencies": {
     "@okam/logger": "1.1.0",
     "next": "^14.1.1",
-    "radashi": "^12.3.0"
+    "radashi": "^12.3.0",
+    "@okam/directus-query": "1.4.1",
+    "server-only": "0.0.1",
+    "graphql-request": "7.1.2",
+    "server-only-context": "0.1.0",
+    "@graphql-typed-document-node/core": "3.2.0"
   }
 }

package/pageSettings/context.d.ts

@@ -0,0 +1,4 @@
+import type { Variables } from 'graphql-request';
+import type { TPageSettingsQueryItem, TUsePageSettingsReturn } from './interface';
+export declare function pageSettingsContext<Item extends TPageSettingsQueryItem>(defaultValue?: TUsePageSettingsReturn<Item>): readonly [() => TUsePageSettingsReturn<Item> | undefined, (v: TUsePageSettingsReturn<Item> | undefined) => void];
+export declare function pageSettingsVariablesContext(variables?: Variables): readonly [() => object | undefined, (v: object | undefined) => void];

package/pageSettings/index.d.ts

@@ -0,0 +1,3 @@
+export * from './context';
+export type { TPageSettings, TPageSettingsTranslation, TPageSettingsItemDocument, TPageSettingsItemQuery, } from './interface';
+export * from './usePageSettings';

package/pageSettings/interface.d.ts

@@ -0,0 +1,69 @@
+import { type TypedDocumentNode } from '@graphql-typed-document-node/core';
+import type { Variables } from 'graphql-request';
+import type { TFiles } from '../files/interface';
+import type { DirectusRouteConfig } from '../types/directusRouteConfig';
+export type Fragmentize<FragmentData, FragmentName extends string = string> = {
+    ' $fragmentRefs'?: {
+        [FragmentKey in FragmentName]?: FragmentData | null | undefined;
+    } | null | undefined;
+} | null | undefined;
+export type MaybeArray<T> = T | (T | null | undefined)[] | null | undefined;
+/**
+ * Directus page settings translations collection.
+ */
+export type TPageSettingsTranslation = {
+    slug?: string | null;
+    title?: string | null;
+    path?: string | null;
+    languages_code?: {
+        code: string;
+    } | null;
+    page_settings_id?: TPageSettings | null;
+    canonical_url?: string | null;
+    meta_description?: string | null;
+    no_follow?: boolean | null;
+    no_index?: boolean | null;
+    og_image?: TFiles | null;
+};
+/**
+ * Directus page settings collection.
+ */
+export type TPageSettings = {
+    id: string;
+    belongs_to_collection?: string | null;
+    belongs_to_key?: string | null;
+    translations?: Array<TPageSettingsTranslation | null> | null;
+    route?: {
+        translations?: Array<{
+            route?: string | null;
+        } | null> | null;
+    } | null;
+};
+export type TPageSettingsQueryItem = {
+    page_settings?: TPageSettings | Fragmentize<TPageSettings, 'PageSettingsFragment'> | null | undefined;
+} | null | undefined;
+export type TPageSettingsItemQuery<Item extends TPageSettingsQueryItem, ItemKey extends string> = {
+    __typename?: 'Query';
+} & {
+    [Key in ItemKey]?: MaybeArray<Item> | MaybeArray<Fragmentize<Item>>;
+};
+export type TPageSettingsItemDocument<Item extends TPageSettingsQueryItem, ItemKey extends string, QueryVariables extends Variables> = TypedDocumentNode<TPageSettingsItemQuery<Item, ItemKey>, QueryVariables>;
+export type TUsePageSettingsConfig = DirectusRouteConfig | Record<string, string>;
+/**
+ * If not using a fragment in the item key, all type parameters must be passed. Otherwise, only the `page_settings` field will be in the type definition.
+ * If using a fragment in the item key, the return type will contain the fragment.
+ */
+export interface TUsePageSettingsProps<Item extends TPageSettingsQueryItem, ItemKey extends string, QueryVariables extends Variables> {
+    document: TPageSettingsItemDocument<Item, ItemKey, QueryVariables>;
+    /**
+     * `variables.locale` is a special value that will get mapped according to the config.
+     */
+    variables?: QueryVariables;
+    /**
+     * Either a directus route config or directly a locale map. Not passing a config while passing a document will result in direct usage of the `locale` variable.
+     */
+    config?: TUsePageSettingsConfig;
+}
+export type TUsePageSettingsReturn<Item extends TPageSettingsQueryItem> = Omit<Item, 'page_settings'> & {
+    page_settings?: Exclude<NonNullable<Item>['page_settings'], Fragmentize<TPageSettings, 'PageSettingsFragment'>> | null | undefined;
+};

package/pageSettings/usePageSettings.d.ts

@@ -0,0 +1,30 @@
+import type { Variables } from 'graphql-request';
+import type { TUsePageSettingsProps, TPageSettingsQueryItem, TUsePageSettingsReturn } from './interface';
+/**
+ * @param props Optional props. Passing new props will trigger a new query if the variables have changed compared to the value of the variables in the cache. Omitting props will return the cached value.
+ * @param itemKey Required if the query has more than a single root field
+ * @example
+ * #### `itemKey` not required
+ * ```graphql
+ * query PageById($id: ID!) {
+ *   pages_by_id(id: $id) {
+ *     ...Page
+ *   }
+ * }
+ * ```
+ *
+ * #### `itemKey` required
+ * Otherwise the first root field will be used as the item key automatically (not necessarily the correct one)
+ * ```graphql
+ * query PageAndPostById($id: ID!) {
+ *   pages_by_id(id: $id) {
+ *     ...Page
+ *   }
+ *   posts_by_id(id: $id) {
+ *     ...Post
+ *   }
+ * }
+ * ```
+ * @returns The new queried page settings item or the cached value if the variables have not changed. If the query contains a fragment, the contents of the fragment will be returned.
+ */
+export declare function usePageSettings<Item extends TPageSettingsQueryItem, ItemKey extends string = string, QueryVariables extends Variables = Variables>(props?: TUsePageSettingsProps<Item, ItemKey, QueryVariables>, itemKey?: Exclude<ItemKey, '__typename'>): Promise<TUsePageSettingsReturn<Item>>;

package/server.d.ts

@@ -1,2 +1,3 @@
 export { directusRouteRouter } from './lib/directusRouteRouter';
 export type { DirectusRouteConfig } from './types/directusRouteConfig';
+export * from './pageSettings';