@endge/core 1.2.5

package/dist/domain/script-api/watch.d.ts

@@ -0,0 +1,7 @@
+import { StoreWriter } from '../entities/runtime/RuntimeContext';
+import { RuntimeScope } from '../entities/runtime/RuntimeScope';
+/**
+ * Функция watch, предоставляемая в RuntimeContext.
+ * При вызове с queryId возвращает .to(...), но если .to не будет вызвана вручную - выполнится автоматически.
+ */
+export declare function apiWatch(scope: RuntimeScope, queryId: string): StoreWriter;

package/dist/domain/services/AbstractSyntaxTree_JSX.d.ts

@@ -0,0 +1,30 @@
+import { DependencyGraph } from '../entities/data/DependencyGraph';
+import { RField } from '../entities/reflect/RField';
+/**
+ * Класс для парсинга JSX-скрипта компонента:
+ * - строит DependencyGraph
+ * - сразу создаёт DependencyEdge для связей с дочерними компонентами (Aegis)
+ */
+export declare class AbstractSyntaxTree_JSX {
+    private jsxCode;
+    private ast;
+    private dependencyGraph;
+    private exportedNames;
+    private meId;
+    constructor(jsxCode: string, meId: string);
+    /**
+     * Парсит JSX-скрипт, сразу строя локальный DependencyGraph и Aegis-связи.
+     */
+    parseAndBuildGraph(inputFields: Record<string, RField>, exportedNames?: Set<string>): void;
+    /**
+     * Рекурсивно обходит AST-узлы:
+     * - Добавляет зависимости (DependencyNode) для выражений
+     * - Строит DependencyEdge для Component
+     */
+    private _walk;
+    /**
+     * Возвращает локальный DependencyGraph.
+     */
+    getDependencyGraph(): DependencyGraph | null;
+    private _normalizeInterpolations;
+}

package/dist/domain/services/AbstractSyntaxTree_TS.d.ts

@@ -0,0 +1,18 @@
+import * as t from '@babel/types';
+export declare class AbstractSyntaxTree_TS {
+    private script;
+    private ast;
+    private usedVariables;
+    private errors;
+    private exportedNames;
+    private readonly globalVariables;
+    constructor(script: string);
+    parse(): void;
+    extractDeclaredGlobals(): void;
+    getVariables(): string[];
+    validateInputFields(inputFields: Record<string, any>): void;
+    addError(error: string): void;
+    getExportedNames(): Set<string>;
+    getErrors(): string[];
+    getAst(): t.File | null;
+}

package/dist/domain/services/GraphQLBuilderService.d.ts

@@ -0,0 +1,19 @@
+import { DependencyGraph } from '../entities/data/DependencyGraph';
+import { GQLQueryNode } from '../types/types';
+/**
+ * Сервис для построения GraphQL-запроса из DependencyGraph.
+ */
+export declare class GraphQLBuilderService {
+    /**
+     * Построить JSON-структуру запроса.
+     */
+    buildQueryTree(graph: DependencyGraph, marker: string): GQLQueryNode | null;
+    /**
+     * Превращает JSON-структуру запроса в строку GraphQL.
+     */
+    toGraphQLString(node: GQLQueryNode, indent?: string): string;
+    /**
+     * Построить JSON-структуру GraphQL-запроса с типами на конечных узлах.
+     */
+    buildQueryJSON(graph: DependencyGraph, marker: string): Record<string, any> | null;
+}

package/dist/domain/services/ScenarioScriptBuilderService.d.ts

@@ -0,0 +1,19 @@
+export interface MemoryLink {
+    query: string;
+    mount: string;
+}
+export declare class ScenarioScriptBuilderService {
+    /**
+     * Ошибки, найденные при анализе
+     */
+    errors: string[];
+    /**
+     * Структура: memoryId -> { query: string, mount: string }
+     */
+    memoryLinks: Record<string, MemoryLink>;
+    /**
+     * Анализирует TypeScript-скрипт сценария.
+     * Результат сохраняется в свойствах this.errors и this.memoryLinks.
+     */
+    analyze(script: string): void;
+}

package/dist/domain/services/auth.d.ts

