@endge/core 2.0.4 → 3.0.2

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

@@ -1,110 +0,0 @@
-/**
- * Канонический тип шага внутри action-flow.
- * Описывает поведение шага на уровне UX/runtime, а не форму graph-node.
- */
-export type ActionFlowStepKind = 'builtin' | 'action' | '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/flow/flow-condition.types.d.ts

@@ -1,39 +0,0 @@
-import { FlowHandlerContext } from './action.types';
-export type { FlowHandlerContext };
-/**
- * Параметр входа условия из реестра (для UI и валидации).
- */
-export interface FlowConditionInputParam {
-    name: string;
-    label: string;
-    valueType: string;
-    optional?: boolean;
-    /** Секции домена, с которых разрешён выбор сущности (например vocabs). */
-    acceptSectionTypes?: string[];
-}
-/**
- * Спека условия для реестра (метаданные + evaluator).
- */
-export interface FlowConditionSpec {
-    id: string;
-    title: string;
-    description: string | null;
-    inputParams: FlowConditionInputParam[];
-    evaluate(ctx: FlowHandlerContext, params: Record<string, unknown>): boolean | Promise<boolean>;
-}
-/**
- * Конфиг одной ветки switch в режиме реестра.
- */
-export interface FlowSwitchBranchConfig {
-    conditionId: string;
-    params: Record<string, unknown>;
-    portId: string;
-}
-/**
- * Параметры узла switch в flow.
- */
-export interface FlowSwitchParams {
-    conditionMode?: 'script' | 'registry';
-    scriptExpression?: string;
-    branches?: FlowSwitchBranchConfig[];
-}

package/dist/model/modules/runtime/core/endge-bind.d.ts

@@ -1,39 +0,0 @@
-import { ActionStepHandler } from '../../../../domain/types/flow/action.types';
-import { ComputationOverride } from '../../../../domain/types/computation/computation-runtime.types';
-import { EndgeModule } from '../../../../domain/entities/endge/EndgeModule';
-import { RAction } from '../../../../domain/entities/reflect/RAction';
-/**
- * Привязка кастомного кода к существующим сущностям ядра.
- * Не связана с declarative bindings и event contracts.
- */
-export declare class EndgeBind extends EndgeModule {
-    private readonly computationOverrides;
-    /**
-     * Регистрирует built-in converters после загрузки домена.
-     */
-    start(): void;
-    /**
-     * Регистрирует Default Converters.
-     */
-    private registerDefaultConverters;
-    /**
-     * Находит конвертер по identity и ставит кастомный обработчик (setCustom).
-     * @param identity - id конвертера в домене
-     * @param handler - функция (value) => convertedValue
-     * @returns true, если конвертер найден и обработчик установлен
-     */
-    converter(identity: string, handler: (v: any, options?: Record<string, unknown>) => any): boolean;
-    /**
-     * Привязывает обработчик runtime-step в контексте конкретного action.
-     * @deprecated Для полного Action используйте Endge.actions.override(); этот API оставлен только для legacy runtimeAction nodes.
-     * @param actionOrId - действие или его id/identity
-     * @param runtimeId - id runtime-step внутри переданного action
-     * @param handler - обработчик шага
-     * @returns true, если action и runtime-step найдены, и обработчик установлен
-     */
-    action(actionOrId: RAction | string | number, runtimeId: string, handler: ActionStepHandler): boolean;
-    /** Registers a local full replacement for a persisted computation graph. */
-    computation(identity: string, override: ComputationOverride): VoidFunction;
-    /** Runtime-only lookup used by EndgeComputation. */
-    getComputation(identity: string): ComputationOverride | null;
-}

package/dist/model/modules/runtime/flow/endge-flow-registry.d.ts

@@ -1,34 +0,0 @@
-import { FlowConditionSpec } from '../../../../domain/types/flow/flow-condition.types';
-import { FlowHandlerContext } from '../../../../domain/types/flow/action.types';
-/**
- * Реестр конструкций flow: условия и в будущем другие сущности.
- * Принадлежит runtime flow executor и не участвует в federation lifecycle.
- */
-export declare class EndgeFlowRegistry {
-    private _conditions;
-    constructor();
-    /**
-     * Регистрирует условие flow.
-     */
-    registerCondition(spec: FlowConditionSpec): void;
-    /**
-     * Возвращает список спецификаций условий для UI.
-     */
-    listConditions(): FlowConditionSpec[];
-    /**
-     * Возвращает спецификацию условия по id.
-     */
-    getCondition(id: string): FlowConditionSpec | undefined;
-    /**
-     * Выполняет условие по id с runtime-контекстом и параметрами.
-     */
-    evaluateCondition(conditionId: string, ctx: FlowHandlerContext, params: Record<string, unknown>): Promise<boolean>;
-    /**
-     * Регистрирует стандартные flow-условия на стадии start.
-     */
-    reset(): void;
-    /**
-     * Регистрирует условия по умолчанию.
-     */
-    private _registerDefaultConditions;
-}

