@carlonicora/nextjs-jsonapi 1.107.1 → 1.109.0

package/dist/features/help/server/createHelpAssetRouteHandler.js

@@ -0,0 +1,43 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
+
+var _chunk7QVYU63Ejs = require('../../../chunk-7QVYU63E.js');
+
+// src/features/help/server/createHelpAssetRouteHandler.ts
+var _server = require('next/server');
+var _promises = require('fs/promises');
+var _path = require('path');
+var MIME = {
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".webp": "image/webp",
+  ".gif": "image/gif",
+  ".svg": "image/svg+xml",
+  ".mp4": "video/mp4",
+  ".webm": "video/webm"
+};
+function createHelpAssetRouteHandler({ srcRoot }) {
+  return /* @__PURE__ */ _chunk7QVYU63Ejs.__name.call(void 0, async function GET(_req, { params }) {
+    const { path } = await params;
+    const safe = path.filter((p) => p !== ".." && !p.includes("/")).join("/");
+    const filePath = _path.join.call(void 0, srcRoot, safe);
+    try {
+      const s = await _promises.stat.call(void 0, filePath);
+      if (!s.isFile()) return new (0, _server.NextResponse)("Not found", { status: 404 });
+      const ext = filePath.toLowerCase().slice(filePath.lastIndexOf("."));
+      const mime = _nullishCoalesce(MIME[ext], () => ( "application/octet-stream"));
+      const data = await _promises.readFile.call(void 0, filePath);
+      return new (0, _server.NextResponse)(data, {
+        status: 200,
+        headers: { "Content-Type": mime, "Cache-Control": "public, max-age=3600" }
+      });
+    } catch (e) {
+      return new (0, _server.NextResponse)("Not found", { status: 404 });
+    }
+  }, "GET");
+}
+_chunk7QVYU63Ejs.__name.call(void 0, createHelpAssetRouteHandler, "createHelpAssetRouteHandler");
+
+
+exports.createHelpAssetRouteHandler = createHelpAssetRouteHandler;
+//# sourceMappingURL=createHelpAssetRouteHandler.js.map

package/dist/features/help/server/createHelpAssetRouteHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/nextjs-jsonapi/nextjs-jsonapi/dist/features/help/server/createHelpAssetRouteHandler.js","../../../../src/features/help/server/createHelpAssetRouteHandler.ts"],"names":[],"mappings":"AAAA;AACE;AACF,6DAAmC;AACnC;AACA;ACJA,qCAA6B;AAC7B,uCAA+B;AAC/B,4BAAqB;AAErB,IAAM,KAAA,EAA+B;AAAA,EACnC,MAAA,EAAQ,WAAA;AAAA,EACR,MAAA,EAAQ,YAAA;AAAA,EACR,OAAA,EAAS,YAAA;AAAA,EACT,OAAA,EAAS,YAAA;AAAA,EACT,MAAA,EAAQ,WAAA;AAAA,EACR,MAAA,EAAQ,eAAA;AAAA,EACR,MAAA,EAAQ,WAAA;AAAA,EACR,OAAA,EAAS;AACX,CAAA;AAEO,SAAS,2BAAA,CAA4B,EAAE,QAAQ,CAAA,EAAwB;AAC5E,EAAA,uBAAO,qCAAA,MAAA,SAAe,GAAA,CAAI,IAAA,EAAe,EAAE,OAAO,CAAA,EAA4C;AAC5F,IAAA,MAAM,EAAE,KAAK,EAAA,EAAI,MAAM,MAAA;AACvB,IAAA,MAAM,KAAA,EAAO,IAAA,CAAK,MAAA,CAAO,CAAC,CAAA,EAAA,GAAM,EAAA,IAAM,KAAA,GAAQ,CAAC,CAAA,CAAE,QAAA,CAAS,GAAG,CAAC,CAAA,CAAE,IAAA,CAAK,GAAG,CAAA;AACxE,IAAA,MAAM,SAAA,EAAW,wBAAA,OAAK,EAAS,IAAI,CAAA;AACnC,IAAA,IAAI;AACF,MAAA,MAAM,EAAA,EAAI,MAAM,4BAAA,QAAa,CAAA;AAC7B,MAAA,GAAA,CAAI,CAAC,CAAA,CAAE,MAAA,CAAO,CAAA,EAAG,OAAO,IAAI,yBAAA,CAAa,WAAA,EAAa,EAAE,MAAA,EAAQ,IAAI,CAAC,CAAA;AACrE,MAAA,MAAM,IAAA,EAAM,QAAA,CAAS,WAAA,CAAY,CAAA,CAAE,KAAA,CAAM,QAAA,CAAS,WAAA,CAAY,GAAG,CAAC,CAAA;AAClE,MAAA,MAAM,KAAA,mBAAO,IAAA,CAAK,GAAG,CAAA,UAAK,4BAAA;AAC1B,MAAA,MAAM,KAAA,EAAO,MAAM,gCAAA,QAAiB,CAAA;AACpC,MAAA,OAAO,IAAI,yBAAA,CAAa,IAAA,EAAM;AAAA,QAC5B,MAAA,EAAQ,GAAA;AAAA,QACR,OAAA,EAAS,EAAE,cAAA,EAAgB,IAAA,EAAM,eAAA,EAAiB,uBAAuB;AAAA,MAC3E,CAAC,CAAA;AAAA,IACH,EAAA,UAAQ;AACN,MAAA,OAAO,IAAI,yBAAA,CAAa,WAAA,EAAa,EAAE,MAAA,EAAQ,IAAI,CAAC,CAAA;AAAA,IACtD;AAAA,EACF,CAAA,EAjBO,KAAA,CAAA;AAkBT;AAnBgB,qCAAA,2BAAA,EAAA,6BAAA,CAAA;ADwBhB;AACE;AACF,kEAAC","file":"/home/runner/work/nextjs-jsonapi/nextjs-jsonapi/dist/features/help/server/createHelpAssetRouteHandler.js","sourcesContent":[null,"import { NextResponse } from \"next/server\";\nimport { readFile, stat } from \"node:fs/promises\";\nimport { join } from \"node:path\";\n\nconst MIME: Record<string, string> = {\n  \".png\": \"image/png\",\n  \".jpg\": \"image/jpeg\",\n  \".jpeg\": \"image/jpeg\",\n  \".webp\": \"image/webp\",\n  \".gif\": \"image/gif\",\n  \".svg\": \"image/svg+xml\",\n  \".mp4\": \"video/mp4\",\n  \".webm\": \"video/webm\",\n};\n\nexport function createHelpAssetRouteHandler({ srcRoot }: { srcRoot: string }) {\n  return async function GET(_req: Request, { params }: { params: Promise<{ path: string[] }> }) {\n    const { path } = await params;\n    const safe = path.filter((p) => p !== \"..\" && !p.includes(\"/\")).join(\"/\");\n    const filePath = join(srcRoot, safe);\n    try {\n      const s = await stat(filePath);\n      if (!s.isFile()) return new NextResponse(\"Not found\", { status: 404 });\n      const ext = filePath.toLowerCase().slice(filePath.lastIndexOf(\".\"));\n      const mime = MIME[ext] ?? \"application/octet-stream\";\n      const data = await readFile(filePath);\n      return new NextResponse(data, {\n        status: 200,\n        headers: { \"Content-Type\": mime, \"Cache-Control\": \"public, max-age=3600\" },\n      });\n    } catch {\n      return new NextResponse(\"Not found\", { status: 404 });\n    }\n  };\n}\n"]}

