@endge/core 1.2.5

package/dist/model/endge/endge-bootstrap.d.ts

@@ -0,0 +1,23 @@
+import { AppBootstrapOptions, BootstrapStep, BootstrapStepName } from '../../domain/types/bootstrap.types';
+import { EndgeModule } from '../../domain/entities/endge/EndgeModule';
+export declare class EndgeBootstrap extends EndgeModule {
+    private readonly strict;
+    private readonly onEvent?;
+    private readonly steps;
+    private readonly done;
+    private readonly inFlight;
+    constructor(options?: AppBootstrapOptions);
+    registerStep(step: BootstrapStep): void;
+    registerSteps(steps: readonly BootstrapStep[]): void;
+    run(requestedSteps: readonly BootstrapStepName[]): Promise<void>;
+    reset(): void;
+    invalidate(steps: readonly BootstrapStepName[]): void;
+    markDone(steps: readonly BootstrapStepName[]): void;
+    isDone(step: BootstrapStepName): boolean;
+    /**
+     * Internals
+     */
+    private expandWithDependencies;
+    private runOnce;
+    private unique;
+}

package/dist/model/endge/endge-console.d.ts

@@ -0,0 +1,35 @@
+import { EndgeModule } from '../../domain/entities/endge/EndgeModule';
+export interface EndgeConsoleCommandMeta {
+    name: string;
+    description?: string;
+}
+/**
+ * Глобальная регистрация команд для консоли разработчика.
+ * В globalThis.Endge выставляется только объект с зарегистрированными методами (Endge.tab(), Endge.document() и т.д.),
+ * класс Endge в глобал не публикуется.
+ */
+export declare class EndgeConsole extends EndgeModule {
+    private _handlers;
+    private _meta;
+    /**
+     * Регистрирует команду консоли. После exposeToGlobal() будет доступна как Endge[name]().
+     */
+    register(name: string, fn: (...args: any[]) => any, description?: string): void;
+    /**
+     * Удаляет зарегистрированную команду.
+     */
+    unregister(name: string): void;
+    /**
+     * Возвращает все зарегистрированные имена.
+     */
+    getRegistered(): string[];
+    /**
+     * Возвращает зарегистрированные команды вместе с описаниями.
+     */
+    getRegisteredMeta(): EndgeConsoleCommandMeta[];
+    /**
+     * Выставляет в globalThis.Endge объект только с зарегистрированными командами (фасад).
+     * Класс Endge в глобал не попадает.
+     */
+    exposeToGlobal(): void;
+}

package/dist/model/endge/endge-contracts.d.ts

@@ -0,0 +1,77 @@
+import { BehaviorContract, EndgeContract, EndgeFacetType, FacetedCascadeEntityType, PresentationContract } from '../../domain/types/faceted-cascade';
+import { ConfigurationContract } from '../../domain/types/configuration-contract.types';
+import { EndgeModule } from '../../domain/entities/endge/EndgeModule';
+/**
+ * Централизованный реестр контрактов Endge.
+ * Публично остаётся единым фасадом, но внутри хранит три независимые семьи:
+ * behavior, presentation и configuration.
+ */
+export declare class EndgeContracts extends EndgeModule {
+    private _behaviorContracts;
+    private _behaviorContractsByEntity;
+    private _behaviorContractsByKey;
+    private _presentationContracts;
+    private _presentationContractsByEntity;
+    private _presentationContractsByKey;
+    private _configurationContracts;
+    private _configurationContractsByEntity;
+    private _configurationContractsByKey;
+    /**
+     * На старте модуля регистрирует канонический набор core-контрактов всех трёх фасетов.
+     */
+    init(): void;
+    reset(): void;
+    /**
+     * Полная замена общего каталога контрактов.
+     */
+    setContracts(contracts: EndgeContract[]): void;
+    /**
+     * Добавление/обновление контрактов поверх текущего каталога.
+     */
+    registerContracts(contracts: EndgeContract[]): void;
+    /**
+     * Полная замена только configuration-контрактов.
+     * Остальные фасеты остаются без изменений.
+     */
+    setConfigurationContracts(contracts: ConfigurationContract[]): void;
+    /**
+     * Добавление/обновление только configuration-контрактов.
+     */
+    registerConfigurationContracts(contracts: ConfigurationContract[]): void;
+    /**
+     * Очистка всех контрактов.
+     */
+    clear(): void;
+    getAll(): EndgeContract[];
+    getByFacet(facet: EndgeFacetType): EndgeContract[];
+    getBehaviorByEntity(entityType: FacetedCascadeEntityType): BehaviorContract[];
+    getBehaviorByEvent(entityType: FacetedCascadeEntityType, eventName: string): BehaviorContract | null;
+    supportsBehaviorOverride(entityType: FacetedCascadeEntityType, eventName: string): boolean;
+    supportsBehaviorBinding(entityType: FacetedCascadeEntityType, eventName: string): boolean;
+    getPresentationByEntity(entityType: FacetedCascadeEntityType): PresentationContract[];
+    getPresentationByRole(entityType: FacetedCascadeEntityType, role: string): PresentationContract | null;
+    supportsPresentationOverride(entityType: FacetedCascadeEntityType, role: string): boolean;
+    supportsPresentationBinding(entityType: FacetedCascadeEntityType, role: string): boolean;
+    getAllConfiguration(): ConfigurationContract[];
+    getConfigurationByEntity(entityType: string): ConfigurationContract[];
+    getConfigurationField(entityType: string, fieldPath: string): ConfigurationContract | null;
+    supportsConfigurationOverride(entityType: string, fieldPath: string): boolean;
+    supportsConfigurationBinding(entityType: string, fieldPath: string): boolean;
+    supportsConfigurationWatch(entityType: string, fieldPath: string): boolean;
+    supportsRuntimeConfigurationMutation(entityType: string, fieldPath: string): boolean;
+    private _applyContracts;
+    private _applyConfigurationContracts;
+    private _commitContracts;
+    private _rebuildBehaviorIndexes;
+    private _rebuildPresentationIndexes;
+    private _rebuildConfigurationIndexes;
+    private _normalizeBehaviorContract;
+    private _normalizePresentationContract;
+    private _normalizeConfigurationContract;
+    private _createBehaviorMap;
+    private _createPresentationMap;
+    private _createConfigurationMap;
+    private _toBehaviorKey;
+    private _toPresentationKey;
+    private _toConfigurationKey;
+}

