@endge/core 1.2.5 → 1.2.7

package/dist/domain/types/document/document-draft.type.d.ts

@@ -0,0 +1,9 @@
+/** Опции создания доменного черновика без регистрации и сохранения. */
+export interface DocumentDraftOptions {
+    /** Стабильный identity для repository и runtime registry. */
+    identity: string;
+    /** Человекочитаемое имя; по умолчанию используется identity. */
+    name?: string;
+    /** Необязательная связь с родительской папкой. */
+    folderId?: string | number | null;
+}

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

@@ -0,0 +1,99 @@
+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 { RPageTemplate } from '../../entities/reflect/RPageTemplate';
+import { RPage } from '../../entities/reflect/RPage';
+import { RNavigation } from '../../entities/reflect/RNavigation';
+import { RQuery } from '../../entities/reflect/RQuery';
+import { RDataView } from '../../entities/reflect/RDataView';
+import { RPolicy } from '../../entities/reflect/RPolicy';
+import { RStyle } from '../../entities/reflect/RStyle';
+import { RTenant } from '../../entities/reflect/RTenant';
+import { RType } from '../../entities/reflect/RType';
+import { RVocabs } from '../../entities/reflect/RVocabs';
+import { RI18nBundle } from '../../entities/reflect/RI18nBundle';
+import { RComponentSFC } from '../../entities/reflect/RComponentSFC';
+import { RAuthProfile } from '../../entities/reflect/RAuthProfile';
+import { RWorkspace } from '../../entities/reflect/RWorkspace';
+import { RComponent } from '../component/component.types';
+import { RComposition } from '../../entities/reflect/RComposition';
+import { RStore } from '../../entities/reflect/RStore';
+import { RMock } from '../../entities/reflect/RMock';
+import { RComputation } from '../../entities/reflect/RComputation';
+/**
+ * Разновидности типов компонентов
+ */
+export declare enum ComponentType {
+    Component = "component",
+    /** Legacy table-column template type; not a standalone document. */
+    Html = "html",
+    DSL = "component-dsl",
+    Table = "component-table",
+    SFC = "component-sfc"
+}
+/** Тип документа «Параметр» (коллекция 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",
+    DataView = "data-view",
+    Composition = "composition",
+    Store = "store",
+    Mock = "mock",
+    Action = "action",
+    /** Frontend-only catalog classification; Event is not a persisted document. */
+    Event = "event",
+    Converter = "converter",
+    Computation = "computation",
+    Integration = "integration",
+    Parameters = "parameters",
+    Filters = "filters",
+    Environment = "environment",
+    Tenant = "tenant",
+    Policy = "policy",
+    Style = "style",
+    PageTemplate = "page-template",
+    Page = "page",
+    Navigation = "navigation",
+    Vocabs = "vocabs",
+    I18nBundles = "i18n-bundles",
+    AuthProfile = "auth-profile",
+    Project = "project"
+}
+/**
+ * Все возможные типы документов
+ */
+export type DomainDocumentType = 'primitive' | 'type' | 'action' | 'converter' | 'computation' | 'data-view' | 'composition' | 'store' | 'mock' | 'integration' | 'page-template' | 'page' | 'navigation' | 'environment' | 'policy' | 'style' | 'vocabs' | 'i18n-bundles' | 'auth-profile' | 'tenant' | 'project' | 'workspace' | Exclude<ComponentType, ComponentType.Component | ComponentType.Html> | QueryType | ParameterType | FilterType;
+/**
+ * Описывает любой документ
+ */
+export interface Document {
+    type: DomainDocumentType;
+    sectionType: DomainSectionType;
+    id: string;
+}
+/**
+ * Описывает любой документ рефлекцию
+ */
+export type RDocument = RComponent | RComponentSFC | RQuery | RDataView | RComposition | RStore | RMock | RAction | RConverter | RComputation | RIntegration | RParameter | RFilter | RPolicy | RStyle | RType | RVocabs | RI18nBundle | RAuthProfile | RWorkspace | RTenant | RPageTemplate | RPage | RNavigation;

package/dist/domain/types/document/domain-export.type.d.ts