package/dist/features/help/server/createHelpAssetRouteHandler.mjs

@@ -0,0 +1,43 @@
+import {
+  __name
+} from "../../../chunk-PAWJFY3S.mjs";
+
+// src/features/help/server/createHelpAssetRouteHandler.ts
+import { NextResponse } from "next/server";
+import { readFile, stat } from "fs/promises";
+import { join } from "path";
+var MIME = {
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".webp": "image/webp",
+  ".gif": "image/gif",
+  ".svg": "image/svg+xml",
+  ".mp4": "video/mp4",
+  ".webm": "video/webm"
+};
+function createHelpAssetRouteHandler({ srcRoot }) {
+  return /* @__PURE__ */ __name(async function GET(_req, { params }) {
+    const { path } = await params;
+    const safe = path.filter((p) => p !== ".." && !p.includes("/")).join("/");
+    const filePath = join(srcRoot, safe);
+    try {
+      const s = await stat(filePath);
+      if (!s.isFile()) return new NextResponse("Not found", { status: 404 });
+      const ext = filePath.toLowerCase().slice(filePath.lastIndexOf("."));
+      const mime = MIME[ext] ?? "application/octet-stream";
+      const data = await readFile(filePath);
+      return new NextResponse(data, {
+        status: 200,
+        headers: { "Content-Type": mime, "Cache-Control": "public, max-age=3600" }
+      });
+    } catch {
+      return new NextResponse("Not found", { status: 404 });
+    }
+  }, "GET");
+}
+__name(createHelpAssetRouteHandler, "createHelpAssetRouteHandler");
+export {
+  createHelpAssetRouteHandler
+};
+//# sourceMappingURL=createHelpAssetRouteHandler.mjs.map

package/dist/features/help/server/createHelpAssetRouteHandler.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/features/help/server/createHelpAssetRouteHandler.ts"],"sourcesContent":["import { NextResponse } from \"next/server\";\nimport { readFile, stat } from \"node:fs/promises\";\nimport { join } from \"node:path\";\n\nconst MIME: Record<string, string> = {\n  \".png\": \"image/png\",\n  \".jpg\": \"image/jpeg\",\n  \".jpeg\": \"image/jpeg\",\n  \".webp\": \"image/webp\",\n  \".gif\": \"image/gif\",\n  \".svg\": \"image/svg+xml\",\n  \".mp4\": \"video/mp4\",\n  \".webm\": \"video/webm\",\n};\n\nexport function createHelpAssetRouteHandler({ srcRoot }: { srcRoot: string }) {\n  return async function GET(_req: Request, { params }: { params: Promise<{ path: string[] }> }) {\n    const { path } = await params;\n    const safe = path.filter((p) => p !== \"..\" && !p.includes(\"/\")).join(\"/\");\n    const filePath = join(srcRoot, safe);\n    try {\n      const s = await stat(filePath);\n      if (!s.isFile()) return new NextResponse(\"Not found\", { status: 404 });\n      const ext = filePath.toLowerCase().slice(filePath.lastIndexOf(\".\"));\n      const mime = MIME[ext] ?? \"application/octet-stream\";\n      const data = await readFile(filePath);\n      return new NextResponse(data, {\n        status: 200,\n        headers: { \"Content-Type\": mime, \"Cache-Control\": \"public, max-age=3600\" },\n      });\n    } catch {\n      return new NextResponse(\"Not found\", { status: 404 });\n    }\n  };\n}\n"],"mappings":";;;;;AAAA,SAAS,oBAAoB;AAC7B,SAAS,UAAU,YAAY;AAC/B,SAAS,YAAY;AAErB,IAAM,OAA+B;AAAA,EACnC,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,SAAS;AACX;AAEO,SAAS,4BAA4B,EAAE,QAAQ,GAAwB;AAC5E,SAAO,sCAAe,IAAI,MAAe,EAAE,OAAO,GAA4C;AAC5F,UAAM,EAAE,KAAK,IAAI,MAAM;AACvB,UAAM,OAAO,KAAK,OAAO,CAAC,MAAM,MAAM,QAAQ,CAAC,EAAE,SAAS,GAAG,CAAC,EAAE,KAAK,GAAG;AACxE,UAAM,WAAW,KAAK,SAAS,IAAI;AACnC,QAAI;AACF,YAAM,IAAI,MAAM,KAAK,QAAQ;AAC7B,UAAI,CAAC,EAAE,OAAO,EAAG,QAAO,IAAI,aAAa,aAAa,EAAE,QAAQ,IAAI,CAAC;AACrE,YAAM,MAAM,SAAS,YAAY,EAAE,MAAM,SAAS,YAAY,GAAG,CAAC;AAClE,YAAM,OAAO,KAAK,GAAG,KAAK;AAC1B,YAAM,OAAO,MAAM,SAAS,QAAQ;AACpC,aAAO,IAAI,aAAa,MAAM;AAAA,QAC5B,QAAQ;AAAA,QACR,SAAS,EAAE,gBAAgB,MAAM,iBAAiB,uBAAuB;AAAA,MAC3E,CAAC;AAAA,IACH,QAAQ;AACN,aAAO,IAAI,aAAa,aAAa,EAAE,QAAQ,IAAI,CAAC;AAAA,IACtD;AAAA,EACF,GAjBO;AAkBT;AAnBgB;","names":[]}

