mcp-creatio 0.5.0 → 0.6.1

package/dist/creatio/engines/admin-operation-engine.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdminOperationEngine = void 0;
+const engine_1 = require("./engine");
+class AdminOperationEngine extends engine_1.BaseEngine {
+    _provider;
+    name = 'admin-operation';
+    constructor(provider, env) {
+        super(env);
+        this._provider = provider;
+    }
+    get kind() {
+        return this._provider.kind;
+    }
+    upsertAdminOperation(request) {
+        return this._mutate('admin-operation.upsert', { code: request?.code ?? null }, () => this._provider.upsertAdminOperation(request));
+    }
+    deleteAdminOperation(recordIds) {
+        return this._mutate('admin-operation.delete', { count: recordIds?.length ?? 0 }, () => this._provider.deleteAdminOperation(recordIds));
+    }
+    setAdminOperationGrantee(request) {
+        return this._mutate('admin-operation.set-grantee', { adminOperationId: request?.adminOperationId ?? null }, () => this._provider.setAdminOperationGrantee(request));
+    }
+    deleteAdminOperationGrantee(recordIds) {
+        return this._mutate('admin-operation.delete-grantee', { count: recordIds?.length ?? 0 }, () => this._provider.deleteAdminOperationGrantee(recordIds));
+    }
+}
+exports.AdminOperationEngine = AdminOperationEngine;
+//# sourceMappingURL=admin-operation-engine.js.map

package/dist/creatio/engines/admin-operation-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-operation-engine.js","sourceRoot":"","sources":["../../../src/creatio/engines/admin-operation-engine.ts"],"names":[],"mappings":";;;AAQA,qCAAiD;AAEjD,MAAa,oBAAqB,SAAQ,mBAAU;IAClC,SAAS,CAAyB;IAEnC,IAAI,GAAG,iBAAiB,CAAC;IAEzC,YAAY,QAAgC,EAAE,GAAe;QAC5D,KAAK,CAAC,GAAG,CAAC,CAAC;QACX,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,IAAW,IAAI;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;IAC5B,CAAC;IAEM,oBAAoB,CAC1B,OAAoC;QAEpC,OAAO,IAAI,CAAC,OAAO,CAAC,wBAAwB,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,IAAI,EAAE,EAAE,GAAG,EAAE,CACnF,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAC5C,CAAC;IACH,CAAC;IAEM,oBAAoB,CAAC,SAAmB;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,wBAAwB,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,CACrF,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAC9C,CAAC;IACH,CAAC;IAEM,wBAAwB,CAC9B,OAAwC;QAExC,OAAO,IAAI,CAAC,OAAO,CAClB,6BAA6B,EAC7B,EAAE,gBAAgB,EAAE,OAAO,EAAE,gBAAgB,IAAI,IAAI,EAAE,EACvD,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,wBAAwB,CAAC,OAAO,CAAC,CACtD,CAAC;IACH,CAAC;IAEM,2BAA2B,CAAC,SAAmB;QACrD,OAAO,IAAI,CAAC,OAAO,CAClB,gCAAgC,EAChC,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC,EAAE,EACjC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,2BAA2B,CAAC,SAAS,CAAC,CAC3D,CAAC;IACH,CAAC;CACD;AA7CD,oDA6CC"}

package/dist/creatio/engines/configuration-engine.d.ts

@@ -0,0 +1,10 @@
+import { CallConfigurationServiceRequest, CallConfigurationServiceResult, ConfigurationProvider } from '../contracts';
+import { BaseEngine, EngineEnv } from './engine';
+export declare class ConfigurationEngine extends BaseEngine {
+    private readonly _provider;
+    readonly name = "configuration";
+    constructor(provider: ConfigurationProvider, env?: EngineEnv);
+    get kind(): string;
+    call(request: CallConfigurationServiceRequest): Promise<CallConfigurationServiceResult>;
+}
+//# sourceMappingURL=configuration-engine.d.ts.map

package/dist/creatio/engines/configuration-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration-engine.d.ts","sourceRoot":"","sources":["../../../src/creatio/engines/configuration-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,+BAA+B,EAC/B,8BAA8B,EAC9B,qBAAqB,EACrB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEjD,qBAAa,mBAAoB,SAAQ,UAAU;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAElD,SAAgB,IAAI,mBAAmB;gBAE3B,QAAQ,EAAE,qBAAqB,EAAE,GAAG,CAAC,EAAE,SAAS;IAK5D,IAAW,IAAI,IAAI,MAAM,CAExB;IAEM,IAAI,CAAC,OAAO,EAAE,+BAA+B,GAAG,OAAO,CAAC,8BAA8B,CAAC;CAU9F"}

