mcp-creatio 0.4.0 → 0.5.0

package/src/creatio/engines/engine-manager.ts

@@ -1,157 +0,0 @@
-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 { CreatioEngine } from './engine';
-import { EngineRegistry, EngineType } 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';
-
-export interface EngineManagerOptions {
-	adminOperationProvider?: AdminOperationProvider;
-	configurationProvider?: ConfigurationProvider;
-	crudProvider?: CrudProvider;
-	featureProvider?: FeatureProvider;
-	processProvider?: ProcessProvider;
-	sysSettingsProvider?: SysSettingsProvider;
-	userProvider?: UserProvider;
-	enableAdminOperation?: boolean;
-	enableConfiguration?: boolean;
-	enableCrud?: boolean;
-	enableFeature?: boolean;
-	enableProcess?: boolean;
-	enableSysSettings?: boolean;
-	enableUser?: boolean;
-}
-
-export class CreatioEngineManager {
-	private readonly _context: CreatioProviderContext;
-	private readonly _options: EngineManagerOptions | undefined;
-	private readonly _registry = new EngineRegistry();
-	private readonly _engines = new Map<string, CreatioEngine>();
-
-	public get authProvider() {
-		return this._context.authProvider;
-	}
-
-	public get registry(): EngineRegistry {
-		return this._registry;
-	}
-
-	public get adminOperation(): AdminOperationEngine {
-		return this._registry.require<AdminOperationEngine>(EngineType.AdminOperation);
-	}
-
-	public get configuration(): ConfigurationEngine {
-		return this._registry.require<ConfigurationEngine>(EngineType.Configuration);
-	}
-
-	public get crud(): CrudEngine {
-		return this._registry.require<CrudEngine>(EngineType.Crud);
-	}
-
-	public get feature(): FeatureEngine {
-		return this._registry.require<FeatureEngine>(EngineType.Feature);
-	}
-
-	public get process(): ProcessEngine {
-		return this._registry.require<ProcessEngine>(EngineType.Process);
-	}
-
-	public get sysSettings(): SysSettingsEngine {
-		return this._registry.require<SysSettingsEngine>(EngineType.SysSettings);
-	}
-
-	public get user(): UserEngine {
-		return this._registry.require<UserEngine>(EngineType.User);
-	}
-
-	constructor(context: CreatioProviderContext, options?: EngineManagerOptions) {
-		this._context = context;
-		this._options = options;
-		this._initialize();
-	}
-
-	private _initialize() {
-		this._registerEngine(
-			EngineType.AdminOperation,
-			() =>
-				new AdminOperationEngine(
-					this._options?.adminOperationProvider ??
-						(this._context.adminOperation as AdminOperationProvider),
-				),
-			this._options?.enableAdminOperation ?? true,
-		);
-		this._registerEngine(
-			EngineType.Configuration,
-			() =>
-				new ConfigurationEngine(
-					this._options?.configurationProvider ??
-						(this._context.configuration as ConfigurationProvider),
-				),
-			this._options?.enableConfiguration ?? true,
-		);
-		this._registerEngine(
-			EngineType.Crud,
-			() =>
-				new CrudEngine(this._options?.crudProvider ?? (this._context.crud as CrudProvider)),
-			this._options?.enableCrud ?? true,
-		);
-		this._registerEngine(
-			EngineType.Feature,
-			() =>
-				new FeatureEngine(
-					this._options?.featureProvider ?? (this._context.feature as FeatureProvider),
-				),
-			this._options?.enableFeature ?? true,
-		);
-		this._registerEngine(
-			EngineType.Process,
-			() =>
-				new ProcessEngine(
-					this._options?.processProvider ?? (this._context.process as ProcessProvider),
-				),
-			this._options?.enableProcess ?? true,
-		);
-		this._registerEngine(
-			EngineType.SysSettings,
-			() =>
-				new SysSettingsEngine(
-					this._options?.sysSettingsProvider ??
-						(this._context.sysSettings as SysSettingsProvider),
-				),
-			this._options?.enableSysSettings ?? true,
-		);
-		this._registerEngine(
-			EngineType.User,
-			() =>
-				new UserEngine(this._options?.userProvider ?? (this._context.user as UserProvider)),
-			this._options?.enableUser ?? true,
-		);
-	}
-
-	private _registerEngine<T extends CreatioEngine>(
-		type: EngineType,
-		factory: () => T,
-		enabled: boolean,
-	) {
-		if (!enabled) {
-			return;
-		}
-		const engine = factory();
-		this._engines.set(type, engine);
-		this._registry.register(engine);
-	}
-}

