@epilot/sdk 2.20.23 → 2.20.24

package/dist/{entity-mapping-WFPSOXRK.cjs → entity-mapping-WE3QMZWA.cjs}

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});require('./chunk-NJK5F5TF.cjs');
 
 // src/docs/entity-mapping.json
-var entity_mapping_default = '# Entity Mapping API\n\n- **Base URL:** `https://entity-mapping.sls.epilot.io`\n- **Full API Docs:** [https://docs.epilot.io/api/entity-mapping](https://docs.epilot.io/api/entity-mapping)\n\n## Usage\n\n```ts\nimport { epilot } from \'@epilot/sdk\'\n\nepilot.authorize(() => \'<token>\')\nconst { data } = await epilot.entityMapping.storeConfig(...)\n```\n\n### Tree-shakeable import\n\n```ts\nimport { getClient, authorize } from \'@epilot/sdk/entity-mapping\'\n\nconst entityMappingClient = getClient()\nauthorize(entityMappingClient, () => \'<token>\')\nconst { data } = await entityMappingClient.storeConfig(...)\n```\n\n## Operations\n\n**mappings**\n- [`storeConfig`](#storeconfig)\n- [`getConfig`](#getconfig)\n- [`deleteConfig`](#deleteconfig)\n- [`getAllVersions`](#getallversions)\n- [`storeNewVersion`](#storenewversion)\n- [`getConfigVersion`](#getconfigversion)\n- [`executeMapping`](#executemapping)\n- [`searchConfigs`](#searchconfigs)\n- [`queryMappingHistory`](#querymappinghistory)\n- [`executeRelations`](#executerelations)\n- [`getMappingConfig`](#getmappingconfig)\n- [`putMappingConfig`](#putmappingconfig)\n\n**Schemas**\n- [`SearchMappingReq`](#searchmappingreq)\n- [`MappingConfigsResp`](#mappingconfigsresp)\n- [`MappingConfigs`](#mappingconfigs)\n- [`MappingConfig`](#mappingconfig)\n- [`MappingConfigV2`](#mappingconfigv2)\n- [`MappingConfigCommonFields`](#mappingconfigcommonfields)\n- [`Owner`](#owner)\n- [`ExecuteRelationsReq`](#executerelationsreq)\n- [`ExecuteRelationsResp`](#executerelationsresp)\n- [`NewRelationItem`](#newrelationitem)\n- [`RelationItem`](#relationitem)\n- [`ExecuteMappingReq`](#executemappingreq)\n- [`ExecuteMappingResp`](#executemappingresp)\n- [`MappingFailure`](#mappingfailure)\n- [`MappingWarning`](#mappingwarning)\n- [`Entity`](#entity)\n- [`EntityRef`](#entityref)\n- [`SourceConfig`](#sourceconfig)\n- [`JourneyRef`](#journeyref)\n- [`Loop_Index_String`](#loop_index_string)\n- [`TargetConfig`](#targetconfig)\n- [`MapCondition`](#mapcondition)\n- [`ConditionNode`](#conditionnode)\n- [`RelationAttribute`](#relationattribute)\n- [`GraphContextEntry`](#graphcontextentry)\n- [`GraphSeed`](#graphseed)\n- [`GraphDefinition`](#graphdefinition)\n- [`GraphNode`](#graphnode)\n- [`GraphNodeFilter`](#graphnodefilter)\n- [`GraphEdge`](#graphedge)\n- [`MappingAttributeV2`](#mappingattributev2)\n- [`AttributeOrigin`](#attributeorigin)\n- [`OperationNode`](#operationnode)\n- [`OperationObjectNode`](#operationobjectnode)\n- [`PrimitiveJSONValue`](#primitivejsonvalue)\n- [`RandomOperation`](#randomoperation)\n- [`MappingAttribute`](#mappingattribute)\n- [`MappingAttributeMode`](#mappingattributemode)\n- [`SetValueMapper`](#setvaluemapper)\n- [`CopyValueMapper`](#copyvaluemapper)\n- [`AppendValueMapper`](#appendvaluemapper)\n- [`MappingHistoryResp`](#mappinghistoryresp)\n- [`MappingHistoryEntry`](#mappinghistoryentry)\n- [`MappingSource`](#mappingsource)\n- [`MappingSourceProperty`](#mappingsourceproperty)\n- [`MappingSourceTargetType`](#mappingsourcetargettype)\n\n### `storeConfig`\n\nStore new MappingConfig\n\n`POST /v1/mappings`\n\n```ts\nconst { data } = await client.storeConfig(\n  {\n    with_id: \'example\',\n  },\n  {\n    id: \'string\',\n    source: {\n      type: \'journey\',\n      config: {\n        journey_id: \'string\'\n      }\n    },\n    targets: [\n      {\n        id: \'string\',\n        name: \'string\',\n        allow_failure: true,\n        target_schema: \'string\',\n        target_unique: [\'string\'],\n        use_uniqueness_criteria: false,\n        loop_config: { /* ... */ },\n        conditionMode: \'oneOf\',\n        conditions: [ /* ... */ ],\n        mapping_attributes: [ /* ... */ ],\n        relation_attributes: [ /* ... */ ],\n        linkback_relation_attribute: \'mapped_entities\',\n        linkback_relation_tags: [\'string\'],\n        graph_context: [ /* ... */ ]\n      }\n    ],\n    created_at: \'1970-01-01T00:00:00.000Z\',\n    updated_at: \'1970-01-01T00:00:00.000Z\',\n    created_by: {\n      type: \'user\',\n      org_id: \'string\',\n      user_id: \'string\'\n    },\n    last_updated_by: {\n      type: \'user\',\n      org_id: \'string\',\n      user_id: \'string\'\n    },\n    org_id: \'66\',\n    version: 2\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "id": "string",\n  "source": {\n    "type": "journey",\n    "config": {\n      "journey_id": "string"\n    }\n  },\n  "targets": [\n    {\n      "id": "string",\n      "name": "string",\n      "allow_failure": true,\n      "target_schema": "string",\n      "target_unique": ["string"],\n      "use_uniqueness_criteria": false,\n      "loop_config": {},\n      "conditionMode": "oneOf",\n      "conditions": [],\n      "mapping_attributes": [],\n      "relation_attributes": [],\n      "linkback_relation_attribute": "mapped_entities",\n      "linkback_relation_tags": ["string"],\n      "graph_context": []\n    }\n  ],\n  "created_at": "1970-01-01T00:00:00.000Z",\n  "updated_at": "1970-01-01T00:00:00.000Z",\n  "created_by": {\n    "type": "user",\n    "org_id": "string",\n    "user_id": "string"\n  },\n  "last_updated_by": {\n    "type": "user",\n    "org_id": "string",\n    "user_id": "string"\n  },\n  "org_id": "66",\n  "version": 2\n}\n```\n\n</details>\n\n---\n\n### `getConfig`\n\nGet latest version of a mapping config by id\n\n`GET /v1/mappings/{id}`\n\n```ts\nconst { data } = await client.getConfig({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "id": "string",\n  "source": {\n    "type": "journey",\n    "config": {\n      "journey_id": "string"\n    }\n  },\n  "targets": [\n    {\n      "id": "string",\n      "name": "string",\n      "allow_failure": true,\n      "target_schema": "string",\n      "target_unique": ["string"],\n      "use_uniqueness_criteria": false,\n      "loop_config": {},\n      "conditionMode": "oneOf",\n      "conditions": [],\n      "mapping_attributes": [],\n      "relation_attributes": [],\n      "linkback_relation_attribute": "mapped_entities",\n      "linkback_relation_tags": ["string"],\n      "graph_context": []\n    }\n  ],\n  "created_at": "1970-01-01T00:00:00.000Z",\n  "updated_at": "1970-01-01T00:00:00.000Z",\n  "created_by": {\n    "type": "user",\n    "org_id": "string",\n    "user_id": "string"\n  },\n  "last_updated_by": {\n    "type": "user",\n    "org_id": "string",\n    "user_id": "string"\n  },\n  "org_id": "66",\n  "version": 2\n}\n```\n\n</details>\n\n---\n\n### `deleteConfig`\n\nDelete entity mapping config\n\n`DELETE /v1/mappings/{id}`\n\n```ts\nconst { data } = await client.deleteConfig({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "id": "string",\n  "source": {\n    "type": "journey",\n    "config": {\n      "journey_id": "string"\n    }\n  },\n  "targets": [\n    {\n      "id": "string",\n      "name": "string",\n      "allow_failure": true,\n      "target_schema": "string",\n      "target_unique": ["string"],\n      "use_uniqueness_criteria": false,\n      "loop_config": {},\n      "conditionMode": "oneOf",\n      "conditions": [],\n      "mapping_attributes": [],\n      "relation_attributes": [],\n      "linkback_relation_attribute": "mapped_entities",\n      "linkback_relation_tags": ["string"],\n      "graph_context": []\n    }\n  ],\n  "created_at": "1970-01-01T00:00:00.000Z",\n  "updated_at": "1970-01-01T00:00:00.000Z",\n  "created_by": {\n    "type": "user",\n    "org_id": "string",\n    "user_id": "string"\n  },\n  "last_updated_by": {\n    "type": "user",\n    "org_id": "string",\n    "user_id": "string"\n  },\n  "org_id": "66",\n  "version": 2\n}\n```\n\n</details>\n\n---\n\n### `getAllVersions`\n\nGet all version of MappingConfig\n\n`GET /v1/mappings/{id}/versions`\n\n```ts\nconst { data } = await client.getAllVersions({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "configs": [\n    {\n      "id": "string",\n      "source": {},\n      "targets": [],\n      "created_at": "1970-01-01T00:00:00.000Z",\n      "updated_at": "1970-01-01T00:00:00.000Z",\n      "created_by": {},\n      "last_updated_by": {},\n      "org_id": "66",\n      "version": 2\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `storeNewVersion`\n\nStore new version of MappingConfig\n\n`POST /v1/mappings/{id}/versions`\n\n```ts\nconst { data } = await client.storeNewVersion(\n  {\n    id: \'123e4567-e89b-12d3-a456-426614174000\',\n  },\n  {\n    id: \'string\',\n    source: {\n      type: \'journey\',\n      config: {\n        journey_id: \'string\'\n      }\n    },\n    targets: [\n      {\n        id: \'string\',\n        name: \'string\',\n        allow_failure: true,\n        target_schema: \'string\',\n        target_unique: [\'string\'],\n        use_uniqueness_criteria: false,\n        loop_config: { /* ... */ },\n        conditionMode: \'oneOf\',\n        conditions: [ /* ... */ ],\n        mapping_attributes: [ /* ... */ ],\n        relation_attributes: [ /* ... */ ],\n        linkback_relation_attribute: \'mapped_entities\',\n        linkback_relation_tags: [\'string\'],\n        graph_context: [ /* ... */ ]\n      }\n    ],\n    created_at: \'1970-01-01T00:00:00.000Z\',\n    updated_at: \'1970-01-01T00:00:00.000Z\',\n    created_by: {\n      type: \'user\',\n      org_id: \'string\',\n      user_id: \'string\'\n    },\n    last_updated_by: {\n      type: \'user\',\n      org_id: \'string\',\n      user_id: \'string\'\n    },\n    org_id: \'66\',\n    version: 2\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "id": "string",\n  "source": {\n    "type": "journey",\n    "config": {\n      "journey_id": "string"\n    }\n  },\n  "targets": [\n    {\n      "id": "string",\n      "name": "string",\n      "allow_failure": true,\n      "target_schema": "string",\n      "target_unique": ["string"],\n      "use_uniqueness_criteria": false,\n      "loop_config": {},\n      "conditionMode": "oneOf",\n      "conditions": [],\n      "mapping_attributes": [],\n      "relation_attributes": [],\n      "linkback_relation_attribute": "mapped_entities",\n      "linkback_relation_tags": ["string"],\n      "graph_context": []\n    }\n  ],\n  "created_at": "1970-01-01T00:00:00.000Z",\n  "updated_at": "1970-01-01T00:00:00.000Z",\n  "created_by": {\n    "type": "user",\n    "org_id": "string",\n    "user_id": "string"\n  },\n  "last_updated_by": {\n    "type": "user",\n    "org_id": "string",\n    "user_id": "string"\n  },\n  "org_id": "66",\n  "version": 2\n}\n```\n\n</details>\n\n---\n\n### `getConfigVersion`\n\nGet specific version of a mapping config by id & version\n\n`GET /v1/mappings/{id}/versions/{version}`\n\n```ts\nconst { data } = await client.getConfigVersion({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n  version: 1,\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "id": "string",\n  "source": {\n    "type": "journey",\n    "config": {\n      "journey_id": "string"\n    }\n  },\n  "targets": [\n    {\n      "id": "string",\n      "name": "string",\n      "allow_failure": true,\n      "target_schema": "string",\n      "target_unique": ["string"],\n      "use_uniqueness_criteria": false,\n      "loop_config": {},\n      "conditionMode": "oneOf",\n      "conditions": [],\n      "mapping_attributes": [],\n      "relation_attributes": [],\n      "linkback_relation_attribute": "mapped_entities",\n      "linkback_relation_tags": ["string"],\n      "graph_context": []\n    }\n  ],\n  "created_at": "1970-01-01T00:00:00.000Z",\n  "updated_at": "1970-01-01T00:00:00.000Z",\n  "created_by": {\n    "type": "user",\n    "org_id": "string",\n    "user_id": "string"\n  },\n  "last_updated_by": {\n    "type": "user",\n    "org_id": "string",\n    "user_id": "string"\n  },\n  "org_id": "66",\n  "version": 2\n}\n```\n\n</details>\n\n---\n\n### `executeMapping`\n\nExecute entity mapping based on a config\n\n`POST /v1/mappings:execute`\n\n```ts\nconst { data } = await client.executeMapping(\n  {\n    preview_mode: true,\n  },\n  {\n    source_ref: {\n      entity_id: \'string\',\n      entity_schema: \'submission\'\n    },\n    loop_ref: {\n      entity_id: \'string\',\n      entity_schema: \'submission\'\n    },\n    targets: [\n      {\n        id: \'string\',\n        name: \'string\',\n        allow_failure: true,\n        target_schema: \'string\',\n        target_unique: [\'string\'],\n        use_uniqueness_criteria: false,\n        loop_config: { /* ... */ },\n        conditionMode: \'oneOf\',\n        conditions: [ /* ... */ ],\n        mapping_attributes: [ /* ... */ ],\n        relation_attributes: [ /* ... */ ],\n        linkback_relation_attribute: \'mapped_entities\',\n        linkback_relation_tags: [\'string\'],\n        graph_context: [ /* ... */ ]\n      }\n    ]\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "mapped_entities": [\n    {\n      "_id": "string",\n      "_schema": "string",\n      "_title": "string",\n      "_org": "string",\n      "_tags": ["string"],\n      "_created_at": "string",\n      "_updated_at": "string",\n      "required": {}\n    }\n  ],\n  "failures": [\n    {\n      "target": {},\n      "error": {}\n    }\n  ],\n  "warnings": [\n    {\n      "explanation": "string",\n      "context": "string",\n      "id": "string"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `searchConfigs`\n\nSearch mapping configs\n\n`POST /v1/mappings:search`\n\n```ts\nconst { data } = await client.searchConfigs(\n  null,\n  {\n    source: {\n      type: \'journey\',\n      config: {\n        journey_id: \'string\'\n      }\n    }\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "id": "string",\n  "source": {\n    "type": "journey",\n    "config": {\n      "journey_id": "string"\n    }\n  },\n  "targets": [\n    {\n      "id": "string",\n      "name": "string",\n      "allow_failure": true,\n      "target_schema": "string",\n      "target_unique": ["string"],\n      "use_uniqueness_criteria": false,\n      "loop_config": {},\n      "conditionMode": "oneOf",\n      "conditions": [],\n      "mapping_attributes": [],\n      "relation_attributes": [],\n      "linkback_relation_attribute": "mapped_entities",\n      "linkback_relation_tags": ["string"],\n      "graph_context": []\n    }\n  ],\n  "created_at": "1970-01-01T00:00:00.000Z",\n  "updated_at": "1970-01-01T00:00:00.000Z",\n  "created_by": {\n    "type": "user",\n    "org_id": "string",\n    "user_id": "string"\n  },\n  "last_updated_by": {\n    "type": "user",\n    "org_id": "string",\n    "user_id": "string"\n  },\n  "org_id": "66",\n  "version": 2\n}\n```\n\n</details>\n\n---\n\n### `queryMappingHistory`\n\nGet the Mapping History\n\n`GET /v1/mappings/history`\n\n```ts\nconst { data } = await client.queryMappingHistory({\n  from: \'example\',\n  to: \'example\',\n  targetEntityId: \'example\',\n  sourceEntityId: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{}\n```\n\n</details>\n\n---\n\n### `executeRelations`\n\nExecute relation mapping between source entity and target entities\n\n`POST /v1/relations:execute`\n\n```ts\nconst { data } = await client.executeRelations(\n  null,\n  {\n    source_ref: {\n      entity_id: \'string\',\n      entity_schema: \'submission\'\n    },\n    target: {\n      main_entity_ref: {\n        entity_id: \'string\',\n        entity_schema: \'submission\'\n      },\n      relation_attributes: [\n        {\n          target: \'string\',\n          target_tags: [\'string\'],\n          target_tags_include_source: false,\n          target_entity_tags: [\'string\'],\n          override_with_source_filter: false,\n          source_filter: {\n            limit: 0,\n            schema: \'string\',\n            attribute: \'string\',\n            relation_tag: \'string\',\n            tag: \'string\',\n            self: false\n          },\n          related_to: {},\n          mode: \'append\',\n          origin: \'system_recommendation\'\n        }\n      ],\n      linkback: {\n        attribute: \'mapped_entities\',\n        relation_tags: [\'string\']\n      }\n    },\n    additional_relations: [\n      {\n        entity_id: \'string\',\n        attribute: \'string\'\n      }\n    ]\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "relations": [\n    {\n      "source_entity_id": "string",\n      "target_entity_id": "string",\n      "relation_attr": "string",\n      "tags": ["string"]\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `getMappingConfig`\n\nGet latest version of a mapping config by id V2\n\n`GET /v2/mappings/{id}`\n\n```ts\nconst { data } = await client.getMappingConfig({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "id": "string",\n  "source": {\n    "type": "journey",\n    "config": {\n      "journey_id": "string"\n    }\n  },\n  "targets": [\n    {\n      "id": "string",\n      "name": "string",\n      "allow_failure": true,\n      "target_schema": "string",\n      "target_unique": ["string"],\n      "use_uniqueness_criteria": false,\n      "loop_config": {},\n      "conditionMode": "oneOf",\n      "conditions": [],\n      "mapping_attributes": [],\n      "relation_attributes": [],\n      "linkback_relation_attribute": "mapped_entities",\n      "linkback_relation_tags": ["string"],\n      "graph_context": []\n    }\n  ],\n  "created_at": "1970-01-01T00:00:00.000Z",\n  "updated_at": "1970-01-01T00:00:00.000Z",\n  "created_by": {\n    "type": "user",\n    "org_id": "string",\n    "user_id": "string"\n  },\n  "last_updated_by": {\n    "type": "user",\n    "org_id": "string",\n    "user_id": "string"\n  },\n  "org_id": "66",\n  "version": 2\n}\n```\n\n</details>\n\n---\n\n### `putMappingConfig`\n\nStores new version of entity mapping config\n\n`PUT /v2/mappings/{id}`\n\n```ts\nconst { data } = await client.putMappingConfig(\n  {\n    id: \'123e4567-e89b-12d3-a456-426614174000\',\n  },\n  {\n    id: \'string\',\n    source: {\n      type: \'journey\',\n      config: {\n        journey_id: \'string\'\n      }\n    },\n    targets: [\n      {\n        id: \'string\',\n        name: \'string\',\n        allow_failure: true,\n        target_schema: \'string\',\n        target_unique: [\'string\'],\n        use_uniqueness_criteria: false,\n        loop_config: { /* ... */ },\n        conditionMode: \'oneOf\',\n        conditions: [ /* ... */ ],\n        mapping_attributes: [ /* ... */ ],\n        relation_attributes: [ /* ... */ ],\n        linkback_relation_attribute: \'mapped_entities\',\n        linkback_relation_tags: [\'string\'],\n        graph_context: [ /* ... */ ]\n      }\n    ],\n    created_at: \'1970-01-01T00:00:00.000Z\',\n    updated_at: \'1970-01-01T00:00:00.000Z\',\n    created_by: {\n      type: \'user\',\n      org_id: \'string\',\n      user_id: \'string\'\n    },\n    last_updated_by: {\n      type: \'user\',\n      org_id: \'string\',\n      user_id: \'string\'\n    },\n    org_id: \'66\',\n    version: 2\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "id": "string",\n  "source": {\n    "type": "journey",\n    "config": {\n      "journey_id": "string"\n    }\n  },\n  "targets": [\n    {\n      "id": "string",\n      "name": "string",\n      "allow_failure": true,\n      "target_schema": "string",\n      "target_unique": ["string"],\n      "use_uniqueness_criteria": false,\n      "loop_config": {},\n      "conditionMode": "oneOf",\n      "conditions": [],\n      "mapping_attributes": [],\n      "relation_attributes": [],\n      "linkback_relation_attribute": "mapped_entities",\n      "linkback_relation_tags": ["string"],\n      "graph_context": []\n    }\n  ],\n  "created_at": "1970-01-01T00:00:00.000Z",\n  "updated_at": "1970-01-01T00:00:00.000Z",\n  "created_by": {\n    "type": "user",\n    "org_id": "string",\n    "user_id": "string"\n  },\n  "last_updated_by": {\n    "type": "user",\n    "org_id": "string",\n    "user_id": "string"\n  },\n  "org_id": "66",\n  "version": 2\n}\n```\n\n</details>\n\n---\n\n## Schemas\n\n### `SearchMappingReq`\n\n```ts\ntype SearchMappingReq = {\n  source?: {\n    type?: "journey" | "entity"\n    config?: {\n      journey_id?: { ... }\n    } | {\n      entity_id: { ... }\n      entity_schema?: { ... }\n    }\n  }\n}\n```\n\n### `MappingConfigsResp`\n\n```ts\ntype MappingConfigsResp = {\n  configs: Array<{\n    id: string\n    source: {\n      type?: { ... }\n      config?: { ... }\n    }\n    targets: Array<{\n      id?: { ... }\n      name?: { ... }\n      allow_failure?: { ... }\n      target_schema: { ... }\n      target_unique?: { ... }\n      use_uniqueness_criteria?: { ... }\n      loop_config?: { ... }\n      conditionMode?: { ... }\n      conditions?: { ... }\n      mapping_attributes: { ... }\n      relation_attributes?: { ... }\n      linkback_relation_attribute?: { ... }\n      linkback_relation_tags?: { ... }\n      graph_context?: { ... }\n    }>\n    created_at?: string // date-time\n    updated_at?: string // date-time\n    created_by?: {\n      type: { ... }\n      org_id?: { ... }\n      user_id?: { ... }\n    }\n    last_updated_by?: {\n      type: { ... }\n      org_id?: { ... }\n      user_id?: { ... }\n    }\n    org_id?: string\n    version?: number\n  }>\n}\n```\n\n### `MappingConfigs`\n\n```ts\ntype MappingConfigs = Array<{\n  id: string\n  source: {\n    type?: "journey" | "entity"\n    config?: {\n      journey_id?: { ... }\n    } | {\n      entity_id: { ... }\n      entity_schema?: { ... }\n    }\n  }\n  targets: Array<{\n    id?: string\n    name?: string\n    allow_failure?: boolean\n    target_schema: string\n    target_unique?: string[]\n    use_uniqueness_criteria?: boolean\n    loop_config?: {\n      source_path?: { ... }\n      length?: { ... }\n    }\n    conditionMode?: "oneOf" | "anyOf" | "allOf"\n    conditions?: Array<{\n      _exists?: { ... }\n      _equals?: { ... }\n      _not_exists?: { ... }\n      _any_of?: { ... }\n    }>\n    mapping_attributes: Array<{\n      target: { ... }\n      operation: { ... }\n      origin?: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      value: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      source: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      source?: { ... }\n      value_json: { ... }\n      target_unique?: { ... }\n    }>\n    relation_attributes?: Array<{\n      target: { ... }\n      target_tags?: { ... }\n      target_tags_include_source?: { ... }\n      target_entity_tags?: { ... }\n      override_with_source_filter?: { ... }\n      source_filter?: { ... }\n      related_to?: { ... }\n      mode: { ... }\n      origin?: { ... }\n    }>\n    linkback_relation_attribute?: string\n    linkback_relation_tags?: string[]\n    graph_context?: Array<{\n      seed: { ... }\n      graph: { ... }\n    }>\n  }>\n  created_at?: string // date-time\n  updated_at?: string // date-time\n  created_by?: {\n    type: "user" | "internal_service"\n    org_id?: string\n    user_id?: string\n  }\n  last_updated_by?: {\n    type: "user" | "internal_service"\n    org_id?: string\n    user_id?: string\n  }\n  org_id?: string\n  version?: number\n}>\n```\n\n### `MappingConfig`\n\n```ts\ntype MappingConfig = {\n  id: string\n  source: {\n    type?: "journey" | "entity"\n    config?: {\n      journey_id?: { ... }\n    } | {\n      entity_id: { ... }\n      entity_schema?: { ... }\n    }\n  }\n  targets: Array<{\n    id?: string\n    name?: string\n    allow_failure?: boolean\n    target_schema: string\n    target_unique?: string[]\n    use_uniqueness_criteria?: boolean\n    loop_config?: {\n      source_path?: { ... }\n      length?: { ... }\n    }\n    conditionMode?: "oneOf" | "anyOf" | "allOf"\n    conditions?: Array<{\n      _exists?: { ... }\n      _equals?: { ... }\n      _not_exists?: { ... }\n      _any_of?: { ... }\n    }>\n    mapping_attributes: Array<{\n      target: { ... }\n      operation: { ... }\n      origin?: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      value: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      source: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      source?: { ... }\n      value_json: { ... }\n      target_unique?: { ... }\n    }>\n    relation_attributes?: Array<{\n      target: { ... }\n      target_tags?: { ... }\n      target_tags_include_source?: { ... }\n      target_entity_tags?: { ... }\n      override_with_source_filter?: { ... }\n      source_filter?: { ... }\n      related_to?: { ... }\n      mode: { ... }\n      origin?: { ... }\n    }>\n    linkback_relation_attribute?: string\n    linkback_relation_tags?: string[]\n    graph_context?: Array<{\n      seed: { ... }\n      graph: { ... }\n    }>\n  }>\n  created_at?: string // date-time\n  updated_at?: string // date-time\n  created_by?: {\n    type: "user" | "internal_service"\n    org_id?: string\n    user_id?: string\n  }\n  last_updated_by?: {\n    type: "user" | "internal_service"\n    org_id?: string\n    user_id?: string\n  }\n  org_id?: string\n  version?: number\n}\n```\n\n### `MappingConfigV2`\n\n```ts\ntype MappingConfigV2 = {\n  id: string\n  source: {\n    type?: "journey" | "entity"\n    config?: {\n      journey_id?: { ... }\n    } | {\n      entity_id: { ... }\n      entity_schema?: { ... }\n    }\n  }\n  targets: Array<{\n    id?: string\n    name?: string\n    allow_failure?: boolean\n    target_schema: string\n    target_unique?: string[]\n    use_uniqueness_criteria?: boolean\n    loop_config?: {\n      source_path?: { ... }\n      length?: { ... }\n    }\n    conditionMode?: "oneOf" | "anyOf" | "allOf"\n    conditions?: Array<{\n      _exists?: { ... }\n      _equals?: { ... }\n      _not_exists?: { ... }\n      _any_of?: { ... }\n    }>\n    mapping_attributes: Array<{\n      target: { ... }\n      operation: { ... }\n      origin?: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      value: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      source: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      source?: { ... }\n      value_json: { ... }\n      target_unique?: { ... }\n    }>\n    relation_attributes?: Array<{\n      target: { ... }\n      target_tags?: { ... }\n      target_tags_include_source?: { ... }\n      target_entity_tags?: { ... }\n      override_with_source_filter?: { ... }\n      source_filter?: { ... }\n      related_to?: { ... }\n      mode: { ... }\n      origin?: { ... }\n    }>\n    linkback_relation_attribute?: string\n    linkback_relation_tags?: string[]\n    graph_context?: Array<{\n      seed: { ... }\n      graph: { ... }\n    }>\n  }>\n  created_at?: string // date-time\n  updated_at?: string // date-time\n  created_by?: {\n    type: "user" | "internal_service"\n    org_id?: string\n    user_id?: string\n  }\n  last_updated_by?: {\n    type: "user" | "internal_service"\n    org_id?: string\n    user_id?: string\n  }\n  org_id?: string\n  version?: number\n}\n```\n\n### `MappingConfigCommonFields`\n\n```ts\ntype MappingConfigCommonFields = {\n  id: string\n  source: {\n    type?: "journey" | "entity"\n    config?: {\n      journey_id?: { ... }\n    } | {\n      entity_id: { ... }\n      entity_schema?: { ... }\n    }\n  }\n  targets: Array<{\n    id?: string\n    name?: string\n    allow_failure?: boolean\n    target_schema: string\n    target_unique?: string[]\n    use_uniqueness_criteria?: boolean\n    loop_config?: {\n      source_path?: { ... }\n      length?: { ... }\n    }\n    conditionMode?: "oneOf" | "anyOf" | "allOf"\n    conditions?: Array<{\n      _exists?: { ... }\n      _equals?: { ... }\n      _not_exists?: { ... }\n      _any_of?: { ... }\n    }>\n    mapping_attributes: Array<{\n      target: { ... }\n      operation: { ... }\n      origin?: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      value: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      source: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      source?: { ... }\n      value_json: { ... }\n      target_unique?: { ... }\n    }>\n    relation_attributes?: Array<{\n      target: { ... }\n      target_tags?: { ... }\n      target_tags_include_source?: { ... }\n      target_entity_tags?: { ... }\n      override_with_source_filter?: { ... }\n      source_filter?: { ... }\n      related_to?: { ... }\n      mode: { ... }\n      origin?: { ... }\n    }>\n    linkback_relation_attribute?: string\n    linkback_relation_tags?: string[]\n    graph_context?: Array<{\n      seed: { ... }\n      graph: { ... }\n    }>\n  }>\n  created_at?: string // date-time\n  updated_at?: string // date-time\n  created_by?: {\n    type: "user" | "internal_service"\n    org_id?: string\n    user_id?: string\n  }\n  last_updated_by?: {\n    type: "user" | "internal_service"\n    org_id?: string\n    user_id?: string\n  }\n}\n```\n\n### `Owner`\n\n```ts\ntype Owner = {\n  type: "user" | "internal_service"\n  org_id?: string\n  user_id?: string\n}\n```\n\n### `ExecuteRelationsReq`\n\nBuild relations between a source entity and one or more target entities, dynamically identified\n\n```ts\ntype ExecuteRelationsReq = {\n  source_ref: {\n    entity_id: string\n    entity_schema?: string\n  }\n  target?: {\n    main_entity_ref: {\n      entity_id: { ... }\n      entity_schema?: { ... }\n    }\n    relation_attributes: Array<{\n      target: { ... }\n      target_tags?: { ... }\n      target_tags_include_source?: { ... }\n      target_entity_tags?: { ... }\n      override_with_source_filter?: { ... }\n      source_filter?: { ... }\n      related_to?: { ... }\n      mode: { ... }\n      origin?: { ... }\n    }>\n    linkback?: {\n      attribute: { ... }\n      relation_tags: { ... }\n    }\n  }\n  additional_relations?: Array<{\n    entity_id: string\n    attribute: string\n  }>\n}\n```\n\n### `ExecuteRelationsResp`\n\n```ts\ntype ExecuteRelationsResp = {\n  relations?: Array<{\n    source_entity_id: string\n    target_entity_id: string\n    relation_attr: string\n    tags?: string[]\n  }>\n}\n```\n\n### `NewRelationItem`\n\n```ts\ntype NewRelationItem = {\n  source_entity_id: string\n  target_entity_id: string\n  relation_attr: string\n  tags?: string[]\n}\n```\n\n### `RelationItem`\n\n```ts\ntype RelationItem = {\n  entity_id: string\n  attribute: string\n}\n```\n\n### `ExecuteMappingReq`\n\nPass either source or source_entity\n\n```ts\ntype ExecuteMappingReq = {\n  source_ref: {\n    entity_id: string\n    entity_schema?: string\n  }\n  loop_ref?: {\n    entity_id: string\n    entity_schema?: string\n  }\n  targets: Array<{\n    id?: string\n    name?: string\n    allow_failure?: boolean\n    target_schema: string\n    target_unique?: string[]\n    use_uniqueness_criteria?: boolean\n    loop_config?: {\n      source_path?: { ... }\n      length?: { ... }\n    }\n    conditionMode?: "oneOf" | "anyOf" | "allOf"\n    conditions?: Array<{\n      _exists?: { ... }\n      _equals?: { ... }\n      _not_exists?: { ... }\n      _any_of?: { ... }\n    }>\n    mapping_attributes: Array<{\n      target: { ... }\n      operation: { ... }\n      origin?: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      value: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      source: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      source?: { ... }\n      value_json: { ... }\n      target_unique?: { ... }\n    }>\n    relation_attributes?: Array<{\n      target: { ... }\n      target_tags?: { ... }\n      target_tags_include_source?: { ... }\n      target_entity_tags?: { ... }\n      override_with_source_filter?: { ... }\n      source_filter?: { ... }\n      related_to?: { ... }\n      mode: { ... }\n      origin?: { ... }\n    }>\n    linkback_relation_attribute?: string\n    linkback_relation_tags?: string[]\n    graph_context?: Array<{\n      seed: { ... }\n      graph: { ... }\n    }>\n  }>\n}\n```\n\n### `ExecuteMappingResp`\n\n```ts\ntype ExecuteMappingResp = {\n  mapped_entities: Array<{\n    _id?: string\n    _schema?: string\n    _title?: string\n    _org?: string\n    _tags?: string[]\n    _created_at?: string\n    _updated_at?: string\n    required?: unknown\n  }>\n  failures?: Array<{\n    target?: {\n      id?: { ... }\n      name?: { ... }\n      allow_failure?: { ... }\n      target_schema: { ... }\n      target_unique?: { ... }\n      use_uniqueness_criteria?: { ... }\n      loop_config?: { ... }\n      conditionMode?: { ... }\n      conditions?: { ... }\n      mapping_attributes: { ... }\n      relation_attributes?: { ... }\n      linkback_relation_attribute?: { ... }\n      linkback_relation_tags?: { ... }\n      graph_context?: { ... }\n    }\n    error?: {\n      isSilent?: { ... }\n      message?: { ... }\n    }\n  }>\n  warnings?: Array<{\n    explanation: string\n    context?: string\n    id?: string\n  }>\n}\n```\n\n### `MappingFailure`\n\n```ts\ntype MappingFailure = {\n  target?: {\n    id?: string\n    name?: string\n    allow_failure?: boolean\n    target_schema: string\n    target_unique?: string[]\n    use_uniqueness_criteria?: boolean\n    loop_config?: {\n      source_path?: { ... }\n      length?: { ... }\n    }\n    conditionMode?: "oneOf" | "anyOf" | "allOf"\n    conditions?: Array<{\n      _exists?: { ... }\n      _equals?: { ... }\n      _not_exists?: { ... }\n      _any_of?: { ... }\n    }>\n    mapping_attributes: Array<{\n      target: { ... }\n      operation: { ... }\n      origin?: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      value: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      source: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      source?: { ... }\n      value_json: { ... }\n      target_unique?: { ... }\n    }>\n    relation_attributes?: Array<{\n      target: { ... }\n      target_tags?: { ... }\n      target_tags_include_source?: { ... }\n      target_entity_tags?: { ... }\n      override_with_source_filter?: { ... }\n      source_filter?: { ... }\n      related_to?: { ... }\n      mode: { ... }\n      origin?: { ... }\n    }>\n    linkback_relation_attribute?: string\n    linkback_relation_tags?: string[]\n    graph_context?: Array<{\n      seed: { ... }\n      graph: { ... }\n    }>\n  }\n  error?: {\n    isSilent?: boolean\n    message?: string\n  }\n}\n```\n\n### `MappingWarning`\n\n```ts\ntype MappingWarning = {\n  explanation: string\n  context?: string\n  id?: string\n}\n```\n\n### `Entity`\n\n```ts\ntype Entity = {\n  _id?: string\n  _schema?: string\n  _title?: string\n  _org?: string\n  _tags?: string[]\n  _created_at?: string\n  _updated_at?: string\n  required?: unknown\n}\n```\n\n### `EntityRef`\n\n```ts\ntype EntityRef = {\n  entity_id: string\n  entity_schema?: string\n}\n```\n\n### `SourceConfig`\n\n```ts\ntype SourceConfig = {\n  type?: "journey" | "entity"\n  config?: {\n    journey_id?: string\n  } | {\n    entity_id: string\n    entity_schema?: string\n  }\n}\n```\n\n### `JourneyRef`\n\n```ts\ntype JourneyRef = {\n  journey_id?: string\n}\n```\n\n### `Loop_Index_String`\n\nThis string value will be replaced with the value of the loop index, when mapping in loop mode\n\n```ts\ntype Loop_Index_String = "##LOOP_INDEX##"\n```\n\n### `TargetConfig`\n\n```ts\ntype TargetConfig = {\n  id?: string\n  name?: string\n  allow_failure?: boolean\n  target_schema: string\n  target_unique?: string[]\n  use_uniqueness_criteria?: boolean\n  loop_config?: {\n    source_path?: string\n    length?: number\n  }\n  conditionMode?: "oneOf" | "anyOf" | "allOf"\n  conditions?: Array<{\n    _exists?: {\n      source?: { ... }\n      value?: { ... }\n    }\n    _equals?: {\n      source?: { ... }\n      value?: { ... }\n    }\n    _not_exists?: {\n      source?: { ... }\n      value?: { ... }\n    }\n    _any_of?: {\n      source?: { ... }\n      value?: { ... }\n    }\n  }>\n  mapping_attributes: Array<{\n    target: string\n    operation: {\n      _set?: { ... }\n      _append?: { ... }\n      _prepend?: { ... }\n      _uniq?: { ... }\n      _retain_old_values?: { ... }\n      _copy?: { ... }\n      _template?: { ... }\n      _random?: { ... }\n      _each?: { ... }\n      _as?: { ... }\n      _map?: { ... }\n    } | string | boolean | number | Record<string, unknown> | unknown[]\n    origin?: "system_recommendation" | "user_manually" | "entity_updating_system_recommendation"\n  } | {\n    mode: "copy_if_exists" | "append_if_exists" | "set_value"\n    target: string\n    value: unknown\n  } | {\n    mode: "copy_if_exists" | "append_if_exists" | "set_value"\n    target: string\n    source: string\n  } | {\n    mode: "copy_if_exists" | "append_if_exists" | "set_value"\n    target: string\n    source?: string\n    value_json: string\n    target_unique?: string[]\n  }>\n  relation_attributes?: Array<{\n    target: string\n    target_tags?: string[]\n    target_tags_include_source?: boolean\n    target_entity_tags?: string[]\n    override_with_source_filter?: boolean\n    source_filter?: {\n      limit?: { ... }\n      schema?: { ... }\n      attribute?: { ... }\n      relation_tag?: { ... }\n      tag?: { ... }\n      self?: { ... }\n    }\n    related_to?: Record<string, unknown>\n    mode: "append" | "prepend" | "set"\n    origin?: "system_recommendation" | "user_manually" | "entity_updating_system_recommendation"\n  }>\n  linkback_relation_attribute?: string\n  linkback_relation_tags?: string[]\n  graph_context?: Array<{\n    seed: {\n      entity_id: { ... }\n      node_id: { ... }\n    }\n    graph: {\n      nodes: { ... }\n      edges: { ... }\n    }\n  }>\n}\n```\n\n### `MapCondition`\n\n```ts\ntype MapCondition = {\n  _exists?: {\n    source?: string\n    value?: string | number | object | object[]\n  }\n  _equals?: {\n    source?: string\n    value?: string | number | object | object[]\n  }\n  _not_exists?: {\n    source?: string\n    value?: string | number | object | object[]\n  }\n  _any_of?: {\n    source?: string\n    value?: string | number | object | object[]\n  }\n}\n```\n\n### `ConditionNode`\n\n```ts\ntype ConditionNode = {\n  source?: string\n  value?: string | number | object | object[]\n}\n```\n\n### `RelationAttribute`\n\n```ts\ntype RelationAttribute = {\n  target: string\n  target_tags?: string[]\n  target_tags_include_source?: boolean\n  target_entity_tags?: string[]\n  override_with_source_filter?: boolean\n  source_filter?: {\n    limit?: number\n    schema?: string\n    attribute?: string\n    relation_tag?: string\n    tag?: string\n    self?: boolean\n  }\n  related_to?: Record<string, unknown>\n  mode: "append" | "prepend" | "set"\n  origin?: "system_recommendation" | "user_manually" | "entity_updating_system_recommendation"\n}\n```\n\n### `GraphContextEntry`\n\nOne multi-hop graph lookup against entity-api\'s `POST /v1/entity:graph`, resolved during\ngraph_context enrichment (before mapping_attributes are evaluated). Every node in `graph.nodes`\nis merged into sourceContext under its own `id`, so listing several nodes here costs one\nentity-api call, not one p\n\n```ts\ntype GraphContextEntry = {\n  seed: {\n    entity_id: string\n    node_id: string\n  }\n  graph: {\n    nodes: Array<{\n      id: { ... }\n      schema: { ... }\n      cardinality?: { ... }\n      fields?: { ... }\n      filter?: { ... }\n    }>\n    edges: Array<{\n      from: { ... }\n      to: { ... }\n    }>\n  }\n}\n```\n\n### `GraphSeed`\n\nMirrors entity-api\'s GraphSeed (see entity-api openapi.yml) - the entity the graph traversal starts from.\n\n```ts\ntype GraphSeed = {\n  entity_id: string\n  node_id: string\n}\n```\n\n### `GraphDefinition`\n\nMirrors entity-api\'s GraphDefinition (see entity-api openapi.yml) - the shape of the graph to traverse.\n\n```ts\ntype GraphDefinition = {\n  nodes: Array<{\n    id: string\n    schema: string\n    cardinality?: "one" | "many"\n    fields?: string[]\n    filter?: Array<{\n      attribute: { ... }\n      value: { ... }\n    }>\n  }>\n  edges: Array<{\n    from: string\n    to: string\n  }>\n}\n```\n\n### `GraphNode`\n\nMirrors entity-api\'s GraphNode (see entity-api openapi.yml).\n\n```ts\ntype GraphNode = {\n  id: string\n  schema: string\n  cardinality?: "one" | "many"\n  fields?: string[]\n  filter?: Array<{\n    attribute: string\n    value: string | number | boolean\n  }>\n}\n```\n\n### `GraphNodeFilter`\n\nMirrors entity-api\'s GraphNodeFilter (see entity-api openapi.yml).\n\n```ts\ntype GraphNodeFilter = {\n  attribute: string\n  value: string | number | boolean\n}\n```\n\n### `GraphEdge`\n\nMirrors entity-api\'s GraphEdge (see entity-api openapi.yml).\n\n```ts\ntype GraphEdge = {\n  from: string\n  to: string\n}\n```\n\n### `MappingAttributeV2`\n\n```ts\ntype MappingAttributeV2 = {\n  target: string\n  operation: {\n    _set?: string | boolean | number | Record<string, unknown> | unknown[]\n    _append?: unknown\n    _prepend?: unknown\n    _uniq?: boolean | string[]\n    _retain_old_values?: boolean\n    _copy?: string\n    _template?: string\n    _random?: {\n      type: { ... }\n    } | {\n      type: { ... }\n      min?: { ... }\n      max?: { ... }\n    }\n    _each?: string\n    _as?: string\n    _map?: {\n      _set?: { ... }\n      _append?: { ... }\n      _prepend?: { ... }\n      _uniq?: { ... }\n      _retain_old_values?: { ... }\n      _copy?: { ... }\n      _template?: { ... }\n      _random?: { ... }\n      _each?: { ... }\n      _as?: { ... }\n      _map?: { ... }\n    } | string | boolean | number | Record<string, unknown> | unknown[]\n  } | string | boolean | number | Record<string, unknown> | unknown[]\n  origin?: "system_recommendation" | "user_manually" | "entity_updating_system_recommendation"\n}\n```\n\n### `AttributeOrigin`\n\nOrigin of an attribute.\n\n```ts\ntype AttributeOrigin = "system_recommendation" | "user_manually" | "entity_updating_system_recommendation"\n```\n\n### `OperationNode`\n\nMapping operation nodes are either primitive values or operation node objects\n\n```ts\ntype OperationNode = {\n  _set?: string | boolean | number | Record<string, unknown> | unknown[]\n  _append?: unknown\n  _prepend?: unknown\n  _uniq?: boolean | string[]\n  _retain_old_values?: boolean\n  _copy?: string\n  _template?: string\n  _random?: {\n    type: "uuid" | "nanoid"\n  } | {\n    type: "number"\n    min?: number\n    max?: number\n  }\n  _each?: string\n  _as?: string\n  _map?: {\n    _set?: string | boolean | number | Record<string, unknown> | unknown[]\n    _append?: unknown\n    _prepend?: unknown\n    _uniq?: boolean | string[]\n    _retain_old_values?: boolean\n    _copy?: string\n    _template?: string\n    _random?: {\n      type: { ... }\n    } | {\n      type: { ... }\n      min?: { ... }\n      max?: { ... }\n    }\n    _each?: string\n    _as?: string\n    _map?: {\n      _set?: { ... }\n      _append?: { ... }\n      _prepend?: { ... }\n      _uniq?: { ... }\n      _retain_old_values?: { ... }\n      _copy?: { ... }\n      _template?: { ... }\n      _random?: { ... }\n      _each?: { ... }\n      _as?: { ... }\n      _map?: { ... }\n    } | string | boolean | number | Record<string, unknown> | unknown[]\n  } | string | boolean | number | Record<string, unknown> | unknown[]\n} | string | boolean | number | Record<string, unknown> | unknown[]\n```\n\n### `OperationObjectNode`\n\n```ts\ntype OperationObjectNode = {\n  _set?: string | boolean | number | Record<string, unknown> | unknown[]\n  _append?: unknown\n  _prepend?: unknown\n  _uniq?: boolean | string[]\n  _retain_old_values?: boolean\n  _copy?: string\n  _template?: string\n  _random?: {\n    type: "uuid" | "nanoid"\n  } | {\n    type: "number"\n    min?: number\n    max?: number\n  }\n  _each?: string\n  _as?: string\n  _map?: {\n    _set?: string | boolean | number | Record<string, unknown> | unknown[]\n    _append?: unknown\n    _prepend?: unknown\n    _uniq?: boolean | string[]\n    _retain_old_values?: boolean\n    _copy?: string\n    _template?: string\n    _random?: {\n      type: { ... }\n    } | {\n      type: { ... }\n      min?: { ... }\n      max?: { ... }\n    }\n    _each?: string\n    _as?: string\n    _map?: {\n      _set?: { ... }\n      _append?: { ... }\n      _prepend?: { ... }\n      _uniq?: { ... }\n      _retain_old_values?: { ... }\n      _copy?: { ... }\n      _template?: { ... }\n      _random?: { ... }\n      _each?: { ... }\n      _as?: { ... }\n      _map?: { ... }\n    } | string | boolean | number | Record<string, unknown> | unknown[]\n  } | string | boolean | number | Record<string, unknown> | unknown[]\n}\n```\n\n### `PrimitiveJSONValue`\n\nRepresents any primitive JSON value\n\n```ts\ntype PrimitiveJSONValue = string | boolean | number | Record<string, unknown> | unknown[]\n```\n\n### `RandomOperation`\n\n```ts\ntype RandomOperation = {\n  type: "uuid" | "nanoid"\n} | {\n  type: "number"\n  min?: number\n  max?: number\n}\n```\n\n### `MappingAttribute`\n\n```ts\ntype MappingAttribute = {\n  mode: "copy_if_exists" | "append_if_exists" | "set_value"\n  target: string\n  value: unknown\n} | {\n  mode: "copy_if_exists" | "append_if_exists" | "set_value"\n  target: string\n  source: string\n} | {\n  mode: "copy_if_exists" | "append_if_exists" | "set_value"\n  target: string\n  source?: string\n  value_json: string\n  target_unique?: string[]\n}\n```\n\n### `MappingAttributeMode`\n\n- copy_if_exists - it replaces the target attribute with the source value - append_if_exists - it currently replaces target attribute with array like values. Useful when you have multiple values to be added into one attribute. - set_value - it sets a value to a predefined value. Must be used togethe\n\n```ts\ntype MappingAttributeMode = "copy_if_exists" | "append_if_exists" | "set_value"\n```\n\n### `SetValueMapper`\n\n```ts\ntype SetValueMapper = {\n  mode: "copy_if_exists" | "append_if_exists" | "set_value"\n  target: string\n  value: unknown\n}\n```\n\n### `CopyValueMapper`\n\n```ts\ntype CopyValueMapper = {\n  mode: "copy_if_exists" | "append_if_exists" | "set_value"\n  target: string\n  source: string\n}\n```\n\n### `AppendValueMapper`\n\n```ts\ntype AppendValueMapper = {\n  mode: "copy_if_exists" | "append_if_exists" | "set_value"\n  target: string\n  source?: string\n  value_json: string\n  target_unique?: string[]\n}\n```\n\n### `MappingHistoryResp`\n\n```ts\ntype MappingHistoryResp = {\n  results: Array<{\n    id: string\n    timestamp: string // ISO datetime\n    source_entity_snapshot: {\n      _id?: { ... }\n      _schema?: { ... }\n      _title?: { ... }\n      _org?: { ... }\n      _tags?: { ... }\n      _created_at?: { ... }\n      _updated_at?: { ... }\n      required?: { ... }\n    }\n    mapped_entities_snapshot: Array<{\n      _id?: { ... }\n      _schema?: { ... }\n      _title?: { ... }\n      _org?: { ... }\n      _tags?: { ... }\n      _created_at?: { ... }\n      _updated_at?: { ... }\n      required?: { ... }\n    }>\n    target_configs_snapshot: Array<{\n      id?: { ... }\n      name?: { ... }\n      allow_failure?: { ... }\n      target_schema: { ... }\n      target_unique?: { ... }\n      use_uniqueness_criteria?: { ... }\n      loop_config?: { ... }\n      conditionMode?: { ... }\n      conditions?: { ... }\n      mapping_attributes: { ... }\n      relation_attributes?: { ... }\n      linkback_relation_attribute?: { ... }\n      linkback_relation_tags?: { ... }\n      graph_context?: { ... }\n    }>\n  }>\n}\n```\n\n### `MappingHistoryEntry`\n\n```ts\ntype MappingHistoryEntry = {\n  id: string\n  timestamp: string // ISO datetime\n  source_entity_snapshot: {\n    _id?: string\n    _schema?: string\n    _title?: string\n    _org?: string\n    _tags?: string[]\n    _created_at?: string\n    _updated_at?: string\n    required?: unknown\n  }\n  mapped_entities_snapshot: Array<{\n    _id?: string\n    _schema?: string\n    _title?: string\n    _org?: string\n    _tags?: string[]\n    _created_at?: string\n    _updated_at?: string\n    required?: unknown\n  }>\n  target_configs_snapshot: Array<{\n    id?: string\n    name?: string\n    allow_failure?: boolean\n    target_schema: string\n    target_unique?: string[]\n    use_uniqueness_criteria?: boolean\n    loop_config?: {\n      source_path?: { ... }\n      length?: { ... }\n    }\n    conditionMode?: "oneOf" | "anyOf" | "allOf"\n    conditions?: Array<{\n      _exists?: { ... }\n      _equals?: { ... }\n      _not_exists?: { ... }\n      _any_of?: { ... }\n    }>\n    mapping_attributes: Array<{\n      target: { ... }\n      operation: { ... }\n      origin?: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      value: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      source: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      source?: { ... }\n      value_json: { ... }\n      target_unique?: { ... }\n    }>\n    relation_attributes?: Array<{\n      target: { ... }\n      target_tags?: { ... }\n      target_tags_include_source?: { ... }\n      target_entity_tags?: { ... }\n      override_with_source_filter?: { ... }\n      source_filter?: { ... }\n      related_to?: { ... }\n      mode: { ... }\n      origin?: { ... }\n    }>\n    linkback_relation_attribute?: string\n    linkback_relation_tags?: string[]\n    graph_context?: Array<{\n      seed: { ... }\n      graph: { ... }\n    }>\n  }>\n}\n```\n\n### `MappingSource`\n\n```ts\ntype MappingSource = {\n  key: string\n  sub_properties?: Array<{\n    value: string\n    label: string\n    initial_target_value?: string\n    possible_target_types?: "string" | "date" | "datetime" | "boolean" | "number" | "image" | "file" | "address" | "email" | "phone" | "select" | "multiselect" | "payment" | "link" | "currency" | "sequence" | "relation" | "array"[]\n    raw?: boolean\n  }>\n  source_type: string\n  group?: string\n  possible_target_types?: "string" | "date" | "datetime" | "boolean" | "number" | "image" | "file" | "address" | "email" | "phone" | "select" | "multiselect" | "payment" | "link" | "currency" | "sequence" | "relation" | "array"[]\n  initial_relation?: {\n    target: string\n    target_tags?: string[]\n    target_tags_include_source?: boolean\n    target_entity_tags?: string[]\n    override_with_source_filter?: boolean\n    source_filter?: {\n      limit?: { ... }\n      schema?: { ... }\n      attribute?: { ... }\n      relation_tag?: { ... }\n      tag?: { ... }\n      self?: { ... }\n    }\n    related_to?: Record<string, unknown>\n    mode: "append" | "prepend" | "set"\n    origin?: "system_recommendation" | "user_manually" | "entity_updating_system_recommendation"\n  }\n  title: string\n  sub_title?: string\n  repeatable?: boolean\n  target_settings?: {\n    allowed_ui_actions?: "schema-select" | "attribute-select" | "target-delete" | "target-add" | "target"[]\n    locked?: "each" | "first" | "system_recommendation"\n    isSingleTarget?: boolean\n    visibility?: {\n      mode: { ... }\n      if: { ... }\n      message?: { ... }\n    }\n  }\n}\n```\n\n### `MappingSourceProperty`\n\n```ts\ntype MappingSourceProperty = {\n  value: string\n  label: string\n  initial_target_value?: string\n  possible_target_types?: "string" | "date" | "datetime" | "boolean" | "number" | "image" | "file" | "address" | "email" | "phone" | "select" | "multiselect" | "payment" | "link" | "currency" | "sequence" | "relation" | "array"[]\n  raw?: boolean\n}\n```\n\n### `MappingSourceTargetType`\n\n```ts\ntype MappingSourceTargetType = "string" | "date" | "datetime" | "boolean" | "number" | "image" | "file" | "address" | "email" | "phone" | "select" | "multiselect" | "payment" | "link" | "currency" | "sequence" | "relation" | "array"\n```\n';
+var entity_mapping_default = '# Entity Mapping API\n\n- **Base URL:** `https://entity-mapping.sls.epilot.io`\n- **Full API Docs:** [https://docs.epilot.io/api/entity-mapping](https://docs.epilot.io/api/entity-mapping)\n\n## Usage\n\n```ts\nimport { epilot } from \'@epilot/sdk\'\n\nepilot.authorize(() => \'<token>\')\nconst { data } = await epilot.entityMapping.storeConfig(...)\n```\n\n### Tree-shakeable import\n\n```ts\nimport { getClient, authorize } from \'@epilot/sdk/entity-mapping\'\n\nconst entityMappingClient = getClient()\nauthorize(entityMappingClient, () => \'<token>\')\nconst { data } = await entityMappingClient.storeConfig(...)\n```\n\n## Operations\n\n**mappings**\n- [`storeConfig`](#storeconfig)\n- [`getConfig`](#getconfig)\n- [`deleteConfig`](#deleteconfig)\n- [`getAllVersions`](#getallversions)\n- [`storeNewVersion`](#storenewversion)\n- [`getConfigVersion`](#getconfigversion)\n- [`executeMapping`](#executemapping)\n- [`searchConfigs`](#searchconfigs)\n- [`queryMappingHistory`](#querymappinghistory)\n- [`executeRelations`](#executerelations)\n- [`getMappingConfig`](#getmappingconfig)\n- [`putMappingConfig`](#putmappingconfig)\n\n**Schemas**\n- [`SearchMappingReq`](#searchmappingreq)\n- [`MappingConfigsResp`](#mappingconfigsresp)\n- [`MappingConfigs`](#mappingconfigs)\n- [`MappingConfig`](#mappingconfig)\n- [`MappingConfigV2`](#mappingconfigv2)\n- [`MappingConfigCommonFields`](#mappingconfigcommonfields)\n- [`Owner`](#owner)\n- [`ExecuteRelationsReq`](#executerelationsreq)\n- [`ExecuteRelationsResp`](#executerelationsresp)\n- [`NewRelationItem`](#newrelationitem)\n- [`RelationItem`](#relationitem)\n- [`ExecuteMappingReq`](#executemappingreq)\n- [`ExecuteMappingResp`](#executemappingresp)\n- [`MappingFailure`](#mappingfailure)\n- [`MappingWarning`](#mappingwarning)\n- [`Entity`](#entity)\n- [`EntityRef`](#entityref)\n- [`SourceConfig`](#sourceconfig)\n- [`JourneyRef`](#journeyref)\n- [`Loop_Index_String`](#loop_index_string)\n- [`TargetConfig`](#targetconfig)\n- [`MapCondition`](#mapcondition)\n- [`ConditionNode`](#conditionnode)\n- [`RelationAttribute`](#relationattribute)\n- [`GraphContextEntry`](#graphcontextentry)\n- [`GraphSeed`](#graphseed)\n- [`GraphDefinition`](#graphdefinition)\n- [`GraphNode`](#graphnode)\n- [`GraphNodeFilter`](#graphnodefilter)\n- [`GraphEdge`](#graphedge)\n- [`MappingAttributeV2`](#mappingattributev2)\n- [`AttributeOrigin`](#attributeorigin)\n- [`OperationNode`](#operationnode)\n- [`OperationObjectNode`](#operationobjectnode)\n- [`PrimitiveJSONValue`](#primitivejsonvalue)\n- [`RandomOperation`](#randomoperation)\n- [`MappingAttribute`](#mappingattribute)\n- [`MappingAttributeMode`](#mappingattributemode)\n- [`SetValueMapper`](#setvaluemapper)\n- [`CopyValueMapper`](#copyvaluemapper)\n- [`AppendValueMapper`](#appendvaluemapper)\n- [`MappingHistoryResp`](#mappinghistoryresp)\n- [`MappingHistoryEntry`](#mappinghistoryentry)\n- [`MappingSource`](#mappingsource)\n- [`MappingSourceProperty`](#mappingsourceproperty)\n- [`MappingSourceTargetType`](#mappingsourcetargettype)\n\n### `storeConfig`\n\nStore new MappingConfig\n\n`POST /v1/mappings`\n\n```ts\nconst { data } = await client.storeConfig(\n  {\n    with_id: \'example\',\n  },\n  {\n    id: \'string\',\n    source: {\n      type: \'journey\',\n      config: {\n        journey_id: \'string\'\n      }\n    },\n    targets: [\n      {\n        id: \'string\',\n        name: \'string\',\n        allow_failure: true,\n        target_schema: \'string\',\n        target_unique: [\'string\'],\n        use_uniqueness_criteria: false,\n        loop_config: { /* ... */ },\n        conditionMode: \'oneOf\',\n        conditions: [ /* ... */ ],\n        mapping_attributes: [ /* ... */ ],\n        relation_attributes: [ /* ... */ ],\n        linkback_relation_attribute: \'mapped_entities\',\n        linkback_relation_tags: [\'string\'],\n        graph_context: [ /* ... */ ]\n      }\n    ],\n    created_at: \'1970-01-01T00:00:00.000Z\',\n    updated_at: \'1970-01-01T00:00:00.000Z\',\n    created_by: {\n      type: \'user\',\n      org_id: \'string\',\n      user_id: \'string\'\n    },\n    last_updated_by: {\n      type: \'user\',\n      org_id: \'string\',\n      user_id: \'string\'\n    },\n    org_id: \'66\',\n    version: 2\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "id": "string",\n  "source": {\n    "type": "journey",\n    "config": {\n      "journey_id": "string"\n    }\n  },\n  "targets": [\n    {\n      "id": "string",\n      "name": "string",\n      "allow_failure": true,\n      "target_schema": "string",\n      "target_unique": ["string"],\n      "use_uniqueness_criteria": false,\n      "loop_config": {},\n      "conditionMode": "oneOf",\n      "conditions": [],\n      "mapping_attributes": [],\n      "relation_attributes": [],\n      "linkback_relation_attribute": "mapped_entities",\n      "linkback_relation_tags": ["string"],\n      "graph_context": []\n    }\n  ],\n  "created_at": "1970-01-01T00:00:00.000Z",\n  "updated_at": "1970-01-01T00:00:00.000Z",\n  "created_by": {\n    "type": "user",\n    "org_id": "string",\n    "user_id": "string"\n  },\n  "last_updated_by": {\n    "type": "user",\n    "org_id": "string",\n    "user_id": "string"\n  },\n  "org_id": "66",\n  "version": 2\n}\n```\n\n</details>\n\n---\n\n### `getConfig`\n\nGet latest version of a mapping config by id\n\n`GET /v1/mappings/{id}`\n\n```ts\nconst { data } = await client.getConfig({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "id": "string",\n  "source": {\n    "type": "journey",\n    "config": {\n      "journey_id": "string"\n    }\n  },\n  "targets": [\n    {\n      "id": "string",\n      "name": "string",\n      "allow_failure": true,\n      "target_schema": "string",\n      "target_unique": ["string"],\n      "use_uniqueness_criteria": false,\n      "loop_config": {},\n      "conditionMode": "oneOf",\n      "conditions": [],\n      "mapping_attributes": [],\n      "relation_attributes": [],\n      "linkback_relation_attribute": "mapped_entities",\n      "linkback_relation_tags": ["string"],\n      "graph_context": []\n    }\n  ],\n  "created_at": "1970-01-01T00:00:00.000Z",\n  "updated_at": "1970-01-01T00:00:00.000Z",\n  "created_by": {\n    "type": "user",\n    "org_id": "string",\n    "user_id": "string"\n  },\n  "last_updated_by": {\n    "type": "user",\n    "org_id": "string",\n    "user_id": "string"\n  },\n  "org_id": "66",\n  "version": 2\n}\n```\n\n</details>\n\n---\n\n### `deleteConfig`\n\nDelete entity mapping config\n\n`DELETE /v1/mappings/{id}`\n\n```ts\nconst { data } = await client.deleteConfig({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "id": "string",\n  "source": {\n    "type": "journey",\n    "config": {\n      "journey_id": "string"\n    }\n  },\n  "targets": [\n    {\n      "id": "string",\n      "name": "string",\n      "allow_failure": true,\n      "target_schema": "string",\n      "target_unique": ["string"],\n      "use_uniqueness_criteria": false,\n      "loop_config": {},\n      "conditionMode": "oneOf",\n      "conditions": [],\n      "mapping_attributes": [],\n      "relation_attributes": [],\n      "linkback_relation_attribute": "mapped_entities",\n      "linkback_relation_tags": ["string"],\n      "graph_context": []\n    }\n  ],\n  "created_at": "1970-01-01T00:00:00.000Z",\n  "updated_at": "1970-01-01T00:00:00.000Z",\n  "created_by": {\n    "type": "user",\n    "org_id": "string",\n    "user_id": "string"\n  },\n  "last_updated_by": {\n    "type": "user",\n    "org_id": "string",\n    "user_id": "string"\n  },\n  "org_id": "66",\n  "version": 2\n}\n```\n\n</details>\n\n---\n\n### `getAllVersions`\n\nGet all version of MappingConfig\n\n`GET /v1/mappings/{id}/versions`\n\n```ts\nconst { data } = await client.getAllVersions({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "configs": [\n    {\n      "id": "string",\n      "source": {},\n      "targets": [],\n      "created_at": "1970-01-01T00:00:00.000Z",\n      "updated_at": "1970-01-01T00:00:00.000Z",\n      "created_by": {},\n      "last_updated_by": {},\n      "org_id": "66",\n      "version": 2\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `storeNewVersion`\n\nStore new version of MappingConfig\n\n`POST /v1/mappings/{id}/versions`\n\n```ts\nconst { data } = await client.storeNewVersion(\n  {\n    id: \'123e4567-e89b-12d3-a456-426614174000\',\n  },\n  {\n    id: \'string\',\n    source: {\n      type: \'journey\',\n      config: {\n        journey_id: \'string\'\n      }\n    },\n    targets: [\n      {\n        id: \'string\',\n        name: \'string\',\n        allow_failure: true,\n        target_schema: \'string\',\n        target_unique: [\'string\'],\n        use_uniqueness_criteria: false,\n        loop_config: { /* ... */ },\n        conditionMode: \'oneOf\',\n        conditions: [ /* ... */ ],\n        mapping_attributes: [ /* ... */ ],\n        relation_attributes: [ /* ... */ ],\n        linkback_relation_attribute: \'mapped_entities\',\n        linkback_relation_tags: [\'string\'],\n        graph_context: [ /* ... */ ]\n      }\n    ],\n    created_at: \'1970-01-01T00:00:00.000Z\',\n    updated_at: \'1970-01-01T00:00:00.000Z\',\n    created_by: {\n      type: \'user\',\n      org_id: \'string\',\n      user_id: \'string\'\n    },\n    last_updated_by: {\n      type: \'user\',\n      org_id: \'string\',\n      user_id: \'string\'\n    },\n    org_id: \'66\',\n    version: 2\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "id": "string",\n  "source": {\n    "type": "journey",\n    "config": {\n      "journey_id": "string"\n    }\n  },\n  "targets": [\n    {\n      "id": "string",\n      "name": "string",\n      "allow_failure": true,\n      "target_schema": "string",\n      "target_unique": ["string"],\n      "use_uniqueness_criteria": false,\n      "loop_config": {},\n      "conditionMode": "oneOf",\n      "conditions": [],\n      "mapping_attributes": [],\n      "relation_attributes": [],\n      "linkback_relation_attribute": "mapped_entities",\n      "linkback_relation_tags": ["string"],\n      "graph_context": []\n    }\n  ],\n  "created_at": "1970-01-01T00:00:00.000Z",\n  "updated_at": "1970-01-01T00:00:00.000Z",\n  "created_by": {\n    "type": "user",\n    "org_id": "string",\n    "user_id": "string"\n  },\n  "last_updated_by": {\n    "type": "user",\n    "org_id": "string",\n    "user_id": "string"\n  },\n  "org_id": "66",\n  "version": 2\n}\n```\n\n</details>\n\n---\n\n### `getConfigVersion`\n\nGet specific version of a mapping config by id & version\n\n`GET /v1/mappings/{id}/versions/{version}`\n\n```ts\nconst { data } = await client.getConfigVersion({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n  version: 1,\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "id": "string",\n  "source": {\n    "type": "journey",\n    "config": {\n      "journey_id": "string"\n    }\n  },\n  "targets": [\n    {\n      "id": "string",\n      "name": "string",\n      "allow_failure": true,\n      "target_schema": "string",\n      "target_unique": ["string"],\n      "use_uniqueness_criteria": false,\n      "loop_config": {},\n      "conditionMode": "oneOf",\n      "conditions": [],\n      "mapping_attributes": [],\n      "relation_attributes": [],\n      "linkback_relation_attribute": "mapped_entities",\n      "linkback_relation_tags": ["string"],\n      "graph_context": []\n    }\n  ],\n  "created_at": "1970-01-01T00:00:00.000Z",\n  "updated_at": "1970-01-01T00:00:00.000Z",\n  "created_by": {\n    "type": "user",\n    "org_id": "string",\n    "user_id": "string"\n  },\n  "last_updated_by": {\n    "type": "user",\n    "org_id": "string",\n    "user_id": "string"\n  },\n  "org_id": "66",\n  "version": 2\n}\n```\n\n</details>\n\n---\n\n### `executeMapping`\n\nExecute entity mapping based on a config\n\n`POST /v1/mappings:execute`\n\n```ts\nconst { data } = await client.executeMapping(\n  {\n    preview_mode: true,\n  },\n  {\n    source_ref: {\n      entity_id: \'string\',\n      entity_schema: \'submission\'\n    },\n    loop_ref: {\n      entity_id: \'string\',\n      entity_schema: \'submission\'\n    },\n    targets: [\n      {\n        id: \'string\',\n        name: \'string\',\n        allow_failure: true,\n        target_schema: \'string\',\n        target_unique: [\'string\'],\n        use_uniqueness_criteria: false,\n        loop_config: { /* ... */ },\n        conditionMode: \'oneOf\',\n        conditions: [ /* ... */ ],\n        mapping_attributes: [ /* ... */ ],\n        relation_attributes: [ /* ... */ ],\n        linkback_relation_attribute: \'mapped_entities\',\n        linkback_relation_tags: [\'string\'],\n        graph_context: [ /* ... */ ]\n      }\n    ]\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "mapped_entities": [\n    {\n      "_id": "string",\n      "_schema": "string",\n      "_title": "string",\n      "_org": "string",\n      "_tags": ["string"],\n      "_created_at": "string",\n      "_updated_at": "string",\n      "required": {}\n    }\n  ],\n  "failures": [\n    {\n      "target": {},\n      "error": {}\n    }\n  ],\n  "warnings": [\n    {\n      "explanation": "string",\n      "context": "string",\n      "id": "string"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `searchConfigs`\n\nSearch mapping configs\n\n`POST /v1/mappings:search`\n\n```ts\nconst { data } = await client.searchConfigs(\n  null,\n  {\n    source: {\n      type: \'journey\',\n      config: {\n        journey_id: \'string\'\n      }\n    }\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "id": "string",\n  "source": {\n    "type": "journey",\n    "config": {\n      "journey_id": "string"\n    }\n  },\n  "targets": [\n    {\n      "id": "string",\n      "name": "string",\n      "allow_failure": true,\n      "target_schema": "string",\n      "target_unique": ["string"],\n      "use_uniqueness_criteria": false,\n      "loop_config": {},\n      "conditionMode": "oneOf",\n      "conditions": [],\n      "mapping_attributes": [],\n      "relation_attributes": [],\n      "linkback_relation_attribute": "mapped_entities",\n      "linkback_relation_tags": ["string"],\n      "graph_context": []\n    }\n  ],\n  "created_at": "1970-01-01T00:00:00.000Z",\n  "updated_at": "1970-01-01T00:00:00.000Z",\n  "created_by": {\n    "type": "user",\n    "org_id": "string",\n    "user_id": "string"\n  },\n  "last_updated_by": {\n    "type": "user",\n    "org_id": "string",\n    "user_id": "string"\n  },\n  "org_id": "66",\n  "version": 2\n}\n```\n\n</details>\n\n---\n\n### `queryMappingHistory`\n\nGet the Mapping History\n\n`GET /v1/mappings/history`\n\n```ts\nconst { data } = await client.queryMappingHistory({\n  from: \'example\',\n  to: \'example\',\n  targetEntityId: \'example\',\n  sourceEntityId: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{}\n```\n\n</details>\n\n---\n\n### `executeRelations`\n\nExecute relation mapping between source entity and target entities\n\n`POST /v1/relations:execute`\n\n```ts\nconst { data } = await client.executeRelations(\n  null,\n  {\n    source_ref: {\n      entity_id: \'string\',\n      entity_schema: \'submission\'\n    },\n    target: {\n      main_entity_ref: {\n        entity_id: \'string\',\n        entity_schema: \'submission\'\n      },\n      relation_attributes: [\n        {\n          target: \'string\',\n          target_tags: [\'string\'],\n          target_tags_include_source: false,\n          target_entity_tags: [\'string\'],\n          override_with_source_filter: false,\n          source_filter: {\n            limit: 0,\n            schema: \'string\',\n            attribute: \'string\',\n            relation_tag: \'string\',\n            tag: \'string\',\n            self: false\n          },\n          related_to: {},\n          mode: \'append\',\n          origin: \'system_recommendation\'\n        }\n      ],\n      linkback: {\n        attribute: \'mapped_entities\',\n        relation_tags: [\'string\']\n      }\n    },\n    additional_relations: [\n      {\n        entity_id: \'string\',\n        attribute: \'string\'\n      }\n    ]\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "relations": [\n    {\n      "source_entity_id": "string",\n      "target_entity_id": "string",\n      "relation_attr": "string",\n      "tags": ["string"]\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `getMappingConfig`\n\nGet latest version of a mapping config by id V2\n\n`GET /v2/mappings/{id}`\n\n```ts\nconst { data } = await client.getMappingConfig({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "id": "string",\n  "source": {\n    "type": "journey",\n    "config": {\n      "journey_id": "string"\n    }\n  },\n  "targets": [\n    {\n      "id": "string",\n      "name": "string",\n      "allow_failure": true,\n      "target_schema": "string",\n      "target_unique": ["string"],\n      "use_uniqueness_criteria": false,\n      "loop_config": {},\n      "conditionMode": "oneOf",\n      "conditions": [],\n      "mapping_attributes": [],\n      "relation_attributes": [],\n      "linkback_relation_attribute": "mapped_entities",\n      "linkback_relation_tags": ["string"],\n      "graph_context": []\n    }\n  ],\n  "created_at": "1970-01-01T00:00:00.000Z",\n  "updated_at": "1970-01-01T00:00:00.000Z",\n  "created_by": {\n    "type": "user",\n    "org_id": "string",\n    "user_id": "string"\n  },\n  "last_updated_by": {\n    "type": "user",\n    "org_id": "string",\n    "user_id": "string"\n  },\n  "org_id": "66",\n  "version": 2\n}\n```\n\n</details>\n\n---\n\n### `putMappingConfig`\n\nStores new version of entity mapping config\n\n`PUT /v2/mappings/{id}`\n\n```ts\nconst { data } = await client.putMappingConfig(\n  {\n    id: \'123e4567-e89b-12d3-a456-426614174000\',\n  },\n  {\n    id: \'string\',\n    source: {\n      type: \'journey\',\n      config: {\n        journey_id: \'string\'\n      }\n    },\n    targets: [\n      {\n        id: \'string\',\n        name: \'string\',\n        allow_failure: true,\n        target_schema: \'string\',\n        target_unique: [\'string\'],\n        use_uniqueness_criteria: false,\n        loop_config: { /* ... */ },\n        conditionMode: \'oneOf\',\n        conditions: [ /* ... */ ],\n        mapping_attributes: [ /* ... */ ],\n        relation_attributes: [ /* ... */ ],\n        linkback_relation_attribute: \'mapped_entities\',\n        linkback_relation_tags: [\'string\'],\n        graph_context: [ /* ... */ ]\n      }\n    ],\n    created_at: \'1970-01-01T00:00:00.000Z\',\n    updated_at: \'1970-01-01T00:00:00.000Z\',\n    created_by: {\n      type: \'user\',\n      org_id: \'string\',\n      user_id: \'string\'\n    },\n    last_updated_by: {\n      type: \'user\',\n      org_id: \'string\',\n      user_id: \'string\'\n    },\n    org_id: \'66\',\n    version: 2\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "id": "string",\n  "source": {\n    "type": "journey",\n    "config": {\n      "journey_id": "string"\n    }\n  },\n  "targets": [\n    {\n      "id": "string",\n      "name": "string",\n      "allow_failure": true,\n      "target_schema": "string",\n      "target_unique": ["string"],\n      "use_uniqueness_criteria": false,\n      "loop_config": {},\n      "conditionMode": "oneOf",\n      "conditions": [],\n      "mapping_attributes": [],\n      "relation_attributes": [],\n      "linkback_relation_attribute": "mapped_entities",\n      "linkback_relation_tags": ["string"],\n      "graph_context": []\n    }\n  ],\n  "created_at": "1970-01-01T00:00:00.000Z",\n  "updated_at": "1970-01-01T00:00:00.000Z",\n  "created_by": {\n    "type": "user",\n    "org_id": "string",\n    "user_id": "string"\n  },\n  "last_updated_by": {\n    "type": "user",\n    "org_id": "string",\n    "user_id": "string"\n  },\n  "org_id": "66",\n  "version": 2\n}\n```\n\n</details>\n\n---\n\n## Schemas\n\n### `SearchMappingReq`\n\n```ts\ntype SearchMappingReq = {\n  source?: {\n    type?: "journey" | "entity"\n    config?: {\n      journey_id?: { ... }\n    } | {\n      entity_id: { ... }\n      entity_schema?: { ... }\n    }\n  }\n}\n```\n\n### `MappingConfigsResp`\n\n```ts\ntype MappingConfigsResp = {\n  configs: Array<{\n    id: string\n    source: {\n      type?: { ... }\n      config?: { ... }\n    }\n    targets: Array<{\n      id?: { ... }\n      name?: { ... }\n      allow_failure?: { ... }\n      target_schema: { ... }\n      target_unique?: { ... }\n      use_uniqueness_criteria?: { ... }\n      loop_config?: { ... }\n      conditionMode?: { ... }\n      conditions?: { ... }\n      mapping_attributes: { ... }\n      relation_attributes?: { ... }\n      linkback_relation_attribute?: { ... }\n      linkback_relation_tags?: { ... }\n      graph_context?: { ... }\n    }>\n    created_at?: string // date-time\n    updated_at?: string // date-time\n    created_by?: {\n      type: { ... }\n      org_id?: { ... }\n      user_id?: { ... }\n    }\n    last_updated_by?: {\n      type: { ... }\n      org_id?: { ... }\n      user_id?: { ... }\n    }\n    org_id?: string\n    version?: number\n  }>\n}\n```\n\n### `MappingConfigs`\n\n```ts\ntype MappingConfigs = Array<{\n  id: string\n  source: {\n    type?: "journey" | "entity"\n    config?: {\n      journey_id?: { ... }\n    } | {\n      entity_id: { ... }\n      entity_schema?: { ... }\n    }\n  }\n  targets: Array<{\n    id?: string\n    name?: string\n    allow_failure?: boolean\n    target_schema: string\n    target_unique?: string[]\n    use_uniqueness_criteria?: boolean\n    loop_config?: {\n      source_path?: { ... }\n      source_type?: { ... }\n      filter_tags?: { ... }\n      length?: { ... }\n    }\n    conditionMode?: "oneOf" | "anyOf" | "allOf"\n    conditions?: Array<{\n      _exists?: { ... }\n      _equals?: { ... }\n      _not_exists?: { ... }\n      _any_of?: { ... }\n    }>\n    mapping_attributes: Array<{\n      target: { ... }\n      operation: { ... }\n      origin?: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      value: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      source: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      source?: { ... }\n      value_json: { ... }\n      target_unique?: { ... }\n    }>\n    relation_attributes?: Array<{\n      target: { ... }\n      target_tags?: { ... }\n      target_tags_include_source?: { ... }\n      target_entity_tags?: { ... }\n      override_with_source_filter?: { ... }\n      source_filter?: { ... }\n      related_to?: { ... }\n      mode: { ... }\n      origin?: { ... }\n    }>\n    linkback_relation_attribute?: string\n    linkback_relation_tags?: string[]\n    graph_context?: Array<{\n      seed: { ... }\n      graph: { ... }\n    }>\n  }>\n  created_at?: string // date-time\n  updated_at?: string // date-time\n  created_by?: {\n    type: "user" | "internal_service"\n    org_id?: string\n    user_id?: string\n  }\n  last_updated_by?: {\n    type: "user" | "internal_service"\n    org_id?: string\n    user_id?: string\n  }\n  org_id?: string\n  version?: number\n}>\n```\n\n### `MappingConfig`\n\n```ts\ntype MappingConfig = {\n  id: string\n  source: {\n    type?: "journey" | "entity"\n    config?: {\n      journey_id?: { ... }\n    } | {\n      entity_id: { ... }\n      entity_schema?: { ... }\n    }\n  }\n  targets: Array<{\n    id?: string\n    name?: string\n    allow_failure?: boolean\n    target_schema: string\n    target_unique?: string[]\n    use_uniqueness_criteria?: boolean\n    loop_config?: {\n      source_path?: { ... }\n      source_type?: { ... }\n      filter_tags?: { ... }\n      length?: { ... }\n    }\n    conditionMode?: "oneOf" | "anyOf" | "allOf"\n    conditions?: Array<{\n      _exists?: { ... }\n      _equals?: { ... }\n      _not_exists?: { ... }\n      _any_of?: { ... }\n    }>\n    mapping_attributes: Array<{\n      target: { ... }\n      operation: { ... }\n      origin?: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      value: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      source: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      source?: { ... }\n      value_json: { ... }\n      target_unique?: { ... }\n    }>\n    relation_attributes?: Array<{\n      target: { ... }\n      target_tags?: { ... }\n      target_tags_include_source?: { ... }\n      target_entity_tags?: { ... }\n      override_with_source_filter?: { ... }\n      source_filter?: { ... }\n      related_to?: { ... }\n      mode: { ... }\n      origin?: { ... }\n    }>\n    linkback_relation_attribute?: string\n    linkback_relation_tags?: string[]\n    graph_context?: Array<{\n      seed: { ... }\n      graph: { ... }\n    }>\n  }>\n  created_at?: string // date-time\n  updated_at?: string // date-time\n  created_by?: {\n    type: "user" | "internal_service"\n    org_id?: string\n    user_id?: string\n  }\n  last_updated_by?: {\n    type: "user" | "internal_service"\n    org_id?: string\n    user_id?: string\n  }\n  org_id?: string\n  version?: number\n}\n```\n\n### `MappingConfigV2`\n\n```ts\ntype MappingConfigV2 = {\n  id: string\n  source: {\n    type?: "journey" | "entity"\n    config?: {\n      journey_id?: { ... }\n    } | {\n      entity_id: { ... }\n      entity_schema?: { ... }\n    }\n  }\n  targets: Array<{\n    id?: string\n    name?: string\n    allow_failure?: boolean\n    target_schema: string\n    target_unique?: string[]\n    use_uniqueness_criteria?: boolean\n    loop_config?: {\n      source_path?: { ... }\n      source_type?: { ... }\n      filter_tags?: { ... }\n      length?: { ... }\n    }\n    conditionMode?: "oneOf" | "anyOf" | "allOf"\n    conditions?: Array<{\n      _exists?: { ... }\n      _equals?: { ... }\n      _not_exists?: { ... }\n      _any_of?: { ... }\n    }>\n    mapping_attributes: Array<{\n      target: { ... }\n      operation: { ... }\n      origin?: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      value: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      source: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      source?: { ... }\n      value_json: { ... }\n      target_unique?: { ... }\n    }>\n    relation_attributes?: Array<{\n      target: { ... }\n      target_tags?: { ... }\n      target_tags_include_source?: { ... }\n      target_entity_tags?: { ... }\n      override_with_source_filter?: { ... }\n      source_filter?: { ... }\n      related_to?: { ... }\n      mode: { ... }\n      origin?: { ... }\n    }>\n    linkback_relation_attribute?: string\n    linkback_relation_tags?: string[]\n    graph_context?: Array<{\n      seed: { ... }\n      graph: { ... }\n    }>\n  }>\n  created_at?: string // date-time\n  updated_at?: string // date-time\n  created_by?: {\n    type: "user" | "internal_service"\n    org_id?: string\n    user_id?: string\n  }\n  last_updated_by?: {\n    type: "user" | "internal_service"\n    org_id?: string\n    user_id?: string\n  }\n  org_id?: string\n  version?: number\n}\n```\n\n### `MappingConfigCommonFields`\n\n```ts\ntype MappingConfigCommonFields = {\n  id: string\n  source: {\n    type?: "journey" | "entity"\n    config?: {\n      journey_id?: { ... }\n    } | {\n      entity_id: { ... }\n      entity_schema?: { ... }\n    }\n  }\n  targets: Array<{\n    id?: string\n    name?: string\n    allow_failure?: boolean\n    target_schema: string\n    target_unique?: string[]\n    use_uniqueness_criteria?: boolean\n    loop_config?: {\n      source_path?: { ... }\n      source_type?: { ... }\n      filter_tags?: { ... }\n      length?: { ... }\n    }\n    conditionMode?: "oneOf" | "anyOf" | "allOf"\n    conditions?: Array<{\n      _exists?: { ... }\n      _equals?: { ... }\n      _not_exists?: { ... }\n      _any_of?: { ... }\n    }>\n    mapping_attributes: Array<{\n      target: { ... }\n      operation: { ... }\n      origin?: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      value: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      source: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      source?: { ... }\n      value_json: { ... }\n      target_unique?: { ... }\n    }>\n    relation_attributes?: Array<{\n      target: { ... }\n      target_tags?: { ... }\n      target_tags_include_source?: { ... }\n      target_entity_tags?: { ... }\n      override_with_source_filter?: { ... }\n      source_filter?: { ... }\n      related_to?: { ... }\n      mode: { ... }\n      origin?: { ... }\n    }>\n    linkback_relation_attribute?: string\n    linkback_relation_tags?: string[]\n    graph_context?: Array<{\n      seed: { ... }\n      graph: { ... }\n    }>\n  }>\n  created_at?: string // date-time\n  updated_at?: string // date-time\n  created_by?: {\n    type: "user" | "internal_service"\n    org_id?: string\n    user_id?: string\n  }\n  last_updated_by?: {\n    type: "user" | "internal_service"\n    org_id?: string\n    user_id?: string\n  }\n}\n```\n\n### `Owner`\n\n```ts\ntype Owner = {\n  type: "user" | "internal_service"\n  org_id?: string\n  user_id?: string\n}\n```\n\n### `ExecuteRelationsReq`\n\nBuild relations between a source entity and one or more target entities, dynamically identified\n\n```ts\ntype ExecuteRelationsReq = {\n  source_ref: {\n    entity_id: string\n    entity_schema?: string\n  }\n  target?: {\n    main_entity_ref: {\n      entity_id: { ... }\n      entity_schema?: { ... }\n    }\n    relation_attributes: Array<{\n      target: { ... }\n      target_tags?: { ... }\n      target_tags_include_source?: { ... }\n      target_entity_tags?: { ... }\n      override_with_source_filter?: { ... }\n      source_filter?: { ... }\n      related_to?: { ... }\n      mode: { ... }\n      origin?: { ... }\n    }>\n    linkback?: {\n      attribute: { ... }\n      relation_tags: { ... }\n    }\n  }\n  additional_relations?: Array<{\n    entity_id: string\n    attribute: string\n  }>\n}\n```\n\n### `ExecuteRelationsResp`\n\n```ts\ntype ExecuteRelationsResp = {\n  relations?: Array<{\n    source_entity_id: string\n    target_entity_id: string\n    relation_attr: string\n    tags?: string[]\n  }>\n}\n```\n\n### `NewRelationItem`\n\n```ts\ntype NewRelationItem = {\n  source_entity_id: string\n  target_entity_id: string\n  relation_attr: string\n  tags?: string[]\n}\n```\n\n### `RelationItem`\n\n```ts\ntype RelationItem = {\n  entity_id: string\n  attribute: string\n}\n```\n\n### `ExecuteMappingReq`\n\nPass either source or source_entity\n\n```ts\ntype ExecuteMappingReq = {\n  source_ref: {\n    entity_id: string\n    entity_schema?: string\n  }\n  loop_ref?: {\n    entity_id: string\n    entity_schema?: string\n  }\n  targets: Array<{\n    id?: string\n    name?: string\n    allow_failure?: boolean\n    target_schema: string\n    target_unique?: string[]\n    use_uniqueness_criteria?: boolean\n    loop_config?: {\n      source_path?: { ... }\n      source_type?: { ... }\n      filter_tags?: { ... }\n      length?: { ... }\n    }\n    conditionMode?: "oneOf" | "anyOf" | "allOf"\n    conditions?: Array<{\n      _exists?: { ... }\n      _equals?: { ... }\n      _not_exists?: { ... }\n      _any_of?: { ... }\n    }>\n    mapping_attributes: Array<{\n      target: { ... }\n      operation: { ... }\n      origin?: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      value: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      source: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      source?: { ... }\n      value_json: { ... }\n      target_unique?: { ... }\n    }>\n    relation_attributes?: Array<{\n      target: { ... }\n      target_tags?: { ... }\n      target_tags_include_source?: { ... }\n      target_entity_tags?: { ... }\n      override_with_source_filter?: { ... }\n      source_filter?: { ... }\n      related_to?: { ... }\n      mode: { ... }\n      origin?: { ... }\n    }>\n    linkback_relation_attribute?: string\n    linkback_relation_tags?: string[]\n    graph_context?: Array<{\n      seed: { ... }\n      graph: { ... }\n    }>\n  }>\n}\n```\n\n### `ExecuteMappingResp`\n\n```ts\ntype ExecuteMappingResp = {\n  mapped_entities: Array<{\n    _id?: string\n    _schema?: string\n    _title?: string\n    _org?: string\n    _tags?: string[]\n    _created_at?: string\n    _updated_at?: string\n    required?: unknown\n  }>\n  failures?: Array<{\n    target?: {\n      id?: { ... }\n      name?: { ... }\n      allow_failure?: { ... }\n      target_schema: { ... }\n      target_unique?: { ... }\n      use_uniqueness_criteria?: { ... }\n      loop_config?: { ... }\n      conditionMode?: { ... }\n      conditions?: { ... }\n      mapping_attributes: { ... }\n      relation_attributes?: { ... }\n      linkback_relation_attribute?: { ... }\n      linkback_relation_tags?: { ... }\n      graph_context?: { ... }\n    }\n    error?: {\n      isSilent?: { ... }\n      message?: { ... }\n    }\n  }>\n  warnings?: Array<{\n    explanation: string\n    context?: string\n    id?: string\n  }>\n}\n```\n\n### `MappingFailure`\n\n```ts\ntype MappingFailure = {\n  target?: {\n    id?: string\n    name?: string\n    allow_failure?: boolean\n    target_schema: string\n    target_unique?: string[]\n    use_uniqueness_criteria?: boolean\n    loop_config?: {\n      source_path?: { ... }\n      source_type?: { ... }\n      filter_tags?: { ... }\n      length?: { ... }\n    }\n    conditionMode?: "oneOf" | "anyOf" | "allOf"\n    conditions?: Array<{\n      _exists?: { ... }\n      _equals?: { ... }\n      _not_exists?: { ... }\n      _any_of?: { ... }\n    }>\n    mapping_attributes: Array<{\n      target: { ... }\n      operation: { ... }\n      origin?: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      value: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      source: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      source?: { ... }\n      value_json: { ... }\n      target_unique?: { ... }\n    }>\n    relation_attributes?: Array<{\n      target: { ... }\n      target_tags?: { ... }\n      target_tags_include_source?: { ... }\n      target_entity_tags?: { ... }\n      override_with_source_filter?: { ... }\n      source_filter?: { ... }\n      related_to?: { ... }\n      mode: { ... }\n      origin?: { ... }\n    }>\n    linkback_relation_attribute?: string\n    linkback_relation_tags?: string[]\n    graph_context?: Array<{\n      seed: { ... }\n      graph: { ... }\n    }>\n  }\n  error?: {\n    isSilent?: boolean\n    message?: string\n  }\n}\n```\n\n### `MappingWarning`\n\n```ts\ntype MappingWarning = {\n  explanation: string\n  context?: string\n  id?: string\n}\n```\n\n### `Entity`\n\n```ts\ntype Entity = {\n  _id?: string\n  _schema?: string\n  _title?: string\n  _org?: string\n  _tags?: string[]\n  _created_at?: string\n  _updated_at?: string\n  required?: unknown\n}\n```\n\n### `EntityRef`\n\n```ts\ntype EntityRef = {\n  entity_id: string\n  entity_schema?: string\n}\n```\n\n### `SourceConfig`\n\n```ts\ntype SourceConfig = {\n  type?: "journey" | "entity"\n  config?: {\n    journey_id?: string\n  } | {\n    entity_id: string\n    entity_schema?: string\n  }\n}\n```\n\n### `JourneyRef`\n\n```ts\ntype JourneyRef = {\n  journey_id?: string\n}\n```\n\n### `Loop_Index_String`\n\nThis string value will be replaced with the value of the loop index, when mapping in loop mode\n\n```ts\ntype Loop_Index_String = "##LOOP_INDEX##"\n```\n\n### `TargetConfig`\n\n```ts\ntype TargetConfig = {\n  id?: string\n  name?: string\n  allow_failure?: boolean\n  target_schema: string\n  target_unique?: string[]\n  use_uniqueness_criteria?: boolean\n  loop_config?: {\n    source_path?: string\n    source_type?: "journey-multi-select" | "journey-file-upload"\n    filter_tags?: string[]\n    length?: number\n  }\n  conditionMode?: "oneOf" | "anyOf" | "allOf"\n  conditions?: Array<{\n    _exists?: {\n      source?: { ... }\n      value?: { ... }\n    }\n    _equals?: {\n      source?: { ... }\n      value?: { ... }\n    }\n    _not_exists?: {\n      source?: { ... }\n      value?: { ... }\n    }\n    _any_of?: {\n      source?: { ... }\n      value?: { ... }\n    }\n  }>\n  mapping_attributes: Array<{\n    target: string\n    operation: {\n      _set?: { ... }\n      _append?: { ... }\n      _prepend?: { ... }\n      _uniq?: { ... }\n      _retain_old_values?: { ... }\n      _copy?: { ... }\n      _template?: { ... }\n      _random?: { ... }\n      _each?: { ... }\n      _as?: { ... }\n      _map?: { ... }\n    } | string | boolean | number | Record<string, unknown> | unknown[]\n    origin?: "system_recommendation" | "user_manually" | "entity_updating_system_recommendation"\n  } | {\n    mode: "copy_if_exists" | "append_if_exists" | "set_value"\n    target: string\n    value: unknown\n  } | {\n    mode: "copy_if_exists" | "append_if_exists" | "set_value"\n    target: string\n    source: string\n  } | {\n    mode: "copy_if_exists" | "append_if_exists" | "set_value"\n    target: string\n    source?: string\n    value_json: string\n    target_unique?: string[]\n  }>\n  relation_attributes?: Array<{\n    target: string\n    target_tags?: string[]\n    target_tags_include_source?: boolean\n    target_entity_tags?: string[]\n    override_with_source_filter?: boolean\n    source_filter?: {\n      limit?: { ... }\n      schema?: { ... }\n      attribute?: { ... }\n      relation_tag?: { ... }\n      tag?: { ... }\n      self?: { ... }\n    }\n    related_to?: Record<string, unknown>\n    mode: "append" | "prepend" | "set"\n    origin?: "system_recommendation" | "user_manually" | "entity_updating_system_recommendation"\n  }>\n  linkback_relation_attribute?: string\n  linkback_relation_tags?: string[]\n  graph_context?: Array<{\n    seed: {\n      entity_id: { ... }\n      node_id: { ... }\n    }\n    graph: {\n      nodes: { ... }\n      edges: { ... }\n    }\n  }>\n}\n```\n\n### `MapCondition`\n\n```ts\ntype MapCondition = {\n  _exists?: {\n    source?: string\n    value?: string | number | object | object[]\n  }\n  _equals?: {\n    source?: string\n    value?: string | number | object | object[]\n  }\n  _not_exists?: {\n    source?: string\n    value?: string | number | object | object[]\n  }\n  _any_of?: {\n    source?: string\n    value?: string | number | object | object[]\n  }\n}\n```\n\n### `ConditionNode`\n\n```ts\ntype ConditionNode = {\n  source?: string\n  value?: string | number | object | object[]\n}\n```\n\n### `RelationAttribute`\n\n```ts\ntype RelationAttribute = {\n  target: string\n  target_tags?: string[]\n  target_tags_include_source?: boolean\n  target_entity_tags?: string[]\n  override_with_source_filter?: boolean\n  source_filter?: {\n    limit?: number\n    schema?: string\n    attribute?: string\n    relation_tag?: string\n    tag?: string\n    self?: boolean\n  }\n  related_to?: Record<string, unknown>\n  mode: "append" | "prepend" | "set"\n  origin?: "system_recommendation" | "user_manually" | "entity_updating_system_recommendation"\n}\n```\n\n### `GraphContextEntry`\n\nOne multi-hop graph lookup against entity-api\'s `POST /v1/entity:graph`, resolved during\ngraph_context enrichment (before mapping_attributes are evaluated). Every node in `graph.nodes`\nis merged into sourceContext under its own `id`, so listing several nodes here costs one\nentity-api call, not one p\n\n```ts\ntype GraphContextEntry = {\n  seed: {\n    entity_id: string\n    node_id: string\n  }\n  graph: {\n    nodes: Array<{\n      id: { ... }\n      schema: { ... }\n      cardinality?: { ... }\n      fields?: { ... }\n      filter?: { ... }\n      optional?: { ... }\n    }>\n    edges: Array<{\n      from: { ... }\n      to: { ... }\n    }>\n  }\n}\n```\n\n### `GraphSeed`\n\nMirrors entity-api\'s GraphSeed (see entity-api openapi.yml) - the entity the graph traversal starts from.\n\n```ts\ntype GraphSeed = {\n  entity_id: string\n  node_id: string\n}\n```\n\n### `GraphDefinition`\n\nMirrors entity-api\'s GraphDefinition (see entity-api openapi.yml) - the shape of the graph to traverse.\n\n```ts\ntype GraphDefinition = {\n  nodes: Array<{\n    id: string\n    schema: string\n    cardinality?: "one" | "many"\n    fields?: string[]\n    filter?: Array<{\n      attribute: { ... }\n      value: { ... }\n    }>\n    optional?: boolean\n  }>\n  edges: Array<{\n    from: string\n    to: string\n  }>\n}\n```\n\n### `GraphNode`\n\nMirrors entity-api\'s GraphNode (see entity-api openapi.yml).\n\n```ts\ntype GraphNode = {\n  id: string\n  schema: string\n  cardinality?: "one" | "many"\n  fields?: string[]\n  filter?: Array<{\n    attribute: string\n    value: string | number | boolean\n  }>\n  optional?: boolean\n}\n```\n\n### `GraphNodeFilter`\n\nMirrors entity-api\'s GraphNodeFilter (see entity-api openapi.yml).\n\n```ts\ntype GraphNodeFilter = {\n  attribute: string\n  value: string | number | boolean\n}\n```\n\n### `GraphEdge`\n\nMirrors entity-api\'s GraphEdge (see entity-api openapi.yml).\n\n```ts\ntype GraphEdge = {\n  from: string\n  to: string\n}\n```\n\n### `MappingAttributeV2`\n\n```ts\ntype MappingAttributeV2 = {\n  target: string\n  operation: {\n    _set?: string | boolean | number | Record<string, unknown> | unknown[]\n    _append?: unknown\n    _prepend?: unknown\n    _uniq?: boolean | string[]\n    _retain_old_values?: boolean\n    _copy?: string\n    _template?: string\n    _random?: {\n      type: { ... }\n    } | {\n      type: { ... }\n      min?: { ... }\n      max?: { ... }\n    }\n    _each?: string\n    _as?: string\n    _map?: {\n      _set?: { ... }\n      _append?: { ... }\n      _prepend?: { ... }\n      _uniq?: { ... }\n      _retain_old_values?: { ... }\n      _copy?: { ... }\n      _template?: { ... }\n      _random?: { ... }\n      _each?: { ... }\n      _as?: { ... }\n      _map?: { ... }\n    } | string | boolean | number | Record<string, unknown> | unknown[]\n  } | string | boolean | number | Record<string, unknown> | unknown[]\n  origin?: "system_recommendation" | "user_manually" | "entity_updating_system_recommendation"\n}\n```\n\n### `AttributeOrigin`\n\nOrigin of an attribute.\n\n```ts\ntype AttributeOrigin = "system_recommendation" | "user_manually" | "entity_updating_system_recommendation"\n```\n\n### `OperationNode`\n\nMapping operation nodes are either primitive values or operation node objects\n\n```ts\ntype OperationNode = {\n  _set?: string | boolean | number | Record<string, unknown> | unknown[]\n  _append?: unknown\n  _prepend?: unknown\n  _uniq?: boolean | string[]\n  _retain_old_values?: boolean\n  _copy?: string\n  _template?: string\n  _random?: {\n    type: "uuid" | "nanoid"\n  } | {\n    type: "number"\n    min?: number\n    max?: number\n  }\n  _each?: string\n  _as?: string\n  _map?: {\n    _set?: string | boolean | number | Record<string, unknown> | unknown[]\n    _append?: unknown\n    _prepend?: unknown\n    _uniq?: boolean | string[]\n    _retain_old_values?: boolean\n    _copy?: string\n    _template?: string\n    _random?: {\n      type: { ... }\n    } | {\n      type: { ... }\n      min?: { ... }\n      max?: { ... }\n    }\n    _each?: string\n    _as?: string\n    _map?: {\n      _set?: { ... }\n      _append?: { ... }\n      _prepend?: { ... }\n      _uniq?: { ... }\n      _retain_old_values?: { ... }\n      _copy?: { ... }\n      _template?: { ... }\n      _random?: { ... }\n      _each?: { ... }\n      _as?: { ... }\n      _map?: { ... }\n    } | string | boolean | number | Record<string, unknown> | unknown[]\n  } | string | boolean | number | Record<string, unknown> | unknown[]\n} | string | boolean | number | Record<string, unknown> | unknown[]\n```\n\n### `OperationObjectNode`\n\n```ts\ntype OperationObjectNode = {\n  _set?: string | boolean | number | Record<string, unknown> | unknown[]\n  _append?: unknown\n  _prepend?: unknown\n  _uniq?: boolean | string[]\n  _retain_old_values?: boolean\n  _copy?: string\n  _template?: string\n  _random?: {\n    type: "uuid" | "nanoid"\n  } | {\n    type: "number"\n    min?: number\n    max?: number\n  }\n  _each?: string\n  _as?: string\n  _map?: {\n    _set?: string | boolean | number | Record<string, unknown> | unknown[]\n    _append?: unknown\n    _prepend?: unknown\n    _uniq?: boolean | string[]\n    _retain_old_values?: boolean\n    _copy?: string\n    _template?: string\n    _random?: {\n      type: { ... }\n    } | {\n      type: { ... }\n      min?: { ... }\n      max?: { ... }\n    }\n    _each?: string\n    _as?: string\n    _map?: {\n      _set?: { ... }\n      _append?: { ... }\n      _prepend?: { ... }\n      _uniq?: { ... }\n      _retain_old_values?: { ... }\n      _copy?: { ... }\n      _template?: { ... }\n      _random?: { ... }\n      _each?: { ... }\n      _as?: { ... }\n      _map?: { ... }\n    } | string | boolean | number | Record<string, unknown> | unknown[]\n  } | string | boolean | number | Record<string, unknown> | unknown[]\n}\n```\n\n### `PrimitiveJSONValue`\n\nRepresents any primitive JSON value\n\n```ts\ntype PrimitiveJSONValue = string | boolean | number | Record<string, unknown> | unknown[]\n```\n\n### `RandomOperation`\n\n```ts\ntype RandomOperation = {\n  type: "uuid" | "nanoid"\n} | {\n  type: "number"\n  min?: number\n  max?: number\n}\n```\n\n### `MappingAttribute`\n\n```ts\ntype MappingAttribute = {\n  mode: "copy_if_exists" | "append_if_exists" | "set_value"\n  target: string\n  value: unknown\n} | {\n  mode: "copy_if_exists" | "append_if_exists" | "set_value"\n  target: string\n  source: string\n} | {\n  mode: "copy_if_exists" | "append_if_exists" | "set_value"\n  target: string\n  source?: string\n  value_json: string\n  target_unique?: string[]\n}\n```\n\n### `MappingAttributeMode`\n\n- copy_if_exists - it replaces the target attribute with the source value - append_if_exists - it currently replaces target attribute with array like values. Useful when you have multiple values to be added into one attribute. - set_value - it sets a value to a predefined value. Must be used togethe\n\n```ts\ntype MappingAttributeMode = "copy_if_exists" | "append_if_exists" | "set_value"\n```\n\n### `SetValueMapper`\n\n```ts\ntype SetValueMapper = {\n  mode: "copy_if_exists" | "append_if_exists" | "set_value"\n  target: string\n  value: unknown\n}\n```\n\n### `CopyValueMapper`\n\n```ts\ntype CopyValueMapper = {\n  mode: "copy_if_exists" | "append_if_exists" | "set_value"\n  target: string\n  source: string\n}\n```\n\n### `AppendValueMapper`\n\n```ts\ntype AppendValueMapper = {\n  mode: "copy_if_exists" | "append_if_exists" | "set_value"\n  target: string\n  source?: string\n  value_json: string\n  target_unique?: string[]\n}\n```\n\n### `MappingHistoryResp`\n\n```ts\ntype MappingHistoryResp = {\n  results: Array<{\n    id: string\n    timestamp: string // ISO datetime\n    source_entity_snapshot: {\n      _id?: { ... }\n      _schema?: { ... }\n      _title?: { ... }\n      _org?: { ... }\n      _tags?: { ... }\n      _created_at?: { ... }\n      _updated_at?: { ... }\n      required?: { ... }\n    }\n    mapped_entities_snapshot: Array<{\n      _id?: { ... }\n      _schema?: { ... }\n      _title?: { ... }\n      _org?: { ... }\n      _tags?: { ... }\n      _created_at?: { ... }\n      _updated_at?: { ... }\n      required?: { ... }\n    }>\n    target_configs_snapshot: Array<{\n      id?: { ... }\n      name?: { ... }\n      allow_failure?: { ... }\n      target_schema: { ... }\n      target_unique?: { ... }\n      use_uniqueness_criteria?: { ... }\n      loop_config?: { ... }\n      conditionMode?: { ... }\n      conditions?: { ... }\n      mapping_attributes: { ... }\n      relation_attributes?: { ... }\n      linkback_relation_attribute?: { ... }\n      linkback_relation_tags?: { ... }\n      graph_context?: { ... }\n    }>\n  }>\n}\n```\n\n### `MappingHistoryEntry`\n\n```ts\ntype MappingHistoryEntry = {\n  id: string\n  timestamp: string // ISO datetime\n  source_entity_snapshot: {\n    _id?: string\n    _schema?: string\n    _title?: string\n    _org?: string\n    _tags?: string[]\n    _created_at?: string\n    _updated_at?: string\n    required?: unknown\n  }\n  mapped_entities_snapshot: Array<{\n    _id?: string\n    _schema?: string\n    _title?: string\n    _org?: string\n    _tags?: string[]\n    _created_at?: string\n    _updated_at?: string\n    required?: unknown\n  }>\n  target_configs_snapshot: Array<{\n    id?: string\n    name?: string\n    allow_failure?: boolean\n    target_schema: string\n    target_unique?: string[]\n    use_uniqueness_criteria?: boolean\n    loop_config?: {\n      source_path?: { ... }\n      source_type?: { ... }\n      filter_tags?: { ... }\n      length?: { ... }\n    }\n    conditionMode?: "oneOf" | "anyOf" | "allOf"\n    conditions?: Array<{\n      _exists?: { ... }\n      _equals?: { ... }\n      _not_exists?: { ... }\n      _any_of?: { ... }\n    }>\n    mapping_attributes: Array<{\n      target: { ... }\n      operation: { ... }\n      origin?: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      value: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      source: { ... }\n    } | {\n      mode: { ... }\n      target: { ... }\n      source?: { ... }\n      value_json: { ... }\n      target_unique?: { ... }\n    }>\n    relation_attributes?: Array<{\n      target: { ... }\n      target_tags?: { ... }\n      target_tags_include_source?: { ... }\n      target_entity_tags?: { ... }\n      override_with_source_filter?: { ... }\n      source_filter?: { ... }\n      related_to?: { ... }\n      mode: { ... }\n      origin?: { ... }\n    }>\n    linkback_relation_attribute?: string\n    linkback_relation_tags?: string[]\n    graph_context?: Array<{\n      seed: { ... }\n      graph: { ... }\n    }>\n  }>\n}\n```\n\n### `MappingSource`\n\n```ts\ntype MappingSource = {\n  key: string\n  sub_properties?: Array<{\n    value: string\n    label: string\n    initial_target_value?: string\n    possible_target_types?: "string" | "date" | "datetime" | "boolean" | "number" | "image" | "file" | "address" | "email" | "phone" | "select" | "multiselect" | "payment" | "link" | "currency" | "sequence" | "relation" | "array"[]\n    raw?: boolean\n  }>\n  source_type: string\n  group?: string\n  possible_target_types?: "string" | "date" | "datetime" | "boolean" | "number" | "image" | "file" | "address" | "email" | "phone" | "select" | "multiselect" | "payment" | "link" | "currency" | "sequence" | "relation" | "array"[]\n  initial_relation?: {\n    target: string\n    target_tags?: string[]\n    target_tags_include_source?: boolean\n    target_entity_tags?: string[]\n    override_with_source_filter?: boolean\n    source_filter?: {\n      limit?: { ... }\n      schema?: { ... }\n      attribute?: { ... }\n      relation_tag?: { ... }\n      tag?: { ... }\n      self?: { ... }\n    }\n    related_to?: Record<string, unknown>\n    mode: "append" | "prepend" | "set"\n    origin?: "system_recommendation" | "user_manually" | "entity_updating_system_recommendation"\n  }\n  title: string\n  sub_title?: string\n  repeatable?: boolean\n  target_settings?: {\n    allowed_ui_actions?: "schema-select" | "attribute-select" | "target-delete" | "target-add" | "target"[]\n    locked?: "each" | "first" | "system_recommendation"\n    isSingleTarget?: boolean\n    visibility?: {\n      mode: { ... }\n      if: { ... }\n      message?: { ... }\n    }\n  }\n}\n```\n\n### `MappingSourceProperty`\n\n```ts\ntype MappingSourceProperty = {\n  value: string\n  label: string\n  initial_target_value?: string\n  possible_target_types?: "string" | "date" | "datetime" | "boolean" | "number" | "image" | "file" | "address" | "email" | "phone" | "select" | "multiselect" | "payment" | "link" | "currency" | "sequence" | "relation" | "array"[]\n  raw?: boolean\n}\n```\n\n### `MappingSourceTargetType`\n\n```ts\ntype MappingSourceTargetType = "string" | "date" | "datetime" | "boolean" | "number" | "image" | "file" | "address" | "email" | "phone" | "select" | "multiselect" | "payment" | "link" | "currency" | "sequence" | "relation" | "array"\n```\n';
 
 
 exports.default = entity_mapping_default;