package/dist/features/help/server.d.mts

@@ -0,0 +1,71 @@
+import { H as HelpContentConfig, a as HelpArticle, b as HelpMode } from '../../help-content-config.interface-B9L02u9i.mjs';
+export { d as HELP_MODES, c as HelpBrandConfig, e as HelpHeading, f as HelpRedirect } from '../../help-content-config.interface-B9L02u9i.mjs';
+import { ReactElement } from 'react';
+import { Metadata } from 'next';
+
+/**
+ * Server-side accessor for the help-content config set via configureJsonApi().
+ * Returns the same value <HelpProvider> exposes via React Context to client components.
+ * Throws with a setup error if helpContent was never configured.
+ */
+declare function getHelpContent(): HelpContentConfig;
+
+/**
+ * Server-side: read the article's raw markdown via the registered help reader
+ * and render it through `next-mdx-remote/rsc`'s server-side MDXRemote, using
+ * the server-safe MDX components (Callout, Steps, Screenshot, EntityRef,
+ * KeyBinding, Video). The returned React element can be embedded inside a
+ * server component (e.g. as `children` of `<HelpArticleBody>`).
+ *
+ * Note: `<Related>` is intentionally not part of the server map — it's a client
+ * component that reads HelpContext. Articles that reference `<Related>` would
+ * need a separate render path that injects the manifest by prop.
+ */
+declare function renderHelpArticle(article: HelpArticle): Promise<ReactElement>;
+/** @deprecated Use `renderHelpArticle` instead — the legacy serialize + client
+ *  MDXRemote pattern is incompatible with App Router RSC. */
+declare const serializeHelpArticle: typeof renderHelpArticle;
+
+declare function generateHelpArticleStaticParams(): {
+    mode: string;
+    slug: string;
+}[];
+
+declare function generateHelpArticleMetadata({ params, }: {
+    params: Promise<{
+        mode: string;
+        slug: string;
+    }>;
+}): Promise<Metadata>;
+
+declare function generateHelpModeStaticParams(): {
+    mode: string;
+}[];
+
+interface HelpNavGroup {
+    mode: HelpMode;
+    articles: HelpArticle[];
+}
+declare function buildHelpNav(manifest: readonly HelpArticle[]): HelpNavGroup[];
+declare function findHelpArticle(manifest: readonly HelpArticle[], mode: string, slug: string): HelpArticle | undefined;
+declare function prevNextWithinMode(manifest: readonly HelpArticle[], current: HelpArticle): {
+    prev: HelpArticle | null;
+    next: HelpArticle | null;
+};
+
+/**
+ * Centralized help-content store accessible from client and server contexts.
+ * Uses globalThis Symbol keys to persist across HMR/Turbopack reloads and to
+ * bridge between the client-side `configureJsonApi` (in `client/config.ts`)
+ * and server-side consumers (HelpProvider, getHelpContent, serializeHelpArticle).
+ *
+ * NO external dependencies to avoid circular imports.
+ *
+ * Pattern mirrors `bootstrapStore.ts`.
+ */
+type HelpReader = (article: {
+    path: string;
+}) => Promise<string>;
+declare function setHelpReader(reader: HelpReader): void;
+
+export { HelpArticle, HelpContentConfig, HelpMode, buildHelpNav, findHelpArticle, generateHelpArticleMetadata, generateHelpArticleStaticParams, generateHelpModeStaticParams, getHelpContent, prevNextWithinMode, renderHelpArticle, serializeHelpArticle, setHelpReader };

package/dist/features/help/server.d.ts

