nodefony 7.0.2 → 10.0.0-alpha.2

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

@@ -0,0 +1,80 @@
+/**
+ * `use()` — colocation de la config d'un module dans le manifeste `modules`
+ * (back-only, D1 ; pilier #1 du chantier configuration : typage impeccable).
+ *
+ * Au lieu d'éparpiller la config d'un module dans une clé `module-<nom>` à la
+ * racine de la config app (legacy, non typée), on la **colocalise** avec son
+ * entrée de chargement :
+ *
+ * @example
+ * ```ts
+ * // nodefony.config.ts
+ * import { defineConfig, use } from "nodefony";
+ * export default defineConfig({
+ *   modules: [
+ *     "@nodefony/http",
+ *     use("@nodefony/security", { firewalls: { main: { pattern: "^/api" } } }),
+ *     use("@nodefony/drizzle", { dialect: "postgres" }, { policy: "dev" }),
+ *   ],
+ * });
+ * ```
+ *
+ * **Le Graal (niveau ③)** : la config passée à `use("@nodefony/security", …)`
+ * est typée AVEC les clés du module ciblé (autocomplétion + hover TSDoc). Le
+ * mécanisme est le registre augmentable {@link NodefonyModuleConfig} : chaque
+ * module enrichit l'index par *declaration merging* (pattern Nuxt/Pinia) →
+ * aucune dépendance de type centralisée, l'écosystème tiers s'y branche aussi.
+ */
+import type { ModulePolicy } from "../types/IModuleManifest.js";
+import type { KnownModule, ModuleEntryInput, ResolvedAppConfig } from "./types.js";
+/**
+ * Registre AUGMENTABLE des configs par module — vide par défaut, enrichi par
+ * chaque module via *declaration merging* sur le package `nodefony` :
+ *
+ * @example
+ * ```ts
+ * // dans @nodefony/security
+ * import type { ISecurityConfig } from "./nodefony/interfaces/ISecurityConfig";
+ * declare module "nodefony" {
+ *   interface NodefonyModuleConfig {
+ *     "@nodefony/security": ISecurityConfig;
+ *   }
+ * }
+ * ```
+ *
+ * Une fois augmentée, {@link ConfigOf} résout `"@nodefony/security"` vers
+ * `ISecurityConfig` → `use()` propose les bonnes clés. Un module non enregistré
+ * reste accepté (config `Record<string, unknown>`), jamais bloqué.
+ */
+export interface NodefonyModuleConfig {
+}
+/**
+ * Type de la config d'un module `N` : sa forme enregistrée dans
+ * {@link NodefonyModuleConfig} si elle existe, sinon un objet libre (le module
+ * n'a pas (encore) publié son type de config — toujours utilisable).
+ *
+ * @typeParam N - nom du module (littéral connu {@link KnownModule} ou tiers).
+ */
+export type ConfigOf<N extends KnownModule> = N extends keyof NodefonyModuleConfig ? NodefonyModuleConfig[N] : Record<string, unknown>;
+/** Options de chargement passées à {@link use} (3ᵉ argument). */
+export interface UseOptions {
+    /** Politique de chargement. Défaut `"optional"`. `"dev"` = hors production. */
+    policy?: ModulePolicy;
+    /** Garde évaluée sur la config résolue ; `false` → module ignoré (0 coût). */
+    when?: (config: ResolvedAppConfig) => boolean;
+}
+/**
+ * Construit une entrée de manifeste `modules` avec config colocalisée + typée.
+ *
+ * Le générique `N` capture le nom du module au call-site → `config` est
+ * contraint à {@link ConfigOf}<N> (autocomplétion des clés du module ciblé).
+ * Le type de RETOUR est volontairement élargi à {@link ModuleEntryInput} (la
+ * config stockée dans le tableau est hétérogène) : le typage fort vit à l'appel,
+ * pas dans le conteneur — exactement le pattern `defineNuxtConfig`/`app.use`.
+ *
+ * @param name - nom du module à charger (`KnownModule` autocomplété, string tierce acceptée).
+ * @param config - config du module, typée selon le registre (optionnelle).
+ * @param opts - politique + garde de chargement (`policy`/`when`).
+ * @returns une entrée `{ name, config?, policy?, when? }` pour l'array `modules`.
+ */
+export declare function use<N extends KnownModule>(name: N, config?: ConfigOf<N>, opts?: UseOptions): ModuleEntryInput;

package/dist/types/finder/File.d.ts

