@endge/core 1.2.5 → 1.2.8

package/dist/domain/types/diagnostics.types.d.ts

@@ -1,235 +0,0 @@
-import { DiagnosticsSpan } from '../entities/diagnostics/DiagnosticsSpan';
-/**
- * Уровни диагностики упорядочены от самого подробного к самому критичному.
- * Политика модуля может отсекать всё, что ниже заданного порога.
- */
-export type DiagnosticsLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
-/**
- * Канонические типы record внутри модуля.
- * Модуль оперирует только ими и не знает ничего о UI-представлениях.
- */
-export type DiagnosticsRecordKind = 'trace-start' | 'trace-end' | 'span-start' | 'span-end' | 'event' | 'measurement' | 'snapshot';
-export type DiagnosticsScalar = string | number | boolean | null | undefined;
-/**
- * Плоские атрибуты record.
- * Здесь не должно быть тяжёлых объектов, чтобы запись оставалась дешёвой.
- */
-export type DiagnosticsAttrs = Record<string, DiagnosticsScalar>;
-/**
- * Ссылка на сущность ядра, к которой относится запись.
- */
-export interface DiagnosticsEntityRef {
-    type: string;
-    id: string;
-    attrs?: DiagnosticsAttrs;
-}
-/**
- * Контекст выполнения, независимый от UI-фреймворков.
- */
-export interface DiagnosticsContextRef {
-    module?: string;
-    runtimeId?: string;
-    project?: string;
-    environment?: string;
-    tenantId?: string;
-    userId?: string;
-    sessionId?: string;
-}
-export interface DiagnosticsCorrelation {
-    traceId: string;
-    spanId?: string;
-    parentSpanId?: string;
-}
-/**
- * Базовая форма любой диагностической записи.
- */
-export interface DiagnosticsRecordBase {
-    id: number;
-    ts: number;
-    level: DiagnosticsLevel;
-    kind: DiagnosticsRecordKind;
-    channel?: string;
-    name?: string;
-    corr?: DiagnosticsCorrelation;
-    attrs?: DiagnosticsAttrs;
-    entities?: DiagnosticsEntityRef[];
-    context?: DiagnosticsContextRef;
-}
-export interface DiagnosticsTraceStartRecord extends DiagnosticsRecordBase {
-    kind: 'trace-start';
-    name: string;
-    corr: DiagnosticsCorrelation;
-}
-export interface DiagnosticsTraceEndRecord extends DiagnosticsRecordBase {
-    kind: 'trace-end';
-    name: string;
-    corr: DiagnosticsCorrelation;
-    durMs: number;
-}
-export interface DiagnosticsSpanStartRecord extends DiagnosticsRecordBase {
-    kind: 'span-start';
-    name: string;
-    corr: DiagnosticsCorrelation;
-}
-export interface DiagnosticsSpanEndRecord extends DiagnosticsRecordBase {
-    kind: 'span-end';
-    name: string;
-    corr: DiagnosticsCorrelation;
-    durMs: number;
-}
-export interface DiagnosticsEventRecord extends DiagnosticsRecordBase {
-    kind: 'event';
-    message: string;
-    data?: unknown;
-    error?: unknown;
-}
-export interface DiagnosticsMeasurementRecord extends DiagnosticsRecordBase {
-    kind: 'measurement';
-    name: string;
-    value: number;
-    unit?: string;
-}
-export interface DiagnosticsSnapshotRecord extends DiagnosticsRecordBase {
-    kind: 'snapshot';
-    name: string;
-    payload?: unknown;
-}
-export type DiagnosticsRecord = DiagnosticsTraceStartRecord | DiagnosticsTraceEndRecord | DiagnosticsSpanStartRecord | DiagnosticsSpanEndRecord | DiagnosticsEventRecord | DiagnosticsMeasurementRecord | DiagnosticsSnapshotRecord;
-export interface DiagnosticsScopeOptions {
-    level?: DiagnosticsLevel;
-    channel?: string;
-    attrs?: DiagnosticsAttrs;
-    entities?: DiagnosticsEntityRef[];
-    context?: Partial<DiagnosticsContextRef>;
-}
-export interface DiagnosticsEventOptions extends DiagnosticsScopeOptions {
-    data?: unknown;
-    error?: unknown;
-}
-export interface DiagnosticsMeasurementOptions extends DiagnosticsScopeOptions {
-    unit?: string;
-}
-export interface DiagnosticsSnapshotOptions extends DiagnosticsScopeOptions {
-    payload?: unknown;
-}
-export interface DiagnosticsPolicy {
-    enabled: boolean;
-    levelThreshold: DiagnosticsLevel;
-    sampleRate: number;
-    maxRecords: number;
-    includeChannels: string[];
-    excludeChannels: string[];
-    exportersEnabled: boolean;
-    persistPolicy: boolean;
-}
-export interface DiagnosticsCounters {
-    totalRecords: number;
-    droppedByPolicy: number;
-    droppedByCapacity: number;
-    activeExporters: number;
-    openTraces: number;
-    openSpans: number;
-    recordsByKind: Partial<Record<DiagnosticsRecordKind, number>>;
-    recordsByChannel: Record<string, number>;
-}
-export interface DiagnosticsRecordQuery {
-    traceId?: string;
-    entity?: {
-        type: string;
-        id: string;
-    };
-    channel?: string;
-    levelAtLeast?: DiagnosticsLevel;
-    limit?: number;
-}
-/**
- * Полный snapshot модуля для чтения извне.
- * По умолчанию records можно не включать, чтобы дешево получать только состояние.
- */
-export interface DiagnosticsSnapshot {
-    sessionId: string;
-    policy: DiagnosticsPolicy;
-    counters: DiagnosticsCounters;
-    records?: DiagnosticsRecord[];
-}
-export interface DiagnosticsScopeWriter {
-    readonly sessionId: string;
-    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;
-}
-export interface DiagnosticsSpanOwner extends DiagnosticsScopeWriter {
-    startSpan(name: string, options: DiagnosticsScopeOptions & {
-        traceId: string;
-        parentSpanId?: string;
-    }): DiagnosticsSpan;
-    createInactiveSpan(traceId: string, parentSpanId: string | undefined): DiagnosticsSpan;
-    writeSpanEnd(input: {
-        name: string;
-        level: DiagnosticsLevel;
-        channel?: string;
-        attrs?: DiagnosticsAttrs;
-        entities?: DiagnosticsScopeOptions['entities'];
-        context?: DiagnosticsContextRef;
-        traceId: string;
-        spanId?: string;
-        parentSpanId?: string;
-        durMs: number;
-    }): void;
-}
-export interface DiagnosticsTraceOwner extends DiagnosticsScopeWriter {
-    startSpan(name: string, options: DiagnosticsScopeOptions & {
-        traceId: string;
-        parentSpanId?: string;
-    }): DiagnosticsSpan;
-    createInactiveSpan(traceId: string, parentSpanId: string | undefined): DiagnosticsSpan;
-    writeTraceEnd(input: {
-        name: string;
-        level: DiagnosticsLevel;
-        channel?: string;
-        attrs?: DiagnosticsAttrs;
-        entities?: DiagnosticsScopeOptions['entities'];
-        context?: DiagnosticsContextRef;
-        traceId: string;
-        durMs: number;
-    }): void;
-}
-export interface DiagnosticsExporter {
-    id: string;
-    export(records: readonly DiagnosticsRecord[], meta: {
-        sessionId: string;
-        exportedAt: number;
-    }): void | Promise<void>;
-}

