@ahmedrowaihi/8n 6.0.30 → 6.0.32

package/dist/index.mjs

@@ -1736,6 +1736,24 @@ const $ZodEnum = /* @__PURE__ */ $constructor("$ZodEnum", (inst, def) => {
 		return payload;
 	};
 });
+const $ZodLiteral = /* @__PURE__ */ $constructor("$ZodLiteral", (inst, def) => {
+	$ZodType.init(inst, def);
+	if (def.values.length === 0) throw new Error("Cannot create literal schema with no valid values");
+	const values = new Set(def.values);
+	inst._zod.values = values;
+	inst._zod.pattern = new RegExp(`^(${def.values.map((o) => typeof o === "string" ? escapeRegex(o) : o ? escapeRegex(o.toString()) : String(o)).join("|")})$`);
+	inst._zod.parse = (payload, _ctx) => {
+		const input = payload.value;
+		if (values.has(input)) return payload;
+		payload.issues.push({
+			code: "invalid_value",
+			values: def.values,
+			input,
+			inst
+		});
+		return payload;
+	};
+});
 const $ZodTransform = /* @__PURE__ */ $constructor("$ZodTransform", (inst, def) => {
 	$ZodType.init(inst, def);
 	inst._zod.parse = (payload, ctx) => {
@@ -2801,6 +2819,27 @@ const enumProcessor = (schema, _ctx, json, _params) => {
 	if (values.every((v) => typeof v === "string")) json.type = "string";
 	json.enum = values;
 };
+const literalProcessor = (schema, ctx, json, _params) => {
+	const def = schema._zod.def;
+	const vals = [];
+	for (const val of def.values) if (val === void 0) {
+		if (ctx.unrepresentable === "throw") throw new Error("Literal `undefined` cannot be represented in JSON Schema");
+	} else if (typeof val === "bigint") if (ctx.unrepresentable === "throw") throw new Error("BigInt literals cannot be represented in JSON Schema");
+	else vals.push(Number(val));
+	else vals.push(val);
+	if (vals.length === 0) {} else if (vals.length === 1) {
+		const val = vals[0];
+		json.type = val === null ? "null" : typeof val;
+		if (ctx.target === "draft-04" || ctx.target === "openapi-3.0") json.enum = [val];
+		else json.const = val;
+	} else {
+		if (vals.every((v) => typeof v === "number")) json.type = "number";
+		if (vals.every((v) => typeof v === "string")) json.type = "string";
+		if (vals.every((v) => typeof v === "boolean")) json.type = "boolean";
+		if (vals.every((v) => v === null)) json.type = "null";
+		json.enum = vals;
+	}
+};
 const customProcessor = (_schema, ctx, _json, _params) => {
 	if (ctx.unrepresentable === "throw") throw new Error("Custom types cannot be represented in JSON Schema");
 };
@@ -3428,6 +3467,23 @@ function _enum(values, params) {
 		...normalizeParams(params)
 	});
 }
+const ZodLiteral = /* @__PURE__ */ $constructor("ZodLiteral", (inst, def) => {
+	$ZodLiteral.init(inst, def);
+	ZodType.init(inst, def);
+	inst._zod.processJSONSchema = (ctx, json, params) => literalProcessor(inst, ctx, json, params);
+	inst.values = new Set(def.values);
+	Object.defineProperty(inst, "value", { get() {
+		if (def.values.length > 1) throw new Error("This schema contains multiple valid literal values. Use `.values` instead.");
+		return def.values[0];
+	} });
+});
+function literal(value, params) {
+	return new ZodLiteral({
+		type: "literal",
+		values: Array.isArray(value) ? value : [value],
+		...normalizeParams(params)
+	});
+}
 const ZodTransform = /* @__PURE__ */ $constructor("ZodTransform", (inst, def) => {
 	$ZodTransform.init(inst, def);
 	ZodType.init(inst, def);
@@ -3608,7 +3664,13 @@ const configSchema = object({
 		url: string()
 	})).default([]) }).default({ links: [] }),
 	animations: boolean().default(true),