@@ -0,0 +1,26 @@
+import FileClass, { FileClassInterface } from "../FileClass.js";
+import FileResult from "./FileResult.js";
+import fs from "node:fs";
+interface FileInterface extends FileClassInterface {
+    childrens?: string;
+    parent?: FileInterface;
+}
+declare class File extends FileClass {
+    parent: File | null;
+    childrens: FileResult;
+    constructor(path: string | fs.PathOrFileDescriptor, parent?: File | null, options?: {
+        defer?: boolean;
+    });
+    /**
+     * Construit un `File` SANS `lstatSync` bloquant — stat résolu en async.
+     * À utiliser dans le Finder pour ne pas bloquer l'event-loop par entrée.
+     *
+     * @param path - chemin du fichier/dossier.
+     * @param parent - `File` parent (arborescence Finder), `null` à la racine.
+     * @returns instance `File` hydratée (stats async).
+     */
+    static from(path: string | fs.PathOrFileDescriptor, parent?: File | null): Promise<File>;
+    get length(): number;
+    toJson(): FileInterface;
+}
+export default File;

package/dist/types/finder/FileResult.d.ts

@@ -0,0 +1,14 @@
+import Result from "./Result.js";
+import File from "./File.js";
+declare class FileResult extends Result {
+    constructor(res?: File[] | undefined);
+    toString(): string;
+    toJson(json?: unknown[]): string;
+    uniq(): FileResult;
+    findByName(name: string | RegExp, result?: FileResult): FileResult;
+    getDirectories(result?: FileResult): FileResult;
+    getFiles(result?: FileResult): FileResult;
+    sortByName(result?: FileResult): FileResult;
+    sortByType(result?: FileResult): FileResult;
+}
+export default FileResult;

package/dist/types/finder/Finder.d.ts

@@ -0,0 +1,51 @@
+import Event from "../Event.js";
+import File from "./File.js";
+import FileClass from "../FileClass.js";
+import Result from "./Result.js";
+interface FinderEvents {
+    onError: (error: Error) => void;
+    onHidden: (info: File, finder: Finder) => void;
+    onFinish: (result: Result, totals: TotalInterface, finder: Finder) => void;
+}
+interface DefaultSettingsInterface {
+    recurse?: boolean;
+    depth?: number;
+    seeHidden?: boolean;
+    match?: RegExp | string | null;
+    exclude?: string | RegExp | null;
+    excludeFile?: string | RegExp | null;
+    excludeDir?: string | RegExp | null;
+    followSymLink?: boolean;
+    matchFile?: string;
+    matchDir?: string;
+}
+interface TotalInterface {
+    Directory: number;
+    File: number;
+    BlockDevice: number;
+    CharacterDevice: number;
+    symbolicLink: number;
+    Fifo: number;
+    Socket: number;
+    hidden: number;
+    [key: string]: number;
+}
+declare class Finder extends Event {
+    settings: DefaultSettingsInterface;
+    totals: TotalInterface;
+    constructor(settings?: DefaultSettingsInterface);
+    clean(): void;
+    checkPath(Path: string | FileClass | string[]): Result;
+    /**
+     * Variante **async** de {@link checkPath} — résout la (les) racine(s) via
+     * `File.from()` (pas de `lstatSync`). Utilisée par `in()` pour ne pas bloquer
+     * l'event-loop dès la résolution du point d'entrée.
+     *
+     * @param Path - string, array de strings, ou FileClass.
+     * @returns `Result` contenant les `File` racines hydratés.
+     */
+    checkPathAsync(Path: string | FileClass | string[]): Promise<Result>;
+    in(Path: string | FileClass | string[], settings?: {}): Promise<Result>;
+}
+export default Finder;
+export { TotalInterface, FinderEvents };

package/dist/types/finder/Result.d.ts

@@ -0,0 +1,10 @@
+import { Severity } from "../syslog/Pdu.js";
+declare class Result extends Array {
+    constructor(res?: any[]);
+    toJson(json?: any[]): string;
+    toString(): string;
+    clean(callback?: (ele: any) => void): void;
+    query(query: string, logger?: boolean, options?: {}, sevrity?: Severity, clean?: boolean): Result;
+    queryGrep(query: string, grep: string, clean?: boolean): Result;
+}
+export default Result;

package/dist/types/index.d.ts