package/dist/domain/types/document.types.d.ts

@@ -1,93 +0,0 @@
-import { RAction } from '../entities/reflect/RAction';
-import { RConverter } from '../entities/reflect/RConverter';
-import { RFilter } from '../entities/reflect/RFilter';
-import { RIntegration } from '../entities/reflect/RIntegration';
-import { RParameter } from '../entities/reflect/RParameter';
-import { RView } from '../entities/reflect/RView';
-import { RPageTemplate } from '../entities/reflect/RPageTemplate';
-import { RPage } from '../entities/reflect/RPage';
-import { RNavigation } from '../entities/reflect/RNavigation';
-import { RQuery } from '../entities/reflect/RQuery';
-import { RScenario } from '../entities/reflect/RScenario';
-import { RSettings } from '../entities/reflect/RSettings';
-import { RPolicy } from '../entities/reflect/RPolicy';
-import { RStyle } from '../entities/reflect/RStyle';
-import { RTenant } from '../entities/reflect/RTenant';
-import { RBehaviorBinding } from '../entities/reflect/RBehaviorBinding';
-import { RPresentationBinding } from '../entities/reflect/RPresentationBinding';
-import { RVocabs } from '../entities/reflect/RVocabs';
-import { RI18nBundle } from '../entities/reflect/RI18nBundle';
-import { RComponent } from './component.types';
-/**
- * Разновидности типов компонентов
- */
-export declare enum ComponentType {
-    Component = "component",
-    DSL = "component-dsl",
-    Table = "component-table"
-}
-/** Тип документа «Параметр» (коллекция parameters). */
-export declare enum ParameterType {
-    DefaultParameter = "default-parameter"
-}
-/** Тип документа «Фильтр» (коллекция filters). */
-export declare enum FilterType {
-    DefaultFilter = "default-filter"
-}
-/**
- * Разновидности типов запросов
- */
-export declare enum QueryType {
-    Custom = "query-custom",
-    GraphQL = "query-gql",
-    REST = "query-rest"
-}
-/**
- * Вариации секций домена.
- */
-export declare enum DomainSectionType {
-    Primitive = "primitive",
-    Type = "type",
-    Component = "component",
-    Query = "query",
-    Scenario = "scenario",
-    Action = "action",
-    Converter = "converter",
-    Integration = "integration",
-    View = "view",
-    Parameters = "parameters",
-    Filters = "filters",
-    Environment = "environment",
-    Tenant = "tenant",
-    Policy = "policy",
-    Style = "style",
-    PageTemplate = "page-template",
-    Page = "page",
-    Navigation = "navigation",
-    Vocabs = "vocabs",
-    I18nBundles = "i18n-bundles",
-    Settings = "settings",
-    Project = "project"
-}
-/**
- * Описывает типы скриптов
- */
-export declare enum ScriptType {
-    ScenarioSetup = "scenario-setup"
-}
-/**
- * Все возможные типы документов
- */
-export type DomainDocumentType = 'primitive' | 'type' | 'action' | 'converter' | 'integration' | 'view' | 'page-template' | 'page' | 'navigation' | 'environment' | 'policy' | 'style' | 'behavior-binding' | 'presentation-binding' | 'vocabs' | 'i18n-bundles' | 'tenant' | 'settings' | 'project' | Exclude<ComponentType, ComponentType.Component> | QueryType | ScriptType | ParameterType | FilterType;
-/**
- * Описывает любой документ
- */
-export interface Document {
-    type: DomainDocumentType;
-    sectionType: DomainSectionType;
-    id: string;
-}
-/**
- * Описывает любой документ рефлекцию
- */
-export type RDocument = RComponent | RQuery | RScenario | RAction | RConverter | RIntegration | RView | RParameter | RFilter | RSettings | RPolicy | RStyle | RVocabs | RI18nBundle | RTenant | RBehaviorBinding | RPresentationBinding | RPageTemplate | RPage | RNavigation;

