@epilot/sdk 2.19.11 → 2.19.12

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

@@ -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 };

package/dist/index.cjs

@@ -158,7 +158,7 @@ var _chunkADSWGLIVcjs = require('./chunk-ADSWGLIV.cjs');
 
 
 
-var _chunk5VKNAAXIcjs = require('./chunk-5VKNAAXI.cjs');
+var _chunk2AZIGIR2cjs = require('./chunk-2AZIGIR2.cjs');
 
 
 var _chunkNJK5F5TFcjs = require('./chunk-NJK5F5TF.cjs');
@@ -225,7 +225,7 @@ var resolveClient = (params) => {
   }
   if (!entry.instance) {
     const definition = entry.loader();
-    entry.instance = _chunk5VKNAAXIcjs.createApiClient.call(void 0, {
+    entry.instance = _chunk2AZIGIR2cjs.createApiClient.call(void 0, {
       definition,
       token: state.token,
       headers: state.globalHeaders,
@@ -258,7 +258,7 @@ var resetAllClients = (registry) => {
 };
 
 // src/apis/_registry.ts
-var expandDef = (mod) => _chunk5VKNAAXIcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
+var expandDef = (mod) => _chunk2AZIGIR2cjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
 var registerBuiltinApis = (registry) => {
   registerApi({
     registry,
@@ -601,9 +601,9 @@ var createSDK = () => {
       const available = [...registry.keys()].join(", ");
       throw new Error(`Unknown API: "${name}". Available: ${available}`);
     }
-    return _chunk5VKNAAXIcjs.createApiHandle.call(void 0, {
+    return _chunk2AZIGIR2cjs.createApiHandle.call(void 0, {
       resolveClient: () => resolveClient({ registry, name, state }),
-      createClient: () => _chunk5VKNAAXIcjs.createApiClient.call(void 0, { definition: entry.loader(), apiName: name }),
+      createClient: () => _chunk2AZIGIR2cjs.createApiClient.call(void 0, { definition: entry.loader(), apiName: name }),
       apiName: name
     });
   };
@@ -651,9 +651,9 @@ var createSDK = () => {
           return interceptorUse;
         }
         case "help":
-          return (apiName) => _chunk5VKNAAXIcjs.help.call(void 0, apiName);
+          return (apiName) => _chunk2AZIGIR2cjs.help.call(void 0, apiName);
         case "openapi":
-          return (apiName) => _chunk5VKNAAXIcjs.openapi.call(void 0, apiName);
+          return (apiName) => _chunk2AZIGIR2cjs.openapi.call(void 0, apiName);
         case "then":
         case "catch":
         case "finally":
@@ -683,4 +683,4 @@ var epilot = createSDK();
 
 
 
-exports.applyLargeResponseInterceptor = applyLargeResponseInterceptor; exports.applyRetryInterceptor = applyRetryInterceptor; exports.authorize = _chunk5VKNAAXIcjs.authorize; exports.createSDK = createSDK; exports.epilot = epilot; exports.help = _chunk5VKNAAXIcjs.help; exports.openapi = _chunk5VKNAAXIcjs.openapi;
+exports.applyLargeResponseInterceptor = applyLargeResponseInterceptor; exports.applyRetryInterceptor = applyRetryInterceptor; exports.authorize = _chunk2AZIGIR2cjs.authorize; exports.createSDK = createSDK; exports.epilot = epilot; exports.help = _chunk2AZIGIR2cjs.help; exports.openapi = _chunk2AZIGIR2cjs.openapi;

package/dist/index.d.cts

@@ -24,7 +24,7 @@ import { C as Client$h } from './document.d-DN37pjdx.cjs';
 import { C as Client$i } from './email-settings.d-DViLYaOl.cjs';
 import { C as Client$j } from './email-template.d-gtQkdaXM.cjs';
 import { C as Client$k } from './entity.d-C3WddgVt.cjs';
-import { C as Client$l } from './entity-mapping.d-DKSW3sfy.cjs';
+import { C as Client$l } from './entity-mapping.d-CQv75o8M.cjs';
 import { C as Client$m } from './environments.d-840_mC07.cjs';
 import { C as Client$n } from './event-catalog.d-QIhhewVH.cjs';
 import { C as Client$o } from './file.d-CBsXF4W8.cjs';

package/dist/index.d.ts

@@ -24,7 +24,7 @@ import { C as Client$h } from './document.d-DN37pjdx.js';
 import { C as Client$i } from './email-settings.d-DViLYaOl.js';
 import { C as Client$j } from './email-template.d-gtQkdaXM.js';
 import { C as Client$k } from './entity.d-C3WddgVt.js';
-import { C as Client$l } from './entity-mapping.d-DKSW3sfy.js';
+import { C as Client$l } from './entity-mapping.d-CQv75o8M.js';
 import { C as Client$m } from './environments.d-840_mC07.js';
 import { C as Client$n } from './event-catalog.d-QIhhewVH.js';
 import { C as Client$o } from './file.d-CBsXF4W8.js';

package/dist/index.js

@@ -158,7 +158,7 @@ import {
   expand,
   help,
   openapi
-} from "./chunk-M2O7H6A2.js";
+} from "./chunk-X3SRAHIZ.js";
 import {
   __require
 } from "./chunk-YPSWSI3M.js";