@nodefony/framework 10.0.0-alpha.3 → 10.0.0-alpha.4

package/dist/_virtual/{_@oxc-project_runtime@0.148.0 → _@oxc-project_runtime@0.149.0}/helpers/esm/decorate.js

@@ -1,4 +1,4 @@
-//#region \0@oxc-project+runtime@0.148.0/helpers/esm/decorate.js
+//#region \0@oxc-project+runtime@0.149.0/helpers/esm/decorate.js
 function __decorate(decorators, target, key, desc) {
 	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
 	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);

package/dist/_virtual/{_@oxc-project_runtime@0.148.0 → _@oxc-project_runtime@0.149.0}/helpers/esm/decorateMetadata.js

@@ -1,4 +1,4 @@
-//#region \0@oxc-project+runtime@0.148.0/helpers/esm/decorateMetadata.js
+//#region \0@oxc-project+runtime@0.149.0/helpers/esm/decorateMetadata.js
 function __decorateMetadata(k, v) {
 	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }

package/dist/index.js

@@ -7,8 +7,8 @@ import Route from "./nodefony/src/Route.js";
 import Controller from "./nodefony/src/Controller.js";
 import { All, Anonymous, Body, BypassFirewall, Cookie, Csp, CsrfExempt, CsrfProtect, CurrentUser, Delete, Domain, Get, Head, Header, Headers, HttpCode, Idempotent, IsGranted, Options, Param, Patch, Post, Put, Query, Redirect, Req, RequireScope, Res, Scope, Session, UploadedFile, UploadedFiles, UseSession, controller, controllers, route, routeExpectsBodyStream } from "./nodefony/decorators/routerDecorators.js";
 import Resolver from "./nodefony/src/Resolver.js";
-import __decorateMetadata from "./_virtual/_@oxc-project_runtime@0.148.0/helpers/esm/decorateMetadata.js";
-import __decorate from "./_virtual/_@oxc-project_runtime@0.148.0/helpers/esm/decorate.js";
+import __decorateMetadata from "./_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
+import __decorate from "./_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
 import router_default from "./nodefony/service/router.js";
 import ResourceController from "./nodefony/src/ResourceController.js";
 import AdminApiController from "./nodefony/controller/AdminApiController.js";
@@ -29,7 +29,7 @@ import { createFrameworkAdminApi } from "./nodefony/src/FrameworkAdminApi.js";
 import { createSyslogAdminApi } from "./nodefony/src/SyslogAdminApi.js";
 import Eta from "./nodefony/service/Eta.js";
 import path from "node:path";
-import { AUTO_STORE, EMPTY_INFRA, Kernel, Module, readStoreLocation, resolveAutoStore, services } from "nodefony";
+import { AUTO_STORE, EMPTY_INFRA, Kernel, Module, durableStoreRemedy, readStoreLocation, resolveAutoStore, runNeedsExternalServices, services } from "nodefony";
 import { mergeResolvers, mergeTypeDefs } from "@graphql-tools/merge";
 import { makeExecutableSchema, mergeSchemas } from "@graphql-tools/schema";
 //#region index.ts