@@ -0,0 +1,17 @@
+import { KeycloakTokenResponse, StoredAuthToken } from '../types/auth.types';
+import { AxiosInstance } from 'axios';
+export declare function mapTokenResponseToStored(data: KeycloakTokenResponse, now?: Date): StoredAuthToken;
+export declare class KeycloakAuthService {
+    private readonly http;
+    private readonly tokenPath;
+    private readonly logoutPath;
+    constructor(baseUrl: string, tokenPath: string, logoutPath: string);
+    passwordGrant(payload: Record<string, string>): Promise<KeycloakTokenResponse>;
+    refreshGrant(payload: Record<string, string>): Promise<KeycloakTokenResponse>;
+    logout(payload: Record<string, string>): Promise<void>;
+    /**
+     * Получить userinfo для текущего токена.
+     * ВАЖНО: сюда нужно передавать axios-инстанс с уже выставленным Authorization.
+     */
+    getUserInfo(authorizedHttp: AxiosInstance): Promise<any>;
+}

package/dist/domain/services/component-render-host.d.ts

@@ -0,0 +1,20 @@
+import { RComponent } from '../types/component.types';
+import { RuntimeScope } from '../entities/runtime/RuntimeScope';
+import { RenderComponentInfo } from '../types/types';
+import { UILegacyComponentRenderHost, UIResolvedLegacyComponentRenderer } from '../types/ui-composition.types';
+export declare function resolveEndgeComponentRenderer(input: {
+    model: RComponent;
+    host: UILegacyComponentRenderHost;
+}): UIResolvedLegacyComponentRenderer | null;
+export declare function resolveEndgeComponentRenderInfo(input: {
+    model: RComponent;
+    host: UILegacyComponentRenderHost;
+}): RenderComponentInfo | null;
+export declare function renderEndgeComponent(input: {
+    h: any;
+    model: RComponent;
+    comData: Record<string, any>;
+    scope?: RuntimeScope;
+    host: UILegacyComponentRenderHost;
+    context?: Record<string, any>;
+}): any;

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

@@ -0,0 +1,65 @@
+import { ActionRuntimeHostContext } from './runtime-host.types';
+import { FlowExecutionState } from './endge-flow-runtime.types';
+import { ActionFlowDefinition } from './endge-flow.types';
+/**
+ * Каноническое определение action как flow-графа.
+ */
+export type ActionDefinition = ActionFlowDefinition;
+/**
+ * Контекст, который получают custom handlers и runtime-step handlers action-flow.
+ */
+export interface FlowHandlerContext {
+    /** Каноническое runtime-state текущего запуска flow. */
+    state: FlowExecutionState;
+    /** Идентификатор node внутри flow, если handler вызван из конкретного шага. */
+    nodeId?: string | null;
+    /** Идентификатор block-spec исполненного шага. */
+    blockId?: string | null;
+    /** Identity или id action, с которым связан текущий handler-вызов. */
+    actionId?: string | null;
+    /** runtime-id host или runtime-step, если он известен во время вызова. */
+    runtimeId?: string | null;
+}
+/**
+ * Результат работы custom/step handler.
+ */
+export type FlowHandlerResult = void | Promise<void>;
+/**
+ * Сигнатура обработчика шага runtime-action: получает полный контекст host'а (input, parent, flowState и т.д.),
+ * сам извлекает вход из context.input; опционально — flowContext (nodeId, state шага).
+ */
+export type ActionStepHandler = (context: ActionRuntimeHostContext, flowContext?: FlowHandlerContext) => FlowHandlerResult;
+/**
+ * Проблема, найденная при валидации или исполнении action-flow.
+ */
+export interface FlowValidationIssue {
+    /** Машинно-стабильный код проблемы. */
+    code: string;
+    /** Человекочитаемое описание проблемы. */
+    message: string;
+    /** Идентификатор node, если проблема относится к конкретному шагу. */
+    nodeId?: string;
+    /** Идентификатор edge, если проблема относится к конкретной связи. */
+    edgeId?: string;
+}
+/**
+ * Скомпилированное action-flow definition с индексами для быстрого исполнения.
+ */
+export interface ActionCompiledFlow {
+    /** Нормализованное flow-описание action. */
+    flow: ActionFlowDefinition;
+    /** Индекс node по id. */
+    nodesById: Map<string, ActionFlowDefinition['nodes'][number]>;
+    /** Индекс первого node-id по blockId. */
+    nodeIdByBlockId: Map<string, string>;
+    /** Индекс исходящих ребер по source node id. */
+    outgoingByNodeId: Map<string, ActionFlowDefinition['edges']>;
+    /** Индекс входящих ребер по target node id (для передачи данных с портов). */
+    incomingByNodeId: Map<string, ActionFlowDefinition['edges']>;
+    /** Индекс runtime-step по runtime-id. */
+    runtimeNodeIdByRuntimeId: Map<string, string>;
+    /** Список достижимых node от entrypoint. */
+    reachableNodeIds: string[];
+    /** Validation issues, найденные во время компиляции. */
+    issues: FlowValidationIssue[];
+}

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