@@ -0,0 +1,48 @@
+import { EndgeWorkspaceDefinition, EndgeWorkspaceSSEConfig } from './workspace.types';
+import { DomainDocumentType, DomainSectionType } from './document.types';
+/** Workspace-конфигурация без прямых credential-значений. */
+export type EndgeWorkspaceExport = Omit<EndgeWorkspaceDefinition, 'sse'> & {
+    sse?: Omit<EndgeWorkspaceSSEConfig, 'manualToken'>;
+};
+/** Persisted-срез домена, который можно восстановить через plain provider. */
+export interface EndgeDomainPlain {
+    projects: unknown[];
+    types: unknown[];
+    queries: unknown[];
+    dataViews: unknown[];
+    compositions: unknown[];
+    stores: unknown[];
+    mocks: unknown[];
+    components: unknown[];
+    componentSFCs: unknown[];
+    actions: unknown[];
+    converters: unknown[];
+    computations: unknown[];
+    integrations: unknown[];
+    folders: unknown[];
+    parameters: unknown[];
+    filters: unknown[];
+    environments: unknown[];
+    tenants: unknown[];
+    policies: unknown[];
+    styles: unknown[];
+    vocabs: unknown[];
+    authProfiles: unknown[];
+    i18nBundles: unknown[];
+    pageTemplates: unknown[];
+    pages: unknown[];
+    navigations: unknown[];
+}
+/** Переносимый bundle текущего workspace и его загруженного домена. */
+export interface EndgeDomainBundle {
+    version: string;
+    workspace: EndgeWorkspaceExport;
+    domain: EndgeDomainPlain;
+}
+/** Ссылка на выбранный документ с типом коллекции, в которой локален его id. */
+export interface EndgeDomainSelection {
+    id: string | number;
+    identity?: string;
+    sectionType: DomainSectionType;
+    docType: DomainDocumentType;
+}

package/dist/domain/types/document/entity-management.type.d.ts

@@ -0,0 +1,33 @@
+export type ManagedBy = 'system' | 'integration' | 'user';
+/** Stable domain reference that never depends on a database identifier. */
+export interface EntityRef {
+    type: string;
+    identity: string;
+}
+/**
+ * Provenance of an entity in the effective domain read-model.
+ * Only storage entities participate in persistence and export operations.
+ */
+export type EntityOrigin = {
+    kind: 'storage';
+} | {
+    kind: 'builtin';
+    owner: string;
+} | {
+    kind: 'local';
+    owner: string;
+} | {
+    kind: 'derived';
+    source: EntityRef;
+};
+export declare function isPersistedEntityOrigin(origin: EntityOrigin | null | undefined): boolean;
+export interface EntityManagement {
+    managedBy: ManagedBy;
+    managedById: string | null;
+}
+export type EntityManagementLike = Partial<EntityManagement> | null | undefined;
+export declare function normalizeEntityManagement(value: EntityManagementLike): EntityManagement;
+export declare function isSystemManaged(value: EntityManagementLike): boolean;
+export declare function isIntegrationManaged(value: EntityManagementLike): boolean;
+export declare function isUserManaged(value: EntityManagementLike): boolean;
+export declare function isExternallyManaged(value: EntityManagementLike): boolean;

package/dist/domain/types/{filter.types.d.ts → document/filter.types.d.ts}

