@salsita-ai/sdk 0.50.0-develop.b335a15889 → 0.50.0-develop.b7caacb493

package/dist/domain/core/component/system-virtual-entity.js

@@ -0,0 +1 @@
+import{createVirtualEntityId as t}from"../model/index.js";export const systemVirtualEntityId=t("system");

package/dist/domain/core/component/tool-state-component.d.ts

@@ -0,0 +1,14 @@
+import { type EntityId } from '../model/index.js';
+export type ToolStateComponentState = {
+    readonly activeState: string;
+};
+/**
+ * Component used to hold tool state for system virtual entity. Use this only via NavigationSystem
+ */
+export declare const toolStateComponent: import("../index.js").SystemComponentType<"toolState", ToolStateComponentState, "activeState">;
+/**
+ * Component used to hold tool state for system virtual entity. Use this only via NavigationSystem
+ */
+export type ToolStateComponent = typeof toolStateComponent;
+export declare const isToolStateComponentSnapshot: (entityId: EntityId) => (snapshot: import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentTypeConstraint>) => snapshot is import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentType<"toolState", ToolStateComponentState, "activeState">>;
+export declare const isSystemToolStateComponentSnapshot: (snapshot: import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentTypeConstraint>) => snapshot is import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentType<"toolState", ToolStateComponentState, "activeState">>;

package/dist/domain/core/component/tool-state-component.js

@@ -0,0 +1 @@
+import{isSnapshotInstance as t}from"../model/index.js";import{SystemComponentBuilder as o}from"./system-component-builder.js";import{systemVirtualEntityId as e}from"./system-virtual-entity.js";export const toolStateComponent=o.component("toolState").withState({type:"object",properties:{activeState:{type:"string"}},required:["activeState"],additionalProperties:!1}).withWritableKeys(["activeState"]).build();export const isToolStateComponentSnapshot=o=>t(o,"singleton",toolStateComponent);export const isSystemToolStateComponentSnapshot=t(e,"singleton",toolStateComponent);

package/dist/domain/core/component/updates.d.ts

