mcp-creatio 0.4.1 → 0.6.0

package/README.md

@@ -1,212 +1,265 @@
-# MCP Creatio Server
-
-[![npm version](https://img.shields.io/npm/v/mcp-creatio)](https://www.npmjs.com/package/mcp-creatio)
-[![Docker pulls](https://img.shields.io/docker/pulls/crackish/mcp-creatio)](https://hub.docker.com/r/crackish/mcp-creatio)
-[![License](https://img.shields.io/github/license/CRACKISH/mcp-creatio)](LICENSE)
-
-Model Context Protocol (MCP) server for Creatio (https://www.creatio.com/) to connect Claude Desktop, ChatGPT, GitHub Copilot, and other AI tools to Creatio data.
-
-Also discoverable as:
-- Creatio MCP server
-- MCP server for Creatio CRM
-- Model Context Protocol for Creatio
-
-## Overview
-
-- Exposes Creatio data as MCP tools for MCP-compatible clients (Claude Desktop, ChatGPT Connectors, GitHub Copilot)
-- Supports reading, creating, updating, deleting records and inspecting schema
-- Execute Creatio business processes with parameters
-- Uses Creatio OData v4 API under the hood
-
-## Features
-
-- **CRUD operations**: read, create, update, delete Creatio records
-- **Schema discovery**: list entity sets and inspect entity schemas
-- **Business processes**: run Creatio workflows with parameters
-- **System settings**: read, write, and manage system setting metadata
-- **Feature toggles**: manage `Feature` / `AdminUnitFeatureState` and refresh the feature cache. ⚠️ Only DB-backed features are reachable — features defined exclusively in `web.config` or other non-DB providers are invisible to MCP.
-- **System operations**: manage `SysAdminOperation` and per-user/role grants (Creatio blocks these tables for OData modifications, so dedicated tools are provided)
-- **Custom services**: invoke any configuration-package REST service (`/0/rest/<service>/<method>`) when no dedicated tool fits
-- **AI assistant compatibility**: Claude Desktop, ChatGPT Connectors, GitHub Copilot
-- **Three authentication modes**: Legacy login/password, OAuth2 client credentials, OAuth2 authorization code
-- **Built-in OAuth server**: Automatic MCP client authentication
-- **Docker ready**: Multi-arch images available
-
-## Run Modes
-
-This project supports two runtime modes:
-
-### 1. CLI Mode (`stdio`)
-
-Use this mode for MCP clients that launch a command directly (VS Code MCP, Claude Desktop, etc.).
-
-- No HTTP endpoint needed
-- Easiest local setup
-- Supports Legacy auth and OAuth2 Client Credentials
-- OAuth2 Authorization Code is **not** supported in `stdio` mode
-
-Run directly from npm:
-
-```bash
-npx -y mcp-creatio@latest \
-  --base-url https://your-creatio.com \
-  --login your_login \
-  --password your_password
-```
-
-`stdio` logs are disabled by default. To enable them, set `MCP_CREATIO_LOG_LEVEL` or pass `--log-level info`.
-
-VS Code MCP config (command-based):
-
-```json
-{
-  "creatio": {
-    "command": "npx",
-    "args": [
-      "-y",
-      "mcp-creatio@latest",
-      "--base-url",
-      "https://your-creatio.com",
-      "--login",
-      "your_login",
-      "--password",
-      "your_password"
-    ]
-  }
-}
-```
-
-Local repo command (without publishing):
-
-```bash
-npm run start:stdio -- --base-url https://your-creatio.com --login your_login --password your_password
-```
-
-### 2. Server Mode (`http`)
-
-Use this mode when your client connects by URL (for example `http://localhost:3000/mcp`).
-
-- Exposes HTTP endpoint: `/mcp`
-- Required for OAuth2 Authorization Code flow
-- Works well with Docker and remote deployments
-
-Start server:
-
-```bash
-npm start
-```
-
-Then connect using URL:
-
-```json
-{
-  "creatio": {
-    "type": "http",
-    "url": "http://localhost:3000/mcp"
-  }
-}
-```
-
-## Configuration
-
-| Variable                     | Description                                                          |
-| ---------------------------- | -------------------------------------------------------------------- |
-| `CREATIO_BASE_URL`           | **Required**. Creatio instance URL (e.g. `https://your-creatio.com`) |
-| `CREATIO_LOGIN`              | Username for legacy auth                                             |
-| `CREATIO_PASSWORD`           | Password for legacy auth                                             |
-| `CREATIO_CLIENT_ID`          | OAuth2 client credentials ID                                         |
-| `CREATIO_CLIENT_SECRET`      | OAuth2 client credentials secret                                     |
-| `CREATIO_ID_BASE_URL`        | Identity Service URL (if separate from main Creatio instance)        |
-| `CREATIO_CODE_CLIENT_ID`     | OAuth2 authorization code client ID                                  |
-| `CREATIO_CODE_CLIENT_SECRET` | OAuth2 authorization code client secret                              |
-| `CREATIO_CODE_REDIRECT_URI`  | OAuth2 redirect URI (e.g. `http://localhost:3000/oauth/callback`)    |
-| `CREATIO_CODE_SCOPE`         | OAuth2 scope (e.g. `offline_access ApplicationAccess_yourappguid`)   |
-| `READONLY_MODE`              | Set `true` to disable create/update/delete operations                |
-| `MCP_CREATIO_LOG_LEVEL`      | Log verbosity: `silent` (default), `error`, `warn`, `info`           |
-
-## Authentication Modes
-
-Choose one of three ways to authenticate with Creatio:
-
-### 1. Legacy (Username/Password)
-
-```bash
-CREATIO_LOGIN=YourLogin
-CREATIO_PASSWORD=YourPassword
-```
-
-### 2. OAuth2 Client Credentials
-
-For server-to-server authentication. [Setup guide →](https://academy.creatio.com/docs/8.x/dev/development-on-creatio-platform/integrations-and-api/authentication/oauth-2-0-authorization/identity-service-overview)
-
-```bash
-CREATIO_CLIENT_ID=your_client_id
-CREATIO_CLIENT_SECRET=your_client_secret
-```
-
-### 3. OAuth2 Authorization Code
-
-For user-delegated access with web authorization. [Setup guide →](https://academy.creatio.com/docs/8.x/dev/development-on-creatio-platform/integrations-and-api/authentication/oauth-2-0-authorization/authorization-code-grant)
-
-```bash
-CREATIO_CODE_CLIENT_ID=your_client_id
-CREATIO_CODE_CLIENT_SECRET=your_client_secret
-CREATIO_CODE_REDIRECT_URI=http://localhost:3000/oauth/callback
-CREATIO_CODE_SCOPE="offline_access ApplicationAccess_yourappguid"
-```
-
-**Note**: Currently uses in-memory storage for OAuth tokens. Tokens will be lost on server restart.
-
-**Important**: OAuth2 Authorization Code requires **Server Mode (`http`)**.
-
-**Priority**: Authorization Code > Client Credentials > Legacy
-
-## MCP Client Authentication (HTTP Mode)
-
-The server includes OAuth 2.1 Authorization Server for MCP clients (Claude Desktop, etc.). No additional setup required - clients authenticate automatically through standard OAuth flow.
-
-## Examples
-
-### Node.js (Legacy Auth)
-
-```bash
-export CREATIO_BASE_URL="https://your-creatio.com"
-export CREATIO_LOGIN="YourLogin"
-export CREATIO_PASSWORD="YourPassword"
-npm start
-```
-
-### Docker (Legacy Auth)
-
-```bash
-docker run --rm -p 3000:3000 \
-  -e CREATIO_BASE_URL="https://your-creatio.com" \
-  -e CREATIO_LOGIN="YourLogin" \
-  -e CREATIO_PASSWORD="YourPassword" \
-  crackish/mcp-creatio
-```
-
-## Available Tools
-
-| Tool                             | Description                                                                                                                                  |
-| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
-| `get-current-user-info`          | Fetch the Creatio contact details for the authenticated MCP user                                                                             |
-| `list-entities`                  | List all available entity sets                                                                                                               |
-| `describe-entity`                | Get schema for an entity (fields, types, keys)                                                                                               |
-| `read`                           | Query records with optional filters, select, expand, ordering                                                                                |
-| `create`                         | Create a new record                                                                                                                          |
-| `update`                         | Update an existing record                                                                                                                    |
-| `delete`                         | Delete a record                                                                                                                              |
-| `execute-process`                | Run a Creatio business process                                                                                                               |
-| `query-sys-settings`             | Read current values and metadata for one or more system settings                                                                             |
-| `set-sys-settings-value`         | Update one or more system setting values                                                                                                     |
-| `create-sys-setting`             | Create a new system setting (with optional initial value)                                                                                    |
-| `update-sys-setting-definition`  | Modify system setting metadata (name, value type, cache flags, lookup reference)                                                             |
-| `refresh-feature-cache`          | Invalidate the in-memory feature-toggle cache. Call after editing `Feature` / `AdminUnitFeatureState` rows                                  |
-| `upsert-admin-operation`         | Create or update a `SysAdminOperation` (system operation / permission). Required because OData modifications are blocked for this entity     |
-| `delete-admin-operation`         | Delete one or more `SysAdminOperation` rows (related grantee rows are cleaned up automatically)                                              |
-| `set-admin-operation-grantee`    | Grant or revoke a system operation for users/roles. Repeated calls update the existing row instead of duplicating                            |
-| `delete-admin-operation-grantee` | Remove specific grant rows by Id. Prefer `set-admin-operation-grantee` to flip allow ↔ deny                                                  |
-| `call-configuration-service`     | Escape hatch: invoke any configuration-package REST service method by name. Use only when no dedicated tool covers the operation             |
-
-> **Note**: Previously documented `search`/`fetch` helper tools (for a specific connector workflow) have been removed as they are no longer required.
+# MCP Creatio Server
+
+[![npm version](https://img.shields.io/npm/v/mcp-creatio)](https://www.npmjs.com/package/mcp-creatio)
+[![Docker pulls](https://img.shields.io/docker/pulls/crackish/mcp-creatio)](https://hub.docker.com/r/crackish/mcp-creatio)
+[![License](https://img.shields.io/github/license/CRACKISH/mcp-creatio)](LICENSE)
+
+Model Context Protocol (MCP) server for Creatio (https://www.creatio.com/) to connect Claude Desktop, ChatGPT, GitHub Copilot, and other AI tools to Creatio data.
+
+Also discoverable as:
+
+- Creatio MCP server
+- MCP server for Creatio CRM
+- Model Context Protocol for Creatio
+
+## Overview
+
+- Exposes Creatio data as MCP tools for MCP-compatible clients (Claude Desktop, ChatGPT Connectors, GitHub Copilot)
+- Supports reading, creating, updating, deleting records and inspecting schema
+- Execute Creatio business processes with parameters
+- Selectable data backend: Creatio DataService (default) or OData v4 (`CREATIO_CRUD_BACKEND`)
+
+## Features
+
+- **CRUD operations**: read, create, update, delete Creatio records
+- **Schema discovery**: list entity sets and inspect entity schemas
+- **Business processes**: run Creatio workflows with parameters
+- **System settings**: read, write, and manage system setting metadata
+- **Feature toggles**: manage `Feature` / `AdminUnitFeatureState` and refresh the feature cache. ⚠️ Only DB-backed features are reachable — features defined exclusively in `web.config` or other non-DB providers are invisible to MCP.
+- **System operations**: manage `SysAdminOperation` and per-user/role grants (Creatio blocks these tables for OData modifications, so dedicated tools are provided)
+- **Custom services**: invoke any configuration-package REST service (`/0/rest/<service>/<method>`) when no dedicated tool fits
+- **AI assistant compatibility**: Claude Desktop, ChatGPT Connectors, GitHub Copilot
+- **Three authentication modes**: Legacy login/password, OAuth2 client credentials, OAuth2 authorization code
+- **Built-in OAuth server**: Automatic MCP client authentication
+- **Docker ready**: Multi-arch images available
+
+## Run Modes
+
+This project supports two runtime modes:
+
+### 1. CLI Mode (`stdio`)
+
+Use this mode for MCP clients that launch a command directly (VS Code MCP, Claude Desktop, etc.).
+
+- No HTTP endpoint needed
+- Easiest local setup
+- Supports Legacy auth and OAuth2 Client Credentials
+- OAuth2 Authorization Code is **not** supported in `stdio` mode
+
+Run directly from npm:
+
+```bash
+npx -y mcp-creatio@latest \
+  --base-url https://your-creatio.com \
+  --login your_login \
+  --password your_password
+```
+
+`stdio` logs are disabled by default. To enable them, set `MCP_CREATIO_LOG_LEVEL` or pass `--log-level info`.
+
+VS Code MCP config (command-based):
+
+```json
+{
+	"creatio": {
+		"command": "npx",
+		"args": [
+			"-y",
+			"mcp-creatio@latest",
+			"--base-url",
+			"https://your-creatio.com",
+			"--login",
+			"your_login",
+			"--password",
+			"your_password"
+		]
+	}
+}
+```
+
+Local repo command (without publishing):
+
+```bash
+npm run start:stdio -- --base-url https://your-creatio.com --login your_login --password your_password
+```
+
+### 2. Server Mode (`http`)
+
+Use this mode when your client connects by URL (for example `http://localhost:3000/mcp`).
+
+- Exposes HTTP endpoint: `/mcp`
+- Required for OAuth2 Authorization Code flow
+- Works well with Docker and remote deployments
+
+Start server:
+
+```bash
+npm start
+```
+
+Then connect using URL:
+
+```json
+{
+	"creatio": {
+		"type": "http",
+		"url": "http://localhost:3000/mcp"
+	}
+}
+```
+
+## Configuration
+
+| Variable                     | Description                                                          |
+| ---------------------------- | -------------------------------------------------------------------- |
+| `CREATIO_BASE_URL`           | **Required**. Creatio instance URL (e.g. `https://your-creatio.com`) |
+| `CREATIO_LOGIN`              | Username for legacy auth                                             |
+| `CREATIO_PASSWORD`           | Password for legacy auth                                             |
+| `CREATIO_CLIENT_ID`          | OAuth2 client credentials ID                                         |
+| `CREATIO_CLIENT_SECRET`      | OAuth2 client credentials secret                                     |
+| `CREATIO_ID_BASE_URL`        | Identity Service URL (if separate from main Creatio instance)        |
+| `CREATIO_CODE_CLIENT_ID`     | OAuth2 authorization code client ID                                  |
+| `CREATIO_CODE_CLIENT_SECRET` | OAuth2 authorization code client secret                              |
+| `CREATIO_CODE_REDIRECT_URI`  | OAuth2 redirect URI (e.g. `http://localhost:3000/oauth/callback`)    |
+| `CREATIO_CODE_SCOPE`         | OAuth2 scope (e.g. `offline_access ApplicationAccess_yourappguid`)   |
+| `CREATIO_CRUD_BACKEND`       | CRUD data API: `dataservice` (default) or `odata`                    |
+| `READONLY_MODE`              | Set `true` to disable create/update/delete operations                |
+| `MCP_CREATIO_LOG_LEVEL`      | Log verbosity: `silent` (default), `error`, `warn`, `info`           |
+
+### CRUD backend
+
+CRUD tools (`read`, `create`, `update`, `delete`, `list-entities`, `describe-entity`) run on a
+selectable data API, chosen once per deployment via `CREATIO_CRUD_BACKEND`:
+
+- **`dataservice`** (default) — Creatio's native DataService.
+- **`odata`** — Creatio OData v4. Also enables the OData-only `read` extras (`filter` raw
+  `$filter` string, `expand`).
+
+Either way you query through the same tool surface: prefer the structured `filters` parameter —
+it works unchanged on both backends.
+
+## Authentication Modes
+
+Choose one of three ways to authenticate with Creatio:
+
+### 1. Legacy (Username/Password)
+
+```bash
+CREATIO_LOGIN=YourLogin
+CREATIO_PASSWORD=YourPassword
+```
+
+### 2. OAuth2 Client Credentials
+
+For server-to-server authentication. [Setup guide →](https://academy.creatio.com/docs/8.x/dev/development-on-creatio-platform/integrations-and-api/authentication/oauth-2-0-authorization/identity-service-overview)
+
+```bash
+CREATIO_CLIENT_ID=your_client_id
+CREATIO_CLIENT_SECRET=your_client_secret
+```
+
+### 3. OAuth2 Authorization Code
+
+For user-delegated access with web authorization. [Setup guide →](https://academy.creatio.com/docs/8.x/dev/development-on-creatio-platform/integrations-and-api/authentication/oauth-2-0-authorization/authorization-code-grant)
+
+```bash
+CREATIO_CODE_CLIENT_ID=your_client_id
+CREATIO_CODE_CLIENT_SECRET=your_client_secret
+CREATIO_CODE_REDIRECT_URI=http://localhost:3000/oauth/callback
+CREATIO_CODE_SCOPE="offline_access ApplicationAccess_yourappguid"
+```
+
+**Note**: Currently uses in-memory storage for OAuth tokens. Tokens will be lost on server restart.
+
+**Important**: OAuth2 Authorization Code requires **Server Mode (`http`)**.
+
+**Priority**: Authorization Code > Client Credentials > Legacy
+
+## MCP Client Authentication (HTTP Mode)
+
+The server includes OAuth 2.1 Authorization Server for MCP clients (Claude Desktop, etc.). No additional setup required - clients authenticate automatically through standard OAuth flow.
+
+## Examples
+
+### Node.js (Legacy Auth)
+
+```bash
+export CREATIO_BASE_URL="https://your-creatio.com"
+export CREATIO_LOGIN="YourLogin"
+export CREATIO_PASSWORD="YourPassword"
+npm start
+```
+
+### Docker (Legacy Auth)
+
+```bash
+docker run --rm -p 3000:3000 \
+  -e CREATIO_BASE_URL="https://your-creatio.com" \
+  -e CREATIO_LOGIN="YourLogin" \
+  -e CREATIO_PASSWORD="YourPassword" \
+  crackish/mcp-creatio
+```
+
+## Available Tools
+
+| Tool                             | Description                                                                                                                                              |
+| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `get-current-user-info`          | Fetch the Creatio contact details for the authenticated MCP user                                                                                         |
+| `list-entities`                  | List all available entity sets                                                                                                                           |
+| `describe-entity`                | Get schema for an entity (fields, types, keys). Routes through DataForge for richer column details when it is enabled, otherwise exact OData `$metadata` |
+| `read`                           | Query records: filters, select, expand, ordering, pagination (skip/top) and total count                                                                  |
+| `create`                         | Create a new record                                                                                                                                      |
+| `update`                         | Update an existing record                                                                                                                                |
+| `delete`                         | Delete a record                                                                                                                                          |
+| `execute-process`                | Run a Creatio business process                                                                                                                           |
+| `query-sys-settings`             | Read current values and metadata for one or more system settings                                                                                         |
+| `set-sys-settings-value`         | Update one or more system setting values                                                                                                                 |
+| `create-sys-setting`             | Create a new system setting (with optional initial value)                                                                                                |
+| `update-sys-setting-definition`  | Modify system setting metadata (name, value type, cache flags, lookup reference)                                                                         |
+| `refresh-feature-cache`          | Invalidate the in-memory feature-toggle cache. Call after editing `Feature` / `AdminUnitFeatureState` rows                                               |
+| `upsert-admin-operation`         | Create or update a `SysAdminOperation` (system operation / permission). Required because OData modifications are blocked for this entity                 |
+| `delete-admin-operation`         | Delete one or more `SysAdminOperation` rows (related grantee rows are cleaned up automatically)                                                          |
+| `set-admin-operation-grantee`    | Grant or revoke a system operation for users/roles. Repeated calls update the existing row instead of duplicating                                        |
+| `delete-admin-operation-grantee` | Remove specific grant rows by Id. Prefer `set-admin-operation-grantee` to flip allow ↔ deny                                                              |
+| `call-configuration-service`     | Escape hatch: invoke any configuration-package REST service method by name. Use only when no dedicated tool covers the operation                         |
+
+> **Note**: Previously documented `search`/`fetch` helper tools (for a specific connector workflow) have been removed as they are no longer required.
+
+### Querying data with `read`
+
+Ask for exactly the data you need — the AI doesn't have to know OData:
+
+- **Filter any way** — equals / not-equals, ranges (`>`, `>=`, `<`, `<=`), text match (`contains`, `starts/ends with`), `AND` / `OR` groups, and "in this list".
+- **Filter by related records naturally** — by name (`Contact/Name = "Andrew Baker"`) or by id; lookups just work, no special syntax to remember.
+- **Sort** by any column, ascending or descending.
+- **Paginate** with page size + offset, so large datasets come back in clean pages.
+- **Count** — get the total number of matches in one call (e.g. "how many open cases does this account have?"), with or without the rows.
+- **Pull in related data** in a single request (e.g. an order together with its account and contact).
+
+### DataForge tools (registered only when DataForge is enabled)
+
+DataForge is Creatio's AI-oriented semantic layer over the data model. These tools are **probed once at startup** and registered **only when the environment has DataForge configured** (a non-empty `DataForgeServiceUrl` system setting). When DataForge is absent the tools are not exposed at all, and `describe-entity` silently uses OData metadata — no wasted remote calls.
+
+| Tool                            | Description                                                                                       |
+| ------------------------------- | ------------------------------------------------------------------------------------------------- |
+| `dataforge-similar-tables`      | Semantic search: map a natural-language query to the Creatio tables that best match its meaning   |
+| `dataforge-table-details`       | Like `dataforge-similar-tables` but returns richer per-table details for the best matches         |
+| `dataforge-table-relationships` | Find the relationship path(s) between two tables (how they join) — useful before `read`/`$expand` |
+| `dataforge-lookup-values`       | Fuzzy/semantic search for lookup values (resolve a phrase to the right lookup record Id)          |
+| `dataforge-status`              | Report whether DataForge is online and whether the data model / lookups are synced                |
+
+**Discovery → confirm → act:** use `dataforge-similar-tables` to find the right entity, then `describe-entity` for the authoritative field list, then `read`/`create`.
+
+**Enabling DataForge** requires (on the Creatio side): the `DataForgeServiceUrl` system setting plus IdentityServer settings (`IdentityServerUrl`, `IdentityServerClientId`/`Secret`), the `DataForge*` feature toggles, and the `CanReadDataStructureColumnDetails` operation granted to the MCP user. Restart the app pool (or run the `DataStructureTransferFromCreatio` / `LookupsTransferFromCreatio` processes) to sync the model.
+
+### Global Search tool (registered only when Global Search is enabled)
+
+Global Search is Creatio's cross-entity, Elasticsearch-backed record search — the engine behind the UI search box. The tool is **probed once at startup** and registered **only when the environment has Global Search configured** (a non-empty `GlobalSearchUrl` system setting).
+
+| Tool            | Description                                                                                                                                                                                                                                   |
+| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `global-search` | Full-text search across all indexed entities (like the UI search). Input: `query`, optional `entities[]`/`limit`/`from`. Returns matched records with `entityName`, `id`, `columnValues`, highlighted `foundColumns`, plus `total`/`nextFrom` |
+
+Differs from `read`: `read` needs an exact entity + OData filter; `global-search` is fuzzy and cross-entity — use it to locate a record when you don't know the entity. Calls `GlobalSearchService.Search`.
+
+**Enabling Global Search** requires the `GlobalSearchUrl` (+ `GlobalSearchConfigServiceUrl`, `GlobalSearchIndexingApiUrl`) system settings and the `GlobalSearch` / `GlobalSearch_V2` feature toggles, with the section index built (Elasticsearch reachable).

package/dist/cli.js

@@ -119,8 +119,9 @@ async function main() {
         throw new Error('oauth2_code_requires_http_server: use "npm start" (HTTP /mcp mode) for OAuth2 authorization-code flow');
     }
     const provider = new creatio_1.CreatioServiceContext(cfg);
-    const engines = new creatio_1.CreatioEngineManager(provider);
-    const server = new server_1.Server(engines, { readonlyMode: (0, utils_1.envBool)('READONLY_MODE', false) });
+    const readonlyMode = (0, utils_1.envBool)('READONLY_MODE', false);
+    const engines = new creatio_1.CreatioEngineManager(provider, { readonly: readonlyMode });
+    const server = new server_1.Server(engines, { readonlyMode });
     const state = { server };
     process.on('SIGINT', () => {
         void shutdown('SIGINT', state).finally(() => process.exit(0));

package/dist/cli.js.map

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

package/dist/config-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-builder.d.ts","sourceRoot":"","sources":["../src/config-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,mBAAmB,EAInB,MAAM,WAAW,CAAC;AA6DnB,wBAAgB,sBAAsB,IAAI,mBAAmB,CAO5D"}
+{"version":3,"file":"config-builder.d.ts","sourceRoot":"","sources":["../src/config-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,mBAAmB,EAKnB,MAAM,WAAW,CAAC;AA0EnB,wBAAgB,sBAAsB,IAAI,mBAAmB,CAO5D"}

package/dist/config-builder.js

@@ -55,12 +55,24 @@ function _getLegacyAuthConfig() {
     }
     return null;
 }
+function getCrudBackend() {
+    const raw = (0, utils_1.env)('CREATIO_CRUD_BACKEND')?.toLowerCase();
+    // DataService is the default backend (Creatio's native data API, what the UI uses);
+    // set CREATIO_CRUD_BACKEND=odata to opt into the OData backend instead.
+    if (!raw || raw === 'dataservice') {
+        return 'dataservice';
+    }
+    if (raw !== 'odata') {
+        throw new Error(`unsupported_crud_backend:${raw} (expected "odata" or "dataservice")`);
+    }
+    return 'odata';
+}
 function getCreatioClientConfig() {
     const baseUrl = (0, utils_1.env)('CREATIO_BASE_URL');
     if (!baseUrl) {
         throw new Error('Environment variable CREATIO_BASE_URL is required but not set');
     }
     const auth = getCreatioClientAuthConfig();
-    return { baseUrl, auth };
+    return { baseUrl, auth, crudBackend: getCrudBackend() };
 }
 //# sourceMappingURL=config-builder.js.map

package/dist/config-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-builder.js","sourceRoot":"","sources":["../src/config-builder.ts"],"names":[],"mappings":";;AAoEA,wDAOC;AA3ED,uCAOmB;AACnB,mCAA8B;AAE9B,SAAS,0BAA0B;IAClC,MAAM,QAAQ,GAAG,wBAAwB,EAAE,CAAC;IAC5C,IAAI,QAAQ,EAAE,CAAC;QACd,OAAO,QAAQ,CAAC;IACjB,CAAC;IACD,MAAM,UAAU,GAAG,oBAAoB,EAAE,CAAC;IAC1C,IAAI,UAAU,EAAE,CAAC;QAChB,OAAO,UAAU,CAAC;IACnB,CAAC;IACD,MAAM,UAAU,GAAG,oBAAoB,EAAE,CAAC;IAC1C,IAAI,UAAU,EAAE,CAAC;QAChB,OAAO,UAAU,CAAC;IACnB,CAAC;IACD,MAAM,IAAI,KAAK,CACd,uKAAuK,CACvK,CAAC;AACH,CAAC;AAED,SAAS,wBAAwB;IAChC,MAAM,YAAY,GAAG,IAAA,WAAG,EAAC,wBAAwB,CAAC,CAAC;IACnD,MAAM,gBAAgB,GAAG,IAAA,WAAG,EAAC,4BAA4B,CAAC,CAAC;IAC3D,MAAM,eAAe,GAAG,IAAA,WAAG,EAAC,2BAA2B,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,IAAA,WAAG,EAAC,oBAAoB,CAAC,CAAC;IAC5C,IAAI,YAAY,IAAI,gBAAgB,IAAI,eAAe,IAAI,SAAS,EAAE,CAAC;QACtE,OAAO;YACN,IAAI,EAAE,0BAAgB,CAAC,UAAU;YACjC,QAAQ,EAAE,YAAY;YACtB,YAAY,EAAE,gBAAgB;YAC9B,WAAW,EAAE,eAAe;YAC5B,KAAK,EAAE,SAAS;SAChB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED,SAAS,oBAAoB;IAC5B,MAAM,QAAQ,GAAG,IAAA,WAAG,EAAC,mBAAmB,CAAC,CAAC;IAC1C,MAAM,YAAY,GAAG,IAAA,WAAG,EAAC,uBAAuB,CAAC,CAAC;IAClD,IAAI,QAAQ,IAAI,YAAY,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAqB,EAAE,IAAI,EAAE,0BAAgB,CAAC,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;QACzF,MAAM,GAAG,GAAG,IAAA,WAAG,EAAC,qBAAqB,CAAC,CAAC;QACvC,IAAI,GAAG,EAAE,CAAC;YACT,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC;QACtB,CAAC;QACD,OAAO,IAAI,CAAC;IACb,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED,SAAS,oBAAoB;IAC5B,MAAM,KAAK,GAAG,IAAA,WAAG,EAAC,eAAe,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAA,WAAG,EAAC,kBAAkB,CAAC,CAAC;IACzC,IAAI,KAAK,IAAI,QAAQ,EAAE,CAAC;QACvB,OAAO,EAAE,IAAI,EAAE,0BAAgB,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAC3D,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED,SAAgB,sBAAsB;IACrC,MAAM,OAAO,GAAG,IAAA,WAAG,EAAC,kBAAkB,CAAC,CAAC;IACxC,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IAClF,CAAC;IACD,MAAM,IAAI,GAAG,0BAA0B,EAAE,CAAC;IAC1C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"config-builder.js","sourceRoot":"","sources":["../src/config-builder.ts"],"names":[],"mappings":"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"}

package/dist/creatio/auth/auth.d.ts

@@ -1,14 +1,28 @@
 import { AuthProviderType } from './providers';
+/**
+ * Core capability every auth provider has: attach auth headers, refresh on 401, and a
+ * safe cancel hook for background timers. Kept deliberately small (ISP) — revocation and
+ * the interactive authorization-code dance are separate, optional capabilities below, so
+ * a provider is never forced to stub methods it does not support.
+ */
 export interface ICreatioAuthProvider {
     type: AuthProviderType;
     getHeaders(accept: string, isJson?: boolean): Promise<Record<string, string>>;
     refresh(): Promise<void>;
+    /** Cancels any background token-refresh timers. Safe no-op for providers without them. */
+    cancelAllRefresh(): void;
+}
+/** A provider whose tokens can be explicitly revoked (OAuth2 variants). */
+export interface IRevocableAuthProvider extends ICreatioAuthProvider {
     revoke(): Promise<void>;
+}
+/** A provider that drives the interactive OAuth2 authorization-code flow. */
+export interface IInteractiveAuthProvider extends ICreatioAuthProvider {
     getAuthorizeUrl(state: string): Promise<string>;
     finishAuthorization(code: string): Promise<void>;
-    /** Cancels any background token-refresh timers. Safe no-op for providers without them. */
-    cancelAllRefresh(): void;
 }
+export declare function supportsRevoke(provider: ICreatioAuthProvider): provider is IRevocableAuthProvider;
+export declare function supportsInteractiveAuth(provider: ICreatioAuthProvider): provider is IInteractiveAuthProvider;
 export declare function buildHeaders(accept: string, isJson?: boolean, token?: string): Record<string, string>;
 export declare const TOKEN_ENDPOINT = "/connect/token";
 export declare const AUTHORIZE_ENDPOINT = "/connect/authorize";

package/dist/creatio/auth/auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/creatio/auth/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,WAAW,oBAAoB;IACpC,IAAI,EAAE,gBAAgB,CAAC;IACvB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,0FAA0F;IAC1F,gBAAgB,IAAI,IAAI,CAAC;CACzB;AAED,wBAAgB,YAAY,CAC3B,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,OAAO,EAChB,KAAK,CAAC,EAAE,MAAM,GACZ,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASxB;AAED,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAC/C,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AACvD,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AACzD,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAC3C,eAAO,MAAM,sBAAsB,KAAK,CAAC"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/creatio/auth/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACpC,IAAI,EAAE,gBAAgB,CAAC;IACvB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,0FAA0F;IAC1F,gBAAgB,IAAI,IAAI,CAAC;CACzB;AAED,2EAA2E;AAC3E,MAAM,WAAW,sBAAuB,SAAQ,oBAAoB;IACnE,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,6EAA6E;AAC7E,MAAM,WAAW,wBAAyB,SAAQ,oBAAoB;IACrE,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,oBAAoB,GAAG,QAAQ,IAAI,sBAAsB,CAEjG;AAED,wBAAgB,uBAAuB,CACtC,QAAQ,EAAE,oBAAoB,GAC5B,QAAQ,IAAI,wBAAwB,CAGtC;AAED,wBAAgB,YAAY,CAC3B,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,OAAO,EAChB,KAAK,CAAC,EAAE,MAAM,GACZ,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASxB;AAED,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAC/C,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AACvD,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AACzD,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAC3C,eAAO,MAAM,sBAAsB,KAAK,CAAC"}