@nodefony/framework 10.0.0-beta.2 → 10.0.0-beta.4

package/dist/nodefony/src/ResourceController.js

@@ -1,7 +1,7 @@
 import Controller from "./Controller.js";
 import { assertPageQuery } from "nodefony";
 import { HttpError } from "@nodefony/http";
-//#region nodefony/src/ResourceController.ts
+// nodefony/src/ResourceController.ts
 /**
 * Controller de ressource **souverain** (V4.2 — POC API souveraine, Phase 2) :
 * la logique métier est écrite UNE fois dans le service de ressource, les
@@ -22,7 +22,7 @@ import { HttpError } from "@nodefony/http";
 *   sur `this` doit rétrograder : `static scope = "request"`.
 *
 * Sécurité : aucun critère de requête n'est passé AUTOMATIQUEMENT au service
-* (pas de `find(this.queryGet)` implicite) — exposer un filtrage est une
+* (pas de `find(this.query)` implicite) — exposer un filtrage est une
 * décision EXPLICITE de la sous-classe (deny-by-default ; le scope de
 * sécurité des données se branche au niveau service/criteria, P6).
 *
@@ -144,5 +144,4 @@ var ResourceController = class extends Controller {
 		return Promise.resolve(resource.delete(criteria));
 	}
 };
-//#endregion
 export { ResourceController as default };

package/dist/nodefony/src/Route.js

@@ -1,7 +1,7 @@
 import { escapeRegExp, stripTrailingSlashes, typeOf } from "nodefony";
 import { HttpError, compileDomainPatterns, isDomainAllowed } from "@nodefony/http";
 import { createHash } from "node:crypto";
-//#region nodefony/src/Route.ts
+// nodefony/src/Route.ts
 /**
 * Motif d'un segment variable : `{id}`, `/{slug}?`, `.{format}`, `{id}(\d+)`.
 *
@@ -99,6 +99,32 @@ function replaceCallback(_match, slash, dot, key, capture, opt, _offset) {
 	}
 	throw new Error(`Bad path `);
 }
+/**
+* Exigences d'une route, l'option `method` versée dans `requirements.methods`.
+*
+* Seul `requirements.methods` restreint le match ; l'option `method` n'était
+* lue que pour l'affichage, si bien qu'une route « POST » servait toutes les
+* méthodes. Les deux déclarations s'UNISSENT, comme le font les décorateurs
+* `@Get`/`@Post` : déclarer n'élargit jamais en silence ni n'écrase.
+*
+* @param requirements - exigences déclarées (jamais mutées)
+* @param method - méthode(s) de l'option `method`
+* @returns les exigences à poser sur la route
+*/
+function withDeclaredMethod(requirements, method) {
+	if (method === void 0) return requirements ?? {};
+	const own = requirements?.methods;
+	const union = new Set(Array.isArray(method) ? method : [method]);
+	if (own !== void 0) for (const m of Array.isArray(own) ? own : [own]) union.add(m);
+	return {
+		...requirements,
+		methods: [...union]
+	};
+}
+/** Canal chiffré : `https` (HTTP) ou `wss` (WebSocket). */
+function isSecureScheme(scheme) {
+	return scheme === "https" || scheme === "wss";
+}
 var Route = class Route {
 	name;
 	path;
@@ -106,7 +132,6 @@ var Route = class Route {
 	classMethod;
 	prefix;
 	method;
-	schemes;
 	pattern;
 	variables = [];
 	/**
@@ -144,6 +169,8 @@ var Route = class Route {
 	* pas son rôle par défaut. Cf {@link RouteOptions.areaRoleExempt}.
 	*/
 	areaRoleExempt = false;
+	/** Route de repli, résolue après toutes les autres. Cf {@link RouteOptions.fallback}. */
+	fallback = false;
 	/**
 	* P2.9 — Cache mémoïsé : l'action attend-elle le **flux brut** du body
 	* (`@Body({ stream:true })`) ? `undefined` = pas encore calculé (résolu au 1er
@@ -177,9 +204,10 @@ var Route = class Route {
 			this.method = obj.method;
 			this.setHostname(obj.host);
 			this.setDefaults(obj.defaults);
-			this.requirements = obj.requirements ?? {};
+			this.requirements = withDeclaredMethod(obj.requirements, obj.method);
 			this.bypassFirewall = obj.bypassFirewall ?? false;
 			this.areaRoleExempt = obj.areaRoleExempt ?? false;
+			this.fallback = obj.fallback ?? false;
 			this.compile();
 		}
 		this.generateId();
@@ -238,7 +266,7 @@ var Route = class Route {
 				const k = this.variables[i] || "wildcard";
 				param &&= decode(param);
 				const req = this.getRequirement(k);
-				let result = null;
+				let result;
 				if (req) {
 					let compiled = this.varRegexp?.[k];
 					if (!compiled) {
@@ -366,7 +394,8 @@ var Route = class Route {
 		const action = this.classMethod || this.name;
 		const mod = this.module?.name ? `@${this.module.name}/` : "";
 		const auth = this.bypassFirewall ? "  (no auth)" : this.areaRoleExempt ? "  (hors rôle de zone)" : "";
-		return `${method} ${this.path} → ${mod}${ctrl}.${action}${auth}`;
+		const fallback = this.fallback ? "  (repli)" : "";
+		return `${method} ${this.path} → ${mod}${ctrl}.${action}${auth}${fallback}`;
 	}
 	toObject() {
 		return {
@@ -376,10 +405,11 @@ var Route = class Route {
 			host: this.host,
 			controller: this.defaults.controller,
 			filePath: this.filePath,
-			schemes: this.schemes,
+			schemes: this.requirements.scheme,
 			variables: this.variables,
 			bypassFirewall: this.bypassFirewall,
-			areaRoleExempt: this.areaRoleExempt
+			areaRoleExempt: this.areaRoleExempt,
+			fallback: this.fallback
 		};
 	}
 	setDefaults(arg) {
@@ -459,6 +489,13 @@ var Route = class Route {
 		return Object.keys(this.requirements).length;
 	}
 	matchRequirements(context, methodOverride) {
+		if (this.requirements.methods === void 0 && (methodOverride !== void 0 || context.method === "WEBSOCKET")) {
+			const error = new HttpError(`Method ${methodOverride ?? "WEBSOCKET"} Not Allowed`);
+			error.code = 405;
+			error.type = "method";
+			error.allow = "";
+			throw error;
+		}
 		if (this.hasRequirements()) for (const i in this.requirements) switch (i) {
 			case "methods":
 				if (!this.methodsSet) throw new Error(`Bad config route method : ${String(this.requirements.methods)}`);
@@ -480,6 +517,16 @@ var Route = class Route {
 					throw error;
 				}
 				break;
+			case "scheme": {
+				const required = this.requirements.scheme;
+				if (required !== void 0 && isSecureScheme(required) !== isSecureScheme(context.scheme)) {
+					const error = new HttpError(`Scheme ${context.scheme} Forbidden for this route : ${required} required`);
+					error.code = 403;
+					error.type = "scheme";
+					throw error;
+				}
+				break;
+			}
 			case "domain": break;
 			case "protocol": if (context.method === "WEBSOCKET") {
 				const requirement = this.requirements[i];
@@ -502,5 +549,4 @@ var Route = class Route {
 		return true;
 	}
 };
-//#endregion
 export { Route as default };

package/dist/nodefony/src/SecurityApiController.js

@@ -0,0 +1,23 @@
+import Controller from "./Controller.js";
+// nodefony/src/SecurityApiController.ts
+const NO_STORE = { "cache-control": "no-store" };
+/**
+* Base des contrôleurs d'authentification (`/nodefony/security/api/*`) : toute
+* réponse JSON part en `Cache-Control: no-store`.
+*
+* Ces réponses portent une identité, un jeton, un secret affiché une seule
+* fois (clé API, secret TOTP, codes de récupération) ou leur refus. Un cookie
+* ou un en-tête dans la requête n'empêche pas un cache partagé de STOCKER la
+* réponse (RFC 9111 §3) ; RFC 6749 §5.1 exige `no-store` sur un jeton. La règle
+* vit ici, une fois : une action ajoutée à un contrôleur héritier ne peut pas
+* l'oublier. Un en-tête passé par l'action garde la priorité.
+*/
+var SecurityApiController = class extends Controller {
+	renderJson(obj, status, headers) {
+		return super.renderJson(obj, status, {
+			...NO_STORE,
+			...headers
+		});
+	}
+};
+export { SecurityApiController as default };

package/dist/nodefony/src/SyslogAdminApi.js

@@ -2,7 +2,7 @@ import { SYSLOG_FILTERS, SYSLOG_SORTABLE } from "./syslogFilters.js";
 import path from "node:path";
 import { Syslog, getActiveLogDriver, getLogDriver, listLogDrivers, parseFilters, parsePageQuery, redactSecrets, setActiveLogDriver } from "nodefony";
 import fsp from "node:fs/promises";
-//#region nodefony/src/SyslogAdminApi.ts
+// nodefony/src/SyslogAdminApi.ts
 /** Plafond d'octets lus en queue de fichier (tail / fenêtre incrémentale). */
 const MAX_TAIL_BYTES = 262144;
 /**
@@ -462,5 +462,4 @@ function createSyslogAdminApi(syslog, options = {}) {
 		adminEndpoints: () => endpoints
 	};
 }
-//#endregion
 export { createSyslogAdminApi };

package/dist/nodefony/src/Template.js

@@ -1,5 +1,5 @@
 import { Service } from "nodefony";
-//#region nodefony/src/Template.ts
+// nodefony/src/Template.ts
 var Template = class extends Service {
 	engine;
 	module;
@@ -11,5 +11,4 @@ var Template = class extends Service {
 		this.cache = module.kernel?.environment === "prod" || module.kernel?.environment === "production";
 	}
 };
-//#endregion
 export { Template as default };

package/dist/nodefony/src/configMutation.js

@@ -1,4 +1,4 @@
-//#region nodefony/src/configMutation.ts
+// nodefony/src/configMutation.ts
 /** Narrowing défensif : `unknown` → nœud JSON Schema (ou `null` si non-objet). */
 function asNode(value) {
 	if (value !== null && typeof value === "object" && !Array.isArray(value)) return value;
@@ -182,5 +182,4 @@ function getResolvedPath(obj, segments) {
 	}
 	return cur;
 }
-//#endregion
 export { getResolvedPath, navigateSchemaNode, nodeFlags, notEditableReason, recipeFor, validateLeafValue };

package/dist/nodefony/src/docsReader.js

@@ -1,11 +1,11 @@
 import { basename, dirname, extname, join } from "node:path";
-import { findProjectRoot, packageManagerCommandLines, packageManagerExecArgs, portableSpawn, resolvePackageManager, resolveSymbolsFile } from "nodefony";
+import { findProjectRoot, isDocVisible, packageManagerCommandLines, packageManagerExecArgs, portableSpawn, readDocScope, readSymbolsGraph, resolvePackageManager } from "nodefony";
 import { existsSync } from "node:fs";
 import { promisify } from "node:util";
 import { readFile, readdir, stat } from "node:fs/promises";
 import { fileURLToPath } from "node:url";
 import { execFile, spawn } from "node:child_process";
-//#region nodefony/src/docsReader.ts
+// nodefony/src/docsReader.ts
 const execFileAsync = promisify(execFile);
 /**
 * Racine de l'APPLICATION servie — jamais le dossier courant du process.
@@ -97,11 +97,19 @@ async function gitLastUpdated(file) {
 		return null;
 	}
 }
-/** Construit un `DocSummary` à partir du contenu brut d'un `.md`. */
-async function summarize(docsDir, fileName, withGit) {
+/**
+* La page se sert-elle dans ce décor ? Portée lue dans `publish` par la règle
+* du cœur (`readDocScope`/`isDocVisible`) — la même que le portail et le site.
+*/
+function servable(data, frameworkRepository) {
+	return isDocVisible(readDocScope(data.publish), frameworkRepository);
+}
+/** Construit un `DocSummary` à partir du contenu brut d'un `.md` — `null` si la page n'est pas servie ici. */
+async function summarize(docsDir, fileName, withGit, frameworkRepository) {
 	const slug = basename(fileName, extname(fileName));
 	const full = join(docsDir, fileName);
 	const { data, body } = parseFrontmatter(await readFile(full, "utf8"));
+	if (!servable(data, frameworkRepository)) return null;
 	const title = docTitle(data, body, slug);
 	return {
 		slug,
@@ -121,7 +129,7 @@ async function summarize(docsDir, fileName, withGit) {
 * @param modulePath - chemin disque du module (`Module.path`).
 * @returns liste triée (vide si le dossier `docs/` est absent).
 */
-async function listModuleDocs(modulePath, withGit = false) {
+async function listModuleDocs(modulePath, withGit = false, frameworkRepository = false) {
 	const docsDir = join(modulePath, "docs");
 	let entries;
 	try {
@@ -130,21 +138,34 @@ async function listModuleDocs(modulePath, withGit = false) {
 		return [];
 	}
 	const mdFiles = entries.filter((f) => f.toLowerCase().endsWith(".md"));
-	return (await Promise.all(mdFiles.map((f) => summarize(docsDir, f, withGit)))).sort((a, b) => a.order - b.order || a.slug.localeCompare(b.slug));
+	return (await Promise.all(mdFiles.map((f) => summarize(docsDir, f, withGit, frameworkRepository)))).filter((d) => d !== null).sort((a, b) => a.order - b.order || a.slug.localeCompare(b.slug));
 }
 /**
-* Comptage rapide des docs (`*.md`) d'un module — readdir seul, sans lire/parser
-* ni `git`. Pour les KPI/overview (`docsCount`) où seul le nombre importe.
+* Comptage des docs SERVIES d'un module, sans `git` — pour les KPI/overview
+* (`docsCount`) où seul le nombre importe. Le frontmatter est lu : le compte
+* suit la même portée (`publish`) que la liste, sinon le KPI annonce des pages
+* que l'onglet Docs refuse d'ouvrir.
 *
 * @param modulePath - chemin disque du module (`Module.path`).
-* @returns nombre de fichiers `.md` dans `<modulePath>/docs/` (0 si absent).
+* @param frameworkRepository - vrai dans le dépôt du framework (pages `core` servies).
+* @returns nombre de pages servies dans `<modulePath>/docs/` (0 si absent).
 */
-async function countModuleDocs(modulePath) {
+async function countModuleDocs(modulePath, frameworkRepository = false) {
+	const docsDir = join(modulePath, "docs");
+	let entries;
 	try {
-		return (await readdir(join(modulePath, "docs"))).filter((f) => f.toLowerCase().endsWith(".md")).length;
+		entries = await readdir(docsDir);
 	} catch {
 		return 0;
 	}
+	return (await Promise.all(entries.filter((f) => f.toLowerCase().endsWith(".md")).map(async (f) => {
+		try {
+			const { data } = parseFrontmatter(await readFile(join(docsDir, f), "utf8"));
+			return servable(data, frameworkRepository);
+		} catch {
+			return false;
+		}
+	}))).filter(Boolean).length;
 }
 /**
 * Lit une doc module par slug : frontmatter + corps markdown brut.
@@ -154,7 +175,7 @@ async function countModuleDocs(modulePath) {
 *
 * @returns `null` si slug invalide ou fichier absent.
 */
-async function readModuleDoc(modulePath, slug) {
+async function readModuleDoc(modulePath, slug, frameworkRepository = false) {
 	if (!SLUG_RE.test(slug)) return null;
 	const full = join(modulePath, "docs", `${slug}.md`);
 	let raw;
@@ -164,6 +185,7 @@ async function readModuleDoc(modulePath, slug) {
 		return null;
 	}
 	const { data, body } = parseFrontmatter(raw);
+	if (!servable(data, frameworkRepository)) return null;
 	return {
 		slug,
 		frontmatter: data,
@@ -276,9 +298,10 @@ async function searchModuleDocs(targets, query, options = {}) {
 			} catch {
 				continue;
 			}
-			scanned += 1;
 			const slug = basename(fileName, extname(fileName));
 			const { data, body } = parseFrontmatter(raw);
+			if (!servable(data, options.frameworkRepository ?? false)) continue;
+			scanned += 1;
 			const title = docTitle(data, body, slug);
 			const foldedTitle = fold(`${title} ${typeof data.navTitle === "string" && data.navTitle.trim() ? data.navTitle.trim() : ""} ${slug}`);
 			const lines = body.split("\n");
@@ -347,15 +370,9 @@ async function searchModuleDocs(targets, query, options = {}) {
 * @returns symboles exportés triés par kind puis nom (vide si fichier absent).
 */
 async function listModuleSymbols(packageName) {
-	const file = resolveSymbolsFile(process.cwd());
-	if (file === null) return [];
-	let parsed;
-	try {
-		parsed = JSON.parse(await readFile(file, "utf8"));
-	} catch {
-		return [];
-	}
-	const symbols = parsed.symbols ?? {};
+	const graph = readSymbolsGraph(process.cwd());
+	if (graph === null) return [];
+	const symbols = graph.symbols;
 	const out = [];
 	for (const sym of Object.values(symbols)) {
 		if (sym.module !== packageName || sym.exported !== true) continue;
@@ -935,5 +952,4 @@ async function readCoreInfo() {
 		dependencies
 	};
 }
-//#endregion
 export { CORE_PACKAGE, checkOutdated, countModuleDocs, listModuleDocs, listModuleSymbols, listTestFiles, listTestGroups, parseFrontmatter, readCoreInfo, readCoverage, readDependencies, readModuleDoc, readSymbolDeclaration, resolveCorePath, runModuleTests, searchModuleDocs, testRunCommand };

package/dist/nodefony/src/idempotency.js

@@ -1,6 +1,6 @@
 import { RequestContext } from "nodefony";
 import { createHash } from "node:crypto";
-//#region nodefony/src/idempotency.ts
+// nodefony/src/idempotency.ts
 /**
 * Logique **pure et partagée** de la porte d'idempotence des mutations, conforme à
 * `draft-ietf-httpapi-idempotency-key-header-06`. Source unique de la sémantique
@@ -51,28 +51,21 @@ function resolveIdempotencyKey(alsKey, header) {
 }
 /**
 * Identité stable pour **scoper** le cache d'idempotence (anti-IDOR : un
-* utilisateur ne doit jamais rejouer la clé d'un autre). Dérivée de l'utilisateur
-* (`username` / `identifier` / `id`, sans coupler le framework au contrat `IUser`),
-* avec fallback sur l'`userId` de l'ALS. `null` = pas d'identité fiable → l'appelant
-* n'utilise PAS le cache (jamais de partage cross-identité).
+* utilisateur ne doit jamais rejouer la clé d'un autre) : l'`identifier` de
+* l'utilisateur AUTHENTIFIÉ de la requête. `null` = pas d'identité fiable →
+* l'appelant n'utilise PAS le cache (jamais de partage cross-identité).
 *
-* ⚠️ Doit renvoyer la MÊME valeur quel que soit le transport pour un même compte
-* (sinon une mutation tentée en WS puis rejouée en HTTP ne dédoublonnerait pas).
-* D'où la dérivation de `request.user` (posé UNIFORMÉMENT dans l'ALS par les deux
-* transports), et NON de `getUserId()` seul (le firewall HTTP ne le pose pas
-* toujours — vécu S4).
+* La décision « authentifié ? » est celle du cœur
+* (`RequestContext.getAuthenticatedUser`) : l'anonyme d'une zone `anonymous`
+* rend `null`. Lire l'`identifier` de l'utilisateur BRUT faisait partager à
+* tous les visiteurs anonymes la même identité (`anon.`), donc le même cache.
+*
+* Même valeur quel que soit le transport pour un même compte : le pare-feu HTTP
+* et le pont realtime posent tous deux le jeton et l'utilisateur dans l'ALS —
+* une mutation tentée en WS puis rejouée en HTTP se dédoublonne.
 */
-function resolveIdentity(user) {
-	if (user && typeof user === "object") {
-		const o = user;
-		for (const v of [
-			o.username,
-			o.identifier,
-			o.id
-		]) if (typeof v === "string" && v) return v;
-	}
-	const uid = RequestContext.getUserId();
-	return typeof uid === "string" && uid ? uid : null;
+function resolveIdentity() {
+	return RequestContext.getAuthenticatedUser()?.identifier ?? null;
 }
 /**
 * Empreinte SHA-256 du **payload** d'une requête (parties sérialisables : nom de
@@ -133,5 +126,4 @@ async function evaluateIdempotency(opts) {
 		};
 	}
 }
-//#endregion
 export { IDEMPOTENCY_KEY_MAX, computeFingerprint, evaluateIdempotency, isMutationMethod, resolveIdempotencyKey, resolveIdentity };

package/dist/nodefony/src/idempotencyGc.js

@@ -1,5 +1,5 @@
 import { GcScheduler } from "nodefony";
-//#region nodefony/src/idempotencyGc.ts
+// nodefony/src/idempotencyGc.ts
 /**
 * Arme un {@link GcScheduler} qui purge périodiquement les entrées expirées d'un
 * store d'idempotence — **UNIQUEMENT si le store expose `gc()`**.
@@ -28,5 +28,4 @@ function scheduleIdempotencyGc(store, opts) {
 	opts.log?.(armed ? `idempotency gc armed — purge every ${opts.intervalS}s (SQL store exposes gc())` : `idempotency gc disarmed — intervalS=${opts.intervalS} (delegated to cron / external)`);
 	return scheduler;
 }
-//#endregion
 export { scheduleIdempotencyGc };

package/dist/nodefony/src/idempotencyStoreRegistry.js

@@ -1,4 +1,4 @@
-//#region nodefony/src/idempotencyStoreRegistry.ts
+// nodefony/src/idempotencyStoreRegistry.ts
 const factories = /* @__PURE__ */ new Map();
 /**
 * Enregistre (ou remplace) la fabrique d'un store d'idempotence distribué.
@@ -32,5 +32,4 @@ function listIdempotencyStores() {
 function listIdempotencyBackends() {
 	return ["memory", ...factories.keys()];
 }
-//#endregion
 export { getIdempotencyStoreFactory, listIdempotencyBackends, listIdempotencyStores, registerIdempotencyStore };