@@ -0,0 +1,123 @@
+import type { Localizable } from '@salsita-ai/common/utils';
+import type { ComponentInstance, DomainEntity, EntityByType, EntityId, StateOfComponent, SystemComponentType, SystemComponentTypeConstraint, WritableStateOfComponent } from '../model/index.js';
+import type { OneComponentFilter } from './component-reader-types.js';
+export interface ComponentModification<COMPONENT_TYPE extends SystemComponentTypeConstraint> {
+    kind: 'modifyComponent';
+    entityId: EntityId;
+    updateTag: string;
+    hint?: Localizable;
+    /** What the assistant agent is told about this update instead of `hint`; `null` keeps the wording from it, and its change record then explains the change by `updateTag`. Never shown to the user. */
+    agentHint?: string | null;
+    componentInstance: ComponentInstance<COMPONENT_TYPE>;
+    writableState: WritableStateOfComponent<COMPONENT_TYPE>;
+    metadata?: Record<string, unknown>;
+}
+export declare const isComponentModificationOfType: <COMPONENT_TYPE extends SystemComponentTypeConstraint>(componentType: COMPONENT_TYPE) => (update: StateUpdate<any, any>) => update is ComponentModification<COMPONENT_TYPE>;
+export interface EphemeralRecordModification<COMPONENT_TYPE extends SystemComponentTypeConstraint = SystemComponentTypeConstraint> {
+    kind: 'modifyEphemeralRecord';
+    entityId: EntityId;
+    updateTag: string;
+    hint?: Localizable;
+    /** What the assistant agent is told about this update instead of `hint`; `null` keeps the wording from it, and its change record then explains the change by `updateTag`. Never shown to the user. */
+    agentHint?: string | null;
+    componentInstance: ComponentInstance<COMPONENT_TYPE>;
+    writableState: WritableStateOfComponent<COMPONENT_TYPE>;
+}
+export interface EphemeralRecordCreation<COMPONENT_TYPE extends SystemComponentTypeConstraint = SystemComponentTypeConstraint> {
+    kind: 'createEphemeralRecord';
+    entityId: EntityId;
+    updateTag: string;
+    hint?: Localizable;
+    /** What the assistant agent is told about this update instead of `hint`; `null` keeps the wording from it, and its change record then explains the change by `updateTag`. Never shown to the user. */
+    agentHint?: string | null;
+    componentInstance: ComponentInstance<COMPONENT_TYPE>;
+    initialState: StateOfComponent<COMPONENT_TYPE>;
+}
+export interface EphemeralRecordDeletion<COMPONENT_TYPE extends SystemComponentTypeConstraint = SystemComponentTypeConstraint> {
+    kind: 'deleteEphemeralRecord';
+    entityId: EntityId;
+    componentInstance: ComponentInstance<COMPONENT_TYPE>;
+    updateTag: string;
+    hint?: Localizable;
+    /** What the assistant agent is told about this update instead of `hint`; `null` keeps the wording from it, and its change record then explains the change by `updateTag`. Never shown to the user. */
+    agentHint?: string | null;
+}
+export type DomainEntityStateDelta<ENTITY extends DomainEntity<string>> = Partial<Omit<ENTITY, 'id' | 'type'>>;
+export interface DomainEntityModification<ENTITY extends DomainEntity<string> = DomainEntity<string>> {
+    kind: 'modifyDomainEntity';
+    entityId: ENTITY['id'];
+    updateTag: string;
+    hint?: Localizable;
+    /** What the assistant agent is told about this update instead of `hint`; `null` keeps the wording from it, and its change record then explains the change by `updateTag`. Never shown to the user. */
+    agentHint?: string | null;
+    stateDelta: DomainEntityStateDelta<ENTITY>;
+    origin?: ComponentModification<SystemComponentTypeConstraint>;
+}
+export interface DomainEntityCreation<ENTITY extends DomainEntity<string>, PARENT extends DomainEntity<string>> {
+    kind: 'createDomainEntity';
+    entityId: ENTITY['id'];
+    entity: ENTITY;
+    updateTag: string;
+    /**
+     * Collection this entity is part of. This should be the instanceName of referenceComponents where this entity should be added.
+     */
+    collection?: string;
+    parentId: PARENT['id'];
+    hint?: Localizable;
+    /** What the assistant agent is told about this update instead of `hint`; `null` keeps the wording from it, and its change record then explains the change by `updateTag`. Never shown to the user. */
+    agentHint?: string | null;
+}
+export interface DomainEntityReplacement<ENTITY extends DomainEntity<string>> {
+    kind: 'replaceDomainEntity';
+    entityId: EntityId<ENTITY>;
+    replacementEntity: ENTITY;
+    updateTag: string;
+    keepChildren: boolean;
+    hint?: Localizable;
+    /** What the assistant agent is told about this update instead of `hint`; `null` keeps the wording from it, and its change record then explains the change by `updateTag`. Never shown to the user. */
+    agentHint?: string | null;
+}
+export interface EntityDeletion<ENTITY extends DomainEntity<string>> {
+    kind: 'deleteEntity';
+    entityId: EntityId<ENTITY>;
+    updateTag: string;
+    hint?: Localizable;
+    /** What the assistant agent is told about this update instead of `hint`; `null` keeps the wording from it, and its change record then explains the change by `updateTag`. Never shown to the user. */
+    agentHint?: string | null;
+}
+export type DataUpdate<ENTITY extends DomainEntity<string>, PARENT extends DomainEntity<string>> = EphemeralRecordModification | EphemeralRecordCreation | EphemeralRecordDeletion | DomainEntityModification<ENTITY> | DomainEntityCreation<ENTITY, PARENT> | DomainEntityReplacement<ENTITY> | EntityDeletion<ENTITY>;
+export type StateUpdate<ENTITY extends DomainEntity<string>, PARENT extends DomainEntity<string>> = ComponentModification<SystemComponentTypeConstraint> | DataUpdate<ENTITY, PARENT>;
+type ComponentUpdate<COMPONENT_TYPE extends SystemComponentTypeConstraint> = ComponentModification<COMPONENT_TYPE> | EphemeralRecordModification<COMPONENT_TYPE> | EphemeralRecordCreation<COMPONENT_TYPE> | EphemeralRecordDeletion<COMPONENT_TYPE>;
+type ComponentUpdateDetails<COMPONENT_TYPE extends SystemComponentTypeConstraint, UPDATE extends ComponentUpdate<COMPONENT_TYPE>> = {
+    readonly componentInstance: OneComponentFilter<COMPONENT_TYPE>;
+} & (COMPONENT_TYPE extends SystemComponentType<any, Record<never, never>, never> ? Omit<UPDATE, 'kind' | 'entityId' | 'componentInstance' | 'writableState' | 'initialState'> : Omit<UPDATE, 'kind' | 'entityId' | 'componentInstance'>);
+export declare const createUpdateFactory: <ENTITIES extends DomainEntity<string>>() => {
+    ComponentModification: <COMPONENT_TYPE extends SystemComponentTypeConstraint>(details: ComponentUpdateDetails<COMPONENT_TYPE, ComponentModification<COMPONENT_TYPE>>) => ComponentModification<COMPONENT_TYPE>;
+    DomainEntityCreation: <ENTITY extends ENTITIES, PARENT extends ENTITIES>(details: Omit<DomainEntityCreation<ENTITY, PARENT>, 'kind' | 'entityId'>) => DomainEntityCreation<ENTITY, PARENT>;
+    DomainEntityReplacement: <ENTITY extends ENTITIES>(details: Omit<DomainEntityReplacement<ENTITY>, 'kind'>) => DomainEntityReplacement<ENTITY>;
+    EphemeralRecordCreation: <COMPONENT_TYPE extends SystemComponentTypeConstraint>(details: ComponentUpdateDetails<COMPONENT_TYPE, EphemeralRecordCreation<COMPONENT_TYPE>>) => EphemeralRecordCreation<COMPONENT_TYPE>;
+    DomainEntityModification: <TYPE extends ENTITIES['type']>(details: Omit<DomainEntityModification<EntityByType<ENTITIES, TYPE>>, 'kind'>) => DomainEntityModification<EntityByType<ENTITIES, TYPE>>;
+    EphemeralRecordModification: <COMPONENT_TYPE extends SystemComponentTypeConstraint>(details: ComponentUpdateDetails<COMPONENT_TYPE, EphemeralRecordModification<COMPONENT_TYPE>>) => EphemeralRecordModification<COMPONENT_TYPE>;
+    EphemeralRecordDeletion: <COMPONENT_TYPE extends SystemComponentTypeConstraint>(details: ComponentUpdateDetails<COMPONENT_TYPE, EphemeralRecordDeletion<COMPONENT_TYPE>>) => EphemeralRecordDeletion<COMPONENT_TYPE>;
+    EntityDeletion: <ENTITY extends ENTITIES>(details: Omit<EntityDeletion<ENTITY>, 'kind'>) => EntityDeletion<ENTITY>;
+};
+export type UpdateFactory<ENTITIES extends DomainEntity<string>> = ReturnType<typeof createUpdateFactory<ENTITIES>>;
+/**
+ * Factory for creating system updates. It is not typed to a specific domain.
+ * This should never be used in a project code! It is just internal tool for sdk.
+ */
+export declare const systemUpdateFactory: {
+    ComponentModification: <COMPONENT_TYPE extends SystemComponentTypeConstraint>(details: ComponentUpdateDetails<COMPONENT_TYPE, ComponentModification<COMPONENT_TYPE>>) => ComponentModification<COMPONENT_TYPE>;
+    DomainEntityCreation: <ENTITY extends DomainEntity<string>, PARENT extends DomainEntity<string>>(details: Omit<DomainEntityCreation<ENTITY, PARENT>, "entityId" | "kind">) => DomainEntityCreation<ENTITY, PARENT>;
+    DomainEntityReplacement: <ENTITY extends DomainEntity<string>>(details: Omit<DomainEntityReplacement<ENTITY>, "kind">) => DomainEntityReplacement<ENTITY>;
+    EphemeralRecordCreation: <COMPONENT_TYPE extends SystemComponentTypeConstraint>(details: ComponentUpdateDetails<COMPONENT_TYPE, EphemeralRecordCreation<COMPONENT_TYPE>>) => EphemeralRecordCreation<COMPONENT_TYPE>;
+    DomainEntityModification: <TYPE extends string>(details: Omit<DomainEntityModification<Extract<DomainEntity<string>, {
+        type: TYPE;
+    }>>, "kind">) => DomainEntityModification<Extract<DomainEntity<string>, {
+        type: TYPE;
+    }>>;
+    EphemeralRecordModification: <COMPONENT_TYPE extends SystemComponentTypeConstraint>(details: ComponentUpdateDetails<COMPONENT_TYPE, EphemeralRecordModification<COMPONENT_TYPE>>) => EphemeralRecordModification<COMPONENT_TYPE>;
+    EphemeralRecordDeletion: <COMPONENT_TYPE extends SystemComponentTypeConstraint>(details: ComponentUpdateDetails<COMPONENT_TYPE, EphemeralRecordDeletion<COMPONENT_TYPE>>) => EphemeralRecordDeletion<COMPONENT_TYPE>;
+    EntityDeletion: <ENTITY extends DomainEntity<string>>(details: Omit<EntityDeletion<ENTITY>, "kind">) => EntityDeletion<ENTITY>;
+};
+export {};