package/dist/{entity-mapping.d-CQv75o8M.d.cts → entity-mapping.d-8MtWa2_L.d.cts}

@@ -222,6 +222,14 @@ declare namespace Components {
              *
              */
             filter?: /* Mirrors entity-api's GraphNodeFilter (see entity-api openapi.yml). */ GraphNodeFilter[];
+            /**
+             * Only meaningful for a node expected to resolve to a single entity (the seed node, or
+             * "cardinality: one"). When true, finding zero matching entities is not an error - the
+             * mapping proceeds without this node's data instead of failing. Finding more than one
+             * match still fails regardless of this flag; ambiguity is never silently accepted.
+             *
+             */
+            optional?: boolean;
         }
         /**
          * Mirrors entity-api's GraphNodeFilter (see entity-api openapi.yml).
@@ -684,6 +692,20 @@ declare namespace Components {
                  * path to the array from the entity payload
                  */
                 source_path?: string;
+                /**
+                 * Kind of journey block the loop iterates. 'journey-multi-select' (default) is a cards block with multi selection. 'journey-file-upload' is a file upload block: source_path points at the submission's `_files.$relation` array and `filter_tags` narrows it down to the block's files. Forwarded to the flow-level loop by the Automation Hub.
+                 *
+                 */
+                source_type?: "journey-multi-select" | "journey-file-upload";
+                /**
+                 * Only iterate items of the array whose `_tags` contain every listed tag. Meant for relation arrays such as `submission._files.$relation`, where the journey tags each file relation with the upload block it came from. `##LOOP_INDEX##` keeps referring to the item's index in the unfiltered array.
+                 *
+                 * example:
+                 * [
+                 *   "_hidden_ 2a4b1c3d-0000-4000-8000-000000000000 - Dokumente"
+                 * ]
+                 */
+                filter_tags?: string[];
                 /**
                  * a hard limit of how many times the loop is allowed to run.
                  */

