@flyo/nitro-next 1.1.0 → 1.2.0

package/dist/server.d.mts

@@ -1,5 +1,7 @@
+import * as react from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { Configuration, ConfigResponse, PagesApi, EntitiesApi, Page, Block } from '@flyo/nitro-typescript';
+import { Metadata } from 'next';
+import { Configuration, ConfigResponse, PagesApi, EntitiesApi, Entity, Page, Block } from '@flyo/nitro-typescript';
 
 declare const initNitro: ({ accessToken, lang, components, showMissingComponentAlert }: {
     accessToken: string;
@@ -10,6 +12,26 @@ declare const initNitro: ({ accessToken, lang, components, showMissingComponentA
 declare const getNitroConfig: () => Promise<ConfigResponse>;
 declare function getNitroPages(): PagesApi;
 declare function getNitroEntities(): EntitiesApi;
+/**
+ * Route params type for Next.js catch-all routes
+ */
+type RouteParams = {
+    params: Promise<{
+        slug?: string[];
+    }>;
+};
+/**
+ * Generic route params type for entity routes
+ * Allows any param structure from Next.js app router
+ */
+type EntityRouteParams<T = any> = {
+    params: Promise<T>;
+};
+/**
+ * Entity resolver function type
+ * Users provide this to resolve entities from their route params
+ */
+type EntityResolver<T = any> = (params: Promise<T>) => Promise<Entity>;
 /**
  * NitroPage component renders all blocks from a Flyo page
  */
@@ -19,5 +41,104 @@ declare function NitroPage({ page, }: {
 declare function NitroBlock({ block, }: {
     block: Block;
 }): react_jsx_runtime.JSX.Element | null;
+/**
+ * Default page route handler for Nitro pages
+ * Can be re-exported directly from Next.js app routes
+ *
+ * @example
+ * ```ts
+ * // app/[[...slug]]/page.tsx
+ * export { nitroPageRoute as default } from '@flyo/nitro-next/server';
+ * ```
+ */
+declare function nitroPageRoute(props: RouteParams): Promise<react_jsx_runtime.JSX.Element>;
+/**
+ * Generate metadata for Nitro pages
+ * Provides basic meta tags based on Flyo page data
+ * Can be re-exported directly from Next.js app routes
+ *
+ * @example
+ * ```ts
+ * // app/[[...slug]]/page.tsx
+ * export { nitroPageGenerateMetadata as generateMetadata } from '@flyo/nitro-next/server';
+ * ```
+ */
+declare function nitroPageGenerateMetadata(props: RouteParams): Promise<Metadata>;
+/**
+ * Generate static params for all Nitro pages
+ * Enables static site generation (SSG) for all pages
+ * Can be re-exported directly from Next.js app routes
+ *
+ * @example
+ * ```ts
+ * // app/[[...slug]]/page.tsx
+ * export { nitroPageGenerateStaticParams as generateStaticParams } from '@flyo/nitro-next/server';
+ * ```
+ */
+declare function nitroPageGenerateStaticParams(): Promise<{
+    slug: string[] | undefined;
+}[]>;
+/**
+ * Default entity route handler with custom resolver
+ * Flexible solution that works with any route param structure
+ *
+ * @example
+ * ```ts
+ * // app/blog/[slug]/page.tsx
+ * const resolver = async (params: Promise<{ slug: string }>) => {
+ *   const { slug } = await params;
+ *   return getNitroEntities().entityBySlug({ slug, typeId: 123 });
+ * };
+ *
+ * export default (props) => nitroEntityRoute(props, {
+ *   resolver,
+ *   render: (entity) => <h1>{entity.entity?.entity_title}</h1>
+ * });
+ * ```
+ *
+ * @example
+ * ```ts
+ * // app/items/[uniqueid]/page.tsx
+ * const resolver = async (params: Promise<{ uniqueid: string }>) => {
+ *   const { uniqueid } = await params;
+ *   return getNitroEntities().entityByUniqueid({ uniqueid });
+ * };
+ *
+ * export default (props) => nitroEntityRoute(props, { resolver });
+ * ```
+ *
+ * @example
+ * ```ts
+ * // app/custom/[whatever]/page.tsx
+ * const resolver = async (params: Promise<{ whatever: string }>) => {
+ *   const { whatever } = await params;
+ *   return getNitroEntities().entityBySlug({ slug: whatever });
+ * };
+ *
+ * export default (props) => nitroEntityRoute(props, { resolver });
+ * ```
+ */
+declare function nitroEntityRoute<T = any>(props: EntityRouteParams<T>, options: {
+    resolver: EntityResolver<T>;
+    render?: (entity: Entity) => React.ReactNode;
+}): Promise<string | number | bigint | boolean | react_jsx_runtime.JSX.Element | Iterable<react.ReactNode> | null | undefined>;
+/**
+ * Generate metadata for Nitro entities with custom resolver
+ * Works with any route param structure
+ *
+ * @example
+ * ```ts
+ * // app/blog/[slug]/page.tsx
+ * const resolver = async (params: Promise<{ slug: string }>) => {
+ *   const { slug } = await params;
+ *   return getNitroEntities().entityBySlug({ slug, typeId: 123 });
+ * };
+ *
+ * export const generateMetadata = (props) => nitroEntityGenerateMetadata(props, { resolver });
+ * ```
+ */
+declare function nitroEntityGenerateMetadata<T = any>(props: EntityRouteParams<T>, options: {
+    resolver: EntityResolver<T>;
+}): Promise<Metadata>;
 
-export { NitroBlock, NitroPage, getNitroConfig, getNitroEntities, getNitroPages, initNitro };
+export { type EntityResolver, NitroBlock, NitroPage, getNitroConfig, getNitroEntities, getNitroPages, initNitro, nitroEntityGenerateMetadata, nitroEntityRoute, nitroPageGenerateMetadata, nitroPageGenerateStaticParams, nitroPageRoute };

package/dist/server.d.ts

@@ -1,5 +1,7 @@
+import * as react from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { Configuration, ConfigResponse, PagesApi, EntitiesApi, Page, Block } from '@flyo/nitro-typescript';
+import { Metadata } from 'next';
+import { Configuration, ConfigResponse, PagesApi, EntitiesApi, Entity, Page, Block } from '@flyo/nitro-typescript';
 
 declare const initNitro: ({ accessToken, lang, components, showMissingComponentAlert }: {
     accessToken: string;
@@ -10,6 +12,26 @@ declare const initNitro: ({ accessToken, lang, components, showMissingComponentA
 declare const getNitroConfig: () => Promise<ConfigResponse>;
 declare function getNitroPages(): PagesApi;
 declare function getNitroEntities(): EntitiesApi;
+/**
+ * Route params type for Next.js catch-all routes
+ */
+type RouteParams = {
+    params: Promise<{
+        slug?: string[];
+    }>;
+};
+/**
+ * Generic route params type for entity routes
+ * Allows any param structure from Next.js app router
+ */
+type EntityRouteParams<T = any> = {
+    params: Promise<T>;
+};
+/**
+ * Entity resolver function type
+ * Users provide this to resolve entities from their route params
+ */
+type EntityResolver<T = any> = (params: Promise<T>) => Promise<Entity>;
 /**
  * NitroPage component renders all blocks from a Flyo page
  */
@@ -19,5 +41,104 @@ declare function NitroPage({ page, }: {
 declare function NitroBlock({ block, }: {
     block: Block;
 }): react_jsx_runtime.JSX.Element | null;
+/**
+ * Default page route handler for Nitro pages
+ * Can be re-exported directly from Next.js app routes
+ *
+ * @example
+ * ```ts
+ * // app/[[...slug]]/page.tsx
+ * export { nitroPageRoute as default } from '@flyo/nitro-next/server';
+ * ```
+ */
+declare function nitroPageRoute(props: RouteParams): Promise<react_jsx_runtime.JSX.Element>;
+/**
+ * Generate metadata for Nitro pages
+ * Provides basic meta tags based on Flyo page data
+ * Can be re-exported directly from Next.js app routes
+ *
+ * @example
+ * ```ts
+ * // app/[[...slug]]/page.tsx
+ * export { nitroPageGenerateMetadata as generateMetadata } from '@flyo/nitro-next/server';
+ * ```
+ */
+declare function nitroPageGenerateMetadata(props: RouteParams): Promise<Metadata>;
+/**
+ * Generate static params for all Nitro pages
+ * Enables static site generation (SSG) for all pages
+ * Can be re-exported directly from Next.js app routes
+ *
+ * @example
+ * ```ts
+ * // app/[[...slug]]/page.tsx
+ * export { nitroPageGenerateStaticParams as generateStaticParams } from '@flyo/nitro-next/server';
+ * ```
+ */
+declare function nitroPageGenerateStaticParams(): Promise<{
+    slug: string[] | undefined;
+}[]>;
+/**
+ * Default entity route handler with custom resolver
+ * Flexible solution that works with any route param structure
+ *
+ * @example
+ * ```ts
+ * // app/blog/[slug]/page.tsx
+ * const resolver = async (params: Promise<{ slug: string }>) => {
+ *   const { slug } = await params;
+ *   return getNitroEntities().entityBySlug({ slug, typeId: 123 });
+ * };
+ *
+ * export default (props) => nitroEntityRoute(props, {
+ *   resolver,
+ *   render: (entity) => <h1>{entity.entity?.entity_title}</h1>
+ * });
+ * ```
+ *
+ * @example
+ * ```ts
+ * // app/items/[uniqueid]/page.tsx
+ * const resolver = async (params: Promise<{ uniqueid: string }>) => {
+ *   const { uniqueid } = await params;
+ *   return getNitroEntities().entityByUniqueid({ uniqueid });
+ * };
+ *
+ * export default (props) => nitroEntityRoute(props, { resolver });
+ * ```
+ *
+ * @example
+ * ```ts
+ * // app/custom/[whatever]/page.tsx
+ * const resolver = async (params: Promise<{ whatever: string }>) => {
+ *   const { whatever } = await params;
+ *   return getNitroEntities().entityBySlug({ slug: whatever });
+ * };
+ *
+ * export default (props) => nitroEntityRoute(props, { resolver });
+ * ```
+ */
+declare function nitroEntityRoute<T = any>(props: EntityRouteParams<T>, options: {
+    resolver: EntityResolver<T>;
+    render?: (entity: Entity) => React.ReactNode;
+}): Promise<string | number | bigint | boolean | react_jsx_runtime.JSX.Element | Iterable<react.ReactNode> | null | undefined>;
+/**
+ * Generate metadata for Nitro entities with custom resolver
+ * Works with any route param structure
+ *
+ * @example
+ * ```ts
+ * // app/blog/[slug]/page.tsx
+ * const resolver = async (params: Promise<{ slug: string }>) => {
+ *   const { slug } = await params;
+ *   return getNitroEntities().entityBySlug({ slug, typeId: 123 });
+ * };
+ *
+ * export const generateMetadata = (props) => nitroEntityGenerateMetadata(props, { resolver });
+ * ```
+ */
+declare function nitroEntityGenerateMetadata<T = any>(props: EntityRouteParams<T>, options: {
+    resolver: EntityResolver<T>;
+}): Promise<Metadata>;
 
-export { NitroBlock, NitroPage, getNitroConfig, getNitroEntities, getNitroPages, initNitro };
+export { type EntityResolver, NitroBlock, NitroPage, getNitroConfig, getNitroEntities, getNitroPages, initNitro, nitroEntityGenerateMetadata, nitroEntityRoute, nitroPageGenerateMetadata, nitroPageGenerateStaticParams, nitroPageRoute };

package/dist/server.js

@@ -25,10 +25,16 @@ __export(server_exports, {
   getNitroConfig: () => getNitroConfig,
   getNitroEntities: () => getNitroEntities,
   getNitroPages: () => getNitroPages,
-  initNitro: () => initNitro
+  initNitro: () => initNitro,
+  nitroEntityGenerateMetadata: () => nitroEntityGenerateMetadata,
+  nitroEntityRoute: () => nitroEntityRoute,
+  nitroPageGenerateMetadata: () => nitroPageGenerateMetadata,
+  nitroPageGenerateStaticParams: () => nitroPageGenerateStaticParams,
+  nitroPageRoute: () => nitroPageRoute
 });
 module.exports = __toCommonJS(server_exports);
 var import_react = require("react");
+var import_navigation = require("next/navigation");
 var import_nitro_typescript = require("@flyo/nitro-typescript");
 var import_jsx_runtime = require("react/jsx-runtime");
 var globalConfiguration = null;
@@ -58,6 +64,31 @@ function getNitroPages() {
 function getNitroEntities() {
   return new import_nitro_typescript.EntitiesApi(globalConfiguration);
 }
+var resolveNitroRoute = (0, import_react.cache)(async ({ params }) => {
+  const { slug } = await params;
+  const path = slug?.join("/") ?? "";
+  const cfg = await getNitroConfig();
+  if (!cfg.pages?.includes(path)) {
+    (0, import_navigation.notFound)();
+  }
+  const page = await getNitroPages().page({ slug: path }).catch((error) => {
+    console.error("Error fetching page:", path, error);
+    (0, import_navigation.notFound)();
+  });
+  if (!page) {
+    (0, import_navigation.notFound)();
+  }
+  return { page, path, cfg };
+});
+function createCachedEntityResolver(resolver) {
+  return (0, import_react.cache)(async ({ params }) => {
+    const entity = await resolver(params);
+    if (!entity) {
+      (0, import_navigation.notFound)();
+    }
+    return entity;
+  });
+}
 function NitroPage({
   page
 }) {
@@ -91,6 +122,73 @@ function NitroBlock({
   }
   return null;
 }
+async function nitroPageRoute(props) {
+  const { page } = await resolveNitroRoute(props);
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(NitroPage, { page });
+}
+async function nitroPageGenerateMetadata(props) {
+  const { page } = await resolveNitroRoute(props);
+  const meta = page.meta_json;
+  const title = meta?.title ?? page.title ?? "Page";
+  const description = meta?.description ?? "";
+  const image = meta?.image ?? "";
+  return {
+    title,
+    description,
+    openGraph: {
+      title,
+      description,
+      images: image ? [image] : [],
+      type: "website"
+    },
+    twitter: {
+      card: "summary_large_image",
+      title,
+      description,
+      images: image ? [image] : []
+    }
+  };
+}
+async function nitroPageGenerateStaticParams() {
+  const cfg = await getNitroConfig();
+  const pages = cfg.pages ?? [];
+  return pages.map((path) => ({
+    slug: path === "" ? void 0 : path.split("/")
+  }));
+}
+function nitroEntityRoute(props, options) {
+  const cachedResolver = createCachedEntityResolver(options.resolver);
+  return (async () => {
+    const entity = await cachedResolver(props);
+    if (options.render) {
+      return options.render(entity);
+    }
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { children: entity.entity?.entity_title });
+  })();
+}
+async function nitroEntityGenerateMetadata(props, options) {
+  const cachedResolver = createCachedEntityResolver(options.resolver);
+  const entity = await cachedResolver(props);
+  const title = entity.entity?.entity_title ?? "Entity";
+  const description = entity.entity?.entity_teaser ?? "";
+  const image = entity.entity?.entity_image ?? "";
+  return {
+    title,
+    description,
+    openGraph: {
+      title,
+      description,
+      images: image ? [image] : [],
+      type: "website"
+    },
+    twitter: {
+      card: "summary_large_image",
+      title,
+      description,
+      images: image ? [image] : []
+    }
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   NitroBlock,
@@ -98,6 +196,11 @@ function NitroBlock({
   getNitroConfig,
   getNitroEntities,
   getNitroPages,
-  initNitro
+  initNitro,
+  nitroEntityGenerateMetadata,
+  nitroEntityRoute,
+  nitroPageGenerateMetadata,
+  nitroPageGenerateStaticParams,
+  nitroPageRoute
 });
 //# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/server.tsx"],"sourcesContent":["import { cache } from 'react';\nimport {\n  Page,\n  Block,\n  ConfigApi,\n  ConfigResponse,\n  Configuration,\n  PagesApi,\n  EntitiesApi\n} from '@flyo/nitro-typescript';\n\nlet globalConfiguration: Configuration | null = null;\nlet globalLang: string | null = null;\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nlet globalComponents: Record<string, any> = {};\nlet globalShowMissingComponentAlert: boolean = false;\n\nexport const initNitro = ({accessToken, lang, components, showMissingComponentAlert}: {accessToken: string, lang?: string, components?: object, showMissingComponentAlert?: boolean}): ( () => Configuration )   => {\n\n    if (!globalConfiguration) {\n      globalConfiguration = new Configuration({\n        apiKey: accessToken,\n      });\n    }\n\n    globalLang = lang ?? null;\n    globalComponents = components ?? {};\n    globalShowMissingComponentAlert = showMissingComponentAlert ?? false;\n\n    return () => globalConfiguration!;\n}\n\nexport const getNitroConfig = cache(async (): Promise<ConfigResponse> => {\n\n    const configApi = new ConfigApi(globalConfiguration!);\n    const useLang = globalLang ?? undefined;\n\n    const config = await configApi.config({ lang: useLang });\n    \n    return config;\n});\n\nexport function getNitroPages(): PagesApi {\n  return new PagesApi(globalConfiguration!);\n}\n\nexport function getNitroEntities(): EntitiesApi {\n  return new EntitiesApi(globalConfiguration!);\n}\n\n\n/**\n * NitroPage component renders all blocks from a Flyo page\n */\nexport function NitroPage({\n  page,\n}: {\n  page: Page\n}) {\n  if (!page?.json || !Array.isArray(page.json)) {\n    return null;\n  }\n\n  return (\n    <>\n      {page.json.map((block: Block, index: number) => (\n        <NitroBlock\n          key={block.uid || index}\n          block={block}\n        />\n      ))}\n    </>\n  );\n}\n\nexport function NitroBlock({\n  block,\n}: {\n  block: Block\n}) {\n  if (!block) {\n    return null;\n  }\n\n  const Component = block.component ? globalComponents[block.component] : undefined;\n\n  if (Component) {\n    return <Component block={block} />;\n  }\n\n  if (globalShowMissingComponentAlert) {\n    return (\n      <div style={{ border: '1px solid #fff', padding: '1rem', marginBottom: '1rem', backgroundColor: 'red' }}>\n        Component <b>{block.component}</b> not found.\n      </div>\n    );\n  }\n\n  return null;\n}"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAAsB;AACtB,8BAQO;AAuDH;AArDJ,IAAI,sBAA4C;AAChD,IAAI,aAA4B;AAEhC,IAAI,mBAAwC,CAAC;AAC7C,IAAI,kCAA2C;AAExC,IAAM,YAAY,CAAC,EAAC,aAAa,MAAM,YAAY,0BAAyB,MAAiI;AAEhN,MAAI,CAAC,qBAAqB;AACxB,0BAAsB,IAAI,sCAAc;AAAA,MACtC,QAAQ;AAAA,IACV,CAAC;AAAA,EACH;AAEA,eAAa,QAAQ;AACrB,qBAAmB,cAAc,CAAC;AAClC,oCAAkC,6BAA6B;AAE/D,SAAO,MAAM;AACjB;AAEO,IAAM,qBAAiB,oBAAM,YAAqC;AAErE,QAAM,YAAY,IAAI,kCAAU,mBAAoB;AACpD,QAAM,UAAU,cAAc;AAE9B,QAAM,SAAS,MAAM,UAAU,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEvD,SAAO;AACX,CAAC;AAEM,SAAS,gBAA0B;AACxC,SAAO,IAAI,iCAAS,mBAAoB;AAC1C;AAEO,SAAS,mBAAgC;AAC9C,SAAO,IAAI,oCAAY,mBAAoB;AAC7C;AAMO,SAAS,UAAU;AAAA,EACxB;AACF,GAEG;AACD,MAAI,CAAC,MAAM,QAAQ,CAAC,MAAM,QAAQ,KAAK,IAAI,GAAG;AAC5C,WAAO;AAAA,EACT;AAEA,SACE,2EACG,eAAK,KAAK,IAAI,CAAC,OAAc,UAC5B;AAAA,IAAC;AAAA;AAAA,MAEC;AAAA;AAAA,IADK,MAAM,OAAO;AAAA,EAEpB,CACD,GACH;AAEJ;AAEO,SAAS,WAAW;AAAA,EACzB;AACF,GAEG;AACD,MAAI,CAAC,OAAO;AACV,WAAO;AAAA,EACT;AAEA,QAAM,YAAY,MAAM,YAAY,iBAAiB,MAAM,SAAS,IAAI;AAExE,MAAI,WAAW;AACb,WAAO,4CAAC,aAAU,OAAc;AAAA,EAClC;AAEA,MAAI,iCAAiC;AACnC,WACE,6CAAC,SAAI,OAAO,EAAE,QAAQ,kBAAkB,SAAS,QAAQ,cAAc,QAAQ,iBAAiB,MAAM,GAAG;AAAA;AAAA,MAC7F,4CAAC,OAAG,gBAAM,WAAU;AAAA,MAAI;AAAA,OACpC;AAAA,EAEJ;AAEA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../src/server.tsx"],"sourcesContent":["import { cache } from 'react';\nimport type { Metadata } from 'next';\nimport { notFound } from 'next/navigation';\nimport {\n  Page,\n  Block,\n  Entity,\n  ConfigApi,\n  ConfigResponse,\n  Configuration,\n  PagesApi,\n  EntitiesApi\n} from '@flyo/nitro-typescript';\n\nlet globalConfiguration: Configuration | null = null;\nlet globalLang: string | null = null;\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nlet globalComponents: Record<string, any> = {};\nlet globalShowMissingComponentAlert: boolean = false;\n\nexport const initNitro = ({accessToken, lang, components, showMissingComponentAlert}: {accessToken: string, lang?: string, components?: object, showMissingComponentAlert?: boolean}): ( () => Configuration )   => {\n\n    if (!globalConfiguration) {\n      globalConfiguration = new Configuration({\n        apiKey: accessToken,\n      });\n    }\n\n    globalLang = lang ?? null;\n    globalComponents = components ?? {};\n    globalShowMissingComponentAlert = showMissingComponentAlert ?? false;\n\n    return () => globalConfiguration!;\n}\n\nexport const getNitroConfig = cache(async (): Promise<ConfigResponse> => {\n\n    const configApi = new ConfigApi(globalConfiguration!);\n    const useLang = globalLang ?? undefined;\n\n    const config = await configApi.config({ lang: useLang });\n    \n    return config;\n});\n\nexport function getNitroPages(): PagesApi {\n  return new PagesApi(globalConfiguration!);\n}\n\nexport function getNitroEntities(): EntitiesApi {\n  return new EntitiesApi(globalConfiguration!);\n}\n\n/**\n * Route params type for Next.js catch-all routes\n */\ntype RouteParams = {\n  params: Promise<{ slug?: string[] }>;\n};\n\n/**\n * Generic route params type for entity routes\n * Allows any param structure from Next.js app router\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype EntityRouteParams<T = any> = {\n  params: Promise<T>;\n};\n\n/**\n * Internal helper to resolve Nitro page from route params\n * Uses React cache to avoid duplicate fetching\n */\nconst resolveNitroRoute = cache(async ({ params }: RouteParams) => {\n  const { slug } = await params;\n  const path = slug?.join('/') ?? '';\n\n  const cfg = await getNitroConfig();\n\n  if (!cfg.pages?.includes(path)) {\n    notFound();\n  }\n\n  const page = await getNitroPages()\n    .page({ slug: path })\n    .catch((error: unknown) => {\n      console.error('Error fetching page:', path, error);\n      notFound();\n    });\n\n  if (!page) {\n    notFound();\n  }\n\n  return { page, path, cfg };\n});\n\n/**\n * Entity resolver function type\n * Users provide this to resolve entities from their route params\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type EntityResolver<T = any> = (params: Promise<T>) => Promise<Entity>;\n\n/**\n * Internal helper to wrap and cache entity resolvers\n * Ensures the resolver is only called once per unique params\n */\nfunction createCachedEntityResolver<T>(\n  resolver: EntityResolver<T>\n): (props: EntityRouteParams<T>) => Promise<Entity> {\n  return cache(async ({ params }: EntityRouteParams<T>) => {\n    const entity = await resolver(params);\n    \n    if (!entity) {\n      notFound();\n    }\n    \n    return entity;\n  });\n}\n\n\n/**\n * NitroPage component renders all blocks from a Flyo page\n */\nexport function NitroPage({\n  page,\n}: {\n  page: Page\n}) {\n  if (!page?.json || !Array.isArray(page.json)) {\n    return null;\n  }\n\n  return (\n    <>\n      {page.json.map((block: Block, index: number) => (\n        <NitroBlock\n          key={block.uid || index}\n          block={block}\n        />\n      ))}\n    </>\n  );\n}\n\nexport function NitroBlock({\n  block,\n}: {\n  block: Block\n}) {\n  if (!block) {\n    return null;\n  }\n\n  const Component = block.component ? globalComponents[block.component] : undefined;\n\n  if (Component) {\n    return <Component block={block} />;\n  }\n\n  if (globalShowMissingComponentAlert) {\n    return (\n      <div style={{ border: '1px solid #fff', padding: '1rem', marginBottom: '1rem', backgroundColor: 'red' }}>\n        Component <b>{block.component}</b> not found.\n      </div>\n    );\n  }\n\n  return null;\n}\n\n/**\n * Default page route handler for Nitro pages\n * Can be re-exported directly from Next.js app routes\n * \n * @example\n * ```ts\n * // app/[[...slug]]/page.tsx\n * export { nitroPageRoute as default } from '@flyo/nitro-next/server';\n * ```\n */\nexport async function nitroPageRoute(props: RouteParams) {\n  const { page } = await resolveNitroRoute(props);\n  return <NitroPage page={page} />;\n}\n\n/**\n * Generate metadata for Nitro pages\n * Provides basic meta tags based on Flyo page data\n * Can be re-exported directly from Next.js app routes\n * \n * @example\n * ```ts\n * // app/[[...slug]]/page.tsx\n * export { nitroPageGenerateMetadata as generateMetadata } from '@flyo/nitro-next/server';\n * ```\n */\nexport async function nitroPageGenerateMetadata(\n  props: RouteParams\n): Promise<Metadata> {\n  const { page } = await resolveNitroRoute(props);\n\n  // Extract meta information from page\n  const meta = page.meta_json;\n  \n  const title = meta?.title ?? page.title ?? 'Page';\n  const description = meta?.description ?? '';\n  const image = meta?.image ?? '';\n\n  return {\n    title,\n    description,\n    openGraph: {\n      title,\n      description,\n      images: image ? [image] : [],\n      type: 'website',\n    },\n    twitter: {\n      card: 'summary_large_image',\n      title,\n      description,\n      images: image ? [image] : [],\n    },\n  };\n}\n\n/**\n * Generate static params for all Nitro pages\n * Enables static site generation (SSG) for all pages\n * Can be re-exported directly from Next.js app routes\n * \n * @example\n * ```ts\n * // app/[[...slug]]/page.tsx\n * export { nitroPageGenerateStaticParams as generateStaticParams } from '@flyo/nitro-next/server';\n * ```\n */\nexport async function nitroPageGenerateStaticParams() {\n  const cfg = await getNitroConfig();\n  const pages = cfg.pages ?? [];\n\n  return pages.map((path: string) => ({\n    slug: path === '' ? undefined : path.split('/'),\n  }));\n}\n\n/**\n * Default entity route handler with custom resolver\n * Flexible solution that works with any route param structure\n * \n * @example\n * ```ts\n * // app/blog/[slug]/page.tsx\n * const resolver = async (params: Promise<{ slug: string }>) => {\n *   const { slug } = await params;\n *   return getNitroEntities().entityBySlug({ slug, typeId: 123 });\n * };\n * \n * export default (props) => nitroEntityRoute(props, {\n *   resolver,\n *   render: (entity) => <h1>{entity.entity?.entity_title}</h1>\n * });\n * ```\n * \n * @example\n * ```ts\n * // app/items/[uniqueid]/page.tsx\n * const resolver = async (params: Promise<{ uniqueid: string }>) => {\n *   const { uniqueid } = await params;\n *   return getNitroEntities().entityByUniqueid({ uniqueid });\n * };\n * \n * export default (props) => nitroEntityRoute(props, { resolver });\n * ```\n * \n * @example\n * ```ts\n * // app/custom/[whatever]/page.tsx\n * const resolver = async (params: Promise<{ whatever: string }>) => {\n *   const { whatever } = await params;\n *   return getNitroEntities().entityBySlug({ slug: whatever });\n * };\n * \n * export default (props) => nitroEntityRoute(props, { resolver });\n * ```\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function nitroEntityRoute<T = any>(\n  props: EntityRouteParams<T>,\n  options: {\n    resolver: EntityResolver<T>;\n    render?: (entity: Entity) => React.ReactNode;\n  }\n) {\n  const cachedResolver = createCachedEntityResolver(options.resolver);\n  \n  return (async () => {\n    const entity = await cachedResolver(props);\n    \n    if (options.render) {\n      return options.render(entity);\n    }\n\n    // Default simple render - users should provide their own render function\n    return <div>{entity.entity?.entity_title}</div>;\n  })();\n}\n\n/**\n * Generate metadata for Nitro entities with custom resolver\n * Works with any route param structure\n * \n * @example\n * ```ts\n * // app/blog/[slug]/page.tsx\n * const resolver = async (params: Promise<{ slug: string }>) => {\n *   const { slug } = await params;\n *   return getNitroEntities().entityBySlug({ slug, typeId: 123 });\n * };\n * \n * export const generateMetadata = (props) => nitroEntityGenerateMetadata(props, { resolver });\n * ```\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport async function nitroEntityGenerateMetadata<T = any>(\n  props: EntityRouteParams<T>,\n  options: {\n    resolver: EntityResolver<T>;\n  }\n): Promise<Metadata> {\n  const cachedResolver = createCachedEntityResolver(options.resolver);\n  const entity = await cachedResolver(props);\n\n  const title = entity.entity?.entity_title ?? 'Entity';\n  const description = entity.entity?.entity_teaser ?? '';\n  const image = entity.entity?.entity_image ?? '';\n\n  return {\n    title,\n    description,\n    openGraph: {\n      title,\n      description,\n      images: image ? [image] : [],\n      type: 'website',\n    },\n    twitter: {\n      card: 'summary_large_image',\n      title,\n      description,\n      images: image ? [image] : [],\n    },\n  };\n}"],"mappings":"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","names":[]}

package/dist/server.mjs

@@ -1,5 +1,6 @@
 // src/server.tsx
 import { cache } from "react";
+import { notFound } from "next/navigation";
 import {
   ConfigApi,
   Configuration,
@@ -34,6 +35,31 @@ function getNitroPages() {
 function getNitroEntities() {
   return new EntitiesApi(globalConfiguration);
 }
+var resolveNitroRoute = cache(async ({ params }) => {
+  const { slug } = await params;
+  const path = slug?.join("/") ?? "";
+  const cfg = await getNitroConfig();
+  if (!cfg.pages?.includes(path)) {
+    notFound();
+  }
+  const page = await getNitroPages().page({ slug: path }).catch((error) => {
+    console.error("Error fetching page:", path, error);
+    notFound();
+  });
+  if (!page) {
+    notFound();
+  }
+  return { page, path, cfg };
+});
+function createCachedEntityResolver(resolver) {
+  return cache(async ({ params }) => {
+    const entity = await resolver(params);
+    if (!entity) {
+      notFound();
+    }
+    return entity;
+  });
+}
 function NitroPage({
   page
 }) {
@@ -67,12 +93,84 @@ function NitroBlock({
   }
   return null;
 }
+async function nitroPageRoute(props) {
+  const { page } = await resolveNitroRoute(props);
+  return /* @__PURE__ */ jsx(NitroPage, { page });
+}
+async function nitroPageGenerateMetadata(props) {
+  const { page } = await resolveNitroRoute(props);
+  const meta = page.meta_json;
+  const title = meta?.title ?? page.title ?? "Page";
+  const description = meta?.description ?? "";
+  const image = meta?.image ?? "";
+  return {
+    title,
+    description,
+    openGraph: {
+      title,
+      description,
+      images: image ? [image] : [],
+      type: "website"
+    },
+    twitter: {
+      card: "summary_large_image",
+      title,
+      description,
+      images: image ? [image] : []
+    }
+  };
+}
+async function nitroPageGenerateStaticParams() {
+  const cfg = await getNitroConfig();
+  const pages = cfg.pages ?? [];
+  return pages.map((path) => ({
+    slug: path === "" ? void 0 : path.split("/")
+  }));
+}
+function nitroEntityRoute(props, options) {
+  const cachedResolver = createCachedEntityResolver(options.resolver);
+  return (async () => {
+    const entity = await cachedResolver(props);
+    if (options.render) {
+      return options.render(entity);
+    }
+    return /* @__PURE__ */ jsx("div", { children: entity.entity?.entity_title });
+  })();
+}
+async function nitroEntityGenerateMetadata(props, options) {
+  const cachedResolver = createCachedEntityResolver(options.resolver);
+  const entity = await cachedResolver(props);
+  const title = entity.entity?.entity_title ?? "Entity";
+  const description = entity.entity?.entity_teaser ?? "";
+  const image = entity.entity?.entity_image ?? "";
+  return {
+    title,
+    description,
+    openGraph: {
+      title,
+      description,
+      images: image ? [image] : [],
+      type: "website"
+    },
+    twitter: {
+      card: "summary_large_image",
+      title,
+      description,
+      images: image ? [image] : []
+    }
+  };
+}
 export {
   NitroBlock,
   NitroPage,
   getNitroConfig,
   getNitroEntities,
   getNitroPages,
-  initNitro
+  initNitro,
+  nitroEntityGenerateMetadata,
+  nitroEntityRoute,
+  nitroPageGenerateMetadata,
+  nitroPageGenerateStaticParams,
+  nitroPageRoute
 };
 //# sourceMappingURL=server.mjs.map

package/dist/server.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/server.tsx"],"sourcesContent":["import { cache } from 'react';\nimport {\n  Page,\n  Block,\n  ConfigApi,\n  ConfigResponse,\n  Configuration,\n  PagesApi,\n  EntitiesApi\n} from '@flyo/nitro-typescript';\n\nlet globalConfiguration: Configuration | null = null;\nlet globalLang: string | null = null;\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nlet globalComponents: Record<string, any> = {};\nlet globalShowMissingComponentAlert: boolean = false;\n\nexport const initNitro = ({accessToken, lang, components, showMissingComponentAlert}: {accessToken: string, lang?: string, components?: object, showMissingComponentAlert?: boolean}): ( () => Configuration )   => {\n\n    if (!globalConfiguration) {\n      globalConfiguration = new Configuration({\n        apiKey: accessToken,\n      });\n    }\n\n    globalLang = lang ?? null;\n    globalComponents = components ?? {};\n    globalShowMissingComponentAlert = showMissingComponentAlert ?? false;\n\n    return () => globalConfiguration!;\n}\n\nexport const getNitroConfig = cache(async (): Promise<ConfigResponse> => {\n\n    const configApi = new ConfigApi(globalConfiguration!);\n    const useLang = globalLang ?? undefined;\n\n    const config = await configApi.config({ lang: useLang });\n    \n    return config;\n});\n\nexport function getNitroPages(): PagesApi {\n  return new PagesApi(globalConfiguration!);\n}\n\nexport function getNitroEntities(): EntitiesApi {\n  return new EntitiesApi(globalConfiguration!);\n}\n\n\n/**\n * NitroPage component renders all blocks from a Flyo page\n */\nexport function NitroPage({\n  page,\n}: {\n  page: Page\n}) {\n  if (!page?.json || !Array.isArray(page.json)) {\n    return null;\n  }\n\n  return (\n    <>\n      {page.json.map((block: Block, index: number) => (\n        <NitroBlock\n          key={block.uid || index}\n          block={block}\n        />\n      ))}\n    </>\n  );\n}\n\nexport function NitroBlock({\n  block,\n}: {\n  block: Block\n}) {\n  if (!block) {\n    return null;\n  }\n\n  const Component = block.component ? globalComponents[block.component] : undefined;\n\n  if (Component) {\n    return <Component block={block} />;\n  }\n\n  if (globalShowMissingComponentAlert) {\n    return (\n      <div style={{ border: '1px solid #fff', padding: '1rem', marginBottom: '1rem', backgroundColor: 'red' }}>\n        Component <b>{block.component}</b> not found.\n      </div>\n    );\n  }\n\n  return null;\n}"],"mappings":";AAAA,SAAS,aAAa;AACtB;AAAA,EAGE;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAuDH,mBAEI,KA0BF,YA5BF;AArDJ,IAAI,sBAA4C;AAChD,IAAI,aAA4B;AAEhC,IAAI,mBAAwC,CAAC;AAC7C,IAAI,kCAA2C;AAExC,IAAM,YAAY,CAAC,EAAC,aAAa,MAAM,YAAY,0BAAyB,MAAiI;AAEhN,MAAI,CAAC,qBAAqB;AACxB,0BAAsB,IAAI,cAAc;AAAA,MACtC,QAAQ;AAAA,IACV,CAAC;AAAA,EACH;AAEA,eAAa,QAAQ;AACrB,qBAAmB,cAAc,CAAC;AAClC,oCAAkC,6BAA6B;AAE/D,SAAO,MAAM;AACjB;AAEO,IAAM,iBAAiB,MAAM,YAAqC;AAErE,QAAM,YAAY,IAAI,UAAU,mBAAoB;AACpD,QAAM,UAAU,cAAc;AAE9B,QAAM,SAAS,MAAM,UAAU,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEvD,SAAO;AACX,CAAC;AAEM,SAAS,gBAA0B;AACxC,SAAO,IAAI,SAAS,mBAAoB;AAC1C;AAEO,SAAS,mBAAgC;AAC9C,SAAO,IAAI,YAAY,mBAAoB;AAC7C;AAMO,SAAS,UAAU;AAAA,EACxB;AACF,GAEG;AACD,MAAI,CAAC,MAAM,QAAQ,CAAC,MAAM,QAAQ,KAAK,IAAI,GAAG;AAC5C,WAAO;AAAA,EACT;AAEA,SACE,gCACG,eAAK,KAAK,IAAI,CAAC,OAAc,UAC5B;AAAA,IAAC;AAAA;AAAA,MAEC;AAAA;AAAA,IADK,MAAM,OAAO;AAAA,EAEpB,CACD,GACH;AAEJ;AAEO,SAAS,WAAW;AAAA,EACzB;AACF,GAEG;AACD,MAAI,CAAC,OAAO;AACV,WAAO;AAAA,EACT;AAEA,QAAM,YAAY,MAAM,YAAY,iBAAiB,MAAM,SAAS,IAAI;AAExE,MAAI,WAAW;AACb,WAAO,oBAAC,aAAU,OAAc;AAAA,EAClC;AAEA,MAAI,iCAAiC;AACnC,WACE,qBAAC,SAAI,OAAO,EAAE,QAAQ,kBAAkB,SAAS,QAAQ,cAAc,QAAQ,iBAAiB,MAAM,GAAG;AAAA;AAAA,MAC7F,oBAAC,OAAG,gBAAM,WAAU;AAAA,MAAI;AAAA,OACpC;AAAA,EAEJ;AAEA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../src/server.tsx"],"sourcesContent":["import { cache } from 'react';\nimport type { Metadata } from 'next';\nimport { notFound } from 'next/navigation';\nimport {\n  Page,\n  Block,\n  Entity,\n  ConfigApi,\n  ConfigResponse,\n  Configuration,\n  PagesApi,\n  EntitiesApi\n} from '@flyo/nitro-typescript';\n\nlet globalConfiguration: Configuration | null = null;\nlet globalLang: string | null = null;\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nlet globalComponents: Record<string, any> = {};\nlet globalShowMissingComponentAlert: boolean = false;\n\nexport const initNitro = ({accessToken, lang, components, showMissingComponentAlert}: {accessToken: string, lang?: string, components?: object, showMissingComponentAlert?: boolean}): ( () => Configuration )   => {\n\n    if (!globalConfiguration) {\n      globalConfiguration = new Configuration({\n        apiKey: accessToken,\n      });\n    }\n\n    globalLang = lang ?? null;\n    globalComponents = components ?? {};\n    globalShowMissingComponentAlert = showMissingComponentAlert ?? false;\n\n    return () => globalConfiguration!;\n}\n\nexport const getNitroConfig = cache(async (): Promise<ConfigResponse> => {\n\n    const configApi = new ConfigApi(globalConfiguration!);\n    const useLang = globalLang ?? undefined;\n\n    const config = await configApi.config({ lang: useLang });\n    \n    return config;\n});\n\nexport function getNitroPages(): PagesApi {\n  return new PagesApi(globalConfiguration!);\n}\n\nexport function getNitroEntities(): EntitiesApi {\n  return new EntitiesApi(globalConfiguration!);\n}\n\n/**\n * Route params type for Next.js catch-all routes\n */\ntype RouteParams = {\n  params: Promise<{ slug?: string[] }>;\n};\n\n/**\n * Generic route params type for entity routes\n * Allows any param structure from Next.js app router\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype EntityRouteParams<T = any> = {\n  params: Promise<T>;\n};\n\n/**\n * Internal helper to resolve Nitro page from route params\n * Uses React cache to avoid duplicate fetching\n */\nconst resolveNitroRoute = cache(async ({ params }: RouteParams) => {\n  const { slug } = await params;\n  const path = slug?.join('/') ?? '';\n\n  const cfg = await getNitroConfig();\n\n  if (!cfg.pages?.includes(path)) {\n    notFound();\n  }\n\n  const page = await getNitroPages()\n    .page({ slug: path })\n    .catch((error: unknown) => {\n      console.error('Error fetching page:', path, error);\n      notFound();\n    });\n\n  if (!page) {\n    notFound();\n  }\n\n  return { page, path, cfg };\n});\n\n/**\n * Entity resolver function type\n * Users provide this to resolve entities from their route params\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type EntityResolver<T = any> = (params: Promise<T>) => Promise<Entity>;\n\n/**\n * Internal helper to wrap and cache entity resolvers\n * Ensures the resolver is only called once per unique params\n */\nfunction createCachedEntityResolver<T>(\n  resolver: EntityResolver<T>\n): (props: EntityRouteParams<T>) => Promise<Entity> {\n  return cache(async ({ params }: EntityRouteParams<T>) => {\n    const entity = await resolver(params);\n    \n    if (!entity) {\n      notFound();\n    }\n    \n    return entity;\n  });\n}\n\n\n/**\n * NitroPage component renders all blocks from a Flyo page\n */\nexport function NitroPage({\n  page,\n}: {\n  page: Page\n}) {\n  if (!page?.json || !Array.isArray(page.json)) {\n    return null;\n  }\n\n  return (\n    <>\n      {page.json.map((block: Block, index: number) => (\n        <NitroBlock\n          key={block.uid || index}\n          block={block}\n        />\n      ))}\n    </>\n  );\n}\n\nexport function NitroBlock({\n  block,\n}: {\n  block: Block\n}) {\n  if (!block) {\n    return null;\n  }\n\n  const Component = block.component ? globalComponents[block.component] : undefined;\n\n  if (Component) {\n    return <Component block={block} />;\n  }\n\n  if (globalShowMissingComponentAlert) {\n    return (\n      <div style={{ border: '1px solid #fff', padding: '1rem', marginBottom: '1rem', backgroundColor: 'red' }}>\n        Component <b>{block.component}</b> not found.\n      </div>\n    );\n  }\n\n  return null;\n}\n\n/**\n * Default page route handler for Nitro pages\n * Can be re-exported directly from Next.js app routes\n * \n * @example\n * ```ts\n * // app/[[...slug]]/page.tsx\n * export { nitroPageRoute as default } from '@flyo/nitro-next/server';\n * ```\n */\nexport async function nitroPageRoute(props: RouteParams) {\n  const { page } = await resolveNitroRoute(props);\n  return <NitroPage page={page} />;\n}\n\n/**\n * Generate metadata for Nitro pages\n * Provides basic meta tags based on Flyo page data\n * Can be re-exported directly from Next.js app routes\n * \n * @example\n * ```ts\n * // app/[[...slug]]/page.tsx\n * export { nitroPageGenerateMetadata as generateMetadata } from '@flyo/nitro-next/server';\n * ```\n */\nexport async function nitroPageGenerateMetadata(\n  props: RouteParams\n): Promise<Metadata> {\n  const { page } = await resolveNitroRoute(props);\n\n  // Extract meta information from page\n  const meta = page.meta_json;\n  \n  const title = meta?.title ?? page.title ?? 'Page';\n  const description = meta?.description ?? '';\n  const image = meta?.image ?? '';\n\n  return {\n    title,\n    description,\n    openGraph: {\n      title,\n      description,\n      images: image ? [image] : [],\n      type: 'website',\n    },\n    twitter: {\n      card: 'summary_large_image',\n      title,\n      description,\n      images: image ? [image] : [],\n    },\n  };\n}\n\n/**\n * Generate static params for all Nitro pages\n * Enables static site generation (SSG) for all pages\n * Can be re-exported directly from Next.js app routes\n * \n * @example\n * ```ts\n * // app/[[...slug]]/page.tsx\n * export { nitroPageGenerateStaticParams as generateStaticParams } from '@flyo/nitro-next/server';\n * ```\n */\nexport async function nitroPageGenerateStaticParams() {\n  const cfg = await getNitroConfig();\n  const pages = cfg.pages ?? [];\n\n  return pages.map((path: string) => ({\n    slug: path === '' ? undefined : path.split('/'),\n  }));\n}\n\n/**\n * Default entity route handler with custom resolver\n * Flexible solution that works with any route param structure\n * \n * @example\n * ```ts\n * // app/blog/[slug]/page.tsx\n * const resolver = async (params: Promise<{ slug: string }>) => {\n *   const { slug } = await params;\n *   return getNitroEntities().entityBySlug({ slug, typeId: 123 });\n * };\n * \n * export default (props) => nitroEntityRoute(props, {\n *   resolver,\n *   render: (entity) => <h1>{entity.entity?.entity_title}</h1>\n * });\n * ```\n * \n * @example\n * ```ts\n * // app/items/[uniqueid]/page.tsx\n * const resolver = async (params: Promise<{ uniqueid: string }>) => {\n *   const { uniqueid } = await params;\n *   return getNitroEntities().entityByUniqueid({ uniqueid });\n * };\n * \n * export default (props) => nitroEntityRoute(props, { resolver });\n * ```\n * \n * @example\n * ```ts\n * // app/custom/[whatever]/page.tsx\n * const resolver = async (params: Promise<{ whatever: string }>) => {\n *   const { whatever } = await params;\n *   return getNitroEntities().entityBySlug({ slug: whatever });\n * };\n * \n * export default (props) => nitroEntityRoute(props, { resolver });\n * ```\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function nitroEntityRoute<T = any>(\n  props: EntityRouteParams<T>,\n  options: {\n    resolver: EntityResolver<T>;\n    render?: (entity: Entity) => React.ReactNode;\n  }\n) {\n  const cachedResolver = createCachedEntityResolver(options.resolver);\n  \n  return (async () => {\n    const entity = await cachedResolver(props);\n    \n    if (options.render) {\n      return options.render(entity);\n    }\n\n    // Default simple render - users should provide their own render function\n    return <div>{entity.entity?.entity_title}</div>;\n  })();\n}\n\n/**\n * Generate metadata for Nitro entities with custom resolver\n * Works with any route param structure\n * \n * @example\n * ```ts\n * // app/blog/[slug]/page.tsx\n * const resolver = async (params: Promise<{ slug: string }>) => {\n *   const { slug } = await params;\n *   return getNitroEntities().entityBySlug({ slug, typeId: 123 });\n * };\n * \n * export const generateMetadata = (props) => nitroEntityGenerateMetadata(props, { resolver });\n * ```\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport async function nitroEntityGenerateMetadata<T = any>(\n  props: EntityRouteParams<T>,\n  options: {\n    resolver: EntityResolver<T>;\n  }\n): Promise<Metadata> {\n  const cachedResolver = createCachedEntityResolver(options.resolver);\n  const entity = await cachedResolver(props);\n\n  const title = entity.entity?.entity_title ?? 'Entity';\n  const description = entity.entity?.entity_teaser ?? '';\n  const image = entity.entity?.entity_image ?? '';\n\n  return {\n    title,\n    description,\n    openGraph: {\n      title,\n      description,\n      images: image ? [image] : [],\n      type: 'website',\n    },\n    twitter: {\n      card: 'summary_large_image',\n      title,\n      description,\n      images: image ? [image] : [],\n    },\n  };\n}"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flyo/nitro-next",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Connecting Flyo Headless Content Hub into your Next.js project.",
   "homepage": "https://dev.flyo.cloud/nitro",
   "keywords": [