@epilot/sdk 2.19.11 → 2.19.12

package/dist/entity-mapping-WFPSOXRK.cjs

@@ -0,0 +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';
+
+
+exports.default = entity_mapping_default;

package/dist/{entity-mapping.d-DKSW3sfy.d.ts → entity-mapping.d-CQv75o8M.d.cts}

@@ -1,8 +1,6 @@
 import { OpenAPIClient, Parameters, AxiosRequestConfig, OperationResponse, UnknownParamsObject } from 'openapi-client-axios';
 
 /* Auto-copied from entity-mapping-client */
-/* eslint-disable */
-
 
 
 declare namespace Components {
@@ -92,6 +90,14 @@ declare namespace Components {
              * A reference (id and schema) to the entity to be used as source.
              */
             source_ref: EntityRef;
+            /**
+             * Reference to the current iteration's entity when running inside a flow loop.
+             * When set, its fields and relations are merged into the source context;
+             * on schema conflicts the loop entity wins, so paths like `<schema>._id` resolve
+             * to the iteration entity rather than to a same-schema relation of the source.
+             *
+             */
+            loop_ref?: EntityRef;
             /**
              * Mapping Configuration to apply.
              */
@@ -139,6 +145,127 @@ declare namespace Components {
         export interface ExecuteRelationsResp {
             relations?: NewRelationItem[];
         }
+        /**
+         * One multi-hop graph lookup against entity-api's `POST /v1/entity:graph`, resolved during
+         * graph_context enrichment (before mapping_attributes are evaluated). Every node in `graph.nodes`
+         * is merged into sourceContext under its own `id`, so listing several nodes here costs one
+         * entity-api call, not one per node.
+         *
+         * If a node's `cardinality` is "one" (or it is the seed node), exactly one entity must be found
+         * for it: zero or multiple matches fail the mapping execution instead of silently mapping
+         * missing/wrong data. If "many" (the default), it resolves to an array - possibly empty - with no
+         * such failure. Each node's cardinality is validated independently.
+         *
+         * `seed.entity_id` and any `graph.nodes[].filter[].value` may contain `{{handlebars}}` placeholders
+         * (e.g. `{{contract._id}}`, `{{contract.origin_order}}`), resolved against the in-progress
+         * sourceContext (the source entity, its 1-hop relations, and any custom variables already
+         * resolved) before the graph query is sent.
+         *
+         */
+        export interface GraphContextEntry {
+            seed: /* Mirrors entity-api's GraphSeed (see entity-api openapi.yml) - the entity the graph traversal starts from. */ GraphSeed;
+            graph: /* Mirrors entity-api's GraphDefinition (see entity-api openapi.yml) - the shape of the graph to traverse. */ GraphDefinition;
+        }
+        /**
+         * Mirrors entity-api's GraphDefinition (see entity-api openapi.yml) - the shape of the graph to traverse.
+         */
+        export interface GraphDefinition {
+            nodes: /* Mirrors entity-api's GraphNode (see entity-api openapi.yml). */ GraphNode[];
+            edges: /* Mirrors entity-api's GraphEdge (see entity-api openapi.yml). */ GraphEdge[];
+        }
+        /**
+         * Mirrors entity-api's GraphEdge (see entity-api openapi.yml).
+         */
+        export interface GraphEdge {
+            /**
+             * Source node ID.
+             * example:
+             * contact
+             */
+            from: string;
+            /**
+             * Target node ID.
+             * example:
+             * order
+             */
+            to: string;
+        }
+        /**
+         * Mirrors entity-api's GraphNode (see entity-api openapi.yml).
+         */
+        export interface GraphNode {
+            /**
+             * Unique identifier for this node in the graph definition.
+             * example:
+             * contact
+             */
+            id: string;
+            /**
+             * Entity schema slug for this node.
+             * example:
+             * contact
+             */
+            schema: string;
+            /**
+             * "one": this node resolves to a single entity. "many" (default if unset): this node
+             * resolves to an array of entities.
+             *
+             */
+            cardinality?: "one" | "many";
+            /**
+             * Optional entity fields to include in the hydrated response for this node.
+             */
+            fields?: string[];
+            /**
+             * Narrows this node's traversal results to entities matching every filter (AND semantics).
+             * Useful for disambiguating among multiple entities reachable via the same graph edge.
+             *
+             */
+            filter?: /* Mirrors entity-api's GraphNodeFilter (see entity-api openapi.yml). */ GraphNodeFilter[];
+        }
+        /**
+         * Mirrors entity-api's GraphNodeFilter (see entity-api openapi.yml).
+         */
+        export interface GraphNodeFilter {
+            /**
+             * Entity attribute name to match against.
+             * example:
+             * order_number
+             */
+            attribute: string;
+            /**
+             * Literal value the attribute must exactly equal. Supports `{{handlebars}}` placeholders
+             * resolved against sourceContext when given as a string.
+             *
+             * example:
+             * {{contract.origin_order}}
+             */
+            value: /**
+             * Literal value the attribute must exactly equal. Supports `{{handlebars}}` placeholders
+             * resolved against sourceContext when given as a string.
+             *
+             * example:
+             * {{contract.origin_order}}
+             */
+            (string | null) | number | boolean;
+        }
+        /**
+         * Mirrors entity-api's GraphSeed (see entity-api openapi.yml) - the entity the graph traversal starts from.
+         */
+        export interface GraphSeed {
+            /**
+             * The id of the seed entity. Supports `{{handlebars}}` placeholders resolved against sourceContext.
+             * example:
+             * {{contract._id}}
+             */
+            entity_id: string;
+            /**
+             * The node ID in `graph.nodes` that corresponds to the seed entity.
+             * example:
+             * contact
+             */
+            node_id: string;
+        }
         export interface JourneyRef {
             journey_id?: string;
         }
@@ -396,6 +523,31 @@ declare namespace Components {
              * Generate random ids / numbers
              */
             _random?: RandomOperation;
+            /**
+             * Iterate over a source array. Use with _as and _map.
+             * The value is a path to resolve from the source entity context.
+             * Example: "submission.meterReadings"
+             *
+             * example:
+             * submission.meterReadings
+             */
+            _each?: string;
+            /**
+             * Name for the current iteration item in _each.
+             * Accessed as $<name> in _copy paths within _map.
+             * Example: "reading" (accessed as $reading)
+             *
+             * example:
+             * reading
+             */
+            _as?: string;
+            /**
+             * Operation to evaluate per _each iteration item.
+             * Can be any OperationNode, typically an object with _copy
+             * references to the $<_as name> alias.
+             *
+             */
+            _map?: /* Mapping operation nodes are either primitive values or operation node objects */ OperationNode;
         }
         export interface Owner {
             type: "user" | "internal_service";
@@ -428,6 +580,10 @@ declare namespace Components {
              * Include all relation tags (labels) present on the main entity relation
              */
             target_tags_include_source?: boolean;
+            /**
+             * Tags to add to the matched target entity's _tags array during mapping. Useful for assigning file collections to file entities.
+             */
+            target_entity_tags?: string[];
             /**
              * Whether to override the relation source_filter with the specified one
              */
@@ -515,6 +671,11 @@ declare namespace Components {
              * Unique key for target entity (see upsertEntity of Entity API)
              */
             target_unique?: string[];
+            /**
+             * Execution wire flag set per automation by automation-workers: resolve the target entity via the organization's global uniqueness criteria (deduplication-api) instead of target_unique. Never persisted in stored mapping configs.
+             *
+             */
+            use_uniqueness_criteria?: boolean;
             /**
              * contains config in case of running in loop mode
              */
@@ -566,6 +727,32 @@ declare namespace Components {
              * Relation tags (labels) to include in main entity linkback relation attribute
              */
             linkback_relation_tags?: string[];
+            /**
+             * Multi-hop entity graph lookups resolved before any mapping_attribute is evaluated. Each
+             * entry queries entity-api's `POST /v1/entity:graph` and merges every node's result into
+             * sourceContext under its own `graph.nodes[].id`, so mapping_attributes can `_copy`/`_template`
+             * from `<node id>.<field>`. A graph node's value overwrites any existing sourceContext key of
+             * the same name (a source entity field, a 1-hop relation, or another graph node).
+             *
+             */
+            graph_context?: /**
+             * One multi-hop graph lookup against entity-api's `POST /v1/entity:graph`, resolved during
+             * graph_context enrichment (before mapping_attributes are evaluated). Every node in `graph.nodes`
+             * is merged into sourceContext under its own `id`, so listing several nodes here costs one
+             * entity-api call, not one per node.
+             *
+             * If a node's `cardinality` is "one" (or it is the seed node), exactly one entity must be found
+             * for it: zero or multiple matches fail the mapping execution instead of silently mapping
+             * missing/wrong data. If "many" (the default), it resolves to an array - possibly empty - with no
+             * such failure. Each node's cardinality is validated independently.
+             *
+             * `seed.entity_id` and any `graph.nodes[].filter[].value` may contain `{{handlebars}}` placeholders
+             * (e.g. `{{contract._id}}`, `{{contract.origin_order}}`), resolved against the in-progress
+             * sourceContext (the source entity, its 1-hop relations, and any custom variables already
+             * resolved) before the graph query is sent.
+             *
+             */
+            GraphContextEntry[];
         }
     }
 }
@@ -1058,6 +1245,12 @@ type ExecuteMappingReq = Components.Schemas.ExecuteMappingReq;
 type ExecuteMappingResp = Components.Schemas.ExecuteMappingResp;
 type ExecuteRelationsReq = Components.Schemas.ExecuteRelationsReq;
 type ExecuteRelationsResp = Components.Schemas.ExecuteRelationsResp;
+type GraphContextEntry = Components.Schemas.GraphContextEntry;
+type GraphDefinition = Components.Schemas.GraphDefinition;
+type GraphEdge = Components.Schemas.GraphEdge;
+type GraphNode = Components.Schemas.GraphNode;
+type GraphNodeFilter = Components.Schemas.GraphNodeFilter;
+type GraphSeed = Components.Schemas.GraphSeed;
 type JourneyRef = Components.Schemas.JourneyRef;
 type Loop_Index_String = Components.Schemas.LoopIndexString;
 type MapCondition = Components.Schemas.MapCondition;
@@ -1089,4 +1282,4 @@ type SetValueMapper = Components.Schemas.SetValueMapper;
 type SourceConfig = Components.Schemas.SourceConfig;
 type TargetConfig = Components.Schemas.TargetConfig;
 
-export { type AppendValueMapper as A, type OperationObjectNode as B, type Client as C, type Owner as D, type Entity as E, type PrimitiveJSONValue as F, type RelationAttribute as G, type RelationItem as H, type SetValueMapper as I, type JourneyRef as J, type SourceConfig as K, type Loop_Index_String as L, type MapCondition as M, type NewRelationItem as N, type OperationMethods as O, Paths as P, type RandomOperation as R, type SearchMappingReq as S, type TargetConfig as T, Components as a, type PathsDictionary as b, type AttributeOrigin as c, type ConditionNode as d, type CopyValueMapper as e, type EntityRef as f, type ExecuteMappingReq as g, type ExecuteMappingResp as h, type ExecuteRelationsReq as i, type ExecuteRelationsResp as j, type MappingAttribute as k, type MappingAttributeMode as l, type MappingAttributeV2 as m, type MappingConfig as n, type MappingConfigCommonFields as o, type MappingConfigV2 as p, type MappingConfigs as q, type MappingConfigsResp as r, type MappingFailure as s, type MappingHistoryEntry as t, type MappingHistoryResp as u, type MappingSource as v, type MappingSourceProperty as w, type MappingSourceTargetType as x, type MappingWarning as y, type OperationNode as z };
+export { type AppendValueMapper as A, type MappingSource as B, type Client as C, type MappingSourceProperty as D, type Entity as E, type MappingSourceTargetType as F, type GraphContextEntry as G, type MappingWarning as H, type OperationNode as I, type JourneyRef as J, type OperationObjectNode as K, type Loop_Index_String as L, type MapCondition as M, type NewRelationItem as N, type OperationMethods as O, Paths as P, type Owner as Q, type PrimitiveJSONValue as R, type RandomOperation as S, type RelationAttribute as T, type RelationItem as U, type SearchMappingReq as V, type SetValueMapper as W, type SourceConfig as X, type TargetConfig as Y, Components as a, type PathsDictionary as b, type AttributeOrigin as c, type ConditionNode as d, type CopyValueMapper as e, type EntityRef as f, type ExecuteMappingReq as g, type ExecuteMappingResp as h, type ExecuteRelationsReq as i, type ExecuteRelationsResp as j, type GraphDefinition as k, type GraphEdge as l, type GraphNode as m, type GraphNodeFilter as n, type GraphSeed as o, type MappingAttribute as p, type MappingAttributeMode as q, type MappingAttributeV2 as r, type MappingConfig as s, type MappingConfigCommonFields as t, type MappingConfigV2 as u, type MappingConfigs as v, type MappingConfigsResp as w, type MappingFailure as x, type MappingHistoryEntry as y, type MappingHistoryResp as z };