package/src/creatio/engines/engine-registry.ts

@@ -1,39 +0,0 @@
-import { CreatioEngine } from './engine';
-
-export enum EngineType {
-	AdminOperation = 'admin-operation',
-	Configuration = 'configuration',
-	Crud = 'crud',
-	Feature = 'feature',
-	Process = 'process',
-	SysSettings = 'sys-settings',
-	User = 'user',
-}
-
-export class EngineRegistry {
-	private readonly _engines = new Map<string, CreatioEngine>();
-
-	public register(engine: CreatioEngine): CreatioEngine {
-		if (this._engines.has(engine.name)) {
-			throw new Error(`engine_already_registered:${engine.name}`);
-		}
-		this._engines.set(engine.name, engine);
-		return engine;
-	}
-
-	public get<T extends CreatioEngine = CreatioEngine>(name: string): T | undefined {
-		return this._engines.get(name) as T | undefined;
-	}
-
-	public require<T extends CreatioEngine = CreatioEngine>(name: string): T {
-		const engine = this.get<T>(name);
-		if (!engine) {
-			throw new Error(`engine_not_registered:${name}`);
-		}
-		return engine;
-	}
-
-	public entries(): IterableIterator<[string, CreatioEngine]> {
-		return this._engines.entries();
-	}
-}

package/src/creatio/engines/engine.ts

@@ -1,3 +0,0 @@
-export interface CreatioEngine {
-	readonly name: string;
-}

package/src/creatio/engines/feature/feature-engine.ts

@@ -1,20 +0,0 @@
-import { ClearFeatureCacheResult, FeatureProvider } from '../../providers';
-import { CreatioEngine } from '../engine';
-
-export class FeatureEngine implements CreatioEngine {
-	private readonly _provider: FeatureProvider;
-
-	public readonly name = 'feature';
-
-	constructor(provider: FeatureProvider) {
-		this._provider = provider;
-	}
-
-	public get kind(): string {
-		return this._provider.kind;
-	}
-
-	public clearFeaturesCache(featureCode?: string): Promise<ClearFeatureCacheResult> {
-		return this._provider.clearFeaturesCache(featureCode);
-	}
-}

package/src/creatio/engines/index.ts

@@ -1,10 +0,0 @@
-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';

package/src/creatio/engines/process/process-engine.ts

@@ -1,20 +0,0 @@
-import { ExecuteProcessParams, ExecuteProcessResult, ProcessProvider } from '../../providers';
-import { CreatioEngine } from '../engine';
-
-export class ProcessEngine implements CreatioEngine {
-	private readonly _provider: ProcessProvider;
-
-	public readonly name = 'process';
-
-	constructor(provider: ProcessProvider) {
-		this._provider = provider;
-	}
-
-	public get kind(): string {
-		return this._provider.kind;
-	}
-
-	public execute(params: ExecuteProcessParams): Promise<ExecuteProcessResult> {
-		return this._provider.executeProcess(params);
-	}
-}

package/src/creatio/engines/sys-settings/sys-settings-engine.ts

@@ -1,41 +0,0 @@
-import {
-	CreateSysSettingRequest,
-	CreateSysSettingResult,
-	QuerySysSettingsResponse,
-	SysSettingDefinitionUpdate,
-	SysSettingUpdateResponse,
-	SysSettingsProvider,
-} from '../../providers';
-import { CreatioEngine } from '../engine';
-
-export class SysSettingsEngine implements CreatioEngine {
-	private readonly _provider: SysSettingsProvider;
-
-	public readonly name = 'sys-settings';
-
-	constructor(provider: SysSettingsProvider) {
-		this._provider = provider;
-	}
-
-	public get kind(): string {
-		return this._provider.kind;
-	}
-
-	public setValues(values: Record<string, any>): Promise<any> {
-		return this._provider.setValues(values);
-	}
-
-	public queryValues(codes: string[]): Promise<QuerySysSettingsResponse> {
-		return this._provider.queryValues(codes);
-	}
-
-	public createSetting(request: CreateSysSettingRequest): Promise<CreateSysSettingResult> {
-		return this._provider.createSetting(request);
-	}
-
-	public updateDefinition(
-		definition: SysSettingDefinitionUpdate,
-	): Promise<SysSettingUpdateResponse> {
-		return this._provider.updateDefinition(definition);
-	}
-}