@@ -0,0 +1,29 @@
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+/**
+ * Опции запроса (минимальный набор).
+ */
+export interface RequestOptions {
+    /** Доп. заголовки */
+    headers?: Record<string, string>;
+    /** Тело запроса; объект будет сериализован в JSON */
+    body?: unknown;
+    /** AbortSignal для отмены */
+    signal?: AbortSignal;
+    /** Query-параметры */
+    query?: Record<string, string | number | boolean | null | undefined>;
+}
+/**
+ * Описание одного эндпоинта сервиса.
+ */
+export interface EndpointDescriptor {
+    method: HttpMethod;
+    path: string;
+    options?: Omit<RequestOptions, 'body'>;
+}
+/**
+ * Описание сервиса: базовый путь и набор эндпоинтов.
+ */
+export interface ServiceDescriptor {
+    basePath?: string;
+    endpoints: Record<string, EndpointDescriptor>;
+}

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

@@ -0,0 +1,82 @@
+export type AuthPersist = 'localStorage' | 'sessionStorage';
+/** Поддерживаемые провайдеры авторизации. */
+export type AuthProvider = 'none' | 'keycloak_basic';
+/** Базовая часть конфига для Keycloak-совместимых провайдеров. */
+export interface KeycloakBaseConfig {
+    /** Базовый URL до OpenID Connect endpoints, напр. https://host/auth/realms/my/protocol/openid-connect */
+    baseUrl: string;
+    /** Идентификатор клиента */
+    clientId: string;
+    /** Скоупы через пробел */
+    scope?: string;
+    /** Относительный путь до токен-эндпоинта (обычно /endgeToken) */
+    tokenEndpoint?: string;
+    loginEndpoint?: string;
+    logoutEndpoint?: string;
+    /** Автообновление токена перед истечением */
+    autoRefresh?: boolean;
+    /** За сколько миллисекунд до exp обновлять токен */
+    refreshSkewMs?: number;
+    /** Персистентность состояния */
+    persist?: AuthPersist;
+}
+/** Конфигурация для password-гранта (движок сам логинится). */
+export interface KeycloakBasicConfig extends KeycloakBaseConfig {
+    provider: 'keycloak_basic';
+    username?: string;
+    password?: string;
+}
+/** Конфигурация без авторизации. */
+export interface NoneAuthConfig {
+    provider: 'none';
+    persist?: AuthPersist;
+}
+/** Дискриминированный юнион конфига. */
+export type AuthConfig = NoneAuthConfig | KeycloakBasicConfig;
+/** Ответ Keycloak при выдаче/рефреше токена (строго типизированный). */
+export interface KeycloakTokenResponse {
+    access_token: string;
+    expires_in: number;
+    refresh_expires_in: number;
+    refresh_token: string;
+    token_type: 'Bearer';
+    id_token?: string;
+    'not-before-policy'?: number;
+    session_state?: string;
+    scope?: string;
+}
+/** Состояние токена в рантайме/персисте. */
+export interface AuthState {
+    accessToken?: string | null;
+    refreshToken?: string | null;
+    /** Время истечения accessToken в ms (Date.now() базис) */
+    expiresAtMs?: number | null;
+    /** Время истечения refreshToken в ms (Date.now() базис) */
+    refreshExpiresAtMs?: number | null;
+    /** Метаданные */
+    updatedAt?: string;
+}
+/** Полный снапшот для сохранения/восстановления. */
+export interface AuthSnapshot {
+    config: AuthConfig;
+    state: AuthState;
+    /** Версия схемы для миграций */
+    version: number;
+}
+export interface StoredAuthToken {
+    access_token: string;
+    refresh_token?: string;
+    access_expires: string;
+    refresh_expires?: string;
+}
+export interface KeycloakTokenResponse {
+    access_token: string;
+    refresh_token?: string;
+    expires_in?: number;
+    refresh_expires_in?: number;
+}
+export type EndgeTokenMode = 'inherit' | 'manual' | 'none';
+export interface GetAccessTokenOpts {
+    mode?: EndgeTokenMode;
+    manualToken?: string | null;
+}

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