@@ -28,6 +28,8 @@ export interface RFilterSchema {
     identity: string;
     displayName: string;
     fields?: FilterFieldItemSchema[];
+    source?: string;
+    sourceVersion?: number;
     folder?: string | null;
     /** Id папки в Payload (для relationship при сохранении). */
     folderId?: number | string | null;
@@ -35,5 +37,4 @@ export interface RFilterSchema {
     active?: boolean;
     deletedAt?: string | null;
     meta?: Record<string, unknown>;
-    inherited?: boolean;
 }

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

@@ -0,0 +1,11 @@
+export * from './codegen.types';
+export * from './document.types';
+export * from './document-create.type';
+export * from './document-draft.type';
+export * from './domain-export.type';
+export * from './entity-management.type';
+export * from './filter.types';
+export * from './navigation.types';
+export * from './query.types';
+export * from './schema.types';
+export * from './workspace.types';

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

@@ -0,0 +1,36 @@
+import { EntityManagement } from './entity-management.type';
+interface NavigationTreeNodeBaseDoc {
+    id?: string | null;
+    title: string;
+    icon?: string | null;
+    hidden?: boolean;
+    disabled?: boolean;
+    collapsedTitle?: string | null;
+    path?: string | null;
+    routeName?: string | null;
+    external?: boolean;
+}
+export interface NavigationSectionNodeDoc extends NavigationTreeNodeBaseDoc {
+    type: 'section';
+    children?: NavigationTreeNodeDoc[];
+}
+export interface NavigationGroupNodeDoc extends NavigationTreeNodeBaseDoc {
+    type: 'group';
+    children?: NavigationTreeNodeDoc[];
+}
+export interface NavigationLinkNodeDoc extends NavigationTreeNodeBaseDoc {
+    type: 'link';
+}
+/** Узел полного дерева навигации. */
+export type NavigationTreeNodeDoc = NavigationSectionNodeDoc | NavigationGroupNodeDoc | NavigationLinkNodeDoc;
+/** Документ навигации из Payload. */
+export interface NavigationDoc extends EntityManagement {
+    id: number | string;
+    identity: string;
+    displayName: string;
+    description?: string | null;
+    folder?: number | string;
+    tree?: NavigationTreeNodeDoc[];
+    meta?: Record<string, unknown>;
+}
+export {};

package/dist/domain/types/{query.types.d.ts → document/query.types.d.ts}

@@ -1,6 +1,10 @@
-export type RQueryAuthMode = 'none' | 'token';
+export type RQueryAuthMode = 'none' | 'token' | 'inherit' | 'profile' | 'manual';
 export interface RQueryAuth {
     mode: RQueryAuthMode;
+    /** Identity auth-profile для source DSL. */
+    profile?: string;
+    /** @deprecated use profile. Kept for persisted/legacy compatibility. */
+    authProfileIdentity?: string;
     /**
      * Необязательный ручной токен. Если НЕ задан, будет взят из Endge.auth.
      * Пример: "eyJhbGciOi..."
@@ -58,6 +62,7 @@ export interface RParameterSchema {
     author?: string;
     active: boolean;
     deletedAt?: string | null;
+    meta: Record<string, unknown>;
 }
 export declare class RuntimeFilterLinkEntity {
     identity: string;

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

@@ -0,0 +1,102 @@
+import { Projects_Repository } from '../../../model/db/repositories/Projects_Repository';
+import { Types_Repository } from '../../../model/db/repositories/Types_Repository';
+import { Queries_Repository } from '../../../model/db/repositories/Queries_Repository';
+import { DataViews_Repository } from '../../../model/db/repositories/DataViews_Repository';
+import { Folders_Repository } from '../../../model/db/repositories/Folders_Repository';
+import { Components_Repository } from '../../../model/db/repositories/Components_Repository';
+import { ComponentSFCs_Repository } from '../../../model/db/repositories/ComponentSFCs_Repository';
+import { Actions_Repository } from '../../../model/db/repositories/Actions_Repository';
+import { Vocabs_Repository } from '../../../model/db/repositories/Vocabs_Repository';
+import { I18nBundles_Repository } from '../../../model/db/repositories/I18nBundles_Repository';
+import { AuthProfiles_Repository } from '../../../model/db/repositories/AuthProfiles_Repository';
+import { Parameters_Repository } from '../../../model/db/repositories/Parameters_Repository';
+import { Filters_Repository } from '../../../model/db/repositories/Filters_Repository';
+import { Converters_Repository } from '../../../model/db/repositories/Converters_Repository';
+import { Integrations_Repository } from '../../../model/db/repositories/Integrations_Repository';
+import { Versions_Repository } from '../../../model/db/repositories/Versions_Repository';
+import { PageTemplates_Repository } from '../../../model/db/repositories/PageTemplates_Repository';
+import { Pages_Repository } from '../../../model/db/repositories/Pages_Repository';
+import { Navigations_Repository } from '../../../model/db/repositories/Navigations_Repository';
+import { Environments_Repository } from '../../../model/db/repositories/Environments_Repository';
+import { Policies_Repository } from '../../../model/db/repositories/Policies_Repository';
+import { Styles_Repository } from '../../../model/db/repositories/Styles_Repository';
+import { Tenants_Repository } from '../../../model/db/repositories/Tenants_Repository';
+import { Workspaces_Repository } from '../../../model/db/repositories/Workspaces_Repository';
+import { Compositions_Repository } from '../../../model/db/repositories/Compositions_Repository';
+import { Stores_Repository } from '../../../model/db/repositories/Stores_Repository';
+import { Mocks_Repository } from '../../../model/db/repositories/Mocks_Repository';
+import { Computations_Repository } from '../../../model/db/repositories/Computations_Repository';
+export interface EndgeSchemaDump {
+    workspaces?: any[];
+    workspace?: any;
+    projects: any[];
+    types: any[];
+    queries: any[];
+    dataViews: any[];
+    compositions: any[];
+    stores: any[];
+    mocks: any[];
+    folders: any[];
+    components: any[];
+    componentSFCs: any[];
+    actions: any[];
+    converters: any[];
+    computations: any[];
+    integrations: any[];
+    vocabs: any[];
+    i18nBundles: any[];
+    authProfiles: any[];
+    parameters: any[];
+    filters: any[];
+    versions: any[];
+    environments: any[];
+    tenants: any[];
+    policies: any[];
+    styles: any[];
+    pageTemplates: any[];
+    pages: any[];
+    navigations: any[];
+}
+export type EndgeSchemaErrorKind = 'PAYLOAD_NOT_CONFIGURED' | 'PAYLOAD_PING_FAILED' | 'COLLECTION_UNREACHABLE';
+export interface EndgeSchemaError {
+    kind: EndgeSchemaErrorKind;
+    message: string;
+    collection?: string;
+    details?: any;
+    at: string;
+}
+export type RepositoriesBag = {
+    workspaces?: Workspaces_Repository;
+    projects: Projects_Repository;
+    types: Types_Repository;
+    queries: Queries_Repository;
+    dataViews: DataViews_Repository;
+    compositions: Compositions_Repository;
+    stores: Stores_Repository;
+    mocks: Mocks_Repository;
+    folders: Folders_Repository;
+    components: Components_Repository;
+    componentSFCs: ComponentSFCs_Repository;
+    actions: Actions_Repository;
+    vocabs: Vocabs_Repository;
+    i18nBundles: I18nBundles_Repository;
+    authProfiles: AuthProfiles_Repository;
+    parameters: Parameters_Repository;
+    filters: Filters_Repository;
+    converters: Converters_Repository;
+    computations: Computations_Repository;
+    integrations: Integrations_Repository;
+    versions: Versions_Repository;
+    environments: Environments_Repository;
+    tenants: Tenants_Repository;
+    policies: Policies_Repository;
+    styles: Styles_Repository;
+    pageTemplates: PageTemplates_Repository;
+    pages: Pages_Repository;
+    navigations: Navigations_Repository;
+};
+export interface EndgeSchemaStorageOptions {
+    payloadBaseAPI: string;
+    payloadSecret: string;
+    collectionsToCheck?: string[];
+}

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

@@ -0,0 +1,23 @@
+import { EndgeConfiguration, EndgeLocaleDefinition, EndgeSSEAuthMode, EndgeSSEConfiguration, EndgeThemeDefinition, EndgeVariableDefinition } from '../configuration';
+import { EntityManagement } from './entity-management.type';
+export type EndgeWorkspaceLocale = EndgeLocaleDefinition;
+export type EndgeDataMode = 'live' | 'mock';
+export type EndgeWorkspaceLocaleLabelMode = keyof Pick<EndgeWorkspaceLocale, 'displayName' | 'shortLabel'>;
+export type EndgeWorkspaceTheme = EndgeThemeDefinition;
+export type EndgeWorkspaceSSEAuthMode = EndgeSSEAuthMode;
+export type EndgeWorkspaceVar = EndgeVariableDefinition;
+export type EndgeWorkspaceSSEConfig = EndgeSSEConfiguration;
+export interface WorkspaceIntegrationReference {
+    integrationId: string | number;
+    integrationIdentity: string;
+    version: string;
+}
+export interface EndgeWorkspaceDefinition extends EntityManagement {
+    identity: string;
+    displayName: string;
+    dataMode: EndgeDataMode;
+    meta?: Record<string, unknown>;
+    installedIntegrations: WorkspaceIntegrationReference[];
+    configuration: EndgeConfiguration;
+}
+export type EndgeWorkspaceDefinitionInput = Partial<EndgeWorkspaceDefinition> & Record<string, unknown>;

package/dist/domain/types/{action.types.d.ts → flow/action.types.d.ts}

@@ -1,4 +1,4 @@
-import { ActionRuntimeHostContext } from './runtime-host.types';
+import { ActionRuntimeHostContext } from '../runtime/runtime-host.types';
 import { FlowExecutionState } from './endge-flow-runtime.types';
 import { ActionFlowDefinition } from './endge-flow.types';
 /**

package/dist/domain/types/{endge-flow.types.d.ts → flow/endge-flow.types.d.ts}

@@ -2,7 +2,7 @@
  * Канонический тип шага внутри action-flow.
  * Описывает поведение шага на уровне UX/runtime, а не форму graph-node.
  */
-export type ActionFlowStepKind = 'builtin' | 'behavior-binding' | 'runtime' | 'flow-ref';
+export type ActionFlowStepKind = 'builtin' | 'action' | 'runtime' | 'flow-ref';
 /**
  * Тип graph-node внутри action-flow.
  * Определяет, какой блок должен быть исполнен рантаймом flow.

package/dist/domain/types/flow/index.d.ts

@@ -0,0 +1,4 @@
+export * from './action.types';
+export * from './endge-flow.types';
+export * from './endge-flow-runtime.types';
+export * from './flow-condition.types';

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

@@ -0,0 +1,23 @@
+export type I18nLocaleMessages = Record<string, unknown>;
+export type I18nLocales = Record<string, I18nLocaleMessages>;
+/** Плоский compiler-derived индекс сообщений одной локали. */
+export type I18nCompiledLocaleMessages = Record<string, string>;
+/** Compiler-derived сообщения одного i18n-документа по локалям. */
+export type I18nCompiledLocales = Record<string, I18nCompiledLocaleMessages>;
+/** Один публичный translation alias в runtime-контексте Composition. */
+export interface I18nRuntimeCatalogEntry {
+    messages: I18nCompiledLocales;
+}
+/** Накопленный translation catalog, доступный дочернему runtime. */
+export type I18nRuntimeCatalog = Record<string, I18nRuntimeCatalogEntry>;
+export interface I18nTranslateOptions {
+    locale?: string;
+    fallbackLocale?: string;
+    bundle?: string;
+    params?: Record<string, unknown>;
+    defaultValue?: string;
+}
+export interface I18nMessagesOptions {
+    bundle?: string;
+    includeInactive?: boolean;
+}

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

@@ -0,0 +1,48 @@
+import { EndgeExecutionContext } from '../configuration';
+/**
+ * Источник получения доменных данных
+ * default - работа с внешним сервисом backend
+ * payload - @Deprecated внешний сервис на payload
+ * plain - данные подтягиваются из файла
+ */
+export type EndgeDataProvider = 'default' | 'payload' | 'plain';
+/**
+ * Конфигурация загрузки движка
+ * Определяет workspace, данные которого должны быть активированы из Payload.
+ * Tenant, project и environment передаются отдельно через EndgeBootContext.context.
+ */
+export interface EndgeLoadScope {
+    workspaceIdentity?: string;
+}
+export interface EndgePayloadProviderOptions {
+    baseAPI: string;
+    secret: string;
+}
+export interface EndgeBootContext {
+    /**
+     * Источник получения доменных данных
+     */
+    dataProvider: EndgeDataProvider;
+    /**
+     * Граница загружаемых данных.
+     */
+    scope: EndgeLoadScope;
+    /** Structural context immutable for one complete boot/build lifecycle. */
+    context?: Partial<EndgeExecutionContext>;
+    /**
+     * Runtime/env vars, которые нужны ядру.
+     */
+    vars: Record<string, unknown>;
+    /**
+     * Для plain provider.
+     */
+    plainSource?: unknown;
+    /**
+     * Для payload provider.
+     */
+    payload?: EndgePayloadProviderOptions;
+    /**
+     * Для отмены долгой загрузки/сборки.
+     */
+    signal?: AbortSignal;
+}

package/dist/domain/types/kernel/endge-modules.types.d.ts

@@ -0,0 +1,18 @@
+import { EndgeModule } from '../../entities/endge/EndgeModule';
+export type EndgeModuleConstructor<T extends EndgeModule = EndgeModule> = new () => T;
+export interface EndgeModuleDefinition<T extends EndgeModule = EndgeModule> {
+    key: string;
+    module: EndgeModuleConstructor<T>;
+    before?: string | string[];
+    after?: string | string[];
+}
+export interface EndgeModuleDescriptor<T extends EndgeModule = EndgeModule> {
+    key: string;
+    module: T;
+    before?: string | string[];
+    after?: string | string[];
+}
+export interface EndgePlugin {
+    id: string;
+    install(): void;
+}

package/dist/domain/types/kernel/federation.types.d.ts

@@ -0,0 +1,15 @@
+import { EndgeModule } from '../../entities/endge/EndgeModule';
+import { EndgeModuleDescriptor, EndgePlugin } from './endge-modules.types';
+import { EndgeBootContext } from './bootstrap.types';
+export interface EndgeFederationHost {
+    isConfigured: boolean;
+    isConfiguring: boolean;
+    isSetup: boolean;
+    isInitialized: boolean;
+    isHydrating: boolean;
+    bootContext: EndgeBootContext | null;
+    moduleDescriptors: EndgeModuleDescriptor[];
+    modules: Map<string, EndgeModule>;
+    plugins: EndgePlugin[];
+    installedPluginIds: Set<string>;
+}

package/dist/domain/types/kernel/index.d.ts

@@ -0,0 +1,4 @@
+export * from './bootstrap.types';
+export * from './endge-modules.types';
+export * from './events.types';
+export * from './federation.types';

package/dist/domain/types/mock/index.d.ts

@@ -0,0 +1 @@
+export * from './mock-data.type';

package/dist/domain/types/mock/mock-data.type.d.ts

@@ -0,0 +1,37 @@
+import { RMock } from '../../entities/reflect/RMock';
+export type RMockContentSource = 'document' | 'code-provider';
+export type RMockContentType = 'application/json' | 'text/plain';
+/** Контекст вызова code provider для persisted mock-документа. */
+export interface EndgeMockProviderContext {
+    mock: RMock;
+}
+/** Кодовая реализация содержимого, подключаемая к persisted mock по codeRef. */
+export interface EndgeMockProvider {
+    ref: string;
+    description?: string;
+    provide: (context: EndgeMockProviderContext) => unknown;
+}
+/** @deprecated Используйте EndgeMockProvider. */
+export interface EndgeMockRegistration {
+    /** Стабильный identity, используемый в source через mock(identity). */
+    identity: string;
+    /** Исходный mock payload. EndgeMock хранит и возвращает независимые копии. */
+    data: unknown;
+    /** Необязательное описание сценария для diagnostics и configurator UI. */
+    description?: string;
+}
+/** Публичное описание зарегистрированного mock payload без самих данных. */
+export interface EndgeMockDescriptor {
+    ref: string;
+    description?: string;
+}
+export type EndgeMockBindingStatus = 'document' | 'connected' | 'missing-document' | 'missing-provider' | 'invalid-content';
+/** Сериализуемый snapshot модуля EndgeMock. */
+export interface EndgeMockSnapshot {
+    providers: EndgeMockDescriptor[];
+}
+/** Compiler/runtime reference на mock payload. */
+export interface EndgeMockReference {
+    kind: 'mock';
+    identity: string;
+}

package/dist/domain/types/program/index.d.ts

@@ -0,0 +1,2 @@
+export * from './program.types';
+export * from './program-metadata.types';

package/dist/domain/types/program/program-metadata.types.d.ts

@@ -0,0 +1,26 @@
+/** JSON-совместимое значение публичной metadata compiled artifact. */
+export type ProgramMetadataValue = null | boolean | number | string | ProgramMetadataValue[] | {
+    [key: string]: ProgramMetadataValue;
+};
+/** Metadata сущности, сгруппированная по пользовательскому namespace. */
+export type ProgramMetadataMap = Record<string, ProgramMetadataValue>;
+/** Metadata внутреннего source/IR-узла с сохранением provenance. */
+export interface ProgramNodeMetadata {
+    /** Стабильный id узла внутри compiled artifact. */
+    nodeId: string;
+    /** Семантический тип узла, например `Column` или `Text`. */
+    nodeKind: string;
+    /** Пользовательский key узла, если он объявлен в source. */
+    key?: string;
+    /** Metadata узла по namespace. */
+    values: ProgramMetadataMap;
+}
+/** Общий metadata-контракт любого compiled artifact. */
+export interface ProgramMetadata {
+    /** Metadata самой доменной сущности. */
+    self: ProgramMetadataMap;
+    /** Metadata внутренних source/IR-узлов. */
+    nodes: ProgramNodeMetadata[];
+}
+/** Создаёт пустой предсказуемый metadata-контракт artifact. */
+export declare function createEmptyProgramMetadata(): ProgramMetadata;