package/dist/model/endge/endge-debug.d.ts

@@ -0,0 +1,37 @@
+import { Attrs, Correlation, LogLevel, LogRecord } from '../../domain/types/debug/base.types';
+import { LogNode, SpanNode } from '../../domain/types/debug/tree.types';
+import { EndgeModule } from '../../domain/entities/endge/EndgeModule';
+export declare class EndgeDebug extends EndgeModule {
+    private store;
+    private activeTrace;
+    private activeSpan;
+    private spanStartTime;
+    private spanStack;
+    setup(): void;
+    /** ===== CORE ===== */
+    getRecords(): LogRecord[];
+    clear(): void;
+    private emit;
+    /** ===== TRACE / SPAN API ===== */
+    startTrace(name: string, level?: LogLevel, attrs?: Attrs): Correlation;
+    endTrace(level?: LogLevel, attrs?: Attrs): void;
+    startSpan(lane: string, name: string, level?: LogLevel, attrs?: Attrs): Correlation;
+    endSpan(level?: LogLevel, attrs?: Attrs): void;
+    /** ===== EVENT API ===== */
+    log(msg: string, level?: LogLevel, data?: unknown, attrs?: Attrs): void;
+    /** Найти узел-спан со всем его поддеревом по spanId. Возвращает null, если не найден. */
+    getSpanSubtree(spanId: string): SpanNode | null;
+    /** Вернуть только дочерние узлы спана (без самого спана), удобно для детальной панели. */
+    getSpanChildren(spanId: string): LogNode[];
+    /** При необходимости - плоский список записей, попадающих внутрь спана (включая сам спан). */
+    getSpanRecords(spanId: string): LogRecord[];
+    /** ===== SYNTACTIC SUGAR ===== */
+    trace(msg: string, data?: unknown, attrs?: Attrs): void;
+    debug(msg: string, data?: unknown, attrs?: Attrs): void;
+    info(msg: string, data?: unknown, attrs?: Attrs): void;
+    warn(msg: string, data?: unknown, attrs?: Attrs): void;
+    error(msg: string, data?: unknown, attrs?: Attrs): void;
+    fatal(msg: string, data?: unknown, attrs?: Attrs): void;
+    success(msg: string, data?: unknown, attrs?: Attrs): void;
+    toPlain(): object;
+}

package/dist/model/endge/endge-diagnostics.d.ts