package/src/creatio/engines/user/user-engine.ts

@@ -1,20 +0,0 @@
-import { CurrentUserInfo, UserProvider } from '../../providers';
-import { CreatioEngine } from '../engine';
-
-export class UserEngine implements CreatioEngine {
-	private readonly _provider: UserProvider;
-
-	public readonly name = 'user';
-
-	constructor(provider: UserProvider) {
-		this._provider = provider;
-	}
-
-	public get kind(): string {
-		return this._provider.kind;
-	}
-
-	public getCurrentUserInfo(): Promise<CurrentUserInfo> {
-		return this._provider.getCurrentUserInfo();
-	}
-}

package/src/creatio/index.ts

@@ -1,6 +0,0 @@
-export * from './client-config';
-export * from './provider-context';
-export * from './providers';
-export * from './engines';
-export * from './services';
-export * from './auth';

package/src/creatio/provider-context.ts

@@ -1,21 +0,0 @@
-import { ICreatioAuthProvider } from './auth';
-import {
-	AdminOperationProvider,
-	ConfigurationProvider,
-	CrudProvider,
-	FeatureProvider,
-	ProcessProvider,
-	SysSettingsProvider,
-	UserProvider,
-} from './providers';
-
-export interface CreatioProviderContext {
-	authProvider: ICreatioAuthProvider;
-	adminOperation: AdminOperationProvider;
-	configuration: ConfigurationProvider;
-	crud: CrudProvider;
-	feature: FeatureProvider;
-	process: ProcessProvider;
-	sysSettings: SysSettingsProvider;
-	user: UserProvider;
-}

package/src/creatio/providers/admin-operation-provider.ts

@@ -1,34 +0,0 @@
-export interface AdminOperationServiceResult {
-	success: boolean;
-	exMessage?: string;
-	[key: string]: unknown;
-}
-
-export interface UpsertAdminOperationRequest {
-	id?: string;
-	name: string;
-	code: string;
-	description?: string;
-}
-
-export interface UpsertAdminOperationResult extends AdminOperationServiceResult {
-	id?: string;
-}
-
-export interface SetAdminOperationGranteeRequest {
-	adminOperationId: string;
-	adminUnitIds: string[];
-	canExecute: boolean;
-}
-
-export interface AdminOperationProvider {
-	readonly kind: string;
-	upsertAdminOperation(
-		request: UpsertAdminOperationRequest,
-	): Promise<UpsertAdminOperationResult>;
-	deleteAdminOperation(recordIds: string[]): Promise<AdminOperationServiceResult>;
-	setAdminOperationGrantee(
-		request: SetAdminOperationGranteeRequest,
-	): Promise<AdminOperationServiceResult>;
-	deleteAdminOperationGrantee(recordIds: string[]): Promise<AdminOperationServiceResult>;
-}

package/src/creatio/providers/configuration-provider.ts

@@ -1,22 +0,0 @@
-export type ConfigurationServiceHttpMethod = 'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE';
-
-export type ConfigurationServiceQueryValue = string | number | boolean;
-
-export interface CallConfigurationServiceRequest {
-	service: string;
-	method: string;
-	httpMethod?: ConfigurationServiceHttpMethod;
-	body?: unknown;
-	query?: Record<string, ConfigurationServiceQueryValue>;
-}
-
-export interface CallConfigurationServiceResult {
-	status: number;
-	contentType?: string;
-	body: unknown;
-}
-
-export interface ConfigurationProvider {
-	readonly kind: string;
-	call(request: CallConfigurationServiceRequest): Promise<CallConfigurationServiceResult>;
-}

package/src/creatio/providers/crud-provider.ts