@@ -91,13 +91,13 @@ let Framework = class Framework extends Module {
 		let name = configured;
 		let reason = `store explicitement configuré ("${configured}")`;
 		if (name === AUTO_STORE) {
-			const auto = resolveAutoStore("ephemeral", this.kernel?.infra ?? EMPTY_INFRA, listIdempotencyBackends());
+			const auto = resolveAutoStore("ephemeral", this.kernel?.infra ?? EMPTY_INFRA, listIdempotencyBackends(), "memory", runNeedsExternalServices(this.kernel));
 			name = auto.store;
 			reason = auto.reason;
 			this.log(`idempotency.store "auto" → "${name}" (${auto.reason})`, "INFO");
 		}
 		if (name === "memory") {
-			if (this.kernel?.environment === "production") this.log("idempotency.store \"memory\" en PRODUCTION — déduplication per-pod uniquement : un rejeu routé vers un autre pod n'est pas dédupliqué (double-effet possible). Déclarer une infra partagée (NF_REDIS_URL ou NF_DATABASE_URL).", "WARNING");
+			if (this.kernel?.environment === "production") this.log("idempotency.store \"memory\" en PRODUCTION — déduplication per-pod uniquement : un rejeu routé vers un autre pod n'est pas dédupliqué (double-effet possible). " + durableStoreRemedy(runNeedsExternalServices(this.kernel)), "WARNING");
 			this.kernel?.registerStoreResolution({
 				brick: "idempotency",
 				nature: "ephemeral",

package/dist/nodefony/controller/OAuth2Controller.js

@@ -30,13 +30,22 @@ var OAuth2Controller = class extends Controller {
 		super("OAuth2Controller", context);
 	}
 	/**
-	* Liste PUBLIQUE des fournisseurs activés (configurés ET connus du registre).
-	* Consommé par l'UI de login pour n'afficher QUE les boutons opérationnels —
-	* jamais de bouton mort. Aucun secret n'est exposé (uniquement les noms).
+	* Liste PUBLIQUE des fournisseurs à proposer à l'écran de connexion.
+	*
+	* Rend `{ name, label }` : le libellé vient du serveur, seul à connaître la
+	* configuration — un écran ne doit jamais avoir à deviner comment nommer un
+	* fournisseur, ni s'autoriser à en masquer un qu'il ne reconnaît pas. Un
+	* fournisseur déclaré `hidden` n'y figure pas, mais reste autorisable :
+	* masquer n'est pas désactiver. Aucun secret n'est exposé.
 	*/
 	providers() {
 		const svc = this.#service();
-		return this.renderJson({ providers: svc ? svc.listProviders() : [] });
+		if (!svc) return this.renderJson({ providers: [] });
+		const providers = svc.listDisplayProviders ? svc.listDisplayProviders() : svc.listProviders().map((name) => ({
+			name,
+			label: name
+		}));
+		return this.renderJson({ providers });
 	}
 	/** Démarre le flux : URL d'autorisation + état anti-replay en session, 302. */
 	async authorize(provider) {

package/dist/nodefony/service/AdminBroker.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.148.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.148.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
 import router_default from "./router.js";
 import AdminApiController from "../controller/AdminApiController.js";
 import { ADMIN_DEFAULT_ROLE, Module, Service, injectable, resolveAdminRole } from "nodefony";

package/dist/nodefony/service/IdempotencyStore.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.148.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.148.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
 import { Module, Service, assertPageQuery, injectable } from "nodefony";
 //#region nodefony/service/IdempotencyStore.ts
 const serviceName = "idempotencyStore";

package/dist/nodefony/service/router.js

@@ -1,8 +1,8 @@
 import Route from "../src/Route.js";
 import { routeExpectsBodyStream } from "../decorators/routerDecorators.js";
 import Resolver from "../src/Resolver.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.148.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.148.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
 import { Module, Service, injectable } from "nodefony";
 import { HttpError, isDomainAllowed } from "@nodefony/http";
 //#region nodefony/service/router.ts

package/dist/nodefony/src/KernelAdminApi.js

@@ -2,7 +2,7 @@ import { CORE_PACKAGE, checkOutdated, countModuleDocs, listModuleDocs, listModul
 import { getResolvedPath, navigateSchemaNode, nodeFlags, notEditableReason, recipeFor, validateLeafValue } from "./configMutation.js";
 import { createRequire } from "node:module";
 import { join } from "node:path";
-import { GitService, Syslog, applyResolvedPath, collectDevStatus, computeConfigProvenance, defaultAppConfig, extractJsonSchemaDefaults, extractMarkdownSection, getActiveLogDriver, listLogDrivers, outlineMarkdown, parseNfEnvOverrides } from "nodefony";
+import { GitService, Syslog, aggregateProvenance, applyResolvedPath, collectDevStatus, computeConfigProvenance, defaultAppConfig, extractJsonSchemaDefaults, extractMarkdownSection, flattenConfigSchema, getActiveLogDriver, listLogDrivers, outlineMarkdown, parseNfEnvOverrides, readResolvedPath } from "nodefony";
 import { randomUUID } from "node:crypto";
 import { existsSync, readFileSync } from "node:fs";
 //#region nodefony/src/KernelAdminApi.ts
@@ -617,6 +617,63 @@ function createKernelAdminApi(kernel) {
 			summary: "Aggregated config of all modules (effective values redacted + JSON Schema + per-field provenance) for the global config page",
 			handler: async () => ({ modules: buildConfigEntries() })
 		},
+		{
+			path: "config/schema",
+			summary: "Assignable config keys of every module (dotted path, type, default, effective value, provenance, description) — the CATALOG, where `config` gives the STATE",
+			handler: (request) => {
+				const wanted = request.query.module;
+				const filter = typeof wanted === "string" ? wanted.toLowerCase() : null;
+				const rows = [];
+				const entries = buildConfigEntries();
+				const matches = (name, key) => name.toLowerCase() === filter || key.toLowerCase() === filter;
+				if (filter !== null) {
+					const entry = entries.find((e) => matches(e.name, e.key));
+					if (!entry || entry.configSchema == null) {
+						const modules = kernel.getModules();
+						const nameOf = (k) => modules[k].getModuleName?.() ?? k;
+						const loadedKey = Object.keys(modules).find((k) => matches(nameOf(k), k));
+						if (loadedKey !== void 0) {
+							const name = nameOf(loadedKey);
+							return {
+								status: 404,
+								body: {
+									error: "Schema not published",
+									module: name,
+									loaded: true,
+									hint: `Le module ${name} est chargé mais ne publie pas son schéma de configuration : ajouter dans son index.ts \`override configSchema(): unknown { return z.toJSONSchema(schema); }\` (schéma Zod de nodefony/config/config.ts). Sans lui, ses clés sont indécouvrables ici.`
+								}
+							};
+						}
+						return {
+							status: 404,
+							body: {
+								error: "Unknown module",
+								module: wanted,
+								available: entries.map((e) => e.name)
+							}
+						};
+					}
+				}
+				for (const entry of entries) {
+					if (filter !== null && entry.name.toLowerCase() !== filter && entry.key.toLowerCase() !== filter) continue;
+					for (const leaf of flattenConfigSchema(entry.configSchema)) {
+						const path = leaf.key.split(".");
+						const note = SECRET_KEY.test(path[path.length - 1]) && !leaf.note.includes("secret") ? [leaf.note, "secret"].filter(Boolean).join(", ") : leaf.note;
+						rows.push({
+							key: leaf.key,
+							module: entry.name,
+							type: leaf.type,
+							default: leaf.default,
+							effective: readResolvedPath(entry.config, path),
+							source: aggregateProvenance(entry.provenance, leaf.key),
+							note,
+							description: leaf.description
+						});
+					}
+				}
+				return rows;
+			}
+		},
 		{
 			path: "stores",
 			summary: "Runtime persistence stores per brick (resolved store, provenance, available backends) + declared infra",

package/dist/types/index.d.ts

@@ -1,5 +1,5 @@
 import { Kernel, Module } from "nodefony";
-import type { FrameworkConfigInput, FrameworkConfig } from "./nodefony/config/config.js";
+import type { IFrameworkConfigInput, IFrameworkConfig } from "./nodefony/config/config.js";
 import { getIdempotencyStoreFactory, registerIdempotencyStore, listIdempotencyStores } from "./nodefony/src/idempotencyStoreRegistry.js";
 import Router from "./nodefony/service/router.js";
 import Route from "./nodefony/src/Route.js";
@@ -28,10 +28,10 @@ import { mergeSchemas, makeExecutableSchema } from "@graphql-tools/schema";
 import { controllers, route, controller, Get, Post, Put, Delete, Patch, Options, Head, All, Domain, BypassFirewall, IsGranted, RequireScope, Anonymous, Csp, CsrfProtect, CsrfExempt, Idempotent, CurrentUser, Scope, UseSession, HttpCode, Header, Redirect, Param, Body, Query, Headers, Cookie, Session, Req, Res, UploadedFile, UploadedFiles, routeExpectsBodyStream } from "./nodefony/decorators/routerDecorators.js";
 declare module "nodefony" {
     interface NodefonyModuleConfig {
-        "@nodefony/framework": FrameworkConfigInput;
+        "@nodefony/framework": IFrameworkConfigInput;
     }
 }
-declare class Framework extends Module<FrameworkConfig> {
+declare class Framework extends Module<IFrameworkConfig> {
     #private;
     constructor(kernel: Kernel);
     /** JSON Schema de la config framework → data plane admin (config riche Studio). */
@@ -91,6 +91,6 @@ export type { ControllerScope } from "./nodefony/src/Controller.js";
 export type { FrameworkAdminApiOptions } from "./nodefony/src/FrameworkAdminApi.js";
 export type { PlaygroundAction, PlaygroundController, PlaygroundGuards, PlaygroundParam, } from "./nodefony/src/PlaygroundAdminApi.js";
 export type { IResourceService, IResourceReadOptions, IResourcePageQuery, } from "./nodefony/src/ResourceController.js";
-export type { FrameworkConfig, FrameworkConfigInput, } from "./nodefony/config/config.js";
+export type { IFrameworkConfig, IFrameworkConfigInput, } from "./nodefony/config/config.js";
 export { defineFrameworkConfig, frameworkConfigJsonSchema, } from "./nodefony/config/defineModuleConfig.js";
 export type { IController, IRoute, IResolver, IAdminBroker, IAdminRoute, IIdempotencyStore, IdempotencyOutcome, IdempotentResponse, } from "./nodefony/interfaces/index.js";

package/dist/types/nodefony/config/config.d.ts

@@ -9,9 +9,9 @@ export declare const frameworkConfigSchema: z.ZodObject<{
     }, z.core.$strict>>;
 }, z.core.$strict>;
 /** Type de sortie (config normalisée + défauts appliqués). */
-export type FrameworkConfig = z.infer<typeof frameworkConfigSchema>;
+export type IFrameworkConfig = z.infer<typeof frameworkConfigSchema>;
 /** Type d'entrée (toutes sections omissibles — défauts du schéma). */
-export type FrameworkConfigInput = z.input<typeof frameworkConfigSchema>;
+export type IFrameworkConfigInput = z.input<typeof frameworkConfigSchema>;
 declare const _default: {
     router?: {
         [x: string]: unknown;

package/dist/types/nodefony/config/defineModuleConfig.d.ts

@@ -1,4 +1,4 @@
-import type { FrameworkConfig, FrameworkConfigInput } from "./config.js";
+import type { IFrameworkConfig, IFrameworkConfigInput } from "./config.js";
 /**
  * Builder type-safe de la configuration de `@nodefony/framework` (PUR — ne
  * retape JAMAIS un défaut : source unique = `./config.ts`).
@@ -18,7 +18,7 @@ import type { FrameworkConfig, FrameworkConfigInput } from "./config.js";
  * @throws BootConfigurationError si la config est invalide ou porte une clé
  *   inconnue — le boot s'interrompt, en dev comme en prod.
  */
-export declare function defineFrameworkConfig(config?: FrameworkConfigInput): FrameworkConfig;
+export declare function defineFrameworkConfig(config?: IFrameworkConfigInput): IFrameworkConfig;
 /**
  * JSON Schema introspectable de la config framework — destiné au formulaire
  * d'édition Studio et à la documentation générée (les flags de champ posés via

package/dist/types/nodefony/controller/OAuth2Controller.d.ts

@@ -8,7 +8,18 @@ import Controller from "../src/Controller.js";
  */
 export interface IOAuth2Service {
     isEnabled(): boolean;
+    /** Fournisseurs OPÉRATIONNELS — la garde de `/authorize`, jamais l'affichage. */
     listProviders(): string[];
+    /**
+     * Fournisseurs à AFFICHER, libellés compris. Optionnel à dessein : le
+     * couplage à `@nodefony/security` se fait par NOM, sans liaison de build —
+     * une version du module qui ne l'expose pas encore doit dégrader, pas
+     * casser l'écran de connexion (repli sur {@link listProviders}).
+     */
+    listDisplayProviders?(): {
+        name: string;
+        label: string;
+    }[];
     getRedirects(provider?: string): {
         success: string;
         failure: string;
@@ -63,9 +74,13 @@ declare class OAuth2Controller extends Controller {
     #private;
     constructor(context: ContextType);
     /**
-     * Liste PUBLIQUE des fournisseurs activés (configurés ET connus du registre).
-     * Consommé par l'UI de login pour n'afficher QUE les boutons opérationnels —
-     * jamais de bouton mort. Aucun secret n'est exposé (uniquement les noms).
+     * Liste PUBLIQUE des fournisseurs à proposer à l'écran de connexion.
+     *
+     * Rend `{ name, label }` : le libellé vient du serveur, seul à connaître la
+     * configuration — un écran ne doit jamais avoir à deviner comment nommer un
+     * fournisseur, ni s'autoriser à en masquer un qu'il ne reconnaît pas. Un
+     * fournisseur déclaré `hidden` n'y figure pas, mais reste autorisable :
+     * masquer n'est pas désactiver. Aucun secret n'est exposé.
      */
     providers(): Promise<import("@nodefony/http").Http2Response | import("@nodefony/http").HttpResponse | import("@nodefony/http").WebsocketResponse>;
     /** Démarre le flux : URL d'autorisation + état anti-replay en session, 302. */

package/dist/types/nodefony/src/KernelAdminApi.d.ts

@@ -38,6 +38,38 @@ export interface IConfigEntry {
      */
     overriddenBy: Record<string, string>;
 }
+/**
+ * Une clé assignable du catalogue de configuration — ce qu'on a le DROIT
+ * d'écrire, par opposition à {@link IConfigEntry} qui dit ce QUI EST écrit.
+ *
+ * Les noms de champs deviennent les en-têtes de colonnes de
+ * `nodefony inspect schema`, et les clés du JSON qu'un agent filtre.
+ */
+export interface ISchemaCatalogRow {
+    /**
+     * Chemin pointé de la clé (`certificates.selfSigned.hash`).
+     *
+     * EN PREMIER, et ce n'est pas cosmétique : le rendu tient la première
+     * colonne pour l'identité de la ligne et ne l'élague jamais, quand il retire
+     * les suivantes si elles valent partout pareil. `module` d'abord aurait donc
+     * fait répéter le nom du module sur les cent fiches d'un lot filtré.
+     */
+    key: string;
+    /** Nom de paquet du module qui porte la clé, tel qu'on l'écrit dans `use()`. */
+    module: string;
+    /** Type déclaré, ou les valeurs de l'énumération quand il y en a une. */
+    type: string;
+    /** Défaut du schéma — `undefined` si le schéma n'en pose aucun. */
+    default?: unknown;
+    /** Valeur résolue au boot, secrets déjà REDACTÉS par `computeConfigEntry`. */
+    effective: unknown;
+    /** D'où vient la valeur effective : `default`, `app`, `env` ou `runtime`. */
+    source: string;
+    /** Ce que les métadonnées disent de la clé (`réservé`, `secret`…), vide sinon. */
+    note: string;
+    /** La phrase du schéma (`.describe()`) — c'est elle qu'on venait chercher. */
+    description: string;
+}
 /**
  * Paquets à essayer pour une clé de module, **dans l'ordre**, et bornés au
  * périmètre du framework.

package/dist/types/nodefony/src/idempotencyStoreRegistry.d.ts

@@ -1,5 +1,5 @@
 import type { Module, IIdempotencyStore } from "nodefony";
-import type { FrameworkConfig } from "../config/config.js";
+import type { IFrameworkConfig } from "../config/config.js";
 /**
  * Registre de **fabriques de stores d'idempotence DISTRIBUÉS** — résout le nom
  * configuré (`framework.idempotency.store`) vers une instance d'
@@ -29,7 +29,7 @@ export interface IIdempotencyStoreFactoryContext {
     /** Module framework (porte `kernel.container` pour résoudre `redis`, etc.). */
     readonly module: Module;
     /** Config framework validée + gelée. */
-    readonly config: FrameworkConfig;
+    readonly config: IFrameworkConfig;
 }
 /** Fabrique d'un store d'idempotence pour un nom donné. */
 export type IdempotencyStoreFactory = (ctx: IIdempotencyStoreFactoryContext) => IIdempotencyStore;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodefony/framework",
-  "version": "10.0.0-alpha.3",
+  "version": "10.0.0-alpha.4",
   "description": "Le modèle de programmation Nodefony : routeur, contrôleurs, décorateurs et vues — HTTP et WebSocket dans le même contexte",
   "author": "Christophe CAMENSULI <ccamensuli@gmail.com>",
   "main": "./dist/index.js",
@@ -43,20 +43,20 @@
     "directory": "src/packages/@nodefony/framework"
   },
   "dependencies": {
-    "@graphql-tools/merge": "9.2.3",
-    "@graphql-tools/schema": "10.1.0",
+    "@graphql-tools/merge": "9.2.4",
+    "@graphql-tools/schema": "10.1.1",
     "eta": "4.6.0",
     "graphql": "17.0.2",
     "reflect-metadata": "0.2.2",
     "tslib": "2.8.1"
   },
   "devDependencies": {
-    "@nodefony/http": "^10.0.0-alpha.3",
+    "@nodefony/http": "^10.0.0-alpha.4",
     "@types/chai": "5.2.3",
     "@types/node": "26.4.1",
     "@vitest/coverage-v8": "5.0.0",
     "chai": "6.2.2",
-    "nodefony": "^10.0.0-alpha.3",
+    "nodefony": "^10.0.0-alpha.4",
     "rimraf": "6.1.3",
     "tsx": "4.23.13",
     "vitest": "5.0.0"
@@ -65,8 +65,8 @@
   "readmeFilename": "README.md",
   "contributors": [],
   "peerDependencies": {
-    "@nodefony/http": "^10.0.0-alpha.3",
-    "nodefony": "^10.0.0-alpha.3",
+    "@nodefony/http": "^10.0.0-alpha.4",
+    "nodefony": "^10.0.0-alpha.4",
     "zod": "^4.4.3"
   },
   "files": [