From 54b1401fc3c86f4da5bd0e00901f08888ecab02a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EB=AF=BC=EC=88=99=20MISO?= Date: Sun, 8 Nov 2026 17:37:46 +0100 Subject: [PATCH 01/11] feat(addons): expose verified enabled Markdown page index with one signed catalog fetch --- .../nextguide/lib/extension-site-manager.mjs | 40 +++++++++++++++++++ 1 file changed, 40 insertions(+) diff --git a/packages/nextguide/lib/extension-site-manager.mjs b/packages/nextguide/lib/extension-site-manager.mjs index 973cda4..53c05bb 100644 --- a/packages/nextguide/lib/extension-site-manager.mjs +++ b/packages/nextguide/lib/extension-site-manager.mjs @@ -114,6 +114,46 @@ export function createAccountAddonManager({ requireConsent(consent) return store.uninstall({id,expectedRevision}) }, + /** + * Public Account Mode docs index. Only enabled v1 Markdown from fresh, + * active, signature-verified releases is returned. One signed catalog + * fetch is shared for all installed add-ons; no unsigned/stale fallback. + * Navigation/search consumers MUST NOT compile this content as MDX. + */ + async publicPages() { + const enabled=store.list().addons.filter(x=>x.enabled) + if (!enabled.length) return [] + const {envelope}=await signed() + const pages=[] + for (const addon of enabled) { + // A single revoked or corrupt entry must never leak stale content. + // Keep unrelated verified add-ons discoverable. + try { + const verified=store.readEnabled({ + id:addon.id,envelope,pinnedPublicKeyPem + }) + if (!verified) continue + const root=verified.manifest.entrypoints.content+"/" + for (const page of verified.pages) { + if (!page.path.startsWith(root)) continue + const name=page.path.slice(root.length,-3) + if (!name || name.length>180) continue + const label=name==="index" ? verified.manifest.name : + name.split("/").at(-1).replace(/[-_]/g," ") + pages.push({ + id:addon.id,version:verified.version, + slug:name==="index" ? "" : name, + title:label,group:verified.manifest.name, + markdown:page.markdown.slice(0,3500), + }) + } + } catch { + // Already enabled but no longer approved, malformed or missing: + // exclude from public search/navigation until owner resolves it. + } + } + return pages.slice(0,500) + }, /** Privileged API for a future safe Markdown-only public page adapter. */ async readEnabled({id}={}) { if (typeof id!=="string" || !ID.test(id)) reject("INVALID_REQUEST","Invalid add-on ID") From 1bf3176e7f75ccde520573f2d51f0de5af9147c3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EB=AF=BC=EC=88=99=20MISO?= Date: Sun, 8 Nov 2026 17:38:01 +0100 Subject: [PATCH 02/11] types(addons): document verified public navigation page index --- packages/nextguide/lib/extension-site-manager.d.mts | 1 + 1 file changed, 1 insertion(+) diff --git a/packages/nextguide/lib/extension-site-manager.d.mts b/packages/nextguide/lib/extension-site-manager.d.mts index f32b9c6..65ce181 100644 --- a/packages/nextguide/lib/extension-site-manager.d.mts +++ b/packages/nextguide/lib/extension-site-manager.d.mts @@ -56,6 +56,7 @@ export declare function createAccountAddonManager(options?: { expectedRevision: number consent: true }): {revision: number; removed: string; privateDataPreserved: true} + publicPages(): Promise> readEnabled(input: {id: string}): Promise Date: Sun, 8 Nov 2026 17:39:21 +0100 Subject: [PATCH 03/11] feat(account): safely augment generated navigation and search with approved add-on pages --- .../lib/account-addon-index-template.mjs | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 packages/nextguide/lib/account-addon-index-template.mjs diff --git a/packages/nextguide/lib/account-addon-index-template.mjs b/packages/nextguide/lib/account-addon-index-template.mjs new file mode 100644 index 0000000..7e247ce --- /dev/null +++ b/packages/nextguide/lib/account-addon-index-template.mjs @@ -0,0 +1,17 @@ +/** Account Mode only: augment generated navigation/search with approved Markdown. */ +const TAIL = "\n/** Per-request cache: one signed catalog fetch for sidebar and search. */\nconst getInstalledAddonPages = cache(async () => {\n try {\n return await createAccountAddonManager({ project: process.cwd() }).publicPages()\n } catch {\n // No unsigned/stale fallback; keep core docs usable if registry is offline.\n return []\n }\n})\nexport async function getSidebar() {\n const [baseSections, verifiedPages] = await Promise.all([\n getBaseSidebar(), getInstalledAddonPages(),\n ])\n if (!verifiedPages.length) return baseSections\n const ids = [...new Set(verifiedPages.map(page => page.id))]\n const addonItems = ids.map(id => {\n const pages = verifiedPages.filter(page => page.id === id)\n const path = prefix + \"/addons/\" + encodeURIComponent(id)\n return {\n title: pages[0].group,\n href: path + \"/\",\n nav: true, props: {},\n items: pages.map(page => ({\n title: page.title,\n href: path + \"/\" + (page.slug ? page.slug.split(\"/\").map(encodeURIComponent).join(\"/\") + \"/\" : \"\"),\n nav: true, props: {}, items: [],\n })),\n }\n })\n return [...baseSections, section(\"Add-ons\", \"#addons\", addonItems)]\n}\nexport async function getSearchIndex() {\n const [baseEntries, verifiedPages] = await Promise.all([\n getBaseSearchIndex(), getInstalledAddonPages(),\n ])\n return [...baseEntries, ...verifiedPages.map(page => ({\n href: prefix + \"/addons/\" + encodeURIComponent(page.id) + \"/\" +\n (page.slug ? page.slug.split(\"/\").map(encodeURIComponent).join(\"/\") + \"/\" : \"\"),\n title: page.title,\n section: \"Add-ons\",\n group: page.group,\n keywords: page.markdown,\n }))]\n}\n" + +export function accountAddonNavigationLibSource(original) { + if (typeof original !== "string" || + !original.includes('import { createDocs } from "nextguide/mdx"') || + !original.includes("export async function getSidebar() {") || + !original.includes("export async function getSearchIndex() {")) { + throw Error("Generated NextGuide docs library cannot be extended safely") + } + return original + .replace('import { createDocs } from "nextguide/mdx"', + 'import { createDocs } from "nextguide/mdx"\\nimport { cache } from "react"\\nimport { createAccountAddonManager } from "nextguide/extensions/site-manager"'.replaceAll("\\\\n", "\\n")) + .replace("export async function getSidebar() {", "async function getBaseSidebar() {") + .replace("export async function getSearchIndex() {", "async function getBaseSearchIndex() {") + + "\\n" + TAIL +} From ee240e1229361d6119ab9d12a4de15438da38bcf Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EB=AF=BC=EC=88=99=20MISO?= Date: Sun, 8 Nov 2026 17:39:54 +0100 Subject: [PATCH 04/11] fix(account): use reliable newline serialization in generated adapter --- packages/nextguide/lib/account-addon-index-template.mjs | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/packages/nextguide/lib/account-addon-index-template.mjs b/packages/nextguide/lib/account-addon-index-template.mjs index 7e247ce..11d1802 100644 --- a/packages/nextguide/lib/account-addon-index-template.mjs +++ b/packages/nextguide/lib/account-addon-index-template.mjs @@ -1,6 +1,6 @@ /** Account Mode only: augment generated navigation/search with approved Markdown. */ const TAIL = "\n/** Per-request cache: one signed catalog fetch for sidebar and search. */\nconst getInstalledAddonPages = cache(async () => {\n try {\n return await createAccountAddonManager({ project: process.cwd() }).publicPages()\n } catch {\n // No unsigned/stale fallback; keep core docs usable if registry is offline.\n return []\n }\n})\nexport async function getSidebar() {\n const [baseSections, verifiedPages] = await Promise.all([\n getBaseSidebar(), getInstalledAddonPages(),\n ])\n if (!verifiedPages.length) return baseSections\n const ids = [...new Set(verifiedPages.map(page => page.id))]\n const addonItems = ids.map(id => {\n const pages = verifiedPages.filter(page => page.id === id)\n const path = prefix + \"/addons/\" + encodeURIComponent(id)\n return {\n title: pages[0].group,\n href: path + \"/\",\n nav: true, props: {},\n items: pages.map(page => ({\n title: page.title,\n href: path + \"/\" + (page.slug ? page.slug.split(\"/\").map(encodeURIComponent).join(\"/\") + \"/\" : \"\"),\n nav: true, props: {}, items: [],\n })),\n }\n })\n return [...baseSections, section(\"Add-ons\", \"#addons\", addonItems)]\n}\nexport async function getSearchIndex() {\n const [baseEntries, verifiedPages] = await Promise.all([\n getBaseSearchIndex(), getInstalledAddonPages(),\n ])\n return [...baseEntries, ...verifiedPages.map(page => ({\n href: prefix + \"/addons/\" + encodeURIComponent(page.id) + \"/\" +\n (page.slug ? page.slug.split(\"/\").map(encodeURIComponent).join(\"/\") + \"/\" : \"\"),\n title: page.title,\n section: \"Add-ons\",\n group: page.group,\n keywords: page.markdown,\n }))]\n}\n" - +const IMPORTS = "\nimport { cache } from \"react\"\nimport { createAccountAddonManager } from \"nextguide/extensions/site-manager\"" export function accountAddonNavigationLibSource(original) { if (typeof original !== "string" || !original.includes('import { createDocs } from "nextguide/mdx"') || @@ -10,8 +10,8 @@ export function accountAddonNavigationLibSource(original) { } return original .replace('import { createDocs } from "nextguide/mdx"', - 'import { createDocs } from "nextguide/mdx"\\nimport { cache } from "react"\\nimport { createAccountAddonManager } from "nextguide/extensions/site-manager"'.replaceAll("\\\\n", "\\n")) + 'import { createDocs } from "nextguide/mdx"' + IMPORTS) .replace("export async function getSidebar() {", "async function getBaseSidebar() {") .replace("export async function getSearchIndex() {", "async function getBaseSearchIndex() {") + - "\\n" + TAIL + "\n" + TAIL } From 6be74fae6e3209409a290872459f8ff90db265e1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EB=AF=BC=EC=88=99=20MISO?= Date: Sun, 8 Nov 2026 17:40:06 +0100 Subject: [PATCH 05/11] feat(account): wire verified add-on index into generated App Router sidebar and search --- packages/nextguide/lib/account-starter.mjs | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/packages/nextguide/lib/account-starter.mjs b/packages/nextguide/lib/account-starter.mjs index 9c070bf..671b78b 100644 --- a/packages/nextguide/lib/account-starter.mjs +++ b/packages/nextguide/lib/account-starter.mjs @@ -6,6 +6,7 @@ import { accountFile, createBootstrap } from "./account-auth.mjs" import { applyPlan, planDeveloperProject } from "./init.mjs" import { fullStudioRouteSource } from "./account-studio-template.mjs" import { accountAddonDocsRouteSource } from "./account-addon-page-template.mjs" +import { accountAddonNavigationLibSource } from "./account-addon-index-template.mjs" import { installMonacoAssets } from "./monaco-assets.mjs" const PAGE = `// Generated by NextGuide CLI. Edit freely; NextGuide never overwrites these files. @@ -214,6 +215,10 @@ export function initAccount(projectDirectory, inspection, options = {}) { const config = JSON.parse(plan.files["nextguide.config.json"]) config.mode = "account" plan.files["nextguide.config.json"] = JSON.stringify(config, null, 2) + "\n" + // Only Account Mode extends the public sidebar/search with signed v1 add-ons. + const libRoot = plan.router.folder.startsWith("src/") ? "src/" : "" + const docsLib = libRoot + "lib/nextguide." + (plan.typed ? "ts" : "js") + plan.files[docsLib] = accountAddonNavigationLibSource(plan.files[docsLib]) const extra = accountStarterFiles(plan.router.folder, plan.typed, plan.basePath) Object.assign(plan.files, extra) // Account Mode must never statically cache its sidebar, page index, site title From 3294e7f992feb73a3763865c2d94fdc79f727125 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EB=AF=BC=EC=88=99=20MISO?= Date: Sun, 8 Nov 2026 17:40:33 +0100 Subject: [PATCH 06/11] test(addons): enabled reviewed Markdown enters public index, disabled pages never leak --- .../test/extension-site-manager.test.mjs | 21 +++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/packages/nextguide/test/extension-site-manager.test.mjs b/packages/nextguide/test/extension-site-manager.test.mjs index 83d8159..9a87230 100644 --- a/packages/nextguide/test/extension-site-manager.test.mjs +++ b/packages/nextguide/test/extension-site-manager.test.mjs @@ -194,3 +194,24 @@ test("stale signed metadata, incompatible alpha versions and revoked releases ar assert.equal(revoked.network.calls.length,0) }finally{revoked.cleanup()} }) + +test("public navigation includes only explicitly enabled signed Markdown pages",async()=>{ + const a=versioned("1.0.0") + const f=fixture({signedReleases:signed([a.release]),artifacts:[a]}) + try { + assert.deepEqual(await f.manager.publicPages(),[]) + assert.equal(f.network.calls.length,0,"disabled add-ons do not need registry requests") + await f.manager.install({id:"acme.docs",version:"1.0.0",expectedRevision:0,consent:true}) + assert.deepEqual(await f.manager.publicPages(),[]) + await f.manager.toggle({id:"acme.docs",enabled:true,expectedRevision:1}) + const pages=await f.manager.publicPages() + assert.equal(pages.length,1) + assert.deepEqual(Object.keys(pages[0]).sort(),["group","id","markdown","slug","title","version"]) + assert.equal(pages[0].id,"acme.docs") + assert.equal(pages[0].title,"Docs Extension") + assert.equal(pages[0].slug,"") + assert.match(pages[0].markdown,/Welcome 1\\.0\\.0/) + await f.manager.toggle({id:"acme.docs",enabled:false,expectedRevision:2}) + assert.deepEqual(await f.manager.publicPages(),[]) + } finally { f.cleanup() } +}) From 08177d2029ce57348a21f074afacf2882c7127b5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EB=AF=BC=EC=88=99=20MISO?= Date: Sun, 8 Nov 2026 17:40:47 +0100 Subject: [PATCH 07/11] test(account): generated docs navigation and search include only trusted add-on adapter --- packages/nextguide/test/account-init.test.mjs | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/packages/nextguide/test/account-init.test.mjs b/packages/nextguide/test/account-init.test.mjs index e8bfe91..258d97b 100644 --- a/packages/nextguide/test/account-init.test.mjs +++ b/packages/nextguide/test/account-init.test.mjs @@ -48,6 +48,13 @@ test("App Router Account Mode scaffolds protected routes and owner token without assert.match(source, /next\/font\/google/, route + " should self-host Inter") assert.match(source, /--ng-preview-inter/, route + " should supply the Account Mode font variable") } + const docsSource = readFileSync(join(project, "src/lib/nextguide.ts"), "utf8") + assert.match(docsSource, /getInstalledAddonPages/) + assert.match(docsSource, /createAccountAddonManager/) + assert.match(docsSource, /async function getBaseSidebar/) + assert.match(docsSource, /async function getBaseSearchIndex/) + assert.match(docsSource, /section\("Add-ons", "#addons"/) + assert.match(docsSource, /section: "Add-ons"/) assert.ok(existsSync(join(project, "src/app/admin/page.tsx"))) const addOnRoute = readFileSync(join(project, "src/app/docs/addons/[id]/[[...page]]/page.tsx"), "utf8") From 6c512519397d10dd9ca23034440a9adcaca8d455 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EB=AF=BC=EC=88=99=20MISO?= Date: Sun, 8 Nov 2026 17:41:03 +0100 Subject: [PATCH 08/11] docs(addons): clarify verified sidebar/search support for generated Account Mode sites --- apps/web/contents/addons/updates.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/apps/web/contents/addons/updates.mdx b/apps/web/contents/addons/updates.mdx index 55a1cb6..e8eb82c 100644 --- a/apps/web/contents/addons/updates.mdx +++ b/apps/web/contents/addons/updates.mdx @@ -33,7 +33,7 @@ The owner-facing **Add-ons** page can install, enable/disable, update, roll back Owner authentication and same-origin checks apply to every mutation. A concurrent change requires refreshing the page rather than overwriting another update. A revoked or stale release cannot be reactivated or rolled back. -Enabled, reviewed v1 Markdown content can be opened at the site's dedicated `/docs/addons//` route (or `/addons//` when the docs base is root). Add-on pages do not yet join the public docs sidebar and search index. Executable add-ons, privileged permissions, secrets, React components and automatic background update checks remain future milestones. Legacy v1 content is never compiled as untrusted MDX. +Enabled, reviewed v1 Markdown content can be opened at the site's dedicated `/docs/addons//` route (or `/addons//` when the docs base is root). Fresh Account Mode installations now include enabled and still-approved Markdown pages in their public docs sidebar and search index. Pages are excluded when disabled, revoked, corrupted or no longer covered by a fresh signed registry. Already-installed sites need an explicit generated-file refresh to receive the updated navigation adapter; authored MDX must not be overwritten. Executable add-ons, privileged permissions, secrets, React components and automatic background update checks remain future milestones. Legacy v1 content is never compiled as untrusted MDX. For details see [Account Mode marketplace](/addons/marketplace) and [runtime API](/addons/api). From 73e81f2b3cb0aec9a5a8275de95ab9c6e27b69d1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EB=AF=BC=EC=88=99=20MISO?= Date: Sun, 8 Nov 2026 17:41:59 +0100 Subject: [PATCH 09/11] test(addons): assert signed Markdown text without overescaped regex --- packages/nextguide/test/extension-site-manager.test.mjs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/nextguide/test/extension-site-manager.test.mjs b/packages/nextguide/test/extension-site-manager.test.mjs index 9a87230..38393d5 100644 --- a/packages/nextguide/test/extension-site-manager.test.mjs +++ b/packages/nextguide/test/extension-site-manager.test.mjs @@ -130,7 +130,7 @@ test("owner catalog includes exact compatibility and durable installed state",as const enabled=await f.manager.toggle({id:"acme.docs",enabled:true,expectedRevision:1}) assert.equal(enabled.addon.enabled,true) const approved=await f.manager.readEnabled({id:"acme.docs"}) - assert.match(approved.pages[0].markdown,/Welcome 1\.0\.0/) + assert.ok(pages[0].markdown.includes("Welcome 1.0.0")) const disabled=await f.manager.toggle({id:"acme.docs",enabled:false,expectedRevision:2}) assert.equal(disabled.addon.enabled,false) assert.equal(await f.manager.readEnabled({id:"acme.docs"}),null) From 70a1480682acfb47376945f6fff24f15288e7746 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EB=AF=BC=EC=88=99=20MISO?= Date: Sun, 8 Nov 2026 17:42:12 +0100 Subject: [PATCH 10/11] test(addons): fix overescaped expected Markdown string --- packages/nextguide/test/extension-site-manager.test.mjs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/nextguide/test/extension-site-manager.test.mjs b/packages/nextguide/test/extension-site-manager.test.mjs index 38393d5..188b00b 100644 --- a/packages/nextguide/test/extension-site-manager.test.mjs +++ b/packages/nextguide/test/extension-site-manager.test.mjs @@ -210,7 +210,7 @@ test("public navigation includes only explicitly enabled signed Markdown pages", assert.equal(pages[0].id,"acme.docs") assert.equal(pages[0].title,"Docs Extension") assert.equal(pages[0].slug,"") - assert.match(pages[0].markdown,/Welcome 1\\.0\\.0/) + assert.ok(pages[0].markdown.includes("Welcome 1.0.0")) await f.manager.toggle({id:"acme.docs",enabled:false,expectedRevision:2}) assert.deepEqual(await f.manager.publicPages(),[]) } finally { f.cleanup() } From 9a810a5c90e08e779f3fc105a2f836269b6b409c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EB=AF=BC=EC=88=99=20MISO?= Date: Sun, 8 Nov 2026 17:42:28 +0100 Subject: [PATCH 11/11] test(addons): restore existing approved page assertion --- packages/nextguide/test/extension-site-manager.test.mjs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/nextguide/test/extension-site-manager.test.mjs b/packages/nextguide/test/extension-site-manager.test.mjs index 188b00b..545d1c4 100644 --- a/packages/nextguide/test/extension-site-manager.test.mjs +++ b/packages/nextguide/test/extension-site-manager.test.mjs @@ -130,7 +130,7 @@ test("owner catalog includes exact compatibility and durable installed state",as const enabled=await f.manager.toggle({id:"acme.docs",enabled:true,expectedRevision:1}) assert.equal(enabled.addon.enabled,true) const approved=await f.manager.readEnabled({id:"acme.docs"}) - assert.ok(pages[0].markdown.includes("Welcome 1.0.0")) + assert.ok(approved.pages[0].markdown.includes("Welcome 1.0.0")) const disabled=await f.manager.toggle({id:"acme.docs",enabled:false,expectedRevision:2}) assert.equal(disabled.addon.enabled,false) assert.equal(await f.manager.readEnabled({id:"acme.docs"}),null)