-	basePath: string().optional()
+	basePath: string().optional(),
+	auth: object({
+		provider: literal("github"),
+		repo: string().optional(),
+		protect: union([boolean(), array(string())]).default(true),
+		sessionDuration: string().default("7d")
+	}).optional()
 });
 async function resolveConfig() {
 	const { config } = await loadConfig({
@@ -3674,7 +3736,7 @@ async function checkSelfUpdate() {
 		});
 		if (!res.ok) return;
 		const { version: latest } = await res.json();
-		const current = "6.0.30";
+		const current = "6.0.32";
 		if (latest !== current) console.log(pc.yellow("⚠") + pc.dim(` new version available: `) + pc.cyan(latest) + pc.dim(` (current: ${current}) — run `) + pc.cyan("npm i -g @ahmedrowaihi/8n") + pc.dim(" to update"));
 	} catch {}
 }
@@ -3742,12 +3804,18 @@ function buildEnv({ config, contentDir, staticExport = false }) {
 		CONTENT_DIR: contentDir,
 		LOCALES: (config.locales ?? ["en"]).join(","),
 		NEXT_PUBLIC_SITE_NAME: config.siteName ?? "Docs",
-		NEXT_PUBLIC_GITHUB_REPO: config.github?.repo ?? ghPagesUrl,
+		NEXT_PUBLIC_GITHUB_REPO: config.github?.repo ?? process.env.NEXT_PUBLIC_GITHUB_REPO ?? ghPagesUrl,
 		SECTIONS: JSON.stringify(config.sections ?? {}),
 		NEXT_PUBLIC_NAV_LINKS: JSON.stringify(config.nav?.links ?? []),
 		NEXT_PUBLIC_ANIMATIONS: config.animations === false ? "false" : "true",
 		NEXT_BASE_PATH: config.basePath ?? ghPagesBasePath ?? "",
-		NEXT_STATIC_EXPORT: staticExport ? "true" : "false"
+		NEXT_STATIC_EXPORT: staticExport ? "true" : "false",
+		...config.auth ? {
+			AUTH_ENABLED: "true",
+			AUTH_REPO: config.auth.repo ?? config.github?.repo ?? ghPagesUrl,
+			AUTH_PROTECT: JSON.stringify(config.auth.protect),
+			AUTH_SESSION_DURATION: config.auth.sessionDuration
+		} : {}
 	};
 }
 async function runNextFlat(projectDir, cmd, env) {
@@ -3778,7 +3846,7 @@ async function dev() {
 async function build({ server = false } = {}) {
 	const { config, contentDir } = await resolveProject();
 	const projectDir = process.cwd();
-	console.log(pc.cyan("8n") + pc.dim(` v6.0.30 build → ${contentDir}`));
+	console.log(pc.cyan("8n") + pc.dim(` v6.0.32 build → ${contentDir}`));
 	if (server) await runNextFlat(projectDir, "build", buildEnv({
 		config,
 		contentDir,
@@ -4096,7 +4164,7 @@ async function mcp() {
 	const mcpDir = join(getStarterDir(), "content", "mcp", "en");
 	const server = new McpServer({
 		name: "8n",
-		version: "6.0.30"
+		version: "6.0.32"
 	});
 	server.registerTool("read_me", {
 		description: "Returns how to use the 8n MCP tools. Call this BEFORE documenting anything with 8n.",
@@ -4237,7 +4305,7 @@ Example: get_component({ name: "components" }) returns all available MDX compone
 
 //#endregion
 //#region src/index.ts
-const program = new Command().name("8n").description("Run your 8n docs site").version("6.0.30").addOption(new Option("--debug").hideHelp()).hook("preAction", (cmd) => {
+const program = new Command().name("8n").description("Run your 8n docs site").version("6.0.32").addOption(new Option("--debug").hideHelp()).hook("preAction", (cmd) => {
 	if (cmd.opts().debug) process.env.DEBUG_8N = "1";
 });
 program.command("init").description("Scaffold a new docs project in the current directory").action(init);

package/package.json

@@ -30,5 +30,5 @@
     "typescript": "^5.9.3",
     "zod": "^4.3.6"
   },
-  "version": "6.0.30"
+  "version": "6.0.32"
 }

package/starter/app/api/auth/callback/route.js

@@ -0,0 +1 @@
+import{redirect as t}from"next/navigation";import{exchangeCode as r,getGitHubUser as a,hasRepoAccess as e,parseState as i,setSession as o}from"../../../../src/features/auth";import{env as n}from"../../../../src/config";export async function GET(s){if(!n.AUTH_ENABLED)return new Response("Auth not enabled",{status:404});let c=new URL(s.url),g=c.searchParams.get("code"),{returnTo:l}=i(c.searchParams.get("state")??"");g||t("/login?error=missing_code");try{let i=await r(g),s=await a(i);n.AUTH_REPO&&(await e(i,n.AUTH_REPO)||t("/login?error=access_denied")),await o({sub:String(s.id),login:s.login})}catch{t("/login?error=auth_failed")}t(l.startsWith("/")?l:"/")}

package/starter/app/api/auth/login/route.js

@@ -0,0 +1 @@
+import{redirect as r}from"next/navigation";import{buildAuthorizationUrl as t}from"../../../../src/features/auth";import{env as e}from"../../../../src/config";export function GET(n){if(!e.AUTH_ENABLED)return new Response("Auth not enabled",{status:404});r(t(new URL(n.url).searchParams.get("returnTo")??"/"))}

package/starter/app/api/auth/logout/route.js

@@ -0,0 +1 @@
+import{redirect as t}from"next/navigation";import{clearSession as n}from"../../../../src/features/auth";import{env as o}from"../../../../src/config";export async function GET(){if(!o.AUTH_ENABLED)return new Response("Auth not enabled",{status:404});await n(),t("/login")}

package/starter/app/login/page.jsx

@@ -0,0 +1 @@
+import{jsx as e,jsxs as t}from"react/jsx-runtime";import{env as n}from"../../src/config";let i={access_denied:"Your GitHub account does not have access to this documentation.",auth_failed:"Authentication failed. Please try again.",missing_code:"Invalid OAuth response. Please try again."};export default function r({searchParams:t}){return e(a,{searchParamsPromise:t})}async function a({searchParamsPromise:r}){let{returnTo:s="/",error:o}=await r,d=`/api/auth/login?returnTo=${encodeURIComponent(s)}`,l=n.NEXT_PUBLIC_SITE_NAME,u=o?i[o]??"Something went wrong.":null;return e("div",{className:"flex min-h-screen flex-col items-center justify-center bg-background px-6",children:t("div",{className:"flex w-full max-w-sm flex-col gap-6",children:[t("div",{className:"text-center",children:[e("h1",{className:"text-2xl font-bold tracking-tight",children:l}),e("p",{className:"mt-1 text-sm text-muted-foreground",children:"Sign in to access the documentation."})]}),u&&e("p",{className:"rounded-md border border-destructive/30 bg-destructive/10 px-4 py-3 text-sm text-destructive",children:u}),t("a",{href:d,className:"flex items-center justify-center gap-2 rounded-lg bg-primary px-4 py-2.5 text-sm font-medium text-primary-foreground transition-opacity hover:opacity-90",children:[e(c,{}),"Continue with GitHub"]})]})})}function c(){return e("svg",{width:"16",height:"16",viewBox:"0 0 24 24",fill:"currentColor","aria-hidden":"true",children:e("path",{d:"M12 2C6.477 2 2 6.484 2 12.017c0 4.425 2.865 8.18 6.839 9.504.5.092.682-.217.682-.483 0-.237-.008-.868-.013-1.703-2.782.605-3.369-1.343-3.369-1.343-.454-1.158-1.11-1.466-1.11-1.466-.908-.62.069-.608.069-.608 1.003.07 1.531 1.032 1.531 1.032.892 1.53 2.341 1.088 2.91.832.092-.647.35-1.088.636-1.338-2.22-.253-4.555-1.113-4.555-4.951 0-1.093.39-1.988 1.029-2.688-.103-.253-.446-1.272.098-2.65 0 0 .84-.27 2.75 1.026A9.564 9.564 0 0112 6.844c.85.004 1.705.115 2.504.337 1.909-1.296 2.747-1.027 2.747-1.027.546 1.379.202 2.398.1 2.651.64.7 1.028 1.595 1.028 2.688 0 3.848-2.339 4.695-4.566 4.943.359.309.678.92.678 1.855 0 1.338-.012 2.419-.012 2.747 0 .268.18.58.688.482A10.019 10.019 0 0022 12.017C22 6.484 17.522 2 12 2z"})})}

package/starter/package.json

@@ -106,5 +106,5 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"
   },
-  "version": "6.0.30"
+  "version": "6.0.32"
 }

package/starter/proxy.js

@@ -0,0 +1 @@
+import{NextResponse as e}from"next/server";import{checkAuth as t}from"./src/features/auth";export async function proxy(r){let n=await t(r.nextUrl.pathname,r.cookies.get("8n_session")?.value);return n?e.redirect(new URL(n.redirectTo,r.url)):e.next()}export const config={matcher:["/((?!_next/static|_next/image|favicon\\.ico|.*\\.(?:svg|png|jpg|jpeg|gif|webp)$).*)"]};

package/starter/src/config.js

@@ -1 +1 @@
-import{createEnv as e}from"@t3-oss/env-nextjs";import{z as _}from"zod";let s=_.string().default("[]").transform(e=>JSON.parse(e)),t=_.string().default("{}").transform(e=>JSON.parse(e));export const env=e({server:{SITE_URL:_.string().default("http://localhost:3000"),CONTENT_DIR:_.string().default("./content"),SECTIONS:t},client:{NEXT_PUBLIC_SITE_NAME:_.string().default("Docs"),NEXT_PUBLIC_GITHUB_REPO:_.string().optional(),NEXT_PUBLIC_NAV_LINKS:s,NEXT_PUBLIC_ANIMATIONS:_.enum(["true","false"]).default("true").transform(e=>"true"===e)},runtimeEnv:{SITE_URL:process.env.SITE_URL??(process.env.VERCEL_PROJECT_PRODUCTION_URL?`https://${process.env.VERCEL_PROJECT_PRODUCTION_URL}`:process.env.VERCEL_URL?`https://${process.env.VERCEL_URL}`:void 0),CONTENT_DIR:process.env.CONTENT_DIR,SECTIONS:process.env.SECTIONS,NEXT_PUBLIC_SITE_NAME:process.env.NEXT_PUBLIC_SITE_NAME,NEXT_PUBLIC_GITHUB_REPO:process.env.NEXT_PUBLIC_GITHUB_REPO,NEXT_PUBLIC_NAV_LINKS:process.env.NEXT_PUBLIC_NAV_LINKS,NEXT_PUBLIC_ANIMATIONS:process.env.NEXT_PUBLIC_ANIMATIONS}});export function isSectionHidden(e){return!1===env.SECTIONS[e]}"development"===process.env.NODE_ENV&&env.NEXT_PUBLIC_GITHUB_REPO?.includes("your-org/your-repo")&&console.warn("[8n-starter] ⚠ NEXT_PUBLIC_GITHUB_REPO is still the placeholder value.\n  Set github.repo in 8n.config.ts to enable Edit on GitHub links.");
+import{createEnv as e}from"@t3-oss/env-nextjs";import{z as T}from"zod";let _=T.string().default("[]").transform(e=>JSON.parse(e)),E=T.string().default("{}").transform(e=>JSON.parse(e));export const env=e({server:{SITE_URL:T.string().default("http://localhost:3000"),CONTENT_DIR:T.string().default("./content"),SECTIONS:E,AUTH_ENABLED:T.enum(["true"]).optional(),AUTH_REPO:T.string().optional(),AUTH_PROTECT:T.string().default("true"),AUTH_SESSION_DURATION:T.string().default("7d"),GITHUB_CLIENT_ID:T.string().optional(),GITHUB_CLIENT_SECRET:T.string().optional(),AUTH_SECRET:T.string().optional()},client:{NEXT_PUBLIC_SITE_NAME:T.string().default("Docs"),NEXT_PUBLIC_GITHUB_REPO:T.string().optional(),NEXT_PUBLIC_NAV_LINKS:_,NEXT_PUBLIC_ANIMATIONS:T.enum(["true","false"]).default("true").transform(e=>"true"===e)},runtimeEnv:{SITE_URL:process.env.SITE_URL??(process.env.VERCEL_PROJECT_PRODUCTION_URL?`https://${process.env.VERCEL_PROJECT_PRODUCTION_URL}`:process.env.VERCEL_URL?`https://${process.env.VERCEL_URL}`:void 0),CONTENT_DIR:process.env.CONTENT_DIR,SECTIONS:process.env.SECTIONS,AUTH_ENABLED:process.env.AUTH_ENABLED,AUTH_REPO:process.env.AUTH_REPO,AUTH_PROTECT:process.env.AUTH_PROTECT,AUTH_SESSION_DURATION:process.env.AUTH_SESSION_DURATION,GITHUB_CLIENT_ID:process.env.GITHUB_CLIENT_ID,GITHUB_CLIENT_SECRET:process.env.GITHUB_CLIENT_SECRET,AUTH_SECRET:process.env.AUTH_SECRET,NEXT_PUBLIC_SITE_NAME:process.env.NEXT_PUBLIC_SITE_NAME,NEXT_PUBLIC_GITHUB_REPO:process.env.NEXT_PUBLIC_GITHUB_REPO,NEXT_PUBLIC_NAV_LINKS:process.env.NEXT_PUBLIC_NAV_LINKS,NEXT_PUBLIC_ANIMATIONS:process.env.NEXT_PUBLIC_ANIMATIONS}});export function isSectionHidden(e){return!1===env.SECTIONS[e]}"development"===process.env.NODE_ENV&&env.NEXT_PUBLIC_GITHUB_REPO?.includes("your-org/your-repo")&&console.warn("[8n-starter] ⚠ NEXT_PUBLIC_GITHUB_REPO is still the placeholder value.\n  Set github.repo in 8n.config.ts to enable Edit on GitHub links.");

package/starter/src/features/auth/check.js

@@ -0,0 +1 @@
+import{env as t}from"../../config";import{verifyJWT as o}from"./jwt";let e=["/api/auth/","/login"];export async function checkAuth(n,r){if(!t.AUTH_ENABLED||!t.AUTH_SECRET||e.some(t=>n.startsWith(t)))return null;let i=JSON.parse(t.AUTH_PROTECT);return("boolean"==typeof i?i:i.some(t=>n.startsWith(t)))?r&&await o(r,t.AUTH_SECRET)?null:{redirectTo:`/login?returnTo=${encodeURIComponent(n)}`}:null}

package/starter/src/features/auth/github.js

@@ -0,0 +1 @@
+import{env as t}from"../../config";export function buildAuthorizationUrl(e){let r=btoa(JSON.stringify({returnTo:e})).replace(/=/g,"").replace(/\+/g,"-").replace(/\//g,"_"),o=new URLSearchParams({client_id:t.GITHUB_CLIENT_ID,scope:"read:user",state:r});return`https://github.com/login/oauth/authorize?${o}`}export function parseState(t){try{let e=t.replace(/-/g,"+").replace(/_/g,"/"),r=e.length%4;return JSON.parse(atob(r?e+"=".repeat(4-r):e))}catch{return{returnTo:"/"}}}export async function exchangeCode(e){let r=await fetch("https://github.com/login/oauth/access_token",{method:"POST",headers:{"Content-Type":"application/json",Accept:"application/json"},body:JSON.stringify({client_id:t.GITHUB_CLIENT_ID,client_secret:t.GITHUB_CLIENT_SECRET,code:e})}),o=await r.json();if(!o.access_token)throw Error(o.error??"token exchange failed");return o.access_token}export async function getGitHubUser(t){let e=await fetch("https://api.github.com/user",{headers:{Authorization:`Bearer ${t}`,Accept:"application/vnd.github+json"}});if(!e.ok)throw Error("failed to fetch GitHub user");return e.json()}export async function hasRepoAccess(t,e){return(await fetch(`https://api.github.com/repos/${e}`,{headers:{Authorization:`Bearer ${t}`,Accept:"application/vnd.github+json"}})).ok}

package/starter/src/features/auth/index.js

@@ -0,0 +1 @@
+export{getSession,setSession,clearSession,parseDuration}from"./session";export{buildAuthorizationUrl,parseState,exchangeCode,getGitHubUser,hasRepoAccess}from"./github.js";export{checkAuth}from"./check.js";

package/starter/src/features/auth/jwt.js

@@ -0,0 +1 @@
+let e=new TextEncoder;function t(e){let t="",n=new Uint8Array(e);for(let e=0;e<n.length;e++)t+=String.fromCharCode(n[e]);return btoa(t).replace(/=/g,"").replace(/\+/g,"-").replace(/\//g,"_")}function n(e){let t=e.replace(/-/g,"+").replace(/_/g,"/"),n=t.length%4,r=atob(n?t+"=".repeat(4-n):t),l=new Uint8Array(r.length);for(let e=0;e<r.length;e++)l[e]=r.charCodeAt(e);return l}async function r(t){return crypto.subtle.importKey("raw",e.encode(t),{name:"HMAC",hash:"SHA-256"},!1,["sign","verify"])}export async function signJWT(n,l){let a=t(e.encode(JSON.stringify({alg:"HS256",typ:"JWT"}))),c=t(e.encode(JSON.stringify(n))),i=await r(l),o=await crypto.subtle.sign("HMAC",i,e.encode(`${a}.${c}`));return`${a}.${c}.${t(o)}`}export async function verifyJWT(t,l){let a=t.split(".");if(3!==a.length)return null;let[c,i,o]=a;try{let t=await r(l);if(!await crypto.subtle.verify("HMAC",t,n(o),e.encode(`${c}.${i}`)))return null;let a=JSON.parse(new TextDecoder().decode(n(i)));if(a.exp<Date.now()/1e3)return null;return a}catch{return null}}

package/starter/src/features/auth/session.js

@@ -0,0 +1 @@
+import{cookies as e}from"next/headers";import{env as t}from"../../config";import{signJWT as n,verifyJWT as o}from"./jwt.js";let r="8n_session";export function parseDuration(e){let t=/^(\d+)([smhd])$/.exec(e);return t?parseInt(t[1])*({s:1,m:60,h:3600,d:86400})[t[2]]:604800}export async function getSession(){if(!t.AUTH_ENABLED||!t.AUTH_SECRET)return null;let n=(await e()).get(r)?.value;return n?o(n,t.AUTH_SECRET):null}export async function setSession(o){let a=t.AUTH_SECRET,s=parseDuration(t.AUTH_SESSION_DURATION),i=await n({...o,exp:Math.floor(Date.now()/1e3)+s},a);(await e()).set(r,i,{httpOnly:!0,secure:"production"===process.env.NODE_ENV,sameSite:"lax",path:"/",maxAge:s})}export async function clearSession(){(await e()).delete(r)}