package/dist/domain/types/faceted-cascade.d.ts

@@ -1,300 +0,0 @@
-import { EndgeBindingMode, EndgeResolvedOverrideBase } from './resolve.types';
-import { ConfigurationContract } from './configuration-contract.types';
-/**
- * Тип facet-слоя, в котором работает override-специфика.
- * Behavior отвечает за подмену поведения, Presentation - за подмену представления,
- * Configuration - за подмену и наблюдение конфигурационных полей.
- */
-export declare enum EndgeFacetType {
-    Behavior = "behavior",
-    Presentation = "presentation",
-    Configuration = "configuration"
-}
-/**
- * Базовый набор сущностей, поддерживающих faceted cascade.
- * Это общие entity type для behavior- и presentation-контрактов.
- */
-export declare enum FacetedCascadeEntityType {
-    Project = "project",
-    View = "view",
-    Component = "component",
-    Query = "query",
-    Page = "page",
-    PageTemplate = "page-template"
-}
-/**
- * Область действия override-контракта.
- * Owner - слот относится к самой сущности.
- * Target - слот относится к дочерней/связанной сущности.
- * Global - слот описывает глобальную точку расширения.
- */
-export declare enum FacetedCascadeScope {
-    Owner = "owner",
-    Target = "target",
-    Global = "global"
-}
-/**
- * Упрощённая схема полезной нагрузки или контекста для контракта.
- */
-export type FacetedCascadeSchema = Record<string, unknown>;
-/**
- * Общая база для всех override-контрактов.
- * Контракт описывает допустимый слот подмены, но сам по себе не хранит правило override.
- */
-export interface FacetedCascadeContractBase<TEntity extends string = string> {
-    /**
-     * Facet-слой, к которому относится слот подмены.
-     */
-    facet: EndgeFacetType;
-    /**
-     * Тип сущности, для которой открыт слот подмены.
-     */
-    entityType: TEntity;
-    /**
-     * Короткое имя слота для UI и документации.
-     */
-    title: string;
-    /**
-     * Человекочитаемое описание назначения слота.
-     */
-    description?: string | null;
-    /**
-     * Область действия слота в каскаде.
-     */
-    scope: FacetedCascadeScope;
-    /**
-     * Разрешено ли пользователю создавать override/binding для этого слота.
-     * Для совместимости со старой behavior-моделью поле оставлено общим и опциональным.
-     */
-    supportsBinding?: boolean;
-    /**
-     * Можно ли переопределять слот по environment.
-     */
-    supportsEnvironmentOverride: boolean;
-}
-/**
- * Семантическая категория behavior-слота.
- * Нужна для группировки событий и навигации в конфигураторе.
- */
-export declare enum BehaviorContractKind {
-    Lifecycle = "lifecycle",
-    Interaction = "interaction",
-    Data = "data",
-    Composition = "composition"
-}
-/**
- * Контракт behavior-слота.
- * Описывает событие, на которое сущность или контекст могут подменять поведение.
- */
-export interface BehaviorContract<TEntity extends string = string> extends FacetedCascadeContractBase<TEntity> {
-    facet: EndgeFacetType.Behavior;
-    /**
-     * Каноническое имя события, используемое как selector в behavior cascade.
-     */
-    eventName: string;
-    /**
-     * Категория события.
-     */
-    eventKind: BehaviorContractKind;
-    /**
-     * Схема payload события, если она нужна для UI и валидации.
-     */
-    payloadSchema?: FacetedCascadeSchema | null;
-    /**
-     * Схема дополнительного runtime-контекста события.
-     */
-    contextSchema?: FacetedCascadeSchema | null;
-}
-/**
- * Семантическая категория presentation-слота.
- * Нужна для группировки ролей представления в конфигураторе.
- */
-export declare enum PresentationContractKind {
-    Renderer = "renderer",
-    Layout = "layout",
-    Asset = "asset",
-    State = "state",
-    Composition = "composition"
-}
-/**
- * Контракт presentation-слота.
- * Описывает роль представления, для которой можно подменять renderer, layout, asset или state-specific UI.
- */
-export interface PresentationContract<TEntity extends string = string> extends FacetedCascadeContractBase<TEntity> {
-    facet: EndgeFacetType.Presentation;
-    /**
-     * Каноническая роль представления, используемая как selector в presentation cascade.
-     */
-    role: string;
-    /**
-     * Категория presentation-слота.
-     */
-    contractKind: PresentationContractKind;
-    /**
-     * Схема props/контекста, которыми может оперировать presentation-слот.
-     */
-    propsSchema?: FacetedCascadeSchema | null;
-    /**
-     * Схема дополнительного контекста разрешения presentation-слота.
-     */
-    contextSchema?: FacetedCascadeSchema | null;
-}
-/**
- * Общий union контрактов faceted cascade.
- * Реестр контрактов хранит все три типа одновременно и различает их по `facet`.
- */
-export type EndgeContract<TEntity extends string = string> = BehaviorContract<TEntity> | PresentationContract<TEntity> | ConfigurationContract<TEntity>;
-/**
- * Совместимые aliases для существующего behavior/event-слоя.
- * Пока behavior bindings ещё опираются на термин "event contract".
- */
-export type EventContract = BehaviorContract<FacetedCascadeEntityType>;
-export type EventContractSchema = FacetedCascadeSchema;
-export { FacetedCascadeEntityType as EventContractEntityType, BehaviorContractKind as EventContractKind, FacetedCascadeScope as EventContractScope, };
-/**
- * Общая база документа override-binding для обоих facet-слоёв.
- * Binding хранит уже конкретное правило подмены в рамках каскада.
- */
-export interface FacetedCascadeBindingDocBase {
-    id: number;
-    identity: string;
-    displayName: string;
-    projectId?: number | null;
-    ownerType: string;
-    ownerId: number;
-    targetType: string;
-    targetId?: number | null;
-    mode: EndgeBindingMode;
-    priority: number;
-    isEnabled: boolean;
-    environmentId?: number | null;
-    isInherited?: boolean;
-    originBindingId?: number | null;
-    folder?: number | null;
-}
-/**
- * База payload для создания/обновления override-binding.
- */
-export interface FacetedCascadeBindingWriteDataBase {
-    identity: string;
-    displayName: string;
-    projectId?: number | null;
-    ownerType: string;
-    ownerId: number;
-    targetType: string;
-    targetId?: number | null;
-    mode: EndgeBindingMode;
-    priority: number;
-    isEnabled: boolean;
-    environmentId?: number | null;
-    isInherited?: boolean;
-    originBindingId?: number | null;
-    folder?: number | null;
-}
-/**
- * Общие параметры резолва override-binding.
- */
-export interface FacetedCascadeBindingResolverOptions {
-    ownerType: string;
-    ownerId: number;
-    targetType?: string | null;
-    targetId?: number | null;
-    environmentId?: number | null;
-}
-/**
- * База resolved-override результата после применения каскада.
- */
-export type FacetedCascadeResolvedBindingBase = EndgeResolvedOverrideBase;
-/**
- * Конкретное правило подмены поведения.
- */
-export interface BehaviorBindingDoc extends FacetedCascadeBindingDocBase {
-    targetId: number;
-    eventName: string;
-    scriptRef: string;
-}
-/**
- * Payload для записи behavior-binding.
- */
-export interface BehaviorBindingWriteData extends FacetedCascadeBindingWriteDataBase {
-    targetId: number;
-    eventName: string;
-    scriptRef: string;
-}
-/**
- * Параметры резолва behavior-binding для конкретного события.
- */
-export interface BehaviorBindingResolverOptions extends FacetedCascadeBindingResolverOptions {
-    eventName?: string | null;
-}
-/**
- * Итоговый resolved behavior-binding после применения каскада.
- */
-export interface ResolvedBehaviorBinding extends FacetedCascadeResolvedBindingBase {
-    eventName: string;
-    scriptRef: string;
-}
-/**
- * Конкретное правило подмены представления.
- */
-export interface PresentationBindingDoc extends FacetedCascadeBindingDocBase {
-    role: string;
-    rendererRef: string;
-    when?: string | null;
-}
-/**
- * Payload для записи presentation-binding.
- */
-export interface PresentationBindingWriteData extends FacetedCascadeBindingWriteDataBase {
-    role: string;
-    rendererRef: string;
-    when?: string | null;
-}
-/**
- * Параметры резолва presentation-binding для конкретной роли.
- */
-export interface PresentationBindingResolverOptions extends FacetedCascadeBindingResolverOptions {
-    role?: string | null;
-}
-/**
- * Итоговый resolved presentation-binding после применения каскада.
- */
-export interface ResolvedPresentationBinding extends FacetedCascadeResolvedBindingBase {
-    role: string;
-    rendererRef: string;
-    when: string | null;
-}
-/**
- * Результат резолва behavior-контракта: найденные биндинги и метаданные запроса.
- */
-export interface BehaviorResolveResult {
-    /** Параметры, с которыми выполнялся резолв. */
-    request: BehaviorBindingResolverOptions;
-    /** Событие (selector), по которому искали. */
-    eventName: string;
-    /** Найденные биндинги после каскада. */
-    bindings: ResolvedBehaviorBinding[];
-    /** Найден ли хотя бы один биндинг. */
-    found: boolean;
-    /** Количество найденных биндингов. */
-    count: number;
-    /** Фасет для единообразия с presentation. */
-    facet: 'behavior';
-}
-/**
- * Результат резолва presentation-контракта: найденные биндинги и метаданные запроса.
- */
-export interface PresentationResolveResult {
-    /** Параметры, с которыми выполнялся резолв. */
-    request: PresentationBindingResolverOptions;
-    /** Роль (selector), по которой искали. */
-    role: string;
-    /** Найденные биндинги после каскада. */
-    bindings: ResolvedPresentationBinding[];
-    /** Найден ли хотя бы один биндинг. */
-    found: boolean;
-    /** Количество найденных биндингов. */
-    count: number;
-    /** Фасет для единообразия с behavior. */
-    facet: 'presentation';
-}

package/dist/domain/types/navigation.types.d.ts

@@ -1,27 +0,0 @@
-/** Типы документа навигации из Payload (коллекция navigations). */
-/** Узел полного дерева навигации. */
-export interface NavigationTreeNodeDoc {
-    id?: string | null;
-    type: 'link' | 'group';
-    title: string;
-    icon?: string | null;
-    hidden?: boolean;
-    disabled?: boolean;
-    collapsedTitle?: string | null;
-    path?: string | null;
-    routeName?: string | null;
-    external?: boolean;
-    children?: NavigationTreeNodeDoc[];
-}
-/** Документ навигации из Payload. */
-export interface NavigationDoc {
-    id: number | string;
-    identity: string;
-    displayName: string;
-    description?: string | null;
-    folder?: number | string;
-    project?: number | string;
-    isSystem?: boolean;
-    tree?: NavigationTreeNodeDoc[];
-    meta?: Record<string, unknown>;
-}