@@ -0,0 +1,71 @@
+import { H as HelpContentConfig, a as HelpArticle, b as HelpMode } from '../../help-content-config.interface-B9L02u9i.js';
+export { d as HELP_MODES, c as HelpBrandConfig, e as HelpHeading, f as HelpRedirect } from '../../help-content-config.interface-B9L02u9i.js';
+import { ReactElement } from 'react';
+import { Metadata } from 'next';
+
+/**
+ * Server-side accessor for the help-content config set via configureJsonApi().
+ * Returns the same value <HelpProvider> exposes via React Context to client components.
+ * Throws with a setup error if helpContent was never configured.
+ */
+declare function getHelpContent(): HelpContentConfig;
+
+/**
+ * Server-side: read the article's raw markdown via the registered help reader
+ * and render it through `next-mdx-remote/rsc`'s server-side MDXRemote, using
+ * the server-safe MDX components (Callout, Steps, Screenshot, EntityRef,
+ * KeyBinding, Video). The returned React element can be embedded inside a
+ * server component (e.g. as `children` of `<HelpArticleBody>`).
+ *
+ * Note: `<Related>` is intentionally not part of the server map — it's a client
+ * component that reads HelpContext. Articles that reference `<Related>` would
+ * need a separate render path that injects the manifest by prop.
+ */
+declare function renderHelpArticle(article: HelpArticle): Promise<ReactElement>;
+/** @deprecated Use `renderHelpArticle` instead — the legacy serialize + client
+ *  MDXRemote pattern is incompatible with App Router RSC. */
+declare const serializeHelpArticle: typeof renderHelpArticle;
+
+declare function generateHelpArticleStaticParams(): {
+    mode: string;
+    slug: string;
+}[];
+
+declare function generateHelpArticleMetadata({ params, }: {
+    params: Promise<{
+        mode: string;
+        slug: string;
+    }>;
+}): Promise<Metadata>;
+
+declare function generateHelpModeStaticParams(): {
+    mode: string;
+}[];
+
+interface HelpNavGroup {
+    mode: HelpMode;
+    articles: HelpArticle[];
+}
+declare function buildHelpNav(manifest: readonly HelpArticle[]): HelpNavGroup[];
+declare function findHelpArticle(manifest: readonly HelpArticle[], mode: string, slug: string): HelpArticle | undefined;
+declare function prevNextWithinMode(manifest: readonly HelpArticle[], current: HelpArticle): {
+    prev: HelpArticle | null;
+    next: HelpArticle | null;
+};
+
+/**
+ * Centralized help-content store accessible from client and server contexts.
+ * Uses globalThis Symbol keys to persist across HMR/Turbopack reloads and to
+ * bridge between the client-side `configureJsonApi` (in `client/config.ts`)
+ * and server-side consumers (HelpProvider, getHelpContent, serializeHelpArticle).
+ *
+ * NO external dependencies to avoid circular imports.
+ *
+ * Pattern mirrors `bootstrapStore.ts`.
+ */
+type HelpReader = (article: {
+    path: string;
+}) => Promise<string>;
+declare function setHelpReader(reader: HelpReader): void;
+
+export { HelpArticle, HelpContentConfig, HelpMode, buildHelpNav, findHelpArticle, generateHelpArticleMetadata, generateHelpArticleStaticParams, generateHelpModeStaticParams, getHelpContent, prevNextWithinMode, renderHelpArticle, serializeHelpArticle, setHelpReader };

package/dist/features/help/server.js

@@ -0,0 +1,123 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+
+
+
+
+
+
+
+
+
+
+var _chunk3J7RQBF3js = require('../../chunk-3J7RQBF3.js');
+
+
+
+
+var _chunkYQQHAFBSjs = require('../../chunk-YQQHAFBS.js');
+require('../../chunk-CFI4WZ5R.js');
+require('../../chunk-LXKSUWAV.js');
+require('../../chunk-IBS6NI7D.js');
+require('../../chunk-J5LROFGL.js');
+
+
+var _chunk7QVYU63Ejs = require('../../chunk-7QVYU63E.js');
+
+// src/features/help/server/getHelpContent.ts
+function getHelpContent() {
+  const cfg = _chunkYQQHAFBSjs._getStaticHelpContent.call(void 0, );
+  if (!cfg) {
+    throw new Error(
+      "Help content not configured \u2014 call configureJsonApi({ helpContent: {...} }) before importing help pages."
+    );
+  }
+  return cfg;
+}
+_chunk7QVYU63Ejs.__name.call(void 0, getHelpContent, "getHelpContent");
+
+// src/features/help/server/serializeHelpArticle.tsx
+var _rsc = require('next-mdx-remote/rsc');
+var _remarkgfm = require('remark-gfm'); var _remarkgfm2 = _interopRequireDefault(_remarkgfm);
+var _rehypeslug = require('rehype-slug'); var _rehypeslug2 = _interopRequireDefault(_rehypeslug);
+var _rehypeautolinkheadings = require('rehype-autolink-headings'); var _rehypeautolinkheadings2 = _interopRequireDefault(_rehypeautolinkheadings);
+
+// src/features/help/components/mdx/mdx-server-components.ts
+var MDX_SERVER_COMPONENTS = {
+  Callout: _chunk3J7RQBF3js.Callout,
+  Steps: _chunk3J7RQBF3js.Steps,
+  Step: _chunk3J7RQBF3js.Step,
+  Screenshot: _chunk3J7RQBF3js.Screenshot,
+  EntityRef: _chunk3J7RQBF3js.EntityRef,
+  KeyBinding: _chunk3J7RQBF3js.KeyBinding,
+  Video: _chunk3J7RQBF3js.Video
+};
+
+// src/features/help/server/serializeHelpArticle.tsx
+var _jsxruntime = require('react/jsx-runtime');
+async function renderHelpArticle(article) {
+  const readRawMarkdown = _chunkYQQHAFBSjs._getStaticHelpReader.call(void 0, );
+  if (!readRawMarkdown) {
+    throw new Error(
+      "Help reader not configured. Call setHelpReader(fn) from a server-only entrypoint (e.g. Next.js instrumentation register()) before rendering help articles."
+    );
+  }
+  const source = await readRawMarkdown(article);
+  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+    _rsc.MDXRemote,
+    {
+      source,
+      components: MDX_SERVER_COMPONENTS,
+      options: {
+        parseFrontmatter: true,
+        mdxOptions: {
+          remarkPlugins: [_remarkgfm2.default],
+          rehypePlugins: [_rehypeslug2.default, [_rehypeautolinkheadings2.default, { behavior: "wrap" }]]
+        }
+      }
+    }
+  );
+}
+_chunk7QVYU63Ejs.__name.call(void 0, renderHelpArticle, "renderHelpArticle");
+var serializeHelpArticle = renderHelpArticle;
+
+// src/features/help/server/generateHelpArticleStaticParams.ts
+function generateHelpArticleStaticParams() {
+  return getHelpContent().manifest.filter((a) => !a.draft).map((a) => ({ mode: a.mode, slug: a.slug }));
+}
+_chunk7QVYU63Ejs.__name.call(void 0, generateHelpArticleStaticParams, "generateHelpArticleStaticParams");
+
+// src/features/help/server/generateHelpArticleMetadata.ts
+async function generateHelpArticleMetadata({
+  params
+}) {
+  const { mode, slug } = await params;
+  const article = _chunk3J7RQBF3js.findHelpArticle.call(void 0, getHelpContent().manifest, mode, slug);
+  if (!article) return {};
+  return {
+    title: article.title,
+    description: article.summary,
+    openGraph: { title: article.title, description: article.summary }
+  };
+}
+_chunk7QVYU63Ejs.__name.call(void 0, generateHelpArticleMetadata, "generateHelpArticleMetadata");
+
+// src/features/help/server/generateHelpModeStaticParams.ts
+function generateHelpModeStaticParams() {
+  return _chunk3J7RQBF3js.HELP_MODES.map((mode) => ({ mode }));
+}
+_chunk7QVYU63Ejs.__name.call(void 0, generateHelpModeStaticParams, "generateHelpModeStaticParams");
+
+
+
+
+
+
+
+
+
+
+
+
+exports.HELP_MODES = _chunk3J7RQBF3js.HELP_MODES; exports.buildHelpNav = _chunk3J7RQBF3js.buildHelpNav; exports.findHelpArticle = _chunk3J7RQBF3js.findHelpArticle; exports.generateHelpArticleMetadata = generateHelpArticleMetadata; exports.generateHelpArticleStaticParams = generateHelpArticleStaticParams; exports.generateHelpModeStaticParams = generateHelpModeStaticParams; exports.getHelpContent = getHelpContent; exports.prevNextWithinMode = _chunk3J7RQBF3js.prevNextWithinMode; exports.renderHelpArticle = renderHelpArticle; exports.serializeHelpArticle = serializeHelpArticle; exports.setHelpReader = _chunkYQQHAFBSjs.setHelpReader;
+//# sourceMappingURL=server.js.map