@@ -1,45 +0,0 @@
-export interface EntitySchemaProperty {
-	name: string;
-	type: string;
-	nullable?: boolean;
-}
-
-export interface EntitySchemaDescription {
-	entitySet: string;
-	entityType: string;
-	key: string[];
-	properties: EntitySchemaProperty[];
-}
-
-export interface CrudReadParams {
-	entity: string;
-	filter?: string | undefined;
-	select?: string[] | undefined;
-	top?: number | undefined;
-	expand?: string[] | undefined;
-	orderBy?: string | undefined;
-}
-
-export interface CrudWriteParams {
-	entity: string;
-	data: any;
-}
-
-export interface CrudUpdateParams extends CrudWriteParams {
-	id: string;
-}
-
-export interface CrudDeleteParams {
-	entity: string;
-	id: string;
-}
-
-export interface CrudProvider {
-	readonly kind: string;
-	listEntitySets(): Promise<string[]>;
-	describeEntity(entitySet: string): Promise<EntitySchemaDescription>;
-	read(params: CrudReadParams): Promise<any>;
-	create(params: CrudWriteParams): Promise<any>;
-	update(params: CrudUpdateParams): Promise<any>;
-	delete(params: CrudDeleteParams): Promise<any>;
-}

package/src/creatio/providers/feature-provider.ts

@@ -1,10 +0,0 @@
-export interface ClearFeatureCacheResult {
-	success: boolean;
-	featureCode?: string;
-	message: string;
-}
-
-export interface FeatureProvider {
-	readonly kind: string;
-	clearFeaturesCache(featureCode?: string): Promise<ClearFeatureCacheResult>;
-}

package/src/creatio/providers/index.ts

@@ -1,7 +0,0 @@
-export * from './admin-operation-provider';
-export * from './configuration-provider';
-export * from './crud-provider';
-export * from './feature-provider';
-export * from './process-provider';
-export * from './sys-settings-provider';
-export * from './user-provider';

package/src/creatio/providers/process-provider.ts

@@ -1,15 +0,0 @@
-export interface ExecuteProcessParams {
-	processName: string;
-	parameters?: Record<string, any> | undefined;
-}
-
-export interface ExecuteProcessResult {
-	status?: string;
-	returnValues?: Record<string, any>;
-	[key: string]: any;
-}
-
-export interface ProcessProvider {
-	readonly kind: string;
-	executeProcess(params: ExecuteProcessParams): Promise<ExecuteProcessResult>;
-}

package/src/creatio/providers/sys-settings-provider.ts

@@ -1,63 +0,0 @@
-export interface QuerySysSettingsResponse {
-	success: boolean;
-	values: Record<string, SysSettingDetail>;
-	notFoundSettings?: string[];
-}
-
-export interface SysSettingDetail {
-	code?: string;
-	value?: unknown;
-	displayValue?: string;
-	isCacheable?: boolean;
-	dataValueType?: number | string;
-	dataValueTypeName?: number | string;
-	id?: string;
-	name?: string;
-}
-
-export interface SysSettingDefinition extends Record<string, unknown> {
-	code: string;
-	name: string;
-	valueTypeName: string;
-	id?: string | undefined;
-	description?: string | undefined;
-	isCacheable?: boolean | undefined;
-	isPersonal?: boolean | undefined;
-	isSSPAvailable?: boolean | undefined;
-	referenceSchemaUId?: string | undefined;
-	dataValueType?: number | string | undefined;
-}
-
-export type SysSettingDefinitionUpdate = Partial<SysSettingDefinition> & { id: string };
-
-export interface CreateSysSettingRequest {
-	definition: SysSettingDefinition;
-	initialValue?: unknown;
-	isPersonal?: boolean;
-}
-
-export interface SysSettingInsertResponse extends Record<string, unknown> {
-	id: string;
-	success: boolean;
-	rowsAffected?: number;
-	nextPrcElReady?: boolean;
-}
-
-export interface SysSettingUpdateResponse extends Record<string, unknown> {
-	success?: boolean;
-	rowsAffected?: number;
-	nextPrcElReady?: boolean;
-}
-
-export interface CreateSysSettingResult {
-	insertResult: SysSettingInsertResponse;
-	setValueResult?: any;
-}
-
-export interface SysSettingsProvider {
-	readonly kind: string;
-	setValues(values: Record<string, any>): Promise<any>;
-	queryValues(codes: string[]): Promise<QuerySysSettingsResponse>;
-	createSetting(request: CreateSysSettingRequest): Promise<CreateSysSettingResult>;
-	updateDefinition(definition: SysSettingDefinitionUpdate): Promise<SysSettingUpdateResponse>;
-}

package/src/creatio/providers/user-provider.ts