package/dist/creatio/engines/configuration-engine.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigurationEngine = void 0;
+const engine_1 = require("./engine");
+class ConfigurationEngine extends engine_1.BaseEngine {
+    _provider;
+    name = 'configuration';
+    constructor(provider, env) {
+        super(env);
+        this._provider = provider;
+    }
+    get kind() {
+        return this._provider.kind;
+    }
+    call(request) {
+        // The generic configuration caller can reach mutating endpoints, so it is treated
+        // as a mutation for both the readonly guard and the audit trail (it is also in the
+        // readonly-excluded tool list at the MCP layer).
+        return this._mutate('configuration.call', { service: request?.service, method: request?.method, httpMethod: request?.httpMethod }, () => this._provider.call(request));
+    }
+}
+exports.ConfigurationEngine = ConfigurationEngine;
+//# sourceMappingURL=configuration-engine.js.map

package/dist/creatio/engines/configuration-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration-engine.js","sourceRoot":"","sources":["../../../src/creatio/engines/configuration-engine.ts"],"names":[],"mappings":";;;AAMA,qCAAiD;AAEjD,MAAa,mBAAoB,SAAQ,mBAAU;IACjC,SAAS,CAAwB;IAElC,IAAI,GAAG,eAAe,CAAC;IAEvC,YAAY,QAA+B,EAAE,GAAe;QAC3D,KAAK,CAAC,GAAG,CAAC,CAAC;QACX,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,IAAW,IAAI;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;IAC5B,CAAC;IAEM,IAAI,CAAC,OAAwC;QACnD,kFAAkF;QAClF,mFAAmF;QACnF,iDAAiD;QACjD,OAAO,IAAI,CAAC,OAAO,CAClB,oBAAoB,EACpB,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,EACvF,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAClC,CAAC;IACH,CAAC;CACD;AAxBD,kDAwBC"}

package/dist/creatio/engines/crud-engine.d.ts

@@ -0,0 +1,17 @@
+import { CrudCapabilities, CrudDeleteParams, CrudProvider, CrudUpdateParams, CrudWriteParams, EntitySchemaDescription, ReadQuery, ReadResult } from '../contracts';
+import { BaseEngine, EngineEnv } from './engine';
+export declare class CrudEngine extends BaseEngine {
+    private readonly _provider;
+    readonly name = "crud";
+    constructor(provider: CrudProvider, env?: EngineEnv);
+    get kind(): string;
+    /** Read features the active backend honors — drives which read params the tool registers. */
+    get capabilities(): CrudCapabilities;
+    listEntitySets(): Promise<string[]>;
+    describeEntity(entitySet: string): Promise<EntitySchemaDescription>;
+    read(query: ReadQuery): Promise<ReadResult>;
+    create(params: CrudWriteParams): Promise<any>;
+    update(params: CrudUpdateParams): Promise<any>;
+    delete(params: CrudDeleteParams): Promise<any>;
+}
+//# sourceMappingURL=crud-engine.d.ts.map

package/dist/creatio/engines/crud-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crud-engine.d.ts","sourceRoot":"","sources":["../../../src/creatio/engines/crud-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,uBAAuB,EACvB,SAAS,EACT,UAAU,EACV,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEjD,qBAAa,UAAW,SAAQ,UAAU;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IAEzC,SAAgB,IAAI,UAAU;gBAElB,QAAQ,EAAE,YAAY,EAAE,GAAG,CAAC,EAAE,SAAS;IAKnD,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,6FAA6F;IAC7F,IAAW,YAAY,IAAI,gBAAgB,CAE1C;IAEM,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAInC,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAInE,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IAI3C,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC;IAM7C,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC;IAM9C,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC;CAKrD"}

package/dist/creatio/engines/crud-engine.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CrudEngine = void 0;
+const engine_1 = require("./engine");
+class CrudEngine extends engine_1.BaseEngine {
+    _provider;
+    name = 'crud';
+    constructor(provider, env) {
+        super(env);
+        this._provider = provider;
+    }
+    get kind() {
+        return this._provider.kind;
+    }
+    /** Read features the active backend honors — drives which read params the tool registers. */
+    get capabilities() {
+        return this._provider.capabilities;
+    }
+    listEntitySets() {
+        return this._provider.listEntitySets();
+    }
+    describeEntity(entitySet) {
+        return this._provider.describeEntity(entitySet);
+    }
+    read(query) {
+        return this._provider.read(query);
+    }
+    create(params) {
+        return this._mutate('crud.create', { entity: params.entity }, () => this._provider.create(params));
+    }
+    update(params) {
+        return this._mutate('crud.update', { entity: params.entity, id: params.id }, () => this._provider.update(params));
+    }
+    delete(params) {
+        return this._mutate('crud.delete', { entity: params.entity, id: params.id }, () => this._provider.delete(params));
+    }
+}
+exports.CrudEngine = CrudEngine;
+//# sourceMappingURL=crud-engine.js.map