package/dist/features/help/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/nextjs-jsonapi/nextjs-jsonapi/dist/features/help/server.js","../../../src/features/help/server/getHelpContent.ts","../../../src/features/help/server/serializeHelpArticle.tsx","../../../src/features/help/components/mdx/mdx-server-components.ts","../../../src/features/help/server/generateHelpArticleStaticParams.ts","../../../src/features/help/server/generateHelpArticleMetadata.ts","../../../src/features/help/server/generateHelpModeStaticParams.ts"],"names":[],"mappings":"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","file":"/home/runner/work/nextjs-jsonapi/nextjs-jsonapi/dist/features/help/server.js","sourcesContent":[null,"import { _getStaticHelpContent } from \"../../../core/registry/helpStore\";\nimport type { HelpContentConfig } from \"../interfaces/help-content-config.interface\";\n\n/**\n * Server-side accessor for the help-content config set via configureJsonApi().\n * Returns the same value <HelpProvider> exposes via React Context to client components.\n * Throws with a setup error if helpContent was never configured.\n */\nexport function getHelpContent(): HelpContentConfig {\n  const cfg = _getStaticHelpContent<HelpContentConfig>();\n  if (!cfg) {\n    throw new Error(\n      \"Help content not configured — call configureJsonApi({ helpContent: {...} }) before importing help pages.\",\n    );\n  }\n  return cfg;\n}\n","import { MDXRemote } from \"next-mdx-remote/rsc\";\nimport remarkGfm from \"remark-gfm\";\nimport rehypeSlug from \"rehype-slug\";\nimport rehypeAutolinkHeadings from \"rehype-autolink-headings\";\nimport type { ReactElement } from \"react\";\nimport type { HelpArticle } from \"../types/help-article.types\";\nimport { _getStaticHelpReader } from \"../../../core/registry/helpStore\";\nimport { MDX_SERVER_COMPONENTS } from \"../components/mdx/mdx-server-components\";\n\n/**\n * Server-side: read the article's raw markdown via the registered help reader\n * and render it through `next-mdx-remote/rsc`'s server-side MDXRemote, using\n * the server-safe MDX components (Callout, Steps, Screenshot, EntityRef,\n * KeyBinding, Video). The returned React element can be embedded inside a\n * server component (e.g. as `children` of `<HelpArticleBody>`).\n *\n * Note: `<Related>` is intentionally not part of the server map — it's a client\n * component that reads HelpContext. Articles that reference `<Related>` would\n * need a separate render path that injects the manifest by prop.\n */\nexport async function renderHelpArticle(article: HelpArticle): Promise<ReactElement> {\n  const readRawMarkdown = _getStaticHelpReader();\n  if (!readRawMarkdown) {\n    throw new Error(\n      \"Help reader not configured. Call setHelpReader(fn) from a server-only entrypoint (e.g. Next.js instrumentation register()) before rendering help articles.\",\n    );\n  }\n  const source = await readRawMarkdown(article);\n  return (\n    <MDXRemote\n      source={source}\n      components={MDX_SERVER_COMPONENTS}\n      options={{\n        parseFrontmatter: true,\n        mdxOptions: {\n          remarkPlugins: [remarkGfm],\n          rehypePlugins: [rehypeSlug, [rehypeAutolinkHeadings, { behavior: \"wrap\" }]],\n        },\n      }}\n    />\n  );\n}\n\n/** @deprecated Use `renderHelpArticle` instead — the legacy serialize + client\n *  MDXRemote pattern is incompatible with App Router RSC. */\nexport const serializeHelpArticle = renderHelpArticle;\n","// Server-safe subset of MDX_COMPONENTS used by `renderHelpArticle`.\n// Mirrors `mdxComponents.ts` but EXCLUDES `Related` (which is a client\n// component that uses `useHelp` + `usePageUrlGenerator`). Server-side rendering\n// of `<Related>` would require passing the manifest by prop, which the standard\n// MDX components map cannot do — articles that need related links should be\n// extended via a server-side render hook rather than the MDX shortcode.\n\nimport { Callout } from \"./Callout\";\nimport { Steps, Step } from \"./Steps\";\nimport { Screenshot } from \"./Screenshot\";\nimport { EntityRef } from \"./EntityRef\";\nimport { KeyBinding } from \"./KeyBinding\";\nimport { Video } from \"./Video\";\n\nexport const MDX_SERVER_COMPONENTS = {\n  Callout,\n  Steps,\n  Step,\n  Screenshot,\n  EntityRef,\n  KeyBinding,\n  Video,\n} as const;\n","import { getHelpContent } from \"./getHelpContent\";\n\nexport function generateHelpArticleStaticParams(): { mode: string; slug: string }[] {\n  return getHelpContent()\n    .manifest.filter((a) => !a.draft)\n    .map((a) => ({ mode: a.mode, slug: a.slug }));\n}\n","import type { Metadata } from \"next\";\nimport { findHelpArticle } from \"../utils/helpNavigation\";\nimport { getHelpContent } from \"./getHelpContent\";\n\nexport async function generateHelpArticleMetadata({\n  params,\n}: {\n  params: Promise<{ mode: string; slug: string }>;\n}): Promise<Metadata> {\n  const { mode, slug } = await params;\n  const article = findHelpArticle(getHelpContent().manifest, mode, slug);\n  if (!article) return {};\n  return {\n    title: article.title,\n    description: article.summary,\n    openGraph: { title: article.title, description: article.summary },\n  };\n}\n","import { HELP_MODES } from \"../types/help-article.types\";\n\nexport function generateHelpModeStaticParams(): { mode: string }[] {\n  return HELP_MODES.map((mode) => ({ mode }));\n}\n"]}