package/dist/model/modules/runtime/flow/endge-flow.d.ts

@@ -1,94 +0,0 @@
-import { FlowExecutionResult } from '../../../../domain/types/flow/endge-flow-runtime.types';
-import { RuntimeHost } from '../../../../domain/types/runtime/runtime-host.types';
-import { EndgeFlowRegistry } from './endge-flow-registry';
-/**
- * Модуль исполнения compiled flow для action runtime-host.
- */
-export declare class EndgeFlow {
-    readonly conditions: EndgeFlowRegistry;
-    constructor(conditions?: EndgeFlowRegistry);
-    /**
-     * Исполняет flow целиком внутри переданного action runtime-host.
-     */
-    run(host: RuntimeHost<'action'>): Promise<void>;
-    /**
-     * Исполняет один block внутри переданного action runtime-host.
-     */
-    runBlock(host: RuntimeHost<'action'>, blockId: string): Promise<FlowExecutionResult>;
-    /** Создаёт пустой flow-state для случаев, когда состояние ещё не инициализировано. */
-    /**
-     * Создает Default State.
-     */
-    private _createDefaultState;
-    /** Формирует канонический результат выполнения flow/block. */
-    /**
-     * Создает Execution Result.
-     */
-    private _createExecutionResult;
-    /** Преобразует параметры node в плоский объект значений для рантайма. */
-    /**
-     * Преобразует значение в Plain Params.
-     */
-    private _toPlainParams;
-    /** Собирает error-результат с единым форматом issue. */
-    /**
-     * Создает Error Result.
-     */
-    private _createErrorResult;
-    /**
-     * Определяет порт switch по условию (скрипт или реестр).
-     * Возвращает portId для выбора исходящего ребра.
-     */
-    private _getSwitchSelectedPortId;
-    /**
-     * Параметры, приходящие по входящему ребру на порт 'in':
-     * если источник — entrypoint (flow-entry), берём state.input; иначе — выход предыдущего шага.
-     */
-    private _getParamsFromIncomingEdge;
-    /**
-     * Строит payload для action с учётом input-схемы.
-     * Если params = { input: value } (единственный ключ "input"), передаём в action только value (массив и т.д.), без обёртки.
-     */
-    private _buildActionInput;
-    /**
-     * Подготавливает payload для query с учётом сигнатуры параметров.
-     * Поддерживает сценарий, когда в flow передаётся только `input`, а у query объявлен единственный параметр.
-     */
-    private _buildQueryInput;
-    /** Возвращает имена props, объявленных в Query artifact. */
-    private _getQueryArtifactParamNames;
-    /** Формирует runtime-контекст, который передаётся в custom/runtime handlers. */
-    /**
-     * Создает Flow Handler Context.
-     */
-    private _createFlowHandlerContext;
-    /**
-     * Возвращает Compiled Flow.
-     */
-    private _getCompiledFlow;
-    /** Рекурсивно резолвит параметры node через текущий flow-state. */
-    /**
-     * Разрешает Node Params.
-     */
-    private _resolveNodeParams;
-    /** Рекурсивно резолвит значение параметра: строки, массивы и объекты. */
-    /**
-     * Разрешает Value.
-     */
-    private _resolveValue;
-    /** Резолвит выражения вида `{ctx...}` в строках параметров node. */
-    /**
-     * Разрешает String Value.
-     */
-    private _resolveStringValue;
-    /** Достаёт значение из flow-state по пути `ctx.*`. */
-    /**
-     * Возвращает Context Value.
-     */
-    private _getContextValue;
-    /** Проверяет, является ли строка полным выражением контекста (`{ctx...}`). */
-    /**
-     * Внутренний helper модуля: extract Full Context Path.
-     */
-    private _extractFullContextPath;
-}