package/dist/{entity-mapping.d-CQv75o8M.d.ts → entity-mapping.d-8MtWa2_L.d.ts}

@@ -222,6 +222,14 @@ declare namespace Components {
              *
              */
             filter?: /* Mirrors entity-api's GraphNodeFilter (see entity-api openapi.yml). */ GraphNodeFilter[];
+            /**
+             * Only meaningful for a node expected to resolve to a single entity (the seed node, or
+             * "cardinality: one"). When true, finding zero matching entities is not an error - the
+             * mapping proceeds without this node's data instead of failing. Finding more than one
+             * match still fails regardless of this flag; ambiguity is never silently accepted.
+             *
+             */
+            optional?: boolean;
         }
         /**
          * Mirrors entity-api's GraphNodeFilter (see entity-api openapi.yml).
@@ -684,6 +692,20 @@ declare namespace Components {
                  * path to the array from the entity payload
                  */
                 source_path?: string;
+                /**
+                 * Kind of journey block the loop iterates. 'journey-multi-select' (default) is a cards block with multi selection. 'journey-file-upload' is a file upload block: source_path points at the submission's `_files.$relation` array and `filter_tags` narrows it down to the block's files. Forwarded to the flow-level loop by the Automation Hub.
+                 *
+                 */
+                source_type?: "journey-multi-select" | "journey-file-upload";
+                /**
+                 * Only iterate items of the array whose `_tags` contain every listed tag. Meant for relation arrays such as `submission._files.$relation`, where the journey tags each file relation with the upload block it came from. `##LOOP_INDEX##` keeps referring to the item's index in the unfiltered array.
+                 *
+                 * example:
+                 * [
+                 *   "_hidden_ 2a4b1c3d-0000-4000-8000-000000000000 - Dokumente"
+                 * ]
+                 */
+                filter_tags?: string[];
                 /**
                  * a hard limit of how many times the loop is allowed to run.
                  */