package/dist/creatio/engines/crud-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crud-engine.js","sourceRoot":"","sources":["../../../src/creatio/engines/crud-engine.ts"],"names":[],"mappings":";;;AAWA,qCAAiD;AAEjD,MAAa,UAAW,SAAQ,mBAAU;IACxB,SAAS,CAAe;IAEzB,IAAI,GAAG,MAAM,CAAC;IAE9B,YAAY,QAAsB,EAAE,GAAe;QAClD,KAAK,CAAC,GAAG,CAAC,CAAC;QACX,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,IAAW,IAAI;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;IAC5B,CAAC;IAED,6FAA6F;IAC7F,IAAW,YAAY;QACtB,OAAO,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC;IACpC,CAAC;IAEM,cAAc;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,CAAC;IACxC,CAAC;IAEM,cAAc,CAAC,SAAiB;QACtC,OAAO,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IACjD,CAAC;IAEM,IAAI,CAAC,KAAgB;QAC3B,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAEM,MAAM,CAAC,MAAuB;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAClE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAC7B,CAAC;IACH,CAAC;IAEM,MAAM,CAAC,MAAwB;QACrC,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CACjF,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAC7B,CAAC;IACH,CAAC;IAEM,MAAM,CAAC,MAAwB;QACrC,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CACjF,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAC7B,CAAC;IACH,CAAC;CACD;AAhDD,gCAgDC"}

package/dist/creatio/engines/engine-manager.d.ts

@@ -1,13 +1,14 @@
 import { CreatioProviderContext } from '../provider-context';
-import { AdminOperationProvider, ConfigurationProvider, CrudProvider, FeatureProvider, ProcessProvider, SysSettingsProvider, UserProvider } from '../providers';
-import { AdminOperationEngine } from './admin-operation/admin-operation-engine';
-import { ConfigurationEngine } from './configuration/configuration-engine';
-import { CrudEngine } from './crud/crud-engine';
+import { AdminOperationProvider, ConfigurationProvider, CrudProvider, FeatureProvider, ProcessProvider, SysSettingsProvider, UserProvider } from '../contracts';
+import { AdminOperationEngine } from './admin-operation-engine';
+import { ConfigurationEngine } from './configuration-engine';
+import { CrudEngine } from './crud-engine';
+import { EngineEnv } from './engine';
 import { EngineRegistry } from './engine-registry';
