@endge/core 1.2.8 → 1.2.9

package/dist/domain/entities/reflect/RComputation.d.ts

@@ -1,6 +1,5 @@
 import { DuplicateOptions, REntity } from './REntity';
 import { DiagnosticsProblemInput } from '../../types/diagnostics';
-import { RField } from './RField';
 /** Persisted executable specification. Runtime execution is provided separately. */
 export declare class RComputation extends REntity {
     displayName: string;
@@ -8,8 +7,6 @@ export declare class RComputation extends REntity {
     source: string;
     sourceVersion: number;
     contractVersion: number;
-    input: RField | null;
-    output: RField | null;
     static fromPayload(json: any): RComputation;
     static fromPlain(json: any, storageMeta?: any): RComputation;
     toPlain(): Record<string, unknown>;

package/dist/domain/entities/reflect/RStream.d.ts

@@ -0,0 +1,8 @@
+import { DuplicateOptions, REntity } from './REntity';
+/** Persisted source-first definition of a normalized event stream. */
+export declare class RStream extends REntity {
+    readonly type: "stream";
+    source: string;
+    sourceVersion: number;
+    duplicate(options: DuplicateOptions): RStream;
+}

package/dist/domain/entities/reflect/RType.d.ts

@@ -1,20 +1,13 @@
-import { RField } from './RField';
 import { REntity } from './REntity';
 /**
- * Класс рефлексии для хранения информации о типе.
- * Содержит название и список полей.
+ * Source-first доменная сущность типа.
  */
 export declare class RType extends REntity {
     get id(): string;
     name: string;
     isPrimitive: boolean;
-    /** Независимый Type Source. Legacy fields не генерируются из него автоматически. */
+    /** Каноническое структурное определение типа. */
     source: string;
     sourceVersion: number;
-    fields: Map<string, RField>;
     constructor(name: string);
-    addField(field: RField): void;
-    getField(fieldName: string | number): RField | null;
-    hasField(fieldName: string | number): boolean;
-    getFields(): string[];
 }

package/dist/domain/entities/reflect/RUpdate.d.ts

@@ -0,0 +1,10 @@
+import { DuplicateOptions, REntity } from './REntity';
+/** Persisted source-first Store-owned mutation definition. */
+export declare class RUpdate extends REntity {
+    readonly type: "update";
+    /** Stable identity of the only Store that may execute this Update. */
+    storeIdentity: string;
+    source: string;
+    sourceVersion: number;
+    duplicate(options: DuplicateOptions): RUpdate;
+}

package/dist/domain/entities/runtime/hosts/CompositionRuntimeHost.d.ts

@@ -1,5 +1,6 @@
 import { RComposition } from '../../reflect/RComposition';
 import { FilterViewRuntimeHost } from './FilterViewRuntimeHost';
+import { StoreMutationPlan } from '../../../types/source/update-source.types';
 import { CompositionFilterFieldsSlice, CompositionProgramPayload, CompositionPublicOutputHandle, CompositionRuntimeActivationHandle, CompositionRuntimeChildHandle } from '../../../types/source/composition-source.types';
 import { RuntimeArtifactReader, RuntimeHost, RuntimeHostContext, RuntimeHostInputSource, RuntimeHostUpdateContext } from '../../../types/runtime/runtime-host.types';
 import { I18nRuntimeCatalog } from '../../../types/i18n.types';
@@ -29,6 +30,8 @@ export declare class CompositionRuntimeHost extends RuntimeHostBase<'composition
     private _vocabCatalogs;
     private _orchestratedQueries;
     private _orchestratedSuccesses;
+    private _streamBatches;
+    private _streamBatchTimers;
     private _mounted;
     constructor(input: {
         id: string;
@@ -62,6 +65,10 @@ export declare class CompositionRuntimeHost extends RuntimeHostBase<'composition
     getDataSnapshot(): Readonly<Record<string, unknown>>;
     /** Возвращает текущие значения публичных Composition props. */
     getProps(): Readonly<Record<string, unknown>>;
+    /** Imperative local mutation for UI flows that do not need a persisted RUpdate. */
+    mutateStore(dataAlias: string, plan: StoreMutationPlan): void;
+    /** Explicitly invokes one named Store-owned RUpdate outside Stream dispatch. */
+    applyStoreUpdate(dataAlias: string, updateIdentity: string, payload: unknown): void;
     /** Устанавливает literal/Raph-backed источник публичных Composition props. */
     setInputSource(input: RuntimeHostInputSource | null | undefined): void;
     /** Проверяет обязательные props до создания child runtime graph. */
@@ -94,9 +101,12 @@ export declare class CompositionRuntimeHost extends RuntimeHostBase<'composition
     private _publishUpdates;
     protected onUpdate(ctx: RuntimeHostUpdateContext): void;
     private _requireDataPath;
+    private _requireStoreRuntime;
     private _resolveDataReference;
     private _createChild;
     private _bindChild;
+    private _bindStreamDispatch;
+    private _flushStreamBatch;
     private _makeOutputs;
     /** Не допускает прямые и транзитивные циклы Composition runtime tree. */
     private _assertCompositionCycle;

package/dist/domain/entities/runtime/hosts/StoreRuntimeHost.d.ts

@@ -1,6 +1,8 @@
 import { RStore } from '../../reflect/RStore';
 import { RuntimeArtifactReader, RuntimeHost, RuntimeHostContext } from '../../../types/runtime/runtime-host.types';
 import { StoreDataDescriptor, StoreSourceArtifact } from '../../../types/source/store-source.types';
+import { StoreMutationPlan } from '../../../types/source/update-source.types';
+import { StreamEventEnvelope } from '../../../types/source/stream-source.types';
 import { RuntimeHostBase } from '../RuntimeHostBase';
 /** Runtime-владелец writable Store state и реактивных DataView projections. */
 export declare class StoreRuntimeHost extends RuntimeHostBase<'store', RuntimeHostContext<'store'>, StoreSourceArtifact> {
@@ -31,8 +33,22 @@ export declare class StoreRuntimeHost extends RuntimeHostBase<'store', RuntimeHo
     isWritable(path: string): boolean;
     /** Записывает значение в writable Store field и запускает derived graph через Raph. */
     set(path: string, value: unknown): void;
+    /**
+     * Маршрутизирует нормализованное событие по compile-time таблице Store.
+     * Возвращает false, если Store не объявляет Update для данного типа.
+     */
+    dispatch(event: StreamEventEnvelope): boolean;
+    /** Применяет именованный дочерний Update к Store без привязки к транспорту. */
+    applyUpdate(updateIdentity: string, payload: unknown): void;
+    /**
+     * Применяет inline mutation из Composition/UI.
+     * Это escape hatch для локальных изменений, которым не нужен persisted RUpdate.
+     */
+    applyMutation(plan: StoreMutationPlan): void;
     /** Освобождает derived registrations до удаления Store state. */
     destroy(): void;
     /** Инициализирует writable fields и затем immediate derived graph. */
     private _mount;
+    private _makeMutationPlans;
+    private _applyMutationPlan;
 }

package/dist/domain/entities/runtime/hosts/StreamRuntimeHost.d.ts

@@ -0,0 +1,30 @@
+import { RStream } from '../../reflect/RStream';
+import { RuntimeArtifactReader, RuntimeHost, RuntimeHostContext } from '../../../types/runtime/runtime-host.types';
+import { StreamTransportFactory } from '../../../types/runtime/stream-runtime.types';
+import { StreamSourceArtifact } from '../../../types/source/stream-source.types';
+import { RuntimeHostBase } from '../RuntimeHostBase';
+/** Runtime lifecycle owner for one compiled Stream transport. */
+export declare class StreamRuntimeHost extends RuntimeHostBase<'stream', RuntimeHostContext<'stream'>, StreamSourceArtifact> {
+    private _connection;
+    constructor(input: {
+        id: string;
+        model: RStream;
+        parent?: RuntimeHost<any, any> | null;
+        meta?: Record<string, unknown>;
+        artifactReader: RuntimeArtifactReader;
+        privateTransportFactory: StreamTransportFactory;
+    });
+    private readonly _transportFactory;
+    static createRuntime(input: {
+        id: string;
+        model: RStream;
+        meta?: Record<string, any>;
+        parent?: RuntimeHost<any, any> | null;
+        artifacts: RuntimeArtifactReader;
+        transportFactory: StreamTransportFactory;
+    }): StreamRuntimeHost | null;
+    start(): void;
+    stop(): void;
+    destroy(): void;
+    private _receive;
+}

package/dist/domain/types/computation/computation-source.types.d.ts

@@ -1,4 +1,5 @@
 import { SourceExpressionIR } from '../source/source-expression.types';
+import { ComputationContractField } from './computation-program.types';
 export interface ComputationSourceRange {
     start: number;
     end: number;
@@ -23,6 +24,8 @@ export type ComputationSourceNode = {
 };
 /** Canonical compiler-derived representation of defineComputation source. */
 export interface ComputationSourceDocument {
+    input: ComputationContractField | null;
+    output: ComputationContractField | null;
     outputs: ComputationSourceNode[];
     result: SourceExpressionIR;
 }

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

@@ -20,6 +20,8 @@ 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 { RStream } from '../../entities/reflect/RStream';
+import { RUpdate } from '../../entities/reflect/RUpdate';
 import { RMock } from '../../entities/reflect/RMock';
 import { RComputation } from '../../entities/reflect/RComputation';
 /**
@@ -84,7 +86,7 @@ export declare enum DomainSectionType {
 /**
  * Все возможные типы документов
  */
-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 type DomainDocumentType = 'primitive' | 'type' | 'action' | 'converter' | 'computation' | 'data-view' | 'composition' | 'store' | 'stream' | 'update' | '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;
 /**
  * Описывает любой документ
  */
@@ -96,4 +98,4 @@ export interface Document {
 /**
  * Описывает любой документ рефлекцию
  */
-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;
+export type RDocument = RComponent | RComponentSFC | RQuery | RDataView | RComposition | RStore | RStream | RUpdate | 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

@@ -12,6 +12,8 @@ export interface EndgeDomainPlain {
     dataViews: unknown[];
     compositions: unknown[];
     stores: unknown[];
+    streams: unknown[];
+    updates: unknown[];
     mocks: unknown[];
     components: unknown[];
     componentSFCs: unknown[];

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

@@ -24,6 +24,8 @@ import { Tenants_Repository } from '../../../model/db/repositories/Tenants_Repos
 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 { Streams_Repository } from '../../../model/db/repositories/Streams_Repository';
+import { Updates_Repository } from '../../../model/db/repositories/Updates_Repository';
 import { Mocks_Repository } from '../../../model/db/repositories/Mocks_Repository';
 import { Computations_Repository } from '../../../model/db/repositories/Computations_Repository';
 export interface EndgeSchemaDump {
@@ -35,6 +37,8 @@ export interface EndgeSchemaDump {
     dataViews: any[];
     compositions: any[];
     stores: any[];
+    streams: any[];
+    updates: any[];
     mocks: any[];
     folders: any[];
     components: any[];
@@ -73,6 +77,8 @@ export type RepositoriesBag = {
     dataViews: DataViews_Repository;
     compositions: Compositions_Repository;
     stores: Stores_Repository;
+    streams: Streams_Repository;
+    updates: Updates_Repository;
     mocks: Mocks_Repository;
     folders: Folders_Repository;
     components: Components_Repository;

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

@@ -2,13 +2,13 @@ import { ActionCompiledFlow } from '../flow/action.types';
 import { RComponentContract, RComponentDependencies } from '../component/component-core.types';
 import { DataViewManualTransform, DataViewPipelineStep, DataViewRef, DataViewSourceDocument } from '../source/data-view-source.types';
 import { RComponentSFC_AST, RComponentSFC_IR, RComponentSFC_RuntimeDependencies, RComponentSFCSource_Parts } from '../component/sfc';
-import { QueryProgramProp, SourceExpressionIR } from '../source/source-expression.types';
+import { QueryProgramProp, SourceExpressionIR, SourceFieldDefinition } from '../source/source-expression.types';
 import { ProgramMetadata } from './program-metadata.types';
 import { ComputationProgramPayload } from '../computation';
 import { EndgeStyleSheetArtifact } from '../style';
 import { ActionImplementation, ActionTargetSelector } from '../runtime/action.types';
 /** Тип доменной сущности, для которой compiler может построить program artifact. */
-export type ProgramEntityType = 'type' | 'component-sfc' | 'computation' | 'action' | 'query' | 'data-view' | 'store' | 'filter' | 'composition' | 'style';
+export type ProgramEntityType = 'type' | 'component-sfc' | 'computation' | 'action' | 'query' | 'data-view' | 'store' | 'stream' | 'update' | 'filter' | 'composition' | 'style';
 /** Итоговый статус artifact после компиляции и валидации. */
 export type ProgramArtifactStatus = 'valid' | 'warning' | 'error';
 /** Возможность, которую artifact предоставляет runtime/render слоям. */
@@ -106,6 +106,7 @@ export interface QueryProgramOutput {
     key: string;
     source: QueryProgramOutputSource;
     dataViews: DataViewRef[];
+    contract?: SourceFieldDefinition | null;
     materialization: {
         kind: 'source';
     } | {
@@ -160,6 +161,8 @@ export interface DataViewProgramPayload {
     materializationStrategy: import('../source/data-view-source.types').DataViewMaterializationStrategy;
     /** Canonical source document для debug/preview UI. */
     sourceDocument: DataViewSourceDocument | null;
+    /** Декларативный входной и выходной тип DataView. */
+    contract?: DataViewSourceDocument['contract'];
     /** Compiled manual transform. Используется только в mode=manual. */
     transform: DataViewManualTransform | null;
     /** Compiled pipeline steps. Используется только в mode=pipeline. */

package/dist/domain/types/runtime/runtime-entity-map.types.d.ts

@@ -6,6 +6,7 @@ import { RQuery } from '../../entities/reflect/RQuery';
 import { RFilter } from '../../entities/reflect/RFilter';
 import { RComposition } from '../../entities/reflect/RComposition';
 import { RStore } from '../../entities/reflect/RStore';
+import { RStream } from '../../entities/reflect/RStream';
 /**
  * Канонический перечень сущностей, для которых может существовать runtime-host.
  */
@@ -24,6 +25,8 @@ export interface RuntimeEntityModelMap {
     composition: RComposition;
     /** Source-first reactive Store runtime. */
     store: RStore;
+    /** External or emulated normalized event stream. */
+    stream: RStream;
     /** Доменная модель action. */
     action: RAction;
 }

package/dist/domain/types/runtime/runtime-host.types.d.ts

@@ -68,6 +68,10 @@ export interface StoreRuntimeHostContext extends RuntimeHostContextBase {
     writableFields: string[];
     derivedFields: string[];
 }
+export interface StreamRuntimeHostContext extends RuntimeHostContextBase {
+    lastEventAt: string | null;
+    receivedCount: number;
+}
 export interface ComponentSFCRuntimeHostContext extends RuntimeHostContextBase {
     /** Target последней подготовки SFC. */
     target: 'dom' | 'canvas' | null;
@@ -90,6 +94,7 @@ export interface RuntimeHostContextMap {
     filter: FilterRuntimeHostContext;
     composition: CompositionRuntimeHostContext;
     store: StoreRuntimeHostContext;
+    stream: StreamRuntimeHostContext;
     'component-sfc': ComponentSFCRuntimeHostContext;
     page: PageRuntimeHostContext;
     project: ProjectRuntimeHostContext;

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

@@ -1,6 +1,7 @@
 import { RFilter } from '../../entities/reflect/RFilter';
 import { RComposition } from '../../entities/reflect/RComposition';
 import { RStore } from '../../entities/reflect/RStore';
+import { RStream } from '../../entities/reflect/RStream';
 import { RAction } from '../../entities/reflect/RAction';
 import { RComponentSFC } from '../../entities/reflect/RComponentSFC';
 import { RPage } from '../../entities/reflect/RPage';
@@ -10,8 +11,8 @@ import { RuntimeHostRegistrySnapshot } from './runtime-registry.types';
 /**
  * Runtime kinds
  */
-export type RuntimeKind = 'query' | 'filter' | 'composition' | 'store' | 'action' | 'runtime';
-export type RuntimeExecutableModel = RQuery | RAction | RProject | RPage | RComponentSFC | RFilter | RComposition | RStore;
+export type RuntimeKind = 'query' | 'filter' | 'composition' | 'store' | 'stream' | 'action' | 'runtime';
+export type RuntimeExecutableModel = RQuery | RAction | RProject | RPage | RComponentSFC | RFilter | RComposition | RStore | RStream;
 export interface EndgeRuntimeSnapshot extends RuntimeHostRegistrySnapshot {
     generatedAt: number;
     scopes: import('./runtime-scope.types').RuntimeScopeSnapshot[];

package/dist/domain/types/runtime/stream-runtime.types.d.ts

@@ -0,0 +1,17 @@
+import { StreamSourceArtifact } from '../source/stream-source.types';
+export interface StreamTransportMessage {
+    sourceEvent: string;
+    id: string | null;
+    data: unknown;
+}
+export interface StreamTransportConnection {
+    close: () => void;
+}
+/** Browser-neutral port used by StreamRuntimeHost. */
+export interface StreamTransportFactory {
+    open: (artifact: StreamSourceArtifact, callbacks: {
+        message: (message: StreamTransportMessage) => void;
+        error: (error: unknown) => void;
+        open: () => void;
+    }) => StreamTransportConnection;
+}

package/dist/domain/types/source/composition-source.types.d.ts

@@ -8,7 +8,7 @@ import { SourceExpressionIR, SourceFieldDefinition } from './source-expression.t
 import { FilterViewControlDefinition } from '../ui/filter-view.type';
 import { EndgeMockReference } from '../mock';
 import { I18nCompiledLocales } from '../i18n.types';
-export type CompositionRuntimeKind = 'filter' | 'query' | 'component' | 'composition' | 'filter-view';
+export type CompositionRuntimeKind = 'filter' | 'query' | 'component' | 'composition' | 'stream' | 'filter-view';
 export type CompositionActivationMode = 'startup' | 'manual';
 export interface CompositionActivationDescriptor {
     mode: CompositionActivationMode;
@@ -136,6 +136,13 @@ export interface CompositionRuntimeDescriptor {
     /** Локальный data alias child -> data alias owner Composition. */
     dataBindings?: Record<string, string>;
     storeTo: CompositionStorePublication[];
+    /** Store data aliases receiving normalized Stream events. */
+    dispatchTo?: string[];
+    /** Optional Composition-owned event batching policy. */
+    batch?: {
+        maxItems: number;
+        maxWaitMs: number;
+    };
 }
 export interface CompositionRuntimeChildHandle {
     name: string;

package/dist/domain/types/source/data-view-source.types.d.ts

@@ -1,6 +1,6 @@
 import { ProgramDiagnostic } from '../program/program.types';
 import { ProgramMetadataMap } from '../program/program-metadata.types';
-import { SourceExpressionIR } from './source-expression.types';
+import { SourceExpressionIR, SourceFieldDefinition } from './source-expression.types';
 export type DataViewSourceMode = 'manual' | 'pipeline' | 'projection' | 'expression';
 export type DataViewIncrementalRequest = {
     mode: 'auto';
@@ -16,9 +16,14 @@ export type DataViewMaterializationStrategy = {
     kind: 'collection-by-key';
     key: string;
 };
+export interface DataViewSourceContract {
+    input: SourceFieldDefinition;
+    output: SourceFieldDefinition;
+}
 export interface DataViewSourceDocument {
     mode: DataViewSourceMode;
     incremental: DataViewIncrementalRequest;
+    contract?: DataViewSourceContract | null;
     transform?: DataViewManualTransform;
     steps?: DataViewPipelineStep[];
     output?: Record<string, SourceExpressionIR>;

package/dist/domain/types/source/filter-source.types.d.ts

@@ -6,6 +6,53 @@ export interface FilterSourceDocument {
     fields: SourceFieldDefinition[];
     outputs: FilterProgramOutput[];
 }
+/** Абсолютный диапазон узла внутри Filter source. */
+export interface FilterSourceRange {
+    start: number;
+    end: number;
+}
+/** Source-backed поле для визуального редактора Filter. */
+export interface FilterSourceEditorField extends SourceFieldDefinition {
+    sourceRange: FilterSourceRange;
+    keyRange: FilterSourceRange;
+    valueRange: FilterSourceRange;
+    valueSource: string;
+    defaultSource: string | null;
+}
+/** Source-backed output для навигации из визуального редактора. */
+export interface FilterSourceEditorOutput {
+    key: string;
+    kind: FilterProgramOutput['kind'];
+    sourceRange: FilterSourceRange;
+    source: string;
+}
+/** Проекция Filter source, которая не хранится отдельно от source. */
+export interface FilterSourceEditorDocument {
+    fields: FilterSourceEditorField[];
+    outputs: FilterSourceEditorOutput[];
+}
+/** Узкие операции визуального редактора над canonical Filter source. */
+export type FilterSourcePatchOperation = {
+    type: 'add-field';
+    key: string;
+    expression: string;
+} | {
+    type: 'remove-field';
+    key: string;
+} | {
+    type: 'move-field';
+    key: string;
+    toIndex: number;
+} | {
+    type: 'rename-field';
+    key: string;
+    nextKey: string;
+} | {
+    type: 'set-field';
+    key: string;
+    expression: string;
+};
+export type FilterSourcePatch = FilterSourcePatchOperation | FilterSourcePatchOperation[];
 /** JSON-output фильтра. */
 export interface FilterProgramJsonOutput {
     key: string;

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

@@ -5,4 +5,6 @@ export * from './query-source.types';
 export * from './source-engine.types';
 export * from './source-expression.types';
 export * from './store-source.types';
+export * from './stream-source.types';
+export * from './update-source.types';
 export * from './type-source.types';

package/dist/domain/types/source/query-source.types.d.ts

@@ -2,7 +2,7 @@ import { RQueryAuth } from '../document/query.types';
 import { ProgramDiagnostic, QueryProgramPayload } from '../program/program.types';
 import { DataViewRef } from './data-view-source.types';
 import { ProgramMetadataMap } from '../program/program-metadata.types';
-import { QueryProgramProp, SourceExpressionIR } from './source-expression.types';
+import { QueryProgramProp, SourceExpressionIR, SourceFieldDefinition } from './source-expression.types';
 /** Поддерживаемые kind query source v1. */
 export type QuerySourceKind = 'rest';
 /** Static request value or a safe expression evaluated from Query props at runtime. */
@@ -45,6 +45,7 @@ export interface QuerySourceOutput {
     key: string;
     source: QueryOutputSource;
     dataViews: DataViewRef[];
+    contract?: SourceFieldDefinition | null;
 }
 export type QuerySourceOutputs = QuerySourceOutput[];
 /** Canonical authoring-модель source-only Query v2. */

package/dist/domain/types/source/source-engine.types.d.ts

@@ -1,5 +1,5 @@
 /** Канонический тип source-документа, для которого выбирается source strategy. */
-export type SourceKind = 'query' | 'data-view' | 'filter' | 'composition' | 'store' | 'computation' | 'style' | 'type';
+export type SourceKind = 'query' | 'data-view' | 'filter' | 'composition' | 'store' | 'stream' | 'update' | 'computation' | 'style' | 'type';
 /** Тип нейтральной source completion без привязки к Monaco или другому editor API. */
 export type SourceLanguageCompletionKind = 'keyword' | 'function' | 'property' | 'value' | 'snippet';
 /** Позиция курсора внутри source-документа. */
@@ -38,7 +38,7 @@ export interface SourceLanguageCompletion {
     documentation?: string;
 }
 /** Логический тип внешнего доменного документа, на который ссылается source. */
-export type SourceDocumentReferenceTarget = 'auth-profile' | 'component' | 'composition' | 'computation' | 'converter' | 'data-view' | 'filter' | 'mock' | 'query' | 'store' | 'style' | 'type' | 'vocabs';
+export type SourceDocumentReferenceTarget = 'auth-profile' | 'component' | 'composition' | 'computation' | 'converter' | 'data-view' | 'filter' | 'mock' | 'query' | 'store' | 'stream' | 'update' | 'style' | 'type' | 'vocabs';
 /** Семантическая ссылка из source на внешний доменный документ. */
 export interface SourceDocumentReference {
     /** Логический тип цели; UI может уточнить concrete document type через domain. */

package/dist/domain/types/source/source-expression.types.d.ts

@@ -4,7 +4,7 @@ export type SourceFieldType = 'String' | 'Number' | 'Boolean' | 'Date' | 'Time'
 /** Источник безопасного чтения значения внутри source expression. */
 export type SourceExpressionReadKind = 'env' | 'prop' | 'value' | 'row' | 'response' | 'store' | 'current' | 'scope' | 'composition-output' | 'composition-outputs' | 'composition-data' | 'composition-store' | 'composition-filter-fields' | 'composition-runtime-metadata' | 'metadata' | 'computation-output';
 /** Whitelist операций статического expression IR. */
-export type SourceExpressionOperation = 'merge' | 'compact' | 'get' | 'get-or' | 'has' | 'default-to' | 'pick' | 'omit' | 'defaults' | 'keys' | 'values' | 'entries' | 'map' | 'where' | 'reject' | 'find' | 'some' | 'every' | 'flat-map' | 'flatten' | 'uniq' | 'uniq-by' | 'concat' | 'take' | 'drop' | 'sort-by' | 'group-by' | 'key-by' | 'size' | 'sum' | 'sum-by' | 'min' | 'max' | 'min-by' | 'max-by' | 'trim' | 'lower-case' | 'upper-case' | 'split' | 'join' | 'match' | 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte' | 'includes' | 'or' | 'when' | 'not' | 'is-nil' | 'is-empty' | 'and' | 'between' | 'in-list' | 'in-array' | 'relative-date' | 'relative-date-time' | 'left-join' | 'full-join' | 'join-by' | 'join-by-any' | 'join-coalesce' | 'lookup-one' | 'lookup-many' | 'enrich';
+export type SourceExpressionOperation = 'merge' | 'compact' | 'get' | 'get-or' | 'has' | 'default-to' | 'pick' | 'omit' | 'defaults' | 'keys' | 'values' | 'entries' | 'map' | 'where' | 'reject' | 'find' | 'some' | 'every' | 'flat-map' | 'flatten' | 'uniq' | 'uniq-by' | 'concat' | 'take' | 'drop' | 'sort-by' | 'group-by' | 'key-by' | 'size' | 'sum' | 'sum-by' | 'min' | 'max' | 'min-by' | 'max-by' | 'trim' | 'lower-case' | 'upper-case' | 'split' | 'join' | 'match' | 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte' | 'includes' | 'or' | 'when' | 'not' | 'is-nil' | 'is-empty' | 'and' | 'between' | 'in-list' | 'in-array' | 'relative-date' | 'relative-date-time' | 'left-join' | 'full-join' | 'join-by' | 'join-by-any' | 'join-coalesce' | 'lookup-one' | 'lookup-many' | 'enrich' | 'coalesce' | 'choose' | 'lookup-value' | 'to-string' | 'to-number' | 'to-boolean' | 'type-of' | 'is-string' | 'is-number' | 'is-boolean' | 'is-array' | 'is-object' | 'is-date-time' | 'is-duration' | 'add' | 'subtract' | 'multiply' | 'divide' | 'modulo' | 'abs' | 'negate' | 'round' | 'floor' | 'ceil' | 'clamp' | 'average' | 'average-by' | 'starts-with' | 'ends-with' | 'replace' | 'replace-all' | 'slice' | 'pad-start' | 'pad-end' | 'normalize-whitespace' | 'set' | 'unset' | 'rename' | 'get-key' | 'from-entries' | 'first' | 'last' | 'at' | 'reverse' | 'sort-by-desc' | 'order-by' | 'chunk' | 'union' | 'intersection' | 'difference' | 'count-by' | 'date-time' | 'duration' | 'date-time-add' | 'date-time-subtract' | 'date-time-difference' | 'date-time-start-of' | 'date-time-end-of' | 'date-time-part' | 'duration-add' | 'duration-subtract' | 'duration-total' | 'contains-all' | 'contains-any';
 /**
  * Безопасное runtime-выражение, полученное из source callback.
  *

package/dist/domain/types/source/store-source.types.d.ts

@@ -1,11 +1,13 @@
 import { ProgramDiagnostic } from '../program/program.types';
 import { EndgeMockReference } from '../mock';
 import { DataViewRef } from './data-view-source.types';
+import { SourceFieldDefinition } from './source-expression.types';
 export type StoreDataDescriptor = StoreValueDescriptor | StoreDerivedDescriptor;
 export interface StoreValueDescriptor {
     key: string;
     kind: 'value';
     initial: StoreValueInitializer;
+    contract?: SourceFieldDefinition | null;
 }
 export type StoreValueInitializer = {
     kind: 'literal';
@@ -16,14 +18,21 @@ export interface StoreDerivedDescriptor {
     kind: 'derived';
     source: string;
     dataViews: DataViewRef[];
+    contract?: SourceFieldDefinition | null;
 }
 export interface StoreSourceDocument {
     data: StoreDataDescriptor[];
 }
+/** Скомпилированная таблица маршрутизации событий к дочерним Update. */
+export interface StoreUpdateHandlerDescriptor {
+    identity: string;
+    eventTypes: string[];
+}
 /** Runtime-ready Store source artifact v1. */
 export interface StoreSourceArtifact extends StoreSourceDocument {
     type: 'store';
     sourceVersion: number;
+    updateHandlers: StoreUpdateHandlerDescriptor[];
 }
 export interface StoreSourceCompileResult {
     ast: unknown | null;

package/dist/domain/types/source/stream-source.types.d.ts

@@ -0,0 +1,39 @@
+import { ProgramDiagnostic } from '../program/program.types';
+export interface StreamSseTransportDescriptor {
+    kind: 'sse';
+    url: string;
+    withCredentials: boolean;
+    authMode: 'inherit' | 'none';
+}
+export type StreamTransportDescriptor = StreamSseTransportDescriptor;
+export interface StreamEventDescriptor {
+    sourceEvent: string;
+    type: string | null;
+    typePath: string | null;
+    payloadPath: string | null;
+}
+export interface StreamSourceDocument {
+    transport: StreamTransportDescriptor;
+    events: StreamEventDescriptor[];
+}
+/** Runtime-ready Stream artifact. */
+export interface StreamSourceArtifact extends StreamSourceDocument {
+    type: 'stream';
+    sourceVersion: number;
+}
+export interface StreamSourceCompileResult {
+    ast: unknown | null;
+    document: StreamSourceDocument | null;
+    artifact: StreamSourceArtifact | null;
+    diagnostics: Omit<ProgramDiagnostic, 'entityRef'>[];
+}
+export interface StreamEventEnvelope {
+    type: string;
+    payload: unknown;
+    meta: {
+        id: string | null;
+        source: string;
+        sourceEvent: string;
+        occurredAt: string;
+    };
+}

package/dist/domain/types/source/update-source.types.d.ts

@@ -0,0 +1,32 @@
+import { ProgramDiagnostic } from '../program/program.types';
+export type UpdateMutationStrategy = 'set' | 'merge' | 'replace' | 'append' | 'remove';
+export interface UpdateMutationDescriptor {
+    strategy: UpdateMutationStrategy;
+    target: string;
+    forEach: string | null;
+    ifExists: string | null;
+    valueFrom: string | null;
+    vars: Record<string, string>;
+}
+export interface UpdateSourceDocument {
+    handles: string[];
+    mutations: UpdateMutationDescriptor[];
+}
+/** Runtime-ready Update artifact, always scoped to its owner Store. */
+export interface UpdateSourceArtifact extends UpdateSourceDocument {
+    type: 'update';
+    sourceVersion: number;
+    storeIdentity: string;
+}
+export interface UpdateSourceCompileResult {
+    ast: unknown | null;
+    document: UpdateSourceDocument | null;
+    artifact: Omit<UpdateSourceArtifact, 'storeIdentity'> | null;
+    diagnostics: Omit<ProgramDiagnostic, 'entityRef'>[];
+}
+export interface StoreMutationPlan {
+    strategy: UpdateMutationStrategy;
+    path: string;
+    value?: unknown;
+    vars?: Record<string, unknown>;
+}