package/dist/domain/core/component/view-state-component.d.ts

@@ -0,0 +1,14 @@
+import { type EntityId } from '../model/index.js';
+export type ViewStateComponentState = {
+    readonly activeState: string;
+};
+/**
+ * Component used to hold view state for system virtual entity. Use this only via NavigationSystem
+ */
+export declare const viewStateComponent: import("../index.js").SystemComponentType<"viewState", ViewStateComponentState, "activeState">;
+/**
+ * Component used to hold view state for system virtual entity. Use this only via NavigationSystem
+ */
+export type ViewStateComponent = typeof viewStateComponent;
+export declare const isViewComponentSnapshot: (entityId: EntityId) => (snapshot: import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentTypeConstraint>) => snapshot is import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentType<"viewState", ViewStateComponentState, "activeState">>;
+export declare const isSystemViewComponentSnapshot: (snapshot: import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentTypeConstraint>) => snapshot is import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentType<"viewState", ViewStateComponentState, "activeState">>;

package/dist/domain/core/component/view-state-component.js

@@ -0,0 +1 @@
+import{isSnapshotInstance as t}from"../model/index.js";import{SystemComponentBuilder as e}from"./system-component-builder.js";import{systemVirtualEntityId as o}from"./system-virtual-entity.js";export const viewStateComponent=e.component("viewState").withState({type:"object",properties:{activeState:{type:"string"}},required:["activeState"],additionalProperties:!1}).withWritableKeys(["activeState"]).build();export const isViewComponentSnapshot=e=>t(e,"singleton",viewStateComponent);export const isSystemViewComponentSnapshot=t(o,"singleton",viewStateComponent);

package/dist/domain/core/component/viewport-state-component.d.ts

@@ -0,0 +1,29 @@
+import { type EntityId } from '../model/index.js';
+/**
+ * A responsive class the configurator container currently satisfies. The values mirror the
+ * responsive flags computed by the UI layer from the theme breakpoints (`isPhone`, `isMobile`,
+ * `isTablet`, `isDesktop`, `isLandscape`, `isPortrait`), so several can be active at once —
+ * a 600px wide container is `mobile` and `tablet` at the same time.
+ */
+export type Viewport = 'phone' | 'mobile' | 'tablet' | 'desktop' | 'landscape' | 'portrait';
+export declare const VIEWPORTS: readonly ["phone", "mobile", "tablet", "desktop", "landscape", "portrait"];
+export type ViewportStateComponentState = {
+    /**
+     * Every viewport class the container currently satisfies, or `null` while nothing has measured
+     * the container yet (image rendering, tests, non-browser evaluation). Component filters skip
+     * their `viewports` criterion while the value is `null`.
+     */
+    readonly active: readonly Viewport[] | null;
+};
+/**
+ * Component used to hold the active responsive viewport classes for the system virtual entity.
+ * Seeded by the NavigationSystem and written by the configurator UI whenever the responsive
+ * flags change. Use this only via NavigationSystem.
+ */
+export declare const viewportStateComponent: import("../index.js").SystemComponentType<"viewportState", ViewportStateComponentState, "active">;
+/**
+ * Component used to hold the active responsive viewport classes for the system virtual entity. Use this only via NavigationSystem
+ */
+export type ViewportStateComponent = typeof viewportStateComponent;
+export declare const isViewportStateComponentSnapshot: (entityId: EntityId) => (snapshot: import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentTypeConstraint>) => snapshot is import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentType<"viewportState", ViewportStateComponentState, "active">>;
+export declare const isSystemViewportStateComponentSnapshot: (snapshot: import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentTypeConstraint>) => snapshot is import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentType<"viewportState", ViewportStateComponentState, "active">>;