@@ -0,0 +1,205 @@
+export { Nodefony } from "./Nodefony.js";
+export { default as Kernel } from "./kernel/Kernel.js";
+export { default as Module } from "./kernel/Module.js";
+export { BootConfigurationError } from "./kernel/BootConfigurationError.js";
+export { parseModuleConfig } from "./kernel/moduleConfig.js";
+export { default as CliKernel } from "./kernel/CliKernel.js";
+export { default as Service } from "./Service.js";
+export { default as Container } from "./Container.js";
+export { default as Event } from "./Event.js";
+export type { IGuardedEmitOptions, IGuardedEmitResult, IGuardedEmitError, IGuardedListenerInfo, } from "./Event.js";
+export { default as Cli } from "./Cli.js";
+export { default as clc } from "./colors.js";
+export type { ColorFn, Clc } from "./colors.js";
+export { SysExit } from "./cli/sysexits.js";
+export { Spinner, ProgressBar, LiveLine, renderBar, formatDuration, supportsUnicode, shouldAnimate, fitToWidth, BAR_STYLES, BRAILLE_FRAMES, LINE_FRAMES, ARC_FRAMES, BLOCK_FRAMES, DOT_FRAMES, } from "./cli/progress.js";
+export type { IBarStyle, ILiveLineOptions, IProgressBarOptions, IProgressState, IRenderBarOptions, ISpinnerOptions, ProgressRenderer, SpinnerRenderer, } from "./cli/progress.js";
+export { askPasswordMasked } from "./cli/promptPassword.js";
+export { needsShell } from "./cli/execPortable.js";
+export { nodefonyBin } from "./cli/nodefonyBin.js";
+export { renderManPage, escapeRoff, MAN_PAGE_NAME } from "./cli/manPage.js";
+export { default as Command } from "./command/Command.js";
+export { default as Builder } from "./command/Builder.js";
+export { default as Syslog } from "./syslog/Syslog.js";
+export { NULL_LOG_SINK } from "./syslog/Syslog.js";
+export type { ILogSink } from "./syslog/Syslog.js";
+export { default as Pdu } from "./syslog/Pdu.js";
+export { logColor, setLogColor, isLogColorEnabled, resolveColorEnabled, } from "./syslog/logColor.js";
+export { FileSink } from "./syslog/sinks/FileSink.js";
+export type { FileSinkOptions } from "./syslog/sinks/FileSink.js";
+export { pduToRecord } from "./syslog/drivers/ILogDriver.js";
+export type { ILogDriver, ILogDriverCapabilities, ILogDriverProbe, ILogQueryCriteria, ILogQueryResult, ILogRecord, IPduLike, } from "./syslog/drivers/ILogDriver.js";
+export { filterPdus } from "./syslog/drivers/filterPdus.js";
+export { pduProtocol } from "./syslog/drivers/pduProtocol.js";
+export type { LogProtocol } from "./syslog/drivers/pduProtocol.js";
+export { pduFlowStep, FLOW_STEPS } from "./syslog/drivers/pduFlow.js";
+export type { FlowStepId, FlowStepMeta } from "./syslog/drivers/pduFlow.js";
+export { createMemoryLogDriver } from "./syslog/drivers/MemoryLogDriver.js";
+export { createFileLogDriver } from "./syslog/drivers/FileLogDriver.js";
+export type { FileLogDriverOptions } from "./syslog/drivers/FileLogDriver.js";
+export { createLokiLogDriver } from "./syslog/drivers/LokiLogDriver.js";
+export type { LokiLogDriverOptions } from "./syslog/drivers/LokiLogDriver.js";
+export { createOpenSearchLogDriver } from "./syslog/drivers/OpenSearchLogDriver.js";
+export type { OpenSearchLogDriverOptions } from "./syslog/drivers/OpenSearchLogDriver.js";
+export type { FetchLike } from "./syslog/httpFetch.js";
+export { registerLogDriver, setActiveLogDriver, getActiveLogDriver, getLogDriver, listLogDrivers, registerLogDriverFactory, getLogDriverFactory, listLogDriverFactories, } from "./syslog/drivers/logDriverRegistry.js";
+export type { ILogDriverFactory, ILogDriverContext, ILogDriverMount, ILogConfigLike, } from "./syslog/drivers/logDriverRegistry.js";
+export { registerBuiltinLogDrivers } from "./syslog/drivers/builtinLogDrivers.js";
+export { ConsoleTransport, FileTransport, HttpTransport, SyslogTransport, BatchingHttpTransport, LokiTransport, OpenSearchTransport, } from "./syslog/transports/index.js";
+export type { FileTransportOptions, HttpTransportOptions, BatchTransportOptions, BatchTransportStats, LokiTransportOptions, OpenSearchTransportOptions, } from "./syslog/transports/index.js";
+export { default as JsonRpcPeer, RpcError, RpcEnvelope, } from "./realtime/JsonRpcPeer.js";
+export type { IRealtimePeer, RpcActionHandler, RpcNotificationHandler, RpcMeta, RpcTracedResult, JsonRpcFrameKind, JsonRpcErrorObject, JsonRpcPeerOptions, FrameAuditReason, } from "./realtime/JsonRpcPeer.js";
+export { TransportState } from "./realtime/IRealtimeTransport.js";
+export type { IRealtimeTransport, TransportStateValue, RealtimeTransportFactory, } from "./realtime/IRealtimeTransport.js";
+export type { IRealtimeSocket, IRealtimeChannel, IChannelStats, RealtimeHandler, } from "./realtime/IRealtimeSocket.js";
+export { rateChannel, parseRate, isRateChannel } from "./realtime/channelRate.js";
+export type { RateBounds } from "./realtime/channelRate.js";
+export { NODEFONY_CHANNEL_NAMESPACE, PLATFORM_CHANNELS, PLATFORM_INBOUND, PLATFORM_METHODS, PLATFORM_EVENTS, isPlatformChannel, startsWithCI, } from "./realtime/platformChannels.js";
+export type { PlatformChannel, PlatformInboundChannel, PlatformMethod, } from "./realtime/platformChannels.js";
+export { expectType } from "./realtime/RealtimeEventMap.js";
+export type { EventsMap, ActionsMap, DefaultEventsMap, DefaultActionsMap, EventNames, EventPayload, ActionNames, ActionParams, ActionResult, ContractActionNames, ContractParams, ContractResult, TypedRpcActionHandler, RealtimeIdentity, IRealtimeWelcome, IRealtimeDenied, } from "./realtime/RealtimeEventMap.js";
+export { default as nodefonyError, registerErrorAdapter } from "./Error.js";
+export type { IErrorAdapter } from "./Error.js";
+export { default as Finder } from "./finder/Finder.js";
+export { default as File } from "./finder/File.js";
+export { default as Result } from "./finder/Result.js";
+export { default as FileClass } from "./FileClass.js";
+export { default as FileResult } from "./finder/FileResult.js";
+export { default as Fetch } from "./service/fetchService.js";
+export { default as GitService } from "./service/gitService.js";
+export type { GitInfo } from "./service/gitService.js";
+export { default as Injector } from "./kernel/injector/injector.js";
+export { resolveWorkerCount, readCgroupCpuQuota, } from "./service/cluster/cpuQuota.js";
+export type { ResolveWorkerOptions, FileReader, } from "./service/cluster/cpuQuota.js";
+export { resolveTopology, loadClusterConfig } from "./service/cluster/topology.js";
+export { ProcessProbe } from "./service/cluster/processProbe.js";
+export type { IProcessHealth } from "./service/cluster/processProbe.js";
+export { RichProcessProbe } from "./service/cluster/richProcessProbe.js";
+export type { IProcessRich } from "./service/cluster/richProcessProbe.js";
+export { setOrmHealthProvider, readOrmHealth, setOrmRichProvider, readOrmRich, } from "./service/cluster/instanceProbe.js";
+export type { IOrmLeanHealth, IInstanceErrorHealth, } from "./service/cluster/instanceProbe.js";
+export type { WorkersSetting, IClusterConfig, Topology, TopologySource, ResolveTopologyOptions, } from "./service/cluster/topology.js";
+export { ClusterManager, computeBackoff, } from "./service/cluster/ClusterManager.js";
+export type { ClusterManagerOptions, IClusterRuntime, IClusterWorker, ClusterScheduler, } from "./service/cluster/ClusterManager.js";
+export { ClusterRelay } from "./service/cluster/ClusterRelay.js";
+export type { IRelayWorker, ClusterRelayOptions, } from "./service/cluster/ClusterRelay.js";
+export { ClusterProbeAggregator } from "./service/cluster/ClusterProbeAggregator.js";
+export type { IProbeWorker, ClusterProbeAggregatorOptions, } from "./service/cluster/ClusterProbeAggregator.js";
+export { CLUSTER_RT_KIND, CLUSTER_PROBE_KIND, CLUSTER_PROBE_SNAPSHOT_KIND, CLUSTER_PROBE_CTL_KIND, CLUSTER_PROBE_ENRICH_KIND, isClusterMessage, isClusterProbeCtl, isClusterProbeEnrich, } from "./service/cluster/clusterMessage.js";
+export type { IClusterMessage, IClusterProbeCtl, IClusterProbeEnrich, ClusterProbeFacet, } from "./service/cluster/clusterMessage.js";
+export { default as RequestContext } from "./runtime/RequestContext.js";
+export type { RequestContextPayload, IProfilerQuery, } from "./runtime/RequestContext.js";
+export { redactSecrets } from "./runtime/redact.js";
+export { loadEnv } from "./runtime/loadEnv.js";
+export type { ILoadEnvOptions } from "./runtime/loadEnv.js";
+export { withTimeout, TimeoutError } from "./runtime/withTimeout.js";
+export { GcScheduler } from "./runtime/GcScheduler.js";
+export type { IGcSchedulerOptions } from "./runtime/GcScheduler.js";
+export { injectable, inject, services, } from "./kernel/decorators/kernelDecorator.js";
+export type { DIScope, InjectableOptions } from "./kernel/injector/injector.js";
+export { extend, typeOf, isPromise, isEmptyObject, isPlainObject, isUndefined, isRegExp, isContainer, isFunction, isArray, stripTrailingSlashes, escapeRegExp, } from "./Tools.js";
+export { defineConfig, isConfigDescriptor } from "./config/defineConfig.js";
+export type { AppConfigDescriptor } from "./config/defineConfig.js";
+export { use } from "./config/use.js";
+export type { NodefonyModuleConfig, ConfigOf, UseOptions } from "./config/use.js";
+export { defineEnv, envString, envNumber, envBoolean, envEnum, getEnvCatalog, } from "./config/defineEnv.js";
+export type { EnvVarKind, EnvVarMeta, NamedEnvVarMeta, } from "./config/defineEnv.js";
+export { renderEnvExample } from "./config/envExample.js";
+export { defaultAppConfig } from "./config/defaults.js";
+export { parseNfEnvOverrides, applyResolvedPath } from "./config/envOverride.js";
+export type { NfEnvOverride } from "./config/envOverride.js";
+export { computeConfigProvenance, extractJsonSchemaDefaults, } from "./config/configProvenance.js";
+export type { ConfigOrigin } from "./config/configProvenance.js";
+export { appConfigSchema, appConfigJsonSchema, validateAppConfig, } from "./config/schema.js";
+export type { AppConfig } from "./config/schema.js";
+export { configReactivity, getConfigReactivity } from "./config/reactivity.js";
+export type { Reactivity } from "./config/reactivity.js";
+export type { IConfigFieldMeta } from "./config/configMeta.js";
+export { resolveInfra, resolveAutoStore, deriveStoreBackend, readStoreLocation, parseDatabaseUrl, sqliteFilenameFromUrl, AUTO_STORE, EMPTY_INFRA, } from "./config/infra.js";
+export type { IInfra, IInfraDatabase, IInfraCache, IInfraLogs, IAutoStoreResolution, IStoreResolution, StoreProvenance, InfraSqlDialect, DatabaseFamily, StoreKind, InfraEnvSource, } from "./config/infra.js";
+export type { AppConfigInput, ResolvedAppConfig, ConfigInput, ConfigContext, KnownModule, ModuleEntryInput, ModuleManifestInput, AppMeta, ServersConfig, HttpServerConfig, HttpsServerConfig, LogConfig, LogFileConfig, LogDestinationConfig, } from "./config/types.js";
+export type { IKernel, KernelNetworkResult } from "./types/IKernel.js";
+export type { IModuleManifest, IModuleManifestEntry, ModulePolicy, } from "./types/IModuleManifest.js";
+export type { IService, DefaultOptionsService, EventListener, } from "./types/IService.js";
+export type { IContainer, IScope } from "./types/IContainer.js";
+export type { IModule } from "./types/IModule.js";
+export type { IAdminApi, IAdminRegistry, IAdminEndpoint, IAdminPageCapabilities, IAdminDescriptor, IAdminRequest, IAdminResponse, AdminHandler, AdminHttpMethod, } from "./types/IAdminApi.js";
+export { INSPECT_SUBJECTS, readAdminSubject, callAdminEndpoint, unwrapAdminResult, } from "./kernel/inspect/adminSubjects.js";
+export type { IInspectSubject, IAdminBrokerLike, IAdminCall, InspectFailure, InspectResult, } from "./kernel/inspect/adminSubjects.js";
+export { executeAdminEndpoint, normalizeAdminResult, } from "./kernel/adminPlane/executeAdmin.js";
+export type { IAdminExecution, IAdminExecuteInput, IAdminGateVerdict, AdminGate, } from "./kernel/adminPlane/executeAdmin.js";
+export { isAdminGranted, resolveAdminRole, ADMIN_DEFAULT_ROLE, } from "./kernel/adminPlane/adminRbac.js";
+export { localOperatorCaller, rolesFromScopes, refusedAdminScopes, ADMIN_SCOPE_READ, ADMIN_SCOPE_WRITE, } from "./kernel/adminPlane/adminCaller.js";
+export type { IAdminCaller } from "./kernel/adminPlane/adminCaller.js";
+export { mcpCallerRoles } from "./mcp/caller.js";
+export type { IMcpGatePosture } from "./mcp/caller.js";
+export { outlineMarkdown, extractMarkdownSection, } from "./kernel/inspect/docOutline.js";
+export type { IMarkdownSection } from "./kernel/inspect/docOutline.js";
+export type { IIdempotencyStore, IIdempotencyKeyEntry, IIdempotencyListQuery, IdempotencyOutcome, IdempotentResponse, } from "./types/IIdempotencyStore.js";
+export type { IPage, IPageQuery, ISortableSource } from "./types/IPage.js";
+export { assertPageQuery, PaginationModeError, CursorOrderError, } from "./runtime/pageGuard.js";
+export type { PaginationMode } from "./runtime/pageGuard.js";
+export { parsePageQuery, PageQueryError, PAGE_QUERY_KEYS, } from "./runtime/pageQuery.js";
+export { compareByOrder, pickOrder, renameOrderFields, } from "./runtime/pageSort.js";
+export type { FieldReader } from "./runtime/pageSort.js";
+export type { PageQuerySource, IParsePageQueryOptions, } from "./runtime/pageQuery.js";
+export { parseFilters } from "./runtime/pageFilters.js";
+export type { FilterKind, FilterDef, IFilterSpec, FilterValue, FilterValues, IParseFiltersOptions, } from "./runtime/pageFilters.js";
+export { countFacets, facetDimensions, UNKNOWN_COUNT, } from "./runtime/pageFacets.js";
+export type { FacetCount, FacetCounts, IFacetSpec } from "./runtime/pageFacets.js";
+export type { ISyslog } from "./types/ISyslog.js";
+export type { ITransport } from "./types/ITransport.js";
+export type { EnvironmentType, DebugType } from "./types/globals.js";
+export type { DynamicParam, DynamicService, Scopes, ProtoService, ProtoParameters, } from "./Container.js";
+export { Scope } from "./Container.js";
+export { SEVERITY_NAMES, BROWSER_ORIGIN } from "./syslog/Pdu.js";
+export type { Message, Msgid, Pci, Severity, SeverityName } from "./syslog/Pdu.js";
+export type { FamilyType, KernelEventsType, NetworkInterface, FilterInterface, ServiceWithInit, ServiceConstructor, TypeKernelOptions, } from "./kernel/Kernel.js";
+export type { IBootReport, IBootFailure, IBootServerInfo, IBootModuleGated, } from "./kernel/bootReport.js";
+export type { IReadinessContributor } from "./kernel/readinessRegistry.js";
+export type { OptionsCommandInterface } from "./command/Command.js";
+export { collectDevStatus, buildDevStatus, } from "./service/dev/devStatusReport.js";
+export type { DevStatusReport } from "./service/dev/devStatusReport.js";
+export { detectRuntimeMode, runtimeModes, findRuntimeConflict, writeRuntimeState, readRuntimeState, clearRuntimeState, defaultDevPorts, suspendSupervisor, resumeSupervisor, readSupervisorSuspension, signalProcessGroup, isPortListening, } from "./service/dev/devProcess.js";
+export type { DevProcessInfo, DevProcessRole, RuntimeMode, PortState, RuntimeState, SupervisorLock, TreeSignalOutcome, } from "./service/dev/devProcess.js";
+export { getScaffoldSpec } from "./cli/scaffold/spec.js";
+export { argvMcpWiring, mcpWiringPlan } from "./cli/create.js";
+export type { IScaffoldQuestion, IScaffoldTypeSpec, TFrontendChoice, TPresetChoice, } from "./cli/scaffold/spec.js";
+export { runScaffold, resolveAnswers, listTargets, findProjectRoot, scaffoldCaps, getScaffoldContext, } from "./cli/scaffold/engine.js";
+export type { IScaffoldContext, IScaffoldConnector, } from "./cli/scaffold/engine.js";
+export { resolveScaffoldDestination, isSafeSubPath, isInsideRoot, ScaffoldDestinationError, APP_NAME_RE, } from "./cli/scaffold/destination.js";
+export type { IScaffoldRoot } from "./cli/scaffold/destination.js";
+export type { IScaffoldRequest, IScaffoldResult, IScaffoldRunOptions, IScaffoldCaps, IScaffoldTarget, TScaffoldAnswers, } from "./cli/scaffold/engine.js";
+export { diffLines } from "./cli/scaffold/writer.js";
+export type { IScaffoldChange, IDiffLine } from "./cli/scaffold/writer.js";
+export { SCAFFOLD_STEPS, SCAFFOLD_STEP_COMMANDS, SCAFFOLD_STEP_LABELS, isScaffoldStep, } from "./cli/scaffold/steps.js";
+export type { TScaffoldStep } from "./cli/scaffold/steps.js";
+export { resolveSymbolsFile, readSymbolsGraph, lookupSymbol, runSymbolsCommand, } from "./cli/symbols.js";
+export type { ISymbolEntry, ISymbolsGraph } from "./cli/symbols.js";
+export { canonicalResourceUri, protectedResourceMetadataPath, protectedResourceMetadataUrl, buildProtectedResourceMetadata, buildBearerChallenge, authorizeProtectedResource, missingScopes, BearerError, ACCESS_TOKEN_VERIFIER, } from "./oauth/protectedResource.js";
+export type { IProtectedResourceMetadata, IProtectedResourceInput, IProtectedResourcePolicy, IAccessPrincipal, IAccessTokenVerifier, ProtectedResourceOutcome, IBearerChallenge, BearerErrorCode, } from "./oauth/protectedResource.js";
+export { bearerToken, readBearerHeader } from "./runtime/bearer.js";
+export type { BearerHeader } from "./runtime/bearer.js";
+export { canonicalIssuer, authorizationServerMetadataPath, issuerMetadataUrls, validateIssuerMetadata, buildAuthorizationServerMetadata, extractScopes, JWKS_PATH, } from "./oauth/authorizationServer.js";
+export type { IIssuerMetadata, IAuthorizationServerMetadata, IAuthorizationServerInput, } from "./oauth/authorizationServer.js";
+export { MCP_PROTOCOL_VERSION, MCP_SUPPORTED_VERSIONS, MCP_DEFAULT_NEGOTIATED_VERSION, MCP_ENDPOINT_PATH, META_PROTOCOL_VERSION, META_SERVER_INFO, JsonRpcError, McpProtocolError, jsonRpcSuccess, jsonRpcFailure, isNotification, } from "./mcp/protocol.js";
+export type { IJsonRpcMessage, IJsonRpcSuccess, IJsonRpcFailure, IMcpHttpReply, JsonRpcId, } from "./mcp/protocol.js";
+export { handleMcpMessage } from "./mcp/server.js";
+export type { IMcpServerContext, IMcpHeaders } from "./mcp/server.js";
+export { checkMcpAccess, isLocalAddress } from "./mcp/guard.js";
+export type { GuardVerdict, IGuardInput, IGuardPolicy } from "./mcp/guard.js";
+export { mcpText, builtinMcpTools, declareMcpTools, collectMcpTools, mcpDeclaredScopes, publishMcpTools, callMcpTool, BUILTIN_MCP_TOOL_KEYS, } from "./mcp/tools.js";
+export type { IMcpTool, IMcpToolDefinition, IMcpToolResult, IMcpToolDeps, IMcpCaller, IMcpDeclareOptions, IMcpCollectOptions, BuiltinMcpToolKey, } from "./mcp/tools.js";
+export { buildMcpUrl, planMcpConfig, renderMcpPlan, MCP_CONFIG_FILE, MCP_SERVER_KEY, } from "./cli/aiMcpReport.js";
+export type { IMcpConfigDocument, IMcpConfigPlan, IMcpServerEntry, McpConfigAction, } from "./cli/aiMcpReport.js";
+export { runAiMcpCommand, guessOrigin } from "./cli/aiMcp.js";
+export { AGENT_TARGETS, planAgentDeclaration, renderPlanShell, agentRoot, poseVariable, alreadyHasKey, requestedAgents, agentsPresents, MCP_TOKEN_ENV, } from "./cli/agentTargets.js";
+export type { IAgentTarget, IDeclarationContext, IDeclarationPlan, VoieDeclaration, } from "./cli/agentTargets.js";
+export { GIT_HOOKS_DIR, GIT_HOOKS_MARKER, GIT_HOOK_NAMES, renderGitHook, planGitHooks, renderGitHooksPlan, } from "./cli/gitHooksReport.js";
+export type { GitHookName, GitHookAction, HooksPathAction, IPlannedGitHook, IGitHooksPlan, } from "./cli/gitHooksReport.js";
+export { runGitHooksCommand, installGitHooks } from "./cli/gitHooks.js";
+export { collectDoctorReport, countCheckFindings, } from "./kernel/checks/runDoctor.js";
+export type { IDoctorReport } from "./kernel/checks/runDoctor.js";
+export { buildCard, renderCard } from "./cli/cardReport.js";
+export { chargePrompts, request, anchorEventLoop, type IPrompts, } from "./cli/prompts.js";
+export type { ICard, ICardAppInfo, ICardDoor, ICardInput, ICardVerb, CardSource, } from "./cli/cardReport.js";