@@ -1,12 +0,0 @@
-export interface CurrentUserInfo {
-	userId?: string;
-	contactId?: string;
-	userName?: string;
-	cultureName?: string;
-	[key: string]: any;
-}
-
-export interface UserProvider {
-	readonly kind: string;
-	getCurrentUserInfo(): Promise<CurrentUserInfo>;
-}

package/src/creatio/services/admin-operation-service-provider.ts

@@ -1,115 +0,0 @@
-import { randomUUID } from 'node:crypto';
-
-import {
-	AdminOperationProvider,
-	AdminOperationServiceResult,
-	SetAdminOperationGranteeRequest,
-	UpsertAdminOperationRequest,
-	UpsertAdminOperationResult,
-} from '../providers';
-
-import { CreatioHttpClient } from './http-client';
-
-const EMPTY_GUID = '00000000-0000-0000-0000-000000000000';
-
-interface RightsHelperInner {
-	Success: boolean;
-	ExMessage?: string;
-}
-
-export class AdminOperationServiceProvider implements AdminOperationProvider {
-	private readonly _client: CreatioHttpClient;
-
-	public readonly kind = 'creatio-admin-operation-service';
-
-	constructor(client: CreatioHttpClient) {
-		this._client = client;
-	}
-
-	private _getMethodUrl(method: string): string {
-		return `${this._client.normalizedBaseUrl}/0/rest/RightsService/${method}`;
-	}
-
-	private _parseRightsResponse(method: string, body: any): RightsHelperInner {
-		const resultKey = `${method}Result`;
-		const wrapped = body?.[resultKey];
-		if (typeof wrapped !== 'string') {
-			throw new Error(
-				`creatio_rights_service_unexpected_response:${method}:${JSON.stringify(body)}`,
-			);
-		}
-		return JSON.parse(wrapped) as RightsHelperInner;
-	}
-
-	private async _callRightsService(
-		method: string,
-		payload: Record<string, unknown>,
-	): Promise<AdminOperationServiceResult> {
-		const url = this._getMethodUrl(method);
-		return this._client.executeWithTiming(
-			method,
-			url,
-			async () => {
-				const requestInit = await this._client.createPostRequest(payload);
-				return this._client.fetchWithAuth(url, async () => requestInit);
-			},
-			async (response, duration) => {
-				const body = await response.json();
-				const inner = this._parseRightsResponse(method, body);
-				const success = Boolean(inner.Success);
-				this._client.logSuccess(method, response.status, duration, {
-					rightsServiceSuccess: success,
-				});
-				const result: AdminOperationServiceResult = { success };
-				if (inner.ExMessage !== undefined && inner.ExMessage !== '') {
-					result.exMessage = inner.ExMessage;
-				}
-				return result;
-			},
-			async (response, duration) =>
-				this._client.handleErrorResponse(
-					method,
-					response,
-					duration,
-					`creatio_${method.toLowerCase()}_failed`,
-					{ url },
-				),
-			{ method },
-		);
-	}
-
-	public async upsertAdminOperation(
-		request: UpsertAdminOperationRequest,
-	): Promise<UpsertAdminOperationResult> {
-		const recordId = request.id && request.id !== EMPTY_GUID ? request.id : randomUUID();
-		const payload = {
-			recordId,
-			name: request.name,
-			code: request.code,
-			description: request.description ?? '',
-		};
-		const base = await this._callRightsService('UpsertAdminOperation', payload);
-		const result: UpsertAdminOperationResult = { ...base, id: recordId };
-		return result;
-	}
-
-	public async deleteAdminOperation(recordIds: string[]): Promise<AdminOperationServiceResult> {
-		return this._callRightsService('DeleteAdminOperation', { recordIds });
-	}
-
-	public async setAdminOperationGrantee(
-		request: SetAdminOperationGranteeRequest,
-	): Promise<AdminOperationServiceResult> {
-		return this._callRightsService('SetAdminOperationGrantee', {
-			adminOperationId: request.adminOperationId,
-			adminUnitIds: request.adminUnitIds,
-			canExecute: request.canExecute,
-		});
-	}
-
-	public async deleteAdminOperationGrantee(
-		recordIds: string[],
-	): Promise<AdminOperationServiceResult> {
-		return this._callRightsService('DeleteAdminOperationGrantee', { recordIds });
-	}
-}