package/dist/features/help/server.mjs

@@ -0,0 +1,123 @@
+import {
+  Callout,
+  EntityRef,
+  HELP_MODES,
+  KeyBinding,
+  Screenshot,
+  Step,
+  Steps,
+  Video,
+  buildHelpNav,
+  findHelpArticle,
+  prevNextWithinMode
+} from "../../chunk-MZTKPPET.mjs";
+import {
+  _getStaticHelpContent,
+  _getStaticHelpReader,
+  setHelpReader
+} from "../../chunk-CQID6RCF.mjs";
+import "../../chunk-MSNNAHDB.mjs";
+import "../../chunk-AUXK7QSA.mjs";
+import "../../chunk-C7C7VY4F.mjs";
+import "../../chunk-KK7PYKVI.mjs";
+import {
+  __name
+} from "../../chunk-PAWJFY3S.mjs";
+
+// src/features/help/server/getHelpContent.ts
+function getHelpContent() {
+  const cfg = _getStaticHelpContent();
+  if (!cfg) {
+    throw new Error(
+      "Help content not configured \u2014 call configureJsonApi({ helpContent: {...} }) before importing help pages."
+    );
+  }
+  return cfg;
+}
+__name(getHelpContent, "getHelpContent");
+
+// src/features/help/server/serializeHelpArticle.tsx
+import { MDXRemote } from "next-mdx-remote/rsc";
+import remarkGfm from "remark-gfm";
+import rehypeSlug from "rehype-slug";
+import rehypeAutolinkHeadings from "rehype-autolink-headings";
+
+// src/features/help/components/mdx/mdx-server-components.ts
+var MDX_SERVER_COMPONENTS = {
+  Callout,
+  Steps,
+  Step,
+  Screenshot,
+  EntityRef,
+  KeyBinding,
+  Video
+};
+
+// src/features/help/server/serializeHelpArticle.tsx
+import { jsx } from "react/jsx-runtime";
+async function renderHelpArticle(article) {
+  const readRawMarkdown = _getStaticHelpReader();
+  if (!readRawMarkdown) {
+    throw new Error(
+      "Help reader not configured. Call setHelpReader(fn) from a server-only entrypoint (e.g. Next.js instrumentation register()) before rendering help articles."
+    );
+  }
+  const source = await readRawMarkdown(article);
+  return /* @__PURE__ */ jsx(
+    MDXRemote,
+    {
+      source,
+      components: MDX_SERVER_COMPONENTS,
+      options: {
+        parseFrontmatter: true,
+        mdxOptions: {
+          remarkPlugins: [remarkGfm],
+          rehypePlugins: [rehypeSlug, [rehypeAutolinkHeadings, { behavior: "wrap" }]]
+        }
+      }
+    }
+  );
+}
+__name(renderHelpArticle, "renderHelpArticle");
+var serializeHelpArticle = renderHelpArticle;
+
+// src/features/help/server/generateHelpArticleStaticParams.ts
+function generateHelpArticleStaticParams() {
+  return getHelpContent().manifest.filter((a) => !a.draft).map((a) => ({ mode: a.mode, slug: a.slug }));
+}
+__name(generateHelpArticleStaticParams, "generateHelpArticleStaticParams");
+
+// src/features/help/server/generateHelpArticleMetadata.ts
+async function generateHelpArticleMetadata({
+  params
+}) {
+  const { mode, slug } = await params;
+  const article = findHelpArticle(getHelpContent().manifest, mode, slug);
+  if (!article) return {};
+  return {
+    title: article.title,
+    description: article.summary,
+    openGraph: { title: article.title, description: article.summary }
+  };
+}
+__name(generateHelpArticleMetadata, "generateHelpArticleMetadata");
+
+// src/features/help/server/generateHelpModeStaticParams.ts
+function generateHelpModeStaticParams() {
+  return HELP_MODES.map((mode) => ({ mode }));
+}
+__name(generateHelpModeStaticParams, "generateHelpModeStaticParams");
+export {
+  HELP_MODES,
+  buildHelpNav,
+  findHelpArticle,
+  generateHelpArticleMetadata,
+  generateHelpArticleStaticParams,
+  generateHelpModeStaticParams,
+  getHelpContent,
+  prevNextWithinMode,
+  renderHelpArticle,
+  serializeHelpArticle,
+  setHelpReader
+};
+//# sourceMappingURL=server.mjs.map