@@ -0,0 +1,35 @@
+export type BootstrapStepName = string;
+export interface BootstrapStep {
+    name: BootstrapStepName;
+    run: () => Promise<void>;
+    dependsOn?: readonly BootstrapStepName[];
+}
+export type BootstrapEvent = {
+    type: 'bootstrap:start';
+    steps: BootstrapStepName[];
+} | {
+    type: 'bootstrap:plan';
+    requested: BootstrapStepName[];
+    expanded: BootstrapStepName[];
+} | {
+    type: 'step:skip';
+    step: BootstrapStepName;
+} | {
+    type: 'step:start';
+    step: BootstrapStepName;
+} | {
+    type: 'step:done';
+    step: BootstrapStepName;
+    ms: number;
+} | {
+    type: 'step:error';
+    step: BootstrapStepName;
+    error: unknown;
+} | {
+    type: 'bootstrap:done';
+    steps: BootstrapStepName[];
+};
+export interface AppBootstrapOptions {
+    strict?: boolean;
+    onEvent?: (e: BootstrapEvent) => void;
+}

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

@@ -0,0 +1,23 @@
+export type EndgeProjectId = string;
+export type EndgeEnvId = string;
+export type EndgeTenantId = string;
+export type EndgeFolderId = string;
+export type EndgeSettingsId = string;
+export type EndgeTypeId = string;
+export type EndgeQueryId = string;
+export type EndgeComponentId = string;
+export type EndgeScenarioId = string;
+export type EndgeActionId = string;
+export type EndgeConverterId = string;
+export type EndgeIntegrationId = string;
+export type EndgeViewId = string;
+export type EndgePageTemplateId = string;
+export type EndgePageId = string;
+export type EndgeNavigationId = string;
+export type EndgeParameterId = string;
+export type EndgeFilterId = string;
+export type EndgeBehaviorBindingId = string;
+export type EndgePresentationBindingId = string;
+export type EndgePolicyId = string;
+export type EndgeStyleId = string;
+export type EndgeVocabId = string;

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

@@ -0,0 +1,8 @@
+import { RComponentDSL } from '../entities/reflect/RComponentDSL';
+import { RComponentTable } from '../entities/reflect/RComponentTable';
+import { ComponentType } from './document.types';
+export type RComponent = RComponentDSL | RComponentTable;
+/**
+ * Разновидности типов компонентов, которые могут быть встроены в таблицу
+ */
+export type ColumnComponentType = Exclude<ComponentType, ComponentType.Table>;

package/dist/domain/types/configuration-contract.types.d.ts