-import { FeatureEngine } from './feature/feature-engine';
-import { ProcessEngine } from './process/process-engine';
-import { SysSettingsEngine } from './sys-settings/sys-settings-engine';
-import { UserEngine } from './user/user-engine';
+import { FeatureEngine } from './feature-engine';
+import { ProcessEngine } from './process-engine';
+import { SysSettingsEngine } from './sys-settings-engine';
+import { UserEngine } from './user-engine';
 export interface EngineManagerOptions {
     adminOperationProvider?: AdminOperationProvider;
     configurationProvider?: ConfigurationProvider;
@@ -23,13 +24,19 @@ export interface EngineManagerOptions {
     enableProcess?: boolean;
     enableSysSettings?: boolean;
     enableUser?: boolean;
+    /** When true, every mutating engine operation throws {@link ReadonlyModeError}. */
+    readonly?: boolean;
+    /** Override the audit sink (defaults to `log.audit`). */
+    audit?: EngineEnv['audit'];
 }
 export declare class CreatioEngineManager {
     private readonly _context;
     private readonly _options;
     private readonly _registry;
     private readonly _engines;
+    private readonly _env;
     get authProvider(): import("..").ICreatioAuthProvider;
+    get readonly(): boolean;
     get registry(): EngineRegistry;
     get adminOperation(): AdminOperationEngine;
     get configuration(): ConfigurationEngine;

package/dist/creatio/engines/engine-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine-manager.d.ts","sourceRoot":"","sources":["../../../src/creatio/engines/engine-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EACN,sBAAsB,EACtB,qBAAqB,EACrB,YAAY,EACZ,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,OAAO,EAAE,cAAc,EAAc,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,MAAM,WAAW,oBAAoB;IACpC,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;IAChD,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;IAC9C,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,oBAAoB;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAC5D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAClD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAE7D,IAAW,YAAY,sCAEtB;IAED,IAAW,QAAQ,IAAI,cAAc,CAEpC;IAED,IAAW,cAAc,IAAI,oBAAoB,CAEhD;IAED,IAAW,aAAa,IAAI,mBAAmB,CAE9C;IAED,IAAW,IAAI,IAAI,UAAU,CAE5B;IAED,IAAW,OAAO,IAAI,aAAa,CAElC;IAED,IAAW,OAAO,IAAI,aAAa,CAElC;IAED,IAAW,WAAW,IAAI,iBAAiB,CAE1C;IAED,IAAW,IAAI,IAAI,UAAU,CAE5B;gBAEW,OAAO,EAAE,sBAAsB,EAAE,OAAO,CAAC,EAAE,oBAAoB;IAM3E,OAAO,CAAC,WAAW;IA0DnB,OAAO,CAAC,eAAe;CAYvB"}
+{"version":3,"file":"engine-manager.d.ts","sourceRoot":"","sources":["../../../src/creatio/engines/engine-manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EACN,sBAAsB,EACtB,qBAAqB,EACrB,YAAY,EACZ,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAiB,SAAS,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,cAAc,EAAc,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,MAAM,WAAW,oBAAoB;IACpC,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;IAChD,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;IAC9C,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yDAAyD;IACzD,KAAK,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;CAC3B;AAED,qBAAa,oBAAoB;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAC5D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAClD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAC7D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAY;IAEjC,IAAW,YAAY,sCAEtB;IAED,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAED,IAAW,QAAQ,IAAI,cAAc,CAEpC;IAED,IAAW,cAAc,IAAI,oBAAoB,CAEhD;IAED,IAAW,aAAa,IAAI,mBAAmB,CAE9C;IAED,IAAW,IAAI,IAAI,UAAU,CAE5B;IAED,IAAW,OAAO,IAAI,aAAa,CAElC;IAED,IAAW,OAAO,IAAI,aAAa,CAElC;IAED,IAAW,WAAW,IAAI,iBAAiB,CAE1C;IAED,IAAW,IAAI,IAAI,UAAU,CAE5B;gBAEW,OAAO,EAAE,sBAAsB,EAAE,OAAO,CAAC,EAAE,oBAAoB;IAU3E,OAAO,CAAC,WAAW;IAqEnB,OAAO,CAAC,eAAe;CAYvB"}

package/dist/creatio/engines/engine-manager.js

@@ -1,22 +1,30 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CreatioEngineManager = void 0;
-const admin_operation_engine_1 = require("./admin-operation/admin-operation-engine");
-const configuration_engine_1 = require("./configuration/configuration-engine");
-const crud_engine_1 = require("./crud/crud-engine");
+const log_1 = __importDefault(require("../../log"));
+const admin_operation_engine_1 = require("./admin-operation-engine");
+const configuration_engine_1 = require("./configuration-engine");
+const crud_engine_1 = require("./crud-engine");
 const engine_registry_1 = require("./engine-registry");
-const feature_engine_1 = require("./feature/feature-engine");
-const process_engine_1 = require("./process/process-engine");
-const sys_settings_engine_1 = require("./sys-settings/sys-settings-engine");
-const user_engine_1 = require("./user/user-engine");
+const feature_engine_1 = require("./feature-engine");
+const process_engine_1 = require("./process-engine");
+const sys_settings_engine_1 = require("./sys-settings-engine");
+const user_engine_1 = require("./user-engine");
 class CreatioEngineManager {
     _context;
     _options;
     _registry = new engine_registry_1.EngineRegistry();
     _engines = new Map();
+    _env;
     get authProvider() {
         return this._context.authProvider;
     }
+    get readonly() {
+        return this._env.readonly;
+    }
     get registry() {
         return this._registry;
     }
@@ -44,19 +52,23 @@ class CreatioEngineManager {
     constructor(context, options) {
         this._context = context;
         this._options = options;
+        this._env = {
+            readonly: options?.readonly ?? false,
+            audit: options?.audit ?? ((action, details) => log_1.default.audit(action, details)),
+        };
         this._initialize();
     }
     _initialize() {
         this._registerEngine(engine_registry_1.EngineType.AdminOperation, () => new admin_operation_engine_1.AdminOperationEngine(this._options?.adminOperationProvider ??
-            this._context.adminOperation), this._options?.enableAdminOperation ?? true);
+            this._context.adminOperation, this._env), this._options?.enableAdminOperation ?? true);
         this._registerEngine(engine_registry_1.EngineType.Configuration, () => new configuration_engine_1.ConfigurationEngine(this._options?.configurationProvider ??
-            this._context.configuration), this._options?.enableConfiguration ?? true);
-        this._registerEngine(engine_registry_1.EngineType.Crud, () => new crud_engine_1.CrudEngine(this._options?.crudProvider ?? this._context.crud), this._options?.enableCrud ?? true);
-        this._registerEngine(engine_registry_1.EngineType.Feature, () => new feature_engine_1.FeatureEngine(this._options?.featureProvider ?? this._context.feature), this._options?.enableFeature ?? true);
-        this._registerEngine(engine_registry_1.EngineType.Process, () => new process_engine_1.ProcessEngine(this._options?.processProvider ?? this._context.process), this._options?.enableProcess ?? true);
+            this._context.configuration, this._env), this._options?.enableConfiguration ?? true);
+        this._registerEngine(engine_registry_1.EngineType.Crud, () => new crud_engine_1.CrudEngine(this._options?.crudProvider ?? this._context.crud, this._env), this._options?.enableCrud ?? true);
+        this._registerEngine(engine_registry_1.EngineType.Feature, () => new feature_engine_1.FeatureEngine(this._options?.featureProvider ?? this._context.feature, this._env), this._options?.enableFeature ?? true);
+        this._registerEngine(engine_registry_1.EngineType.Process, () => new process_engine_1.ProcessEngine(this._options?.processProvider ?? this._context.process, this._env), this._options?.enableProcess ?? true);
         this._registerEngine(engine_registry_1.EngineType.SysSettings, () => new sys_settings_engine_1.SysSettingsEngine(this._options?.sysSettingsProvider ??
-            this._context.sysSettings), this._options?.enableSysSettings ?? true);
-        this._registerEngine(engine_registry_1.EngineType.User, () => new user_engine_1.UserEngine(this._options?.userProvider ?? this._context.user), this._options?.enableUser ?? true);
+            this._context.sysSettings, this._env), this._options?.enableSysSettings ?? true);
+        this._registerEngine(engine_registry_1.EngineType.User, () => new user_engine_1.UserEngine(this._options?.userProvider ?? this._context.user, this._env), this._options?.enableUser ?? true);
     }
     _registerEngine(type, factory, enabled) {
         if (!enabled) {

package/dist/creatio/engines/engine-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"engine-manager.js","sourceRoot":"","sources":["../../../src/creatio/engines/engine-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"engine-manager.js","sourceRoot":"","sources":["../../../src/creatio/engines/engine-manager.ts"],"names":[],"mappings":"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"}

package/dist/creatio/engines/engine.d.ts

@@ -1,4 +1,40 @@
 export interface CreatioEngine {
     readonly name: string;
 }
+/**
+ * Domain-level cross-cutting context shared by every engine. It lives ABOVE the
+ * provider interface so the behaviour is written once and applies uniformly to every
+ * CRUD backend (OData today, DataService next). Two concerns live here:
+ *
+ * - `readonly` — a defense-in-depth guard. The MCP layer already avoids registering
+ *   mutating tools in readonly mode; this guarantees a mutation throws even if some
+ *   future caller reaches an engine directly.
+ * - `audit` — a security-relevant trail for every mutation, independent of transport.
+ */
+export interface EngineEnv {
+    readonly readonly: boolean;
+    audit(action: string, details?: Record<string, unknown>): void;
+}
+/** Thrown when a mutating engine operation is attempted while `readonly` is on. */
+export declare class ReadonlyModeError extends Error {
+    readonly action: string;
+    constructor(action: string);
+}
+/** Default env: mutations allowed, audit → structured info log. Used when an engine is
+ *  built without an explicit env (keeps direct construction in tests effortless). */
+export declare const DEFAULT_ENGINE_ENV: EngineEnv;
+/**
+ * Base for engines. Holds the shared {@link EngineEnv} and centralizes the readonly
+ * guard + audit trail for mutating operations so concrete engines never repeat it and
+ * the providers below stay free of cross-cutting policy.
+ */
+export declare abstract class BaseEngine implements CreatioEngine {
+    abstract readonly name: string;
+    protected readonly _env: EngineEnv;
+    constructor(env?: EngineEnv);
+    /** Guard (readonly) + audit a mutating operation, then run it. Always returns a
+     *  promise (a readonly violation surfaces as a rejection, never a synchronous throw)
+     *  so callers can rely on a single `.catch`/`await` path. */
+    protected _mutate<T>(action: string, details: Record<string, unknown>, run: () => Promise<T>): Promise<T>;
+}
 //# sourceMappingURL=engine.d.ts.map

package/dist/creatio/engines/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/creatio/engines/engine.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/creatio/engines/engine.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC/D;AAED,mFAAmF;AACnF,qBAAa,iBAAkB,SAAQ,KAAK;IAC3C,SAAgB,MAAM,EAAE,MAAM,CAAC;gBAEnB,MAAM,EAAE,MAAM;CAK1B;AAED;qFACqF;AACrF,eAAO,MAAM,kBAAkB,EAAE,SAGhC,CAAC;AAEF;;;;GAIG;AACH,8BAAsB,UAAW,YAAW,aAAa;IACxD,kBAAyB,IAAI,EAAE,MAAM,CAAC;IAEtC,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;gBAEvB,GAAG,GAAE,SAA8B;IAI/C;;iEAE6D;cAC7C,OAAO,CAAC,CAAC,EACxB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC;CAOb"}

package/dist/creatio/engines/engine.js

@@ -1,3 +1,46 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseEngine = exports.DEFAULT_ENGINE_ENV = exports.ReadonlyModeError = void 0;
+const log_1 = __importDefault(require("../../log"));
+/** Thrown when a mutating engine operation is attempted while `readonly` is on. */
+class ReadonlyModeError extends Error {
+    action;
+    constructor(action) {
+        super(`readonly_mode_blocked:${action}`);
+        this.name = 'ReadonlyModeError';
+        this.action = action;
+    }
+}
+exports.ReadonlyModeError = ReadonlyModeError;
+/** Default env: mutations allowed, audit → structured info log. Used when an engine is
+ *  built without an explicit env (keeps direct construction in tests effortless). */
+exports.DEFAULT_ENGINE_ENV = {
+    readonly: false,
+    audit: (action, details) => log_1.default.audit(action, details),
+};
+/**
+ * Base for engines. Holds the shared {@link EngineEnv} and centralizes the readonly
+ * guard + audit trail for mutating operations so concrete engines never repeat it and
+ * the providers below stay free of cross-cutting policy.
+ */
+class BaseEngine {
+    _env;
+    constructor(env = exports.DEFAULT_ENGINE_ENV) {
+        this._env = env;
+    }
+    /** Guard (readonly) + audit a mutating operation, then run it. Always returns a
+     *  promise (a readonly violation surfaces as a rejection, never a synchronous throw)
+     *  so callers can rely on a single `.catch`/`await` path. */
+    async _mutate(action, details, run) {
+        if (this._env.readonly) {
+            throw new ReadonlyModeError(action);
+        }
+        this._env.audit(action, details);
+        return run();
+    }
+}
+exports.BaseEngine = BaseEngine;
 //# sourceMappingURL=engine.js.map

package/dist/creatio/engines/engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../../src/creatio/engines/engine.ts"],"names":[],"mappings":""}
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../../src/creatio/engines/engine.ts"],"names":[],"mappings":";;;;;;AAAA,oDAA4B;AAqB5B,mFAAmF;AACnF,MAAa,iBAAkB,SAAQ,KAAK;IAC3B,MAAM,CAAS;IAE/B,YAAY,MAAc;QACzB,KAAK,CAAC,yBAAyB,MAAM,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACtB,CAAC;CACD;AARD,8CAQC;AAED;qFACqF;AACxE,QAAA,kBAAkB,GAAc;IAC5C,QAAQ,EAAE,KAAK;IACf,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,aAAG,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC;CACtD,CAAC;AAEF;;;;GAIG;AACH,MAAsB,UAAU;IAGZ,IAAI,CAAY;IAEnC,YAAY,MAAiB,0BAAkB;QAC9C,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;IACjB,CAAC;IAED;;iEAE6D;IACnD,KAAK,CAAC,OAAO,CACtB,MAAc,EACd,OAAgC,EAChC,GAAqB;QAErB,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACxB,MAAM,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,OAAO,GAAG,EAAE,CAAC;IACd,CAAC;CACD;AAvBD,gCAuBC"}

package/dist/creatio/engines/feature-engine.d.ts

@@ -0,0 +1,10 @@
+import { ClearFeatureCacheResult, FeatureProvider } from '../contracts';
+import { BaseEngine, EngineEnv } from './engine';
+export declare class FeatureEngine extends BaseEngine {
+    private readonly _provider;
+    readonly name = "feature";
+    constructor(provider: FeatureProvider, env?: EngineEnv);
+    get kind(): string;
+    clearFeaturesCache(featureCode?: string): Promise<ClearFeatureCacheResult>;
+}
+//# sourceMappingURL=feature-engine.d.ts.map

package/dist/creatio/engines/feature-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-engine.d.ts","sourceRoot":"","sources":["../../../src/creatio/engines/feature-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAExE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEjD,qBAAa,aAAc,SAAQ,UAAU;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAE5C,SAAgB,IAAI,aAAa;gBAErB,QAAQ,EAAE,eAAe,EAAE,GAAG,CAAC,EAAE,SAAS;IAKtD,IAAW,IAAI,IAAI,MAAM,CAExB;IAEM,kBAAkB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;CAKjF"}

package/dist/creatio/engines/{feature/feature-engine.js → feature-engine.js}

@@ -1,17 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FeatureEngine = void 0;
-class FeatureEngine {
+const engine_1 = require("./engine");
+class FeatureEngine extends engine_1.BaseEngine {
     _provider;
     name = 'feature';
-    constructor(provider) {
+    constructor(provider, env) {
+        super(env);
         this._provider = provider;
     }
     get kind() {
         return this._provider.kind;
     }
     clearFeaturesCache(featureCode) {
-        return this._provider.clearFeaturesCache(featureCode);
+        return this._mutate('feature.clear-cache', { featureCode: featureCode ?? null }, () => this._provider.clearFeaturesCache(featureCode));
     }
 }
 exports.FeatureEngine = FeatureEngine;

package/dist/creatio/engines/feature-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-engine.js","sourceRoot":"","sources":["../../../src/creatio/engines/feature-engine.ts"],"names":[],"mappings":";;;AAEA,qCAAiD;AAEjD,MAAa,aAAc,SAAQ,mBAAU;IAC3B,SAAS,CAAkB;IAE5B,IAAI,GAAG,SAAS,CAAC;IAEjC,YAAY,QAAyB,EAAE,GAAe;QACrD,KAAK,CAAC,GAAG,CAAC,CAAC;QACX,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,IAAW,IAAI;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;IAC5B,CAAC;IAEM,kBAAkB,CAAC,WAAoB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,EAAE,WAAW,EAAE,WAAW,IAAI,IAAI,EAAE,EAAE,GAAG,EAAE,CACrF,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAC9C,CAAC;IACH,CAAC;CACD;AAnBD,sCAmBC"}

package/dist/creatio/engines/index.d.ts

@@ -1,11 +1,11 @@
 export * from './engine';
 export * from './engine-manager';
 export * from './engine-registry';
-export * from './admin-operation/admin-operation-engine';
-export * from './configuration/configuration-engine';
-export * from './crud/crud-engine';
-export * from './feature/feature-engine';
-export * from './process/process-engine';
-export * from './sys-settings/sys-settings-engine';
-export * from './user/user-engine';
+export * from './admin-operation-engine';
+export * from './configuration-engine';
+export * from './crud-engine';
+export * from './feature-engine';
+export * from './process-engine';
+export * from './sys-settings-engine';
+export * from './user-engine';
 //# sourceMappingURL=index.d.ts.map

package/dist/creatio/engines/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/creatio/engines/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0CAA0C,CAAC;AACzD,cAAc,sCAAsC,CAAC;AACrD,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oCAAoC,CAAC;AACnD,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/creatio/engines/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC"}

package/dist/creatio/engines/index.js

@@ -17,11 +17,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./engine"), exports);
 __exportStar(require("./engine-manager"), exports);
 __exportStar(require("./engine-registry"), exports);
-__exportStar(require("./admin-operation/admin-operation-engine"), exports);
-__exportStar(require("./configuration/configuration-engine"), exports);
-__exportStar(require("./crud/crud-engine"), exports);
-__exportStar(require("./feature/feature-engine"), exports);
-__exportStar(require("./process/process-engine"), exports);
-__exportStar(require("./sys-settings/sys-settings-engine"), exports);
-__exportStar(require("./user/user-engine"), exports);
+__exportStar(require("./admin-operation-engine"), exports);
+__exportStar(require("./configuration-engine"), exports);
+__exportStar(require("./crud-engine"), exports);
+__exportStar(require("./feature-engine"), exports);
+__exportStar(require("./process-engine"), exports);
+__exportStar(require("./sys-settings-engine"), exports);
+__exportStar(require("./user-engine"), exports);
 //# sourceMappingURL=index.js.map

package/dist/creatio/engines/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/creatio/engines/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,mDAAiC;AACjC,oDAAkC;AAClC,2EAAyD;AACzD,uEAAqD;AACrD,qDAAmC;AACnC,2DAAyC;AACzC,2DAAyC;AACzC,qEAAmD;AACnD,qDAAmC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/creatio/engines/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,mDAAiC;AACjC,oDAAkC;AAClC,2DAAyC;AACzC,yDAAuC;AACvC,gDAA8B;AAC9B,mDAAiC;AACjC,mDAAiC;AACjC,wDAAsC;AACtC,gDAA8B"}

package/dist/creatio/engines/process-engine.d.ts

@@ -0,0 +1,10 @@
+import { ExecuteProcessParams, ExecuteProcessResult, ProcessProvider } from '../contracts';
+import { BaseEngine, EngineEnv } from './engine';
+export declare class ProcessEngine extends BaseEngine {
+    private readonly _provider;
+    readonly name = "process";
+    constructor(provider: ProcessProvider, env?: EngineEnv);
+    get kind(): string;
+    execute(params: ExecuteProcessParams): Promise<ExecuteProcessResult>;
+}
+//# sourceMappingURL=process-engine.d.ts.map

package/dist/creatio/engines/process-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-engine.d.ts","sourceRoot":"","sources":["../../../src/creatio/engines/process-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE3F,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEjD,qBAAa,aAAc,SAAQ,UAAU;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAE5C,SAAgB,IAAI,aAAa;gBAErB,QAAQ,EAAE,eAAe,EAAE,GAAG,CAAC,EAAE,SAAS;IAKtD,IAAW,IAAI,IAAI,MAAM,CAExB;IAEM,OAAO,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAK3E"}

package/dist/creatio/engines/{process/process-engine.js → process-engine.js}

@@ -1,17 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ProcessEngine = void 0;
-class ProcessEngine {
+const engine_1 = require("./engine");
+class ProcessEngine extends engine_1.BaseEngine {
     _provider;
     name = 'process';
-    constructor(provider) {
+    constructor(provider, env) {
+        super(env);
         this._provider = provider;
     }
     get kind() {
         return this._provider.kind;
     }
     execute(params) {
-        return this._provider.executeProcess(params);
+        return this._mutate('process.execute', { processName: params.processName }, () => this._provider.executeProcess(params));
     }
 }
 exports.ProcessEngine = ProcessEngine;

package/dist/creatio/engines/process-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-engine.js","sourceRoot":"","sources":["../../../src/creatio/engines/process-engine.ts"],"names":[],"mappings":";;;AAEA,qCAAiD;AAEjD,MAAa,aAAc,SAAQ,mBAAU;IAC3B,SAAS,CAAkB;IAE5B,IAAI,GAAG,SAAS,CAAC;IAEjC,YAAY,QAAyB,EAAE,GAAe;QACrD,KAAK,CAAC,GAAG,CAAC,CAAC;QACX,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,IAAW,IAAI;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;IAC5B,CAAC;IAEM,OAAO,CAAC,MAA4B;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,EAAE,GAAG,EAAE,CAChF,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,CACrC,CAAC;IACH,CAAC;CACD;AAnBD,sCAmBC"}

package/dist/creatio/engines/{sys-settings/sys-settings-engine.d.ts → sys-settings-engine.d.ts}

@@ -1,9 +1,9 @@
-import { CreateSysSettingRequest, CreateSysSettingResult, QuerySysSettingsResponse, SysSettingDefinitionUpdate, SysSettingUpdateResponse, SysSettingsProvider } from '../../providers';
-import { CreatioEngine } from '../engine';
-export declare class SysSettingsEngine implements CreatioEngine {
+import { CreateSysSettingRequest, CreateSysSettingResult, QuerySysSettingsResponse, SysSettingDefinitionUpdate, SysSettingUpdateResponse, SysSettingsProvider } from '../contracts';
+import { BaseEngine, EngineEnv } from './engine';
+export declare class SysSettingsEngine extends BaseEngine {
     private readonly _provider;
     readonly name = "sys-settings";
-    constructor(provider: SysSettingsProvider);
+    constructor(provider: SysSettingsProvider, env?: EngineEnv);
     get kind(): string;
     setValues(values: Record<string, any>): Promise<any>;
     queryValues(codes: string[]): Promise<QuerySysSettingsResponse>;

package/dist/creatio/engines/sys-settings-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sys-settings-engine.d.ts","sourceRoot":"","sources":["../../../src/creatio/engines/sys-settings-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,EACxB,mBAAmB,EACnB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEjD,qBAAa,iBAAkB,SAAQ,UAAU;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAEhD,SAAgB,IAAI,kBAAkB;gBAE1B,QAAQ,EAAE,mBAAmB,EAAE,GAAG,CAAC,EAAE,SAAS;IAK1D,IAAW,IAAI,IAAI,MAAM,CAExB;IAEM,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAMpD,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAI/D,aAAa,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAQhF,gBAAgB,CACtB,UAAU,EAAE,0BAA0B,GACpC,OAAO,CAAC,wBAAwB,CAAC;CAOpC"}

package/dist/creatio/engines/sys-settings-engine.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SysSettingsEngine = void 0;
+const engine_1 = require("./engine");
+class SysSettingsEngine extends engine_1.BaseEngine {
+    _provider;
+    name = 'sys-settings';
+    constructor(provider, env) {
+        super(env);
+        this._provider = provider;
+    }
+    get kind() {
+        return this._provider.kind;
+    }
+    setValues(values) {
+        return this._mutate('sys-settings.set-values', { codes: Object.keys(values ?? {}) }, () => this._provider.setValues(values));
+    }
+    queryValues(codes) {
+        return this._provider.queryValues(codes);
+    }
+    createSetting(request) {
+        return this._mutate('sys-settings.create', { code: request?.definition?.code ?? null }, () => this._provider.createSetting(request));
+    }
+    updateDefinition(definition) {
+        return this._mutate('sys-settings.update-definition', { id: definition?.id ?? null }, () => this._provider.updateDefinition(definition));
+    }
+}
+exports.SysSettingsEngine = SysSettingsEngine;
+//# sourceMappingURL=sys-settings-engine.js.map

package/dist/creatio/engines/sys-settings-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sys-settings-engine.js","sourceRoot":"","sources":["../../../src/creatio/engines/sys-settings-engine.ts"],"names":[],"mappings":";;;AASA,qCAAiD;AAEjD,MAAa,iBAAkB,SAAQ,mBAAU;IAC/B,SAAS,CAAsB;IAEhC,IAAI,GAAG,cAAc,CAAC;IAEtC,YAAY,QAA6B,EAAE,GAAe;QACzD,KAAK,CAAC,GAAG,CAAC,CAAC;QACX,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,IAAW,IAAI;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;IAC5B,CAAC;IAEM,SAAS,CAAC,MAA2B;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,yBAAyB,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,CACzF,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,CAChC,CAAC;IACH,CAAC;IAEM,WAAW,CAAC,KAAe;QACjC,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;IAEM,aAAa,CAAC,OAAgC;QACpD,OAAO,IAAI,CAAC,OAAO,CAClB,qBAAqB,EACrB,EAAE,IAAI,EAAG,OAAO,EAAE,UAAkB,EAAE,IAAI,IAAI,IAAI,EAAE,EACpD,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,OAAO,CAAC,CAC3C,CAAC;IACH,CAAC;IAEM,gBAAgB,CACtB,UAAsC;QAEtC,OAAO,IAAI,CAAC,OAAO,CAClB,gCAAgC,EAChC,EAAE,EAAE,EAAG,UAAkB,EAAE,EAAE,IAAI,IAAI,EAAE,EACvC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,UAAU,CAAC,CACjD,CAAC;IACH,CAAC;CACD;AAzCD,8CAyCC"}

package/dist/creatio/engines/user-engine.d.ts

@@ -0,0 +1,10 @@
+import { CurrentUserInfo, UserProvider } from '../contracts';
+import { BaseEngine, EngineEnv } from './engine';
+export declare class UserEngine extends BaseEngine {
+    private readonly _provider;
+    readonly name = "user";
+    constructor(provider: UserProvider, env?: EngineEnv);
+    get kind(): string;
+    getCurrentUserInfo(): Promise<CurrentUserInfo>;
+}
+//# sourceMappingURL=user-engine.d.ts.map

package/dist/creatio/engines/user-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-engine.d.ts","sourceRoot":"","sources":["../../../src/creatio/engines/user-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE7D,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEjD,qBAAa,UAAW,SAAQ,UAAU;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IAEzC,SAAgB,IAAI,UAAU;gBAElB,QAAQ,EAAE,YAAY,EAAE,GAAG,CAAC,EAAE,SAAS;IAKnD,IAAW,IAAI,IAAI,MAAM,CAExB;IAEM,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC;CAGrD"}