package/dist/features/help/server.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/features/help/server/getHelpContent.ts","../../../src/features/help/server/serializeHelpArticle.tsx","../../../src/features/help/components/mdx/mdx-server-components.ts","../../../src/features/help/server/generateHelpArticleStaticParams.ts","../../../src/features/help/server/generateHelpArticleMetadata.ts","../../../src/features/help/server/generateHelpModeStaticParams.ts"],"sourcesContent":["import { _getStaticHelpContent } from \"../../../core/registry/helpStore\";\nimport type { HelpContentConfig } from \"../interfaces/help-content-config.interface\";\n\n/**\n * Server-side accessor for the help-content config set via configureJsonApi().\n * Returns the same value <HelpProvider> exposes via React Context to client components.\n * Throws with a setup error if helpContent was never configured.\n */\nexport function getHelpContent(): HelpContentConfig {\n  const cfg = _getStaticHelpContent<HelpContentConfig>();\n  if (!cfg) {\n    throw new Error(\n      \"Help content not configured — call configureJsonApi({ helpContent: {...} }) before importing help pages.\",\n    );\n  }\n  return cfg;\n}\n","import { MDXRemote } from \"next-mdx-remote/rsc\";\nimport remarkGfm from \"remark-gfm\";\nimport rehypeSlug from \"rehype-slug\";\nimport rehypeAutolinkHeadings from \"rehype-autolink-headings\";\nimport type { ReactElement } from \"react\";\nimport type { HelpArticle } from \"../types/help-article.types\";\nimport { _getStaticHelpReader } from \"../../../core/registry/helpStore\";\nimport { MDX_SERVER_COMPONENTS } from \"../components/mdx/mdx-server-components\";\n\n/**\n * Server-side: read the article's raw markdown via the registered help reader\n * and render it through `next-mdx-remote/rsc`'s server-side MDXRemote, using\n * the server-safe MDX components (Callout, Steps, Screenshot, EntityRef,\n * KeyBinding, Video). The returned React element can be embedded inside a\n * server component (e.g. as `children` of `<HelpArticleBody>`).\n *\n * Note: `<Related>` is intentionally not part of the server map — it's a client\n * component that reads HelpContext. Articles that reference `<Related>` would\n * need a separate render path that injects the manifest by prop.\n */\nexport async function renderHelpArticle(article: HelpArticle): Promise<ReactElement> {\n  const readRawMarkdown = _getStaticHelpReader();\n  if (!readRawMarkdown) {\n    throw new Error(\n      \"Help reader not configured. Call setHelpReader(fn) from a server-only entrypoint (e.g. Next.js instrumentation register()) before rendering help articles.\",\n    );\n  }\n  const source = await readRawMarkdown(article);\n  return (\n    <MDXRemote\n      source={source}\n      components={MDX_SERVER_COMPONENTS}\n      options={{\n        parseFrontmatter: true,\n        mdxOptions: {\n          remarkPlugins: [remarkGfm],\n          rehypePlugins: [rehypeSlug, [rehypeAutolinkHeadings, { behavior: \"wrap\" }]],\n        },\n      }}\n    />\n  );\n}\n\n/** @deprecated Use `renderHelpArticle` instead — the legacy serialize + client\n *  MDXRemote pattern is incompatible with App Router RSC. */\nexport const serializeHelpArticle = renderHelpArticle;\n","// Server-safe subset of MDX_COMPONENTS used by `renderHelpArticle`.\n// Mirrors `mdxComponents.ts` but EXCLUDES `Related` (which is a client\n// component that uses `useHelp` + `usePageUrlGenerator`). Server-side rendering\n// of `<Related>` would require passing the manifest by prop, which the standard\n// MDX components map cannot do — articles that need related links should be\n// extended via a server-side render hook rather than the MDX shortcode.\n\nimport { Callout } from \"./Callout\";\nimport { Steps, Step } from \"./Steps\";\nimport { Screenshot } from \"./Screenshot\";\nimport { EntityRef } from \"./EntityRef\";\nimport { KeyBinding } from \"./KeyBinding\";\nimport { Video } from \"./Video\";\n\nexport const MDX_SERVER_COMPONENTS = {\n  Callout,\n  Steps,\n  Step,\n  Screenshot,\n  EntityRef,\n  KeyBinding,\n  Video,\n} as const;\n","import { getHelpContent } from \"./getHelpContent\";\n\nexport function generateHelpArticleStaticParams(): { mode: string; slug: string }[] {\n  return getHelpContent()\n    .manifest.filter((a) => !a.draft)\n    .map((a) => ({ mode: a.mode, slug: a.slug }));\n}\n","import type { Metadata } from \"next\";\nimport { findHelpArticle } from \"../utils/helpNavigation\";\nimport { getHelpContent } from \"./getHelpContent\";\n\nexport async function generateHelpArticleMetadata({\n  params,\n}: {\n  params: Promise<{ mode: string; slug: string }>;\n}): Promise<Metadata> {\n  const { mode, slug } = await params;\n  const article = findHelpArticle(getHelpContent().manifest, mode, slug);\n  if (!article) return {};\n  return {\n    title: article.title,\n    description: article.summary,\n    openGraph: { title: article.title, description: article.summary },\n  };\n}\n","import { HELP_MODES } from \"../types/help-article.types\";\n\nexport function generateHelpModeStaticParams(): { mode: string }[] {\n  return HELP_MODES.map((mode) => ({ mode }));\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAQO,SAAS,iBAAoC;AAClD,QAAM,MAAM,sBAAyC;AACrD,MAAI,CAAC,KAAK;AACR,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AARgB;;;ACRhB,SAAS,iBAAiB;AAC1B,OAAO,eAAe;AACtB,OAAO,gBAAgB;AACvB,OAAO,4BAA4B;;;ACW5B,IAAM,wBAAwB;AAAA,EACnC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;;;ADOI;AATJ,eAAsB,kBAAkB,SAA6C;AACnF,QAAM,kBAAkB,qBAAqB;AAC7C,MAAI,CAAC,iBAAiB;AACpB,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,QAAM,SAAS,MAAM,gBAAgB,OAAO;AAC5C,SACE;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA,YAAY;AAAA,MACZ,SAAS;AAAA,QACP,kBAAkB;AAAA,QAClB,YAAY;AAAA,UACV,eAAe,CAAC,SAAS;AAAA,UACzB,eAAe,CAAC,YAAY,CAAC,wBAAwB,EAAE,UAAU,OAAO,CAAC,CAAC;AAAA,QAC5E;AAAA,MACF;AAAA;AAAA,EACF;AAEJ;AArBsB;AAyBf,IAAM,uBAAuB;;;AE3C7B,SAAS,kCAAoE;AAClF,SAAO,eAAe,EACnB,SAAS,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAC/B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,EAAE,KAAK,EAAE;AAChD;AAJgB;;;ACEhB,eAAsB,4BAA4B;AAAA,EAChD;AACF,GAEsB;AACpB,QAAM,EAAE,MAAM,KAAK,IAAI,MAAM;AAC7B,QAAM,UAAU,gBAAgB,eAAe,EAAE,UAAU,MAAM,IAAI;AACrE,MAAI,CAAC,QAAS,QAAO,CAAC;AACtB,SAAO;AAAA,IACL,OAAO,QAAQ;AAAA,IACf,aAAa,QAAQ;AAAA,IACrB,WAAW,EAAE,OAAO,QAAQ,OAAO,aAAa,QAAQ,QAAQ;AAAA,EAClE;AACF;AAbsB;;;ACFf,SAAS,+BAAmD;AACjE,SAAO,WAAW,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE;AAC5C;AAFgB;","names":[]}