@@ -0,0 +1,53 @@
+import { EndgeFacetType, FacetedCascadeContractBase, FacetedCascadeSchema } from './faceted-cascade';
+/**
+ * Канонический тип значения конфигурационного поля.
+ * Нужен для UI, валидации и безопасной навигации по runtime-config mirror.
+ */
+export declare enum ConfigurationValueType {
+    String = "string",
+    Number = "number",
+    Boolean = "boolean",
+    Object = "object",
+    Array = "array",
+    Enum = "enum",
+    Unknown = "unknown"
+}
+/**
+ * Политика runtime-мутации поля.
+ * `none` - поле вычисляется только через base/cascade.
+ * `patch` - поле допускает временный runtime patch.
+ * `replace` - поле можно полностью заменить во время исполнения.
+ */
+export type ConfigurationMutationPolicy = 'none' | 'patch' | 'replace';
+/**
+ * Контракт одного конфигурационного поля сущности.
+ * Описывает не реакцию и не renderer, а сам слот конфигурации.
+ */
+export interface ConfigurationContract<TEntity extends string = string> extends FacetedCascadeContractBase<TEntity> {
+    facet: EndgeFacetType.Configuration;
+    /**
+     * Канонический путь поля внутри конфигурации сущности.
+     * Примеры: `tree[*].disabled`, `params.pageSize`, `layout.header.visible`.
+     */
+    fieldPath: string;
+    /**
+     * Тип значения поля.
+     */
+    valueType: ConfigurationValueType;
+    /**
+     * Можно ли подписываться на поле через runtime-config mirror.
+     */
+    supportsWatch?: boolean;
+    /**
+     * Можно ли изменять поле во время исполнения без мутации base-модели.
+     */
+    runtimeMutationPolicy?: ConfigurationMutationPolicy;
+    /**
+     * Необязательная схема для валидации и editor UI.
+     */
+    schema?: FacetedCascadeSchema | null;
+    /**
+     * Необязательное значение по умолчанию для документации/inspectors.
+     */
+    defaultValue?: unknown;
+}

package/dist/domain/types/debug/base.types.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Уровни логирования
+ */
+export type LogLevel = 'trace' | 'debug' | 'info' | 'success' | 'warn' | 'error' | 'fatal';
+/**
+ * Тип записи
+ */
+export type LogKind = 'span_start' | 'span_end' | 'event';
+/**
+ * Корреляция (совместимо с W3C TraceContext по смыслу)
+ */
+export interface Correlation {
+    traceId?: string;
+    spanId?: string;
+    parentSpanId?: string;
+}
+/**
+ * Плоские атрибуты (namespace dotted keys)
+ */
+export type Attrs = Record<string, string | number | boolean | null | undefined>;
+/**
+ * Ссылка на сущность/ресурс
+ */
+export interface EntityRef {
+    type: string;
+    id: string;
+    attrs?: Attrs;
+}
+/**
+ * Базовая запись
+ */
+export interface BaseRecord {
+    ts: number;
+    level: LogLevel;
+    kind: LogKind;
+    /** lane присутствует у спанов/эвентов, но не обязателен у trace-спана */
+    lane?: string;
+    /** человекочитаемое имя спана */
+    name?: string;
+    /** корреляция (trace/span ids) */
+    corr?: Correlation;
+    /** произвольные атрибуты */
+    attrs?: Attrs;
+    /** связанные сущности */
+    entities?: EntityRef[];
+}
+/**
+ * Спан (начало)
+ */
+export interface SpanStart extends BaseRecord {
+    kind: 'span_start';
+    name: string;
+}
+/**
+ * Спан (конец)
+ */
+export interface SpanEnd extends BaseRecord {
+    kind: 'span_end';
+    name: string;
+    durMs: number;
+}
+/**
+ * Точечное событие внутри спана
+ */
+export interface EventRecord extends BaseRecord {
+    kind: 'event';
+    msg: string;
+    data?: unknown;
+    err?: unknown;
+}
+/**
+ * Объединённый тип записи журнала
+ */
+export type LogRecord = SpanStart | SpanEnd | EventRecord;

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

@@ -0,0 +1,3 @@
+export type EndgeDebugEvents = {
+    'endge-debug:new-log': object;
+};

package/dist/domain/types/debug/tree.types.d.ts

@@ -0,0 +1,27 @@
+import { Attrs, Correlation, EntityRef, LogLevel } from './base.types';
+export interface BaseNode {
+    kind: 'span' | 'event';
+    ts: number;
+    level?: LogLevel;
+    lane?: string;
+    name?: string;
+    corr?: Correlation;
+    attrs?: Attrs;
+    entities?: EntityRef[];
+}
+/** Визуальный спан (объединяет start/end) */
+export interface SpanNode extends BaseNode {
+    kind: 'span';
+    name: string;
+    endTs?: number;
+    durMs: number | null;
+    children: LogNode[];
+}
+/** Точечное событие */
+export interface EventNode extends BaseNode {
+    kind: 'event';
+    msg: string;
+    data?: unknown;
+    err?: unknown;
+}
+export type LogNode = SpanNode | EventNode;