@@ -0,0 +1,111 @@
+import { DiagnosticsSpan } from '../../domain/entities/diagnostics/DiagnosticsSpan';
+import { DiagnosticsTrace } from '../../domain/entities/diagnostics/DiagnosticsTrace';
+import { EndgeModule } from '../../domain/entities/endge/EndgeModule';
+import { DiagnosticsAttrs, DiagnosticsContextRef, DiagnosticsCounters, DiagnosticsExporter, DiagnosticsLevel, DiagnosticsPolicy, DiagnosticsRecord, DiagnosticsRecordQuery, DiagnosticsScopeOptions, DiagnosticsSnapshot } from '../../domain/types/diagnostics.types';
+export declare class EndgeDiagnostics extends EndgeModule {
+    private _policy;
+    private _store;
+    private readonly _exporters;
+    private readonly _recordListeners;
+    private _sessionId;
+    private _recordId;
+    private _droppedByPolicy;
+    private _droppedByCapacity;
+    private _openTraces;
+    private _openSpans;
+    private _notifyScheduled;
+    get sessionId(): string;
+    get policy(): DiagnosticsPolicy;
+    serialize(): unknown;
+    deserialize(payload: unknown): void;
+    reset(): void;
+    setPolicy(next: Partial<DiagnosticsPolicy>): void;
+    registerExporter(exporter: DiagnosticsExporter): void;
+    unregisterExporter(exporterId: string): void;
+    /** Подписка на каждую новую запись (для экспорта в канал и т.п.). */
+    addRecordListener(fn: (record: DiagnosticsRecord) => void): void;
+    removeRecordListener(fn: (record: DiagnosticsRecord) => void): void;
+    /**
+     * Trace - корневая операция, в которую группируются span и event-записи.
+     */
+    beginTrace(name: string, options?: DiagnosticsScopeOptions): DiagnosticsTrace;
+    startSpan(name: string, options?: DiagnosticsScopeOptions & {
+        traceId: string;
+        parentSpanId?: string;
+    }): DiagnosticsSpan;
+    createInactiveSpan(traceId: string, parentSpanId: string | undefined): DiagnosticsSpan;
+    writeEvent(input: {
+        message: string;
+        level: DiagnosticsLevel;
+        channel?: string;
+        attrs?: DiagnosticsAttrs;
+        entities?: DiagnosticsScopeOptions['entities'];
+        context?: DiagnosticsContextRef;
+        traceId: string;
+        spanId?: string;
+        data?: unknown;
+        error?: unknown;
+    }): void;
+    writeMeasurement(input: {
+        name: string;
+        value: number;
+        unit?: string;
+        level: DiagnosticsLevel;
+        channel?: string;
+        attrs?: DiagnosticsAttrs;
+        entities?: DiagnosticsScopeOptions['entities'];
+        context?: DiagnosticsContextRef;
+        traceId: string;
+        spanId?: string;
+    }): void;
+    writeSnapshot(input: {
+        name: string;
+        payload?: unknown;
+        level: DiagnosticsLevel;
+        channel?: string;
+        attrs?: DiagnosticsAttrs;
+        entities?: DiagnosticsScopeOptions['entities'];
+        context?: DiagnosticsContextRef;
+        traceId: string;
+        spanId?: string;
+    }): void;
+    writeTraceEnd(input: {
+        name: string;
+        level: DiagnosticsLevel;
+        channel?: string;
+        attrs?: DiagnosticsAttrs;
+        entities?: DiagnosticsScopeOptions['entities'];
+        context?: DiagnosticsContextRef;
+        traceId: string;
+        durMs: number;
+    }): void;
+    writeSpanEnd(input: {
+        name: string;
+        level: DiagnosticsLevel;
+        channel?: string;
+        attrs?: DiagnosticsAttrs;
+        entities?: DiagnosticsScopeOptions['entities'];
+        context?: DiagnosticsContextRef;
+        traceId: string;
+        spanId?: string;
+        parentSpanId?: string;
+        durMs: number;
+    }): void;
+    getRecord(recordId: number): DiagnosticsRecord | null;
+    getRecords(limit?: number): DiagnosticsRecord[];
+    getTraceRecords(traceId: string, limit?: number): DiagnosticsRecord[];
+    getEntityRecords(type: string, id: string, limit?: number): DiagnosticsRecord[];
+    queryRecords(query?: DiagnosticsRecordQuery): DiagnosticsRecord[];
+    getCounters(): DiagnosticsCounters;
+    snapshot(options?: {
+        includeRecords?: boolean;
+        limit?: number;
+    }): DiagnosticsSnapshot;
+    flushExporters(options?: {
+        limit?: number;
+    }): Promise<void>;
+    canCapture(level: DiagnosticsLevel, channel?: string): boolean;
+    private appendRecord;
+    private nextRecordId;
+    private scheduleNotify;
+}