package/dist/types/kernel/BootConfigurationError.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Erreur de **configuration** détectée pendant le boot — TOUJOURS fatale, dans
+ * TOUS les environnements et pour TOUT module, là où un échec de boot ordinaire
+ * n'est fatal qu'en production pour un module critique (fail-soft ailleurs).
+ *
+ * **Pourquoi cette classe existe** : le fail-soft de boot protège la DX (un
+ * module optionnel cassé ne bloque pas le dev) — mais il devient un PIÈGE
+ * quand l'échec vient d'une configuration EXPLICITE de l'utilisateur : une
+ * infra déclarée (`NF_DATABASE_URL`) injoignable, une entité non portée sur le
+ * dialecte demandé… Continuer en « dégradé » = session/users/tokens morts en
+ * silence, avec un serveur qui répond 200 sur ses routes statiques (vécu :
+ * login impossible, cause noyée dans un WARNING). Une erreur de configuration
+ * ne se répare pas en continuant : elle se répare en la corrigeant → le boot
+ * s'interrompt avec le message actionnable.
+ *
+ * Usage (module/service au boot) :
+ * ```ts
+ * throw new BootConfigurationError(
+ *   `connecteur "default" (postgres) injoignable — démarrer l'infra déclarée ` +
+ *     `NF_DATABASE_URL ou retirer la variable. Cause : ${cause.message}`,
+ *   { cause },
+ * );
+ * ```
+ *
+ * 🔴 **Le tag `critical = false` ne s'applique PAS ici**, et c'est délibéré. Les
+ * deux répondent à des questions différentes : `critical = false` dit « cette
+ * application peut tourner SANS ce module » — une affirmation sur sa
+ * DISPONIBILITÉ ; cette erreur dit « ce que l'utilisateur a écrit ne peut pas
+ * être honoré » — une affirmation sur son INTENTION. Les confondre faisait
+ * démarrer un module optionnel en IGNORANT sa configuration, avec pour seule
+ * trace un avertissement dans le journal.
+ *
+ * Ce que cela ne change pas : un module optionnel dont l'INFRA est absente
+ * (Redis éteint) ne lève pas cette erreur — il propage une `Error` ordinaire,
+ * qui reste fail-soft en développement. C'est ce qui rend l'arbitrage sûr, et
+ * c'est ce qu'il fallait vérifier avant de le rendre : au moment de la décision,
+ * dans les cinq modules `critical = false` du dépôt, la seule source de cette
+ * erreur était la validation de configuration ({@link parseModuleConfig}).
+ */
+export declare class BootConfigurationError extends Error {
+    name: string;
+    /**
+     * Type guard TOLÉRANT aux copies multiples du package (dual-package /
+     * bundles) : reconnaît l'instance OU toute `Error` portant le `name` de la
+     * classe — un `instanceof` seul raterait une erreur construite par une autre
+     * copie de `nodefony`.
+     */
+    static is(error: unknown): boolean;
+}
+export default BootConfigurationError;