package/dist/help-content-config.interface-B9L02u9i.d.mts

@@ -0,0 +1,50 @@
+/**
+ * Local copy of the help-article types to keep this published frontend library
+ * decoupled from `@carlonicora/nestjs-neo4jsonapi`. Must stay in sync with
+ * `packages/nestjs-neo4jsonapi/src/foundations/help-content-sync/interfaces/help-article.interface.ts`.
+ */
+declare const HELP_MODES: readonly ["tutorial", "how-to", "reference", "explanation"];
+type HelpMode = (typeof HELP_MODES)[number];
+interface HelpHeading {
+    depth: 2 | 3;
+    slug: string;
+    text: string;
+}
+interface HelpArticle {
+    id: string;
+    slug: string;
+    mode: HelpMode;
+    title: string;
+    summary: string;
+    order: number;
+    tags: readonly string[];
+    contextualKeys: readonly string[];
+    aiIndexed: boolean;
+    draft: boolean;
+    contentHash: string;
+    path: string;
+    headings: readonly HelpHeading[];
+    relatedSlugs: readonly string[];
+    lastUpdated: string;
+}
+interface HelpRedirect {
+    from: string;
+    to: string;
+}
+
+interface HelpBrandConfig {
+    /** URL of the brand logo image (served by the consuming app). */
+    logo?: string;
+    /** Brand label shown in the help header. */
+    label?: string;
+    /** Where the "Open app" button navigates for logged-in users. Defaults to "/". */
+    appHref?: string;
+}
+interface HelpContentConfig {
+    manifest: readonly HelpArticle[];
+    namespaceUuid: string;
+    redirects?: readonly HelpRedirect[];
+    brand?: HelpBrandConfig;
+}
+
+export { type HelpContentConfig as H, type HelpArticle as a, type HelpMode as b, type HelpBrandConfig as c, HELP_MODES as d, type HelpHeading as e, type HelpRedirect as f };

package/dist/help-content-config.interface-B9L02u9i.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Local copy of the help-article types to keep this published frontend library
+ * decoupled from `@carlonicora/nestjs-neo4jsonapi`. Must stay in sync with
+ * `packages/nestjs-neo4jsonapi/src/foundations/help-content-sync/interfaces/help-article.interface.ts`.
+ */
+declare const HELP_MODES: readonly ["tutorial", "how-to", "reference", "explanation"];
+type HelpMode = (typeof HELP_MODES)[number];
+interface HelpHeading {
+    depth: 2 | 3;
+    slug: string;
+    text: string;
+}
+interface HelpArticle {
+    id: string;
+    slug: string;
+    mode: HelpMode;
+    title: string;
+    summary: string;
+    order: number;
+    tags: readonly string[];
+    contextualKeys: readonly string[];
+    aiIndexed: boolean;
+    draft: boolean;
+    contentHash: string;
+    path: string;
+    headings: readonly HelpHeading[];
+    relatedSlugs: readonly string[];
+    lastUpdated: string;
+}
+interface HelpRedirect {
+    from: string;
+    to: string;
+}
+
+interface HelpBrandConfig {
+    /** URL of the brand logo image (served by the consuming app). */
+    logo?: string;
+    /** Brand label shown in the help header. */
+    label?: string;
+    /** Where the "Open app" button navigates for logged-in users. Defaults to "/". */
+    appHref?: string;
+}
+interface HelpContentConfig {
+    manifest: readonly HelpArticle[];
+    namespaceUuid: string;
+    redirects?: readonly HelpRedirect[];
+    brand?: HelpBrandConfig;
+}
+
+export { type HelpContentConfig as H, type HelpArticle as a, type HelpMode as b, type HelpBrandConfig as c, HELP_MODES as d, type HelpHeading as e, type HelpRedirect as f };