@endge/core 1.2.5

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

@@ -0,0 +1,235 @@
+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

@@ -0,0 +1,93 @@
+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/endge-flow-runtime.types.d.ts

@@ -0,0 +1,28 @@
+import { FlowValidationIssue } from './action.types';
+/**
+ * Состояние выполнения action-flow.
+ * Это единственный runtime-state flow, который разделяют executor, handlers и runtime-host.
+ */
+export interface FlowExecutionState {
+    /** Нормализованный input, с которым был запущен flow. */
+    input: Record<string, unknown>;
+    /** Снимки исполнения шагов, индексированные по node-id. */
+    steps: Record<string, Record<string, unknown>>;
+    /** Локальное изменяемое хранилище flow. */
+    locals: Record<string, unknown>;
+    /** Глобальные runtime-метаданные текущего запуска flow. */
+    globals: Record<string, unknown>;
+    /** Снимок последнего исполненного шага. */
+    lastStep: Record<string, unknown> | null;
+}
+/**
+ * Результат исполнения action-flow.
+ */
+export interface FlowExecutionResult {
+    /** Удалось ли выполнить flow без validation/runtime issues. */
+    ok: boolean;
+    /** Итоговое состояние выполнения flow. */
+    state: FlowExecutionState;
+    /** Список validation/runtime проблем, обнаруженных при исполнении flow. */
+    issues: FlowValidationIssue[];
+}

package/dist/domain/types/endge-flow.types.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Канонический тип шага внутри action-flow.
+ * Описывает поведение шага на уровне UX/runtime, а не форму graph-node.
+ */
+export type ActionFlowStepKind = 'builtin' | 'behavior-binding' | 'runtime' | 'flow-ref';
+/**
+ * Тип graph-node внутри action-flow.
+ * Определяет, какой блок должен быть исполнен рантаймом flow.
+ */
+export type EndgeFlowNodeKind = 'start' | 'watch' | 'eventSubscribe' | 'delay' | 'timer' | 'intervalTimer' | 'action' | 'query' | 'runtimeAction' | 'switch' | 'forEach' | 'while' | 'parallel';
+/**
+ * Направление порта graph-node.
+ */
+export type EndgeFlowPortDirection = 'input' | 'output';
+/**
+ * Режим сериализации значения параметра node.
+ */
+export type EndgeFlowBindingMode = 'literal' | 'context' | 'block-output';
+/**
+ * Декларативная ссылка на значение, которое должно быть подставлено в параметр node.
+ */
+export interface EndgeFlowBinding {
+    /** Способ получения значения. */
+    mode: EndgeFlowBindingMode;
+    /** Буквальное значение для режима `literal`. */
+    value?: unknown;
+    /** Путь внутри execution-state для режима `context`. */
+    path?: string | null;
+    /** Источник значения в другом node для режима `block-output`. */
+    nodeId?: string | null;
+    /** Порт источника значения в другом node. */
+    portId?: string | null;
+}
+/**
+ * Сериализованные параметры graph-node.
+ * В editor-слое сюда могут попадать как structured bindings, так и уже развернутые plain values.
+ */
+export type EndgeFlowNodeParams = Record<string, EndgeFlowBinding | unknown>;
+/**
+ * Описание входного или выходного порта flow-блока.
+ */
+export interface EndgeFlowPortDefinition {
+    /** Уникальный идентификатор порта внутри блока. */
+    id: string;
+    /** Название порта для UI и debug. */
+    label: string;
+    /** Направление порта. */
+    direction: EndgeFlowPortDirection;
+    /** Может ли порт иметь несколько подключений одновременно. */
+    multiple?: boolean;
+    /** Обязателен ли порт для корректного исполнения блока. */
+    required?: boolean;
+    /** Человекочитаемый тип значения, проходящего через порт. */
+    valueType?: string | null;
+}
+/**
+ * Описание graph-node внутри action-flow definition.
+ */
+export interface EndgeFlowNodeDefinition {
+    /** Уникальный идентификатор node внутри flow. */
+    id: string;
+    /** Название шага для UI и debug. */
+    title: string;
+    /** Идентификатор block-spec, который должен быть исполнен. */
+    blockId: string;
+    /** Технический вид node в графе. */
+    kind: EndgeFlowNodeKind;
+    /** Параметры node в сериализованном виде. */
+    params?: EndgeFlowNodeParams;
+    /** Свободные метаданные node для editor/runtime. */
+    meta?: Record<string, unknown>;
+}
+/**
+ * Описание связи между двумя node в action-flow.
+ */
+export interface EndgeFlowEdgeDefinition {
+    /** Уникальный идентификатор ребра. */
+    id: string;
+    /** Node-источник. Для входа в граф допускается ссылка на entrypoint. */
+    sourceNodeId: string;
+    /** Порт источника. */
+    sourcePortId: string;
+    /** Node-получатель. */
+    targetNodeId: string;
+    /** Порт получателя. */
+    targetPortId: string;
+    /** Пользовательская подпись ребра. */
+    label?: string | null;
+}
+/**
+ * Каноническое декларативное описание action как flow-графа.
+ */
+export interface EndgeFlowDefinition {
+    /** Версия формата сериализации flow. */
+    version: number;
+    /** Идентификатор стартовой точки графа. Каноническое значение: `flow-entry`. */
+    entrypoint: string;
+    /** Список node action-flow. */
+    nodes: EndgeFlowNodeDefinition[];
+    /** Список ориентированных связей между node. */
+    edges: EndgeFlowEdgeDefinition[];
+}
+/**
+ * Контракт action-definition в формате flow.
+ * Отдельные alias добавлены для ясности в action-контексте.
+ */
+export type ActionFlowNodeKind = EndgeFlowNodeKind;
+export type ActionFlowNodeDefinition = EndgeFlowNodeDefinition;
+export type ActionFlowEdgeDefinition = EndgeFlowEdgeDefinition;
+export type ActionFlowDefinition = EndgeFlowDefinition;

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

@@ -0,0 +1,29 @@
+/**
+ * Связка события и id Действия из домена
+ */
+export type EndgeEventBinding = {
+    event: string;
+    actionId: string | null;
+};
+export type AnyEventName = string;
+export type AnyPayload = unknown;
+export type CachedEvent = {
+    name: AnyEventName;
+    payload: AnyPayload;
+    at: number;
+};
+export interface EndgeCustomEventMap {
+    [event: string]: unknown;
+}
+export interface EndgeEmitOptions {
+    stopOnCancel?: boolean;
+}
+/**
+ * Envelope-событие с возможностью cancel()
+ */
+export declare class EndgeEvent<T> {
+    readonly payload: T;
+    isCanceled: boolean;
+    constructor(payload: T);
+    cancel(): void;
+}