package/dist/domain/core/component/viewport-state-component.js

@@ -0,0 +1 @@
+import{isSnapshotInstance as t}from"../model/index.js";import{SystemComponentBuilder as e}from"./system-component-builder.js";import{systemVirtualEntityId as o}from"./system-virtual-entity.js";export const VIEWPORTS=["phone","mobile","tablet","desktop","landscape","portrait"];export const viewportStateComponent=e.component("viewportState").withState({type:"object",properties:{active:{oneOf:[{type:"array",items:{type:"string",enum:[...VIEWPORTS]}},{type:"null"}]}},required:["active"],additionalProperties:!1,tsType:"ViewportStateComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"ViewportStateComponentState"}]}).withWritableKeys(["active"]).build();export const isViewportStateComponentSnapshot=e=>t(e,"singleton",viewportStateComponent);export const isSystemViewportStateComponentSnapshot=t(o,"singleton",viewportStateComponent);

package/dist/domain/core/data-schema/data-cell-value.d.ts

@@ -0,0 +1,4 @@
+import type { CellValue } from '@salsita-ai/contracts/webhook';
+export type DataCellValue = CellValue | null | {
+    readonly $lang: Record<string, string>;
+} | readonly CellValue[];

package/dist/domain/core/data-schema/data-cell-value.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/core/data-schema/data-schema-array-field.d.ts

@@ -0,0 +1,5 @@
+export interface DataSchemaArrayField {
+    readonly type: 'array';
+    readonly items: 'string' | 'number' | 'boolean';
+    readonly description?: string;
+}

package/dist/domain/core/data-schema/data-schema-array-field.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/core/data-schema/data-schema-field-object.d.ts

@@ -0,0 +1,4 @@
+import type { DataSchemaArrayField } from './data-schema-array-field.js';
+import type { DataSchemaLocalizedField } from './data-schema-localized-field.js';
+import type { DataSchemaPrimitiveField } from './data-schema-primitive-field.js';
+export type DataSchemaFieldObject = DataSchemaPrimitiveField | DataSchemaLocalizedField | DataSchemaArrayField;

package/dist/domain/core/data-schema/data-schema-field-object.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/core/data-schema/data-schema-field.d.ts

@@ -0,0 +1,2 @@
+import type { DataSchemaFieldObject } from './data-schema-field-object.js';
+export type DataSchemaField = 'string' | 'number' | 'boolean' | readonly ['string', 'null'] | readonly ['number', 'null'] | readonly ['boolean', 'null'] | DataSchemaFieldObject;

package/dist/domain/core/data-schema/data-schema-field.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/core/data-schema/data-schema-localized-field.d.ts

@@ -0,0 +1,4 @@
+export interface DataSchemaLocalizedField {
+    readonly type: 'localized';
+    readonly description?: string;
+}

package/dist/domain/core/data-schema/data-schema-localized-field.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/core/data-schema/data-schema-primitive-field.d.ts

@@ -0,0 +1,5 @@
+export interface DataSchemaPrimitiveField {
+    readonly type: 'string' | 'number' | 'integer' | 'boolean';
+    readonly enum?: ReadonlyArray<string | number>;
+    readonly description?: string;
+}

package/dist/domain/core/data-schema/data-schema-primitive-field.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/core/data-schema/data-schema.d.ts

@@ -0,0 +1,2 @@
+import type { DataSchemaField } from './data-schema-field.js';
+export type DataSchema = Record<string, DataSchemaField>;

package/dist/domain/core/data-schema/data-schema.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/core/data-schema/index.d.ts

@@ -0,0 +1,7 @@
+export type * from './data-cell-value.js';
+export type * from './data-schema-array-field.js';
+export type * from './data-schema-field-object.js';
+export type * from './data-schema-field.js';
+export type * from './data-schema-localized-field.js';
+export type * from './data-schema-primitive-field.js';
+export type * from './data-schema.js';

package/dist/domain/core/data-schema/index.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/core/decoder/create-decoder.d.ts

@@ -0,0 +1,6 @@
+import type { Decoder } from './decoder.js';
+/**
+ * Creates the decoder of data that must match a JSON schema. `subject` is what the data is, as the
+ * error names it, for example `Session data`.
+ */
+export declare const createDecoder: <DATA>(schema: object, subject: string) => Decoder<DATA>;

package/dist/domain/core/decoder/create-decoder.js

@@ -0,0 +1 @@
+import{extendedSchemaValidator as r}from"../schema/index.js";export const createDecoder=(e,o)=>t=>{let i=r.compile(e);if(!i(t))throw Error(`${o} is not valid: ${r.errorsText(i.errors)}`);return t};

package/dist/domain/core/decoder/decoder.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Turns data of unknown shape into data of a known type, and throws when the data does not match.
+ * Everything that enters a domain from outside goes through one: published, session, frontend and
+ * backend data.
+ */
+export type Decoder<DATA> = (data: unknown) => DATA;

package/dist/domain/core/decoder/decoder.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/core/decoder/index.d.ts

@@ -0,0 +1,2 @@
+export { createDecoder } from './create-decoder.js';
+export type { Decoder } from './decoder.js';

package/dist/domain/core/decoder/index.js

@@ -0,0 +1 @@
+export{createDecoder}from"./create-decoder.js";

package/dist/domain/core/domain-factory.d.ts

@@ -1,9 +1,8 @@
 import type { ExtendedJsonSchema } from '@salsita-ai/common/utils';
-import type { ActionDefinitions, AnyActionImplementations } from './action.js';
-import type { Expression } from './expression.js';
-import type { MigrateFunction } from './migrations.js';
-import type { $DomainEntity, DomainEntity, EntityByType } from './model.js';
-import type { $DomainEntityReflection, EntityReflections, SchemaOfObject } from './reflection.js';
+import type { ActionDefinitions, AnyActionImplementations } from './action/index.js';
+import type { Expression } from './expression/index.js';
+import type { $DomainEntity, $DomainEntityReflection, DomainEntity, EntityByType, EntityReflections, SchemaOfObject } from './model/index.js';
+import type { MigrateFunction } from './state/index.js';
 type $EntityReflections<ENTITIES extends DomainEntity<string>> = {
     [TYPE in ENTITIES['type']]: $DomainEntityReflection<$DomainEntity<EntityByType<ENTITIES, TYPE>>>;
 };

package/dist/domain/core/domain-factory.js

@@ -1 +1 @@
-import{migrateCommonAdminDomain as t}from"../admin-domain/implementation/common-admin-migrations.js";import{extendedSchemaValidator as r}from"./json-schema.js";export class DomainFactory{context;modelVersion;hasBackendData;constructor(t){this.context=t,this.modelVersion=t.modelVersion,this.hasBackendData=void 0!==t.backendData}parsePublishedData=t=>{let e=r.compile(this.context.publishedData);if(!e(t))throw Error(`Admin data is not valid: ${r.errorsText(e.errors)}`);return t};parseSessionData=t=>{let e=r.compile(this.context.sessionData);if(!e(t))throw Error(`Session data is not valid: ${r.errorsText(e.errors)}`);return t};parseFrontendData=t=>{let e=r.compile(this.context.frontendData);if(!e(t))throw Error(`Frontend data is not valid: ${r.errorsText(e.errors)}`);return t};parseBackendData=t=>{if(void 0===this.context.backendData)throw Error("Backend data is not supported for this domain");let e=r.compile(this.context.backendData);if(!e(t))throw Error(`Backend data is not valid: ${r.errorsText(e.errors)}`);return t};validateAndMigrateState=(r,e)=>{let a=this.context.isAdminDomain?t(r):r;return this.context.migrate({state:a,version:e},{trimExtraProperties:!1})}}
+import{migrateCommonAdminDomain as t}from"../admin-domain/implementation/common-admin-migrations.js";import{createDecoder as a}from"./decoder/index.js";export class DomainFactory{context;modelVersion;hasBackendData;constructor(t){this.context=t,this.modelVersion=t.modelVersion,this.hasBackendData=void 0!==t.backendData}parsePublishedData=t=>a(this.context.publishedData,"Admin data")(t);parseSessionData=t=>a(this.context.sessionData,"Session data")(t);parseFrontendData=t=>a(this.context.frontendData,"Frontend data")(t);parseBackendData=t=>{if(void 0===this.context.backendData)throw Error("Backend data is not supported for this domain");return a(this.context.backendData,"Backend data")(t)};validateAndMigrateState=(a,e)=>{let n=this.context.isAdminDomain?t(a):a;return this.context.migrate({state:n,version:e},{trimExtraProperties:!1})}}

package/dist/domain/core/domain.d.ts

@@ -1,7 +1,6 @@
-import type { AnyExpressions, ExpressionContext } from './expression.js';
-import { type $DomainEntity, type DomainEntity, type DomainEntityId, type EntityByType } from './model.js';
-import type { AnyEntityReflections } from './reflection.js';
-import type { DomainState } from './state.js';
+import type { AnyExpressions, OpenExpressionContext } from './expression/index.js';
+import { type $DomainEntity, type AnyEntityReflections, type DomainEntity, type DomainEntityId, type EntityByType } from './model/index.js';
+import type { DomainState } from './state/index.js';
 export type AllowedRootEntityTypes<ALLOWED_ROOT_ENTITIES extends DomainEntity<string>> = ReadonlyArray<ALLOWED_ROOT_ENTITIES['type']>;
 export type AnyAllowedRootEntityTypes = AllowedRootEntityTypes<DomainEntity<string>>;
 /**
@@ -13,7 +12,7 @@ export interface DomainSelectors {
     readonly getDomainExpressions: () => AnyExpressions;
     readonly getAllowedRootEntityTypes: () => ReadonlyArray<string>;
     readonly getEntityReflections: () => AnyEntityReflections;
-    readonly getExpressionContext: () => ExpressionContext<any, any, any, any, any>;
+    readonly getExpressionContext: () => OpenExpressionContext<any, any, any, any, any>;
 }
 /** Effective mode used by domain expressions and systems. */
 export type DomainMode = 'owner' | 'read' | 'finalize';

package/dist/domain/core/domain.js

@@ -1 +1 @@
-import{createCacheToken as t,getStickyCache as e}from"@salsita-ai/common/utils";import{domainEntityTypeFromId as i}from"./model.js";let r=t(),o=t();export class Domain{_context;constructor(t){this._context=t}getEntity=(t,i)=>{let r=e(i,o),n=r.get("entityMap");if(n)return n.get(t);let s=(t=>{let e=new Map;for(let i of t){if(e.has(i.id))throw Error(`Error while creating a UniqueEntityMap for caching of domain queries. Duplicate entity id ${i.id} encountered!`);e.set(i.id,i)}return e})(i.entities);return r.put("entityMap",s),s.get(t)};get$Entity=(t,i)=>{let o=e(i,r),n=o.get(t);if(n)return n;let s=this.getEntity(t,i);if(!s)throw Error(`Entity ${t} does not exist`);let a={...s},l=this._context.selectors.getDomainExpressions()[s.type];return l&&Object.entries(l).forEach(([t,e])=>{Object.defineProperty(a,t,{enumerable:!0,get:()=>e.evaluate(s.id,i,this._context.selectors.getExpressionContext())})}),Object.defineProperty(a,"_raw",{enumerable:!0,writable:!1,value:s}),Object.defineProperty(a,"_state",{enumerable:!0,writable:!1,value:i}),o.put(t,a),a};get$Entities=(t,e)=>t.map(t=>this.get$Entity(t,e));getRoot$Entity=t=>this.get$Entity(t.rootEntityId,t);validateExpressions=t=>{if(!this._context.selectors.getAllowedRootEntityTypes().includes(t.rootEntityType))throw Error(`Entity type ${t.rootEntityType} is not allowed as root entity`);if(!this.getEntity(t.rootEntityId,t))throw Error(`Root entity ${t.rootEntityId} was not found!`);t.entities.forEach(e=>{let i=this._context.selectors.getDomainExpressions()[e.type];void 0!==i&&Object.values(i).forEach(i=>{!0===i.meta.alwaysEvaluate&&i.evaluate(e.id,t,this._context.selectors.getExpressionContext())})})};validateEntity=t=>{let e=this._context.selectors.getEntityReflections()[t.type];if(!e)throw Error(`Unknown entity type ${t.type}`);return e._meta.validator(t)?{success:!0}:{success:!1,errors:e._meta.validator.errors?.map(t=>`${t.instancePath} ${t.message}`.trim())??[]}};getWritableEntityKeys=(t,e)=>{let r=i(t),o=this._context.selectors.getDomainExpressions()[r];return e.filter(t=>"id"!==t&&"type"!==t&&"_raw"!==t&&o?.[t]===void 0)}}
+import{createCacheToken as t,getStickyCache as e}from"@salsita-ai/common/utils";import{domainEntityTypeFromId as i}from"./model/index.js";let r=t(),o=t();export class Domain{_context;constructor(t){this._context=t}getEntity=(t,i)=>{let r=e(i,o),n=r.get("entityMap");if(n)return n.get(t);let s=(t=>{let e=new Map;for(let i of t){if(e.has(i.id))throw Error(`Error while creating a UniqueEntityMap for caching of domain queries. Duplicate entity id ${i.id} encountered!`);e.set(i.id,i)}return e})(i.entities);return r.put("entityMap",s),s.get(t)};get$Entity=(t,i)=>{let o=e(i,r),n=o.get(t);if(n)return n;let s=this.getEntity(t,i);if(!s)throw Error(`Entity ${t} does not exist`);let a={...s},l=this._context.selectors.getDomainExpressions()[s.type];return l&&Object.entries(l).forEach(([t,e])=>{Object.defineProperty(a,t,{enumerable:!0,get:()=>e.evaluate(s.id,i,this._context.selectors.getExpressionContext())})}),Object.defineProperty(a,"_raw",{enumerable:!0,writable:!1,value:s}),Object.defineProperty(a,"_state",{enumerable:!0,writable:!1,value:i}),o.put(t,a),a};get$Entities=(t,e)=>t.map(t=>this.get$Entity(t,e));getRoot$Entity=t=>this.get$Entity(t.rootEntityId,t);validateExpressions=t=>{if(!this._context.selectors.getAllowedRootEntityTypes().includes(t.rootEntityType))throw Error(`Entity type ${t.rootEntityType} is not allowed as root entity`);if(!this.getEntity(t.rootEntityId,t))throw Error(`Root entity ${t.rootEntityId} was not found!`);t.entities.forEach(e=>{let i=this._context.selectors.getDomainExpressions()[e.type];void 0!==i&&Object.values(i).forEach(i=>{!0===i.meta.alwaysEvaluate&&i.evaluate(e.id,t,this._context.selectors.getExpressionContext())})})};validateEntity=t=>{let e=this._context.selectors.getEntityReflections()[t.type];if(!e)throw Error(`Unknown entity type ${t.type}`);return e._meta.validator(t)?{success:!0}:{success:!1,errors:e._meta.validator.errors?.map(t=>`${t.instancePath} ${t.message}`.trim())??[]}};getWritableEntityKeys=(t,e)=>{let r=i(t),o=this._context.selectors.getDomainExpressions()[r];return e.filter(t=>"id"!==t&&"type"!==t&&"_raw"!==t&&o?.[t]===void 0)}}

package/dist/domain/core/emission/index.d.ts

@@ -0,0 +1,8 @@
+export type * from './reset-state-emission.js';
+export type * from './state-emission.js';
+export type * from './state-update-emission.js';
+export type * from './state-validation-result.js';
+export type * from './transformation-log.js';
+export type * from './transformer-log-entry.js';
+export type * from './transformer-log.js';
+export type * from './transformer-phase.js';

package/dist/domain/core/emission/index.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/core/emission/reset-state-emission.d.ts

@@ -0,0 +1,12 @@
+import type { ViolationTypesOf$Entity } from '../invariant/index.js';
+import type { $DomainEntity, DomainEntity } from '../model/index.js';
+import type { DomainState } from '../state/index.js';
+import type { StateValidationResult } from './state-validation-result.js';
+import type { TransformationLog } from './transformation-log.js';
+export interface ResetStateEmission<ENTITIES extends DomainEntity<string>, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>> {
+    readonly kind: 'reset';
+    readonly state: DomainState<ENTITIES>;
+    readonly validity: StateValidationResult<ENTITIES, ViolationTypesOf$Entity<$MAP[ENTITIES['type']]>>;
+    readonly tag: unknown;
+    readonly transformationLog: TransformationLog | undefined;
+}

package/dist/domain/core/emission/reset-state-emission.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/core/emission/state-emission.d.ts

@@ -0,0 +1,4 @@
+import type { $DomainEntity, DomainEntity } from '../model/index.js';
+import type { ResetStateEmission } from './reset-state-emission.js';
+import type { StateUpdateEmission } from './state-update-emission.js';
+export type StateEmission<ENTITIES extends DomainEntity<string>, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>> = ResetStateEmission<ENTITIES, $MAP> | StateUpdateEmission<ENTITIES, $MAP>;

package/dist/domain/core/emission/state-emission.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/core/emission/state-update-emission.d.ts

@@ -0,0 +1,14 @@
+import type { DataUpdate } from '../component/index.js';
+import type { ViolationTypesOf$Entity } from '../invariant/index.js';
+import type { $DomainEntity, DomainEntity } from '../model/index.js';
+import type { DomainState } from '../state/index.js';
+import type { StateValidationResult } from './state-validation-result.js';
+import type { TransformationLog } from './transformation-log.js';
+export interface StateUpdateEmission<ENTITIES extends DomainEntity<string>, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>> {
+    readonly kind: 'staged' | 'committed';
+    readonly previousState: DomainState<ENTITIES>;
+    readonly state: DomainState<ENTITIES>;
+    readonly updates: ReadonlyArray<DataUpdate<ENTITIES, ENTITIES>>;
+    readonly validity: StateValidationResult<ENTITIES, ViolationTypesOf$Entity<$MAP[ENTITIES['type']]>>;
+    readonly transformationLog: TransformationLog | undefined;
+}

package/dist/domain/core/emission/state-update-emission.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/core/emission/state-validation-result.d.ts

@@ -0,0 +1,18 @@
+import type { EntityViolation } from '../invariant/index.js';
+import type { DomainEntity } from '../model/index.js';
+export type StateValidationResult<ENTITIES extends DomainEntity<string>, VIOLATION_TYPE extends string> = {
+    readonly valid: true;
+    readonly severity: null;
+} | {
+    readonly valid: true;
+    readonly severity: 'warning' | 'notice';
+    readonly entityViolations: ReadonlyArray<EntityViolation<ENTITIES, VIOLATION_TYPE>>;
+} | {
+    readonly valid: false;
+    readonly severity: 'uncaught';
+    readonly error: Error;
+} | {
+    readonly valid: false;
+    readonly severity: 'fatal' | 'fixable';
+    readonly entityViolations: ReadonlyArray<EntityViolation<ENTITIES, VIOLATION_TYPE>>;
+};

package/dist/domain/core/emission/state-validation-result.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/core/emission/transformation-log.d.ts

@@ -0,0 +1,2 @@
+import type { TransformerLog } from './transformer-log.js';
+export type TransformationLog = readonly TransformerLog[];

package/dist/domain/core/emission/transformation-log.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/core/emission/transformer-log-entry.d.ts

@@ -0,0 +1,6 @@
+import type { TransformerPhase } from './transformer-phase.js';
+export interface TransformerLogEntry {
+    phase: TransformerPhase;
+    message: string;
+    data: unknown | undefined;
+}

package/dist/domain/core/emission/transformer-log-entry.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/core/emission/transformer-log.d.ts

@@ -0,0 +1,11 @@
+import type { StateUpdate } from '../component/index.js';
+import type { DomainEntity } from '../model/index.js';
+import type { TransformerLogEntry } from './transformer-log-entry.js';
+import type { TransformerPhase } from './transformer-phase.js';
+export interface TransformerLog {
+    name: string;
+    entries: readonly TransformerLogEntry[];
+    status: TransformerPhase;
+    updatesIn: ReadonlyArray<StateUpdate<DomainEntity<string>, DomainEntity<string>>>;
+    updatesOut: ReadonlyArray<StateUpdate<DomainEntity<string>, DomainEntity<string>>>;
+}

package/dist/domain/core/emission/transformer-log.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/core/emission/transformer-phase.d.ts

@@ -0,0 +1 @@
+export type TransformerPhase = 'no-event' | 'no-match' | 'no-resolve' | 'match' | 'no-apply' | 'apply';

package/dist/domain/core/emission/transformer-phase.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/core/expression/aliased-expressions.d.ts

@@ -0,0 +1,10 @@
+import type { DomainEntity, ExpandAlias, TypeOrAlias } from '../model/index.js';
+import type { AnonymousExpression } from './expression.js';
+/**
+ * The expressions a project implements, keyed by entity type or alias and then by expression name.
+ * It is what `implementCustomExpressions` returns and what the domain is built from; an alias key
+ * stands for every entity type the alias expands to.
+ */
+export type AliasedExpressions<ENTITIES extends DomainEntity<string>, ALLOWED_ROOT_ENTITIES extends ENTITIES, PUBLISHED_DATA extends Record<string, unknown>, SESSION_DATA extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>, ALIASES extends Record<string, ENTITIES>, CONTEXT_EXTENSION = unknown> = {
+    [K in TypeOrAlias<ENTITIES, ALIASES>]?: Record<string, AnonymousExpression<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, ExpandAlias<ENTITIES, ALIASES, K>, unknown, CONTEXT_EXTENSION>>;
+};

package/dist/domain/core/expression/aliased-expressions.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/core/expression/constant-expressions.d.ts

@@ -0,0 +1,16 @@
+import type { ExpressionMeta } from './expression.js';
+/**
+ * The constant expressions of a domain, keyed by entity type or alias and then by the name of the
+ * constant. A constant expression takes no argument: it reads neither the entity nor the state, so
+ * the domain of any project accepts it.
+ */
+export type ConstantExpressions = Readonly<Record<string, Readonly<Record<string, {
+    evaluate(): unknown;
+    readonly meta: ExpressionMeta;
+}>>>>;
+/**
+ * Makes the function that turns the constants of a spec into expressions: every constant becomes an
+ * expression that returns its value. The type a project reads from a constant is the one its
+ * generated model declares for the property, not the type of the expression.
+ */
+export declare const createConstantExpressionFactory: () => (constants: Readonly<Record<string, Readonly<Record<string, unknown>>>>) => ConstantExpressions;

package/dist/domain/core/expression/constant-expressions.js

@@ -0,0 +1 @@
+import{mapNestedObject as t}from"../../utils/map-nested-object.js";export const createConstantExpressionFactory=()=>e=>t()(e,([t,e,o])=>[[t,e,{meta:{},evaluate:()=>o}]]);

package/dist/domain/core/expression/custom-expression.d.ts

@@ -0,0 +1,25 @@
+import type { $DomainEntity, DomainEntity, DomainEntityId, TypeOrAlias } from '../model/index.js';
+import type { DomainState } from '../state/index.js';
+import type { AliasedExpressions } from './aliased-expressions.js';
+import type { ExpressionMeta, OpenExpressionContext } from './expression.js';
+export type CustomExpression<ENTITIES extends DomainEntity<string>, ALLOWED_ROOT_ENTITIES extends ENTITIES, PUBLISHED_DATA extends Record<string, unknown>, SESSION_DATA extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>, SELF extends $DomainEntity<ENTITIES>, T, CONTEXT_EXTENSION = unknown> = (self: SELF, state: DomainState<ENTITIES>, ctx: OpenExpressionContext<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, CONTEXT_EXTENSION>) => T;
+export type PotentialCustomExpressions<ENTITIES extends DomainEntity<string>, ALLOWED_ROOT_ENTITIES extends ENTITIES, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>, PUBLISHED_DATA extends Record<string, unknown>, SESSION_DATA extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>, CONTEXT_EXTENSION = unknown> = {
+    [TYPE_OR_ALIAS in keyof $MAP]?: {
+        [NAME in Extract<keyof $MAP[TYPE_OR_ALIAS], `$${string}`>]?: CustomExpression<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, $MAP[TYPE_OR_ALIAS], $MAP[TYPE_OR_ALIAS][NAME], CONTEXT_EXTENSION>;
+    };
+};
+export declare const createCustomExpressionFactory: <ENTITIES extends DomainEntity<string>, ALLOWED_ROOT_ENTITIES extends ENTITIES, $MAP extends Record<TypeOrAlias<ENTITIES, ALIASES>, $DomainEntity<ENTITIES>>, PUBLISHED_DATA extends Record<string, unknown>, SESSION_DATA extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>, ALIASES extends Record<string, ENTITIES>, CONTEXT_EXTENSION = unknown>() => (implementations: PotentialCustomExpressions<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, CONTEXT_EXTENSION>) => AliasedExpressions<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, ALIASES, CONTEXT_EXTENSION>;
+/**
+ * Wraps the function a project writes for an expression or for a filter criterion into an
+ * expression: the function receives the entity view of `selfId` instead of the id. It takes the
+ * types of the function as they are, so the expression it returns has the state and the context of
+ * the function, and it asks of the context only the entity view it reads itself.
+ */
+export declare const createCustomExpression: <SELF, STATE, CONTEXT extends {
+    readonly domain: {
+        get$Entity(id: DomainEntityId<string>, state: STATE): unknown;
+    };
+}, T>(evaluate: (self: SELF, state: STATE, ctx: CONTEXT) => T, meta: ExpressionMeta) => {
+    evaluate(selfId: DomainEntityId<string>, state: STATE, ctx: CONTEXT): T;
+    readonly meta: ExpressionMeta;
+};

package/dist/domain/core/expression/custom-expression.js

@@ -0,0 +1 @@
+import{mapNestedObject as e}from"../../utils/map-nested-object.js";export const createCustomExpressionFactory=()=>t=>e()(t,([e,t,o])=>{if(!o)throw Error(`Custom expression for ${e}.${t} is of type undefined`);return[[e,t,createCustomExpression(o,{})]]});export const createCustomExpression=(e,t)=>({evaluate:(t,o,r)=>e(r.domain.get$Entity(t,o),o,r),meta:t});