@vlynk-studios/nodulus-core 1.2.0 → 1.2.6

package/dist/index.d.ts

@@ -1,21 +1,5 @@
-import { RequestHandler, Router, Application } from 'express';
+import { RequestHandler, Application } from 'express';
 
-interface ControllerEntry {
-    name: string;
-    path: string;
-    prefix: string;
-    middlewares: RequestHandler[];
-    router?: Router;
-    enabled: boolean;
-}
-interface ModuleEntry {
-    name: string;
-    path: string;
-    indexPath: string;
-    imports: string[];
-    exports: string[];
-    controllers: ControllerEntry[];
-}
 type LogLevel = 'debug' | 'info' | 'warn' | 'error';
 /**
  * Function that receives a log event from Nodulus.
@@ -93,9 +77,24 @@ interface SchemaEntry {
 }
 /** Discriminated union for all file-level identifier entries. */
 type FileEntry = ServiceEntry | RepositoryEntry | SchemaEntry;
+interface NitsConfig {
+    /**
+     * Custom similarity threshold (0.0 to 1.0).
+     * If omitted, a dynamic threshold based on module size is used.
+     */
+    similarityThreshold?: number;
+    /** Whether to enable NITS identity tracking. Default: true. */
+    enabled?: boolean;
+    /** Custom path to the NITS registry file. Default: '.nodulus/registry.json'. */
+    registryPath?: string;
+}
 interface CreateAppOptions {
     /** Glob pointing to module folders. Default: 'src/modules/*'. */
     modules?: string;
+    /** Glob pointing to domain folders (v2.0.0+). Default: undefined. */
+    domains?: string;
+    /** Glob pointing to shared global folders (v2.0.0+). Default: undefined. */
+    shared?: string;
     /** Global route prefix. Example: '/api/v1'. Default: ''. */
     prefix?: string;
     /** Folder aliases beyond the auto-generated @modules/* entries. Default: {}. */
@@ -122,16 +121,8 @@ interface CreateAppOptions {
      * Default: 'info' (debug is off unless explicitly set).
      */
     logLevel?: LogLevel;
-}
-/** Resolved configuration used internally (defaults applied). */
-interface ResolvedConfig {
-    modules: string;
-    prefix: string;
-    aliases: Record<string, string>;
-    strict: boolean;
-    resolveAliases: boolean;
-    logger: LogHandler;
-    logLevel: LogLevel;
+    /** NITS (Nodulus Integrated Tracking System) configuration. */
+    nits?: NitsConfig;
 }
 /** A module as it appears in the NodularApp result after bootstrap. */
 interface RegisteredModule {
@@ -184,6 +175,8 @@ interface GetAliasesOptions {
     absolute?: boolean;
 }
 
+type ModuleRegistration = RegisteredModule;
+type FeatureRegistration = FileEntry;
 /**
  * Returns a read-only view of the registry active in the current async context.
  *
@@ -193,14 +186,12 @@ interface GetAliasesOptions {
  */
 declare const getRegistry: () => NodulusRegistryAdvanced;
 
-type NodulusErrorCode = "MODULE_NOT_FOUND" | "DUPLICATE_MODULE" | "MISSING_IMPORT" | "UNDECLARED_IMPORT" | "CIRCULAR_DEPENDENCY" | "EXPORT_MISMATCH" | "INVALID_CONTROLLER" | "ALIAS_NOT_FOUND" | "DUPLICATE_ALIAS" | "DUPLICATE_BOOTSTRAP" | "REGISTRY_MISSING_CONTEXT" | "INVALID_MODULE_DECLARATION" | "DUPLICATE_SERVICE" | "DUPLICATE_REPOSITORY" | "DUPLICATE_SCHEMA" | "INVALID_ESM_ENV";
+type NodulusErrorCode = "MODULE_NOT_FOUND" | "DUPLICATE_MODULE" | "MISSING_IMPORT" | "UNDECLARED_IMPORT" | "CIRCULAR_DEPENDENCY" | "EXPORT_MISMATCH" | "INVALID_CONTROLLER" | "ALIAS_NOT_FOUND" | "DUPLICATE_ALIAS" | "DUPLICATE_BOOTSTRAP" | "REGISTRY_MISSING_CONTEXT" | "INVALID_MODULE_DECLARATION" | "DUPLICATE_SERVICE" | "DUPLICATE_REPOSITORY" | "DUPLICATE_SCHEMA" | "INVALID_ESM_ENV" | "CLI_ERROR" | "UNUSED_IMPORT";
 declare class NodulusError extends Error {
     readonly code: NodulusErrorCode;
     readonly details?: string;
     constructor(code: NodulusErrorCode, message: string, details?: string);
 }
-/** @deprecated — not used internally. Messages are defined at each throw site. */
-declare const ERROR_MESSAGES: Record<NodulusErrorCode, string>;
 
 declare function Module(name: string, options?: ModuleOptions): void;
 
@@ -264,4 +255,4 @@ declare function createApp(app: Application, options?: CreateAppOptions): Promis
 
 declare function getAliases(options?: GetAliasesOptions): Promise<Record<string, string>>;
 
-export { Controller, type ControllerEntry, type ControllerOptions, type CreateAppOptions, ERROR_MESSAGES, type FileEntry, type GetAliasesOptions, type LogHandler, type LogLevel, Module, type ModuleEntry, type ModuleOptions, type MountedRoute, type NodulusApp, type NodulusConfig, NodulusError, type NodulusErrorCode, type NodulusRegistry, type NodulusRegistryAdvanced, type RegisteredModule, Repository, type RepositoryEntry, type RepositoryOptions, type ResolvedConfig, Schema, type SchemaEntry, type SchemaOptions, Service, type ServiceEntry, type ServiceOptions, createApp, getAliases, getRegistry };
+export { Controller, type ControllerOptions, type CreateAppOptions, type FeatureRegistration, type GetAliasesOptions, type LogHandler, type LogLevel, Module, type ModuleOptions, type ModuleRegistration, type MountedRoute, type NodulusApp, type NodulusConfig, NodulusError, type NodulusErrorCode, type NodulusRegistry, type NodulusRegistryAdvanced, type RegisteredModule, Repository, type RepositoryOptions, Schema, type SchemaOptions, Service, type ServiceOptions, createApp, getAliases, getRegistry };