package/dist/index.cjs

@@ -161,7 +161,7 @@ var _chunkWOUASZJWcjs = require('./chunk-WOUASZJW.cjs');
 
 
 
-var _chunkYCTBOY3Tcjs = require('./chunk-YCTBOY3T.cjs');
+var _chunkB43U4DLUcjs = require('./chunk-B43U4DLU.cjs');
 
 
 var _chunkNJK5F5TFcjs = require('./chunk-NJK5F5TF.cjs');
@@ -228,7 +228,7 @@ var resolveClient = (params) => {
   }
   if (!entry.instance) {
     const definition = entry.loader();
-    entry.instance = _chunkYCTBOY3Tcjs.createApiClient.call(void 0, {
+    entry.instance = _chunkB43U4DLUcjs.createApiClient.call(void 0, {
       definition,
       token: state.token,
       headers: state.globalHeaders,
@@ -261,7 +261,7 @@ var resetAllClients = (registry) => {
 };
 
 // src/apis/_registry.ts
-var expandDef = (mod) => _chunkYCTBOY3Tcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
+var expandDef = (mod) => _chunkB43U4DLUcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
 var registerBuiltinApis = (registry) => {
   registerApi({
     registry,
@@ -609,9 +609,9 @@ var createSDK = () => {
       const available = [...registry.keys()].join(", ");
       throw new Error(`Unknown API: "${name}". Available: ${available}`);
     }
-    return _chunkYCTBOY3Tcjs.createApiHandle.call(void 0, {
+    return _chunkB43U4DLUcjs.createApiHandle.call(void 0, {
       resolveClient: () => resolveClient({ registry, name, state }),
-      createClient: () => _chunkYCTBOY3Tcjs.createApiClient.call(void 0, { definition: entry.loader(), apiName: name }),
+      createClient: () => _chunkB43U4DLUcjs.createApiClient.call(void 0, { definition: entry.loader(), apiName: name }),
       apiName: name
     });
   };
@@ -659,9 +659,9 @@ var createSDK = () => {
           return interceptorUse;
         }
         case "help":
-          return (apiName) => _chunkYCTBOY3Tcjs.help.call(void 0, apiName);
+          return (apiName) => _chunkB43U4DLUcjs.help.call(void 0, apiName);
         case "openapi":
-          return (apiName) => _chunkYCTBOY3Tcjs.openapi.call(void 0, apiName);
+          return (apiName) => _chunkB43U4DLUcjs.openapi.call(void 0, apiName);
         case "then":
         case "catch":
         case "finally":
@@ -691,4 +691,4 @@ var epilot = createSDK();
 
 
 
-exports.applyLargeResponseInterceptor = applyLargeResponseInterceptor; exports.applyRetryInterceptor = applyRetryInterceptor; exports.authorize = _chunkYCTBOY3Tcjs.authorize; exports.createSDK = createSDK; exports.epilot = epilot; exports.help = _chunkYCTBOY3Tcjs.help; exports.openapi = _chunkYCTBOY3Tcjs.openapi;
+exports.applyLargeResponseInterceptor = applyLargeResponseInterceptor; exports.applyRetryInterceptor = applyRetryInterceptor; exports.authorize = _chunkB43U4DLUcjs.authorize; exports.createSDK = createSDK; exports.epilot = epilot; exports.help = _chunkB43U4DLUcjs.help; exports.openapi = _chunkB43U4DLUcjs.openapi;

package/dist/index.d.cts

@@ -25,7 +25,7 @@ import { C as Client$i } from './document.d-DN37pjdx.cjs';
 import { C as Client$j } from './email-settings.d-DViLYaOl.cjs';
 import { C as Client$k } from './email-template.d-gtQkdaXM.cjs';
 import { C as Client$l } from './entity.d-GfKqzFGA.cjs';
-import { C as Client$m } from './entity-mapping.d-CQv75o8M.cjs';
+import { C as Client$m } from './entity-mapping.d-8MtWa2_L.cjs';
 import { C as Client$n } from './environments.d-qL1urwAq.cjs';
 import { C as Client$o } from './event-catalog.d-CCE1qmBN.cjs';
 import { C as Client$p } from './file.d-DELNV63w.cjs';

package/dist/index.d.ts

@@ -25,7 +25,7 @@ import { C as Client$i } from './document.d-DN37pjdx.js';
 import { C as Client$j } from './email-settings.d-DViLYaOl.js';
 import { C as Client$k } from './email-template.d-gtQkdaXM.js';
 import { C as Client$l } from './entity.d-GfKqzFGA.js';
-import { C as Client$m } from './entity-mapping.d-CQv75o8M.js';
+import { C as Client$m } from './entity-mapping.d-8MtWa2_L.js';
 import { C as Client$n } from './environments.d-qL1urwAq.js';
 import { C as Client$o } from './event-catalog.d-CCE1qmBN.js';
 import { C as Client$p } from './file.d-DELNV63w.js';

package/dist/index.js

@@ -161,7 +161,7 @@ import {
   expand,
   help,
   openapi
-} from "./chunk-KZXOYL5D.js";
+} from "./chunk-5D6VD6OZ.js";
 import {
   __require
 } from "./chunk-YPSWSI3M.js";

package/docs/entity-mapping.md

@@ -1029,6 +1029,8 @@ type MappingConfigs = Array<{
     use_uniqueness_criteria?: boolean
     loop_config?: {
       source_path?: { ... }
+      source_type?: { ... }
+      filter_tags?: { ... }
       length?: { ... }
     }
     conditionMode?: "oneOf" | "anyOf" | "allOf"
@@ -1115,6 +1117,8 @@ type MappingConfig = {
     use_uniqueness_criteria?: boolean
     loop_config?: {
       source_path?: { ... }
+      source_type?: { ... }
+      filter_tags?: { ... }
       length?: { ... }
     }
     conditionMode?: "oneOf" | "anyOf" | "allOf"
@@ -1201,6 +1205,8 @@ type MappingConfigV2 = {
     use_uniqueness_criteria?: boolean
     loop_config?: {
       source_path?: { ... }
+      source_type?: { ... }
+      filter_tags?: { ... }
       length?: { ... }
     }
     conditionMode?: "oneOf" | "anyOf" | "allOf"
@@ -1287,6 +1293,8 @@ type MappingConfigCommonFields = {
     use_uniqueness_criteria?: boolean
     loop_config?: {
       source_path?: { ... }
+      source_type?: { ... }
+      filter_tags?: { ... }
       length?: { ... }
     }
     conditionMode?: "oneOf" | "anyOf" | "allOf"
@@ -1452,6 +1460,8 @@ type ExecuteMappingReq = {
     use_uniqueness_criteria?: boolean
     loop_config?: {
       source_path?: { ... }
+      source_type?: { ... }
+      filter_tags?: { ... }
       length?: { ... }
     }
     conditionMode?: "oneOf" | "anyOf" | "allOf"
@@ -1558,6 +1568,8 @@ type MappingFailure = {
     use_uniqueness_criteria?: boolean
     loop_config?: {
       source_path?: { ... }
+      source_type?: { ... }
+      filter_tags?: { ... }
       length?: { ... }
     }
     conditionMode?: "oneOf" | "anyOf" | "allOf"
@@ -1687,6 +1699,8 @@ type TargetConfig = {
   use_uniqueness_criteria?: boolean
   loop_config?: {
     source_path?: string
+    source_type?: "journey-multi-select" | "journey-file-upload"
+    filter_tags?: string[]
     length?: number
   }
   conditionMode?: "oneOf" | "anyOf" | "allOf"
@@ -1847,6 +1861,7 @@ type GraphContextEntry = {
       cardinality?: { ... }
       fields?: { ... }
       filter?: { ... }
+      optional?: { ... }
     }>
     edges: Array<{
       from: { ... }
@@ -1882,6 +1897,7 @@ type GraphDefinition = {
       attribute: { ... }
       value: { ... }
     }>
+    optional?: boolean
   }>
   edges: Array<{
     from: string
@@ -1904,6 +1920,7 @@ type GraphNode = {
     attribute: string
     value: string | number | boolean
   }>
+  optional?: boolean
 }
 ```
 
@@ -2249,6 +2266,8 @@ type MappingHistoryEntry = {
     use_uniqueness_criteria?: boolean
     loop_config?: {
       source_path?: { ... }
+      source_type?: { ... }
+      filter_tags?: { ... }
       length?: { ... }
     }
     conditionMode?: "oneOf" | "anyOf" | "allOf"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epilot/sdk",
-  "version": "2.20.23",
+  "version": "2.20.24",
   "description": "JavaScript/TypeScript SDK for epilot APIs",
   "type": "module",
   "main": "./dist/index.cjs",