@epilot/sdk 2.20.45 → 2.20.46

package/dist/{integration-toolkit.d-D4CzSBOS.d.cts → integration-toolkit.d-93TYFohH.d.cts}

@@ -2940,9 +2940,23 @@ declare namespace Components {
              */
             variants?: number;
             /**
-             * Version writes — one per variant per effective date. Absent when the entity is not conditional.
+             * Version writes — one per variant per effective date. Absent when the entity is not conditional. A total across variants that need not have the same number of dates each, so it says nothing about any one variant; use `version_attribute` to tell dated variants from ones effective now.
              */
             versions?: number;
+            /**
+             * The schema conditions this entity's variants are split by — those the mapping reads from the file, in schema order. A condition left unmapped matches any value and one mapped as a constant pins every variant alike, so neither is listed. Absent when the entity is not conditional.
+             * example:
+             * [
+             *   "grid_area"
+             * ]
+             */
+            condition_attributes?: string[];
+            /**
+             * The attribute versions are dated by (`valid_from`) when the mapping sets it. Absent when the entity is not conditional, or when every variant is effective now.
+             * example:
+             * valid_from
+             */
+            version_attribute?: string;
         }
         /**
          * Why the import failed — present if and only if status = FAILED. `code` is the translation key; for VALIDATION_BLOCKED the specifics are in `validation`.
@@ -3133,13 +3147,9 @@ declare namespace Components {
                 [name: string]: number;
             };
             /**
-             * What this import will write, one entry per entity instance, capped at 20 in first-appearance order. `entities` stays exact regardless.
+             * What this import will write, one entry per entity instance, capped at 6 per mapping target in first-appearance order, so no target crowds another out. `entities` stays exact regardless: `entities[slug]` minus the entries listed for that slug is how many are not shown.
              */
             entity_details?: /* One entity instance the import will write, attributed to the mapping target that produces it. */ ErpImportEntityDetail[];
-            /**
-             * More entities exist than `entity_details` lists.
-             */
-            entity_details_truncated?: boolean;
             /**
              * Whole-file issues, at most one per `code`. Do not expect the length to match blocking + warnings: those also count per-row problems, which are recorded for support but never listed here. Warnings here are what `ack_warnings` on `:execute` acknowledges.
              */

package/dist/{integration-toolkit.d-D4CzSBOS.d.ts → integration-toolkit.d-93TYFohH.d.ts}

@@ -2940,9 +2940,23 @@ declare namespace Components {
              */
             variants?: number;
             /**
-             * Version writes — one per variant per effective date. Absent when the entity is not conditional.
+             * Version writes — one per variant per effective date. Absent when the entity is not conditional. A total across variants that need not have the same number of dates each, so it says nothing about any one variant; use `version_attribute` to tell dated variants from ones effective now.
              */
             versions?: number;
+            /**
+             * The schema conditions this entity's variants are split by — those the mapping reads from the file, in schema order. A condition left unmapped matches any value and one mapped as a constant pins every variant alike, so neither is listed. Absent when the entity is not conditional.
+             * example:
+             * [
+             *   "grid_area"
+             * ]
+             */
+            condition_attributes?: string[];
+            /**
+             * The attribute versions are dated by (`valid_from`) when the mapping sets it. Absent when the entity is not conditional, or when every variant is effective now.
+             * example:
+             * valid_from
+             */
+            version_attribute?: string;
         }
         /**
          * Why the import failed — present if and only if status = FAILED. `code` is the translation key; for VALIDATION_BLOCKED the specifics are in `validation`.
@@ -3133,13 +3147,9 @@ declare namespace Components {
                 [name: string]: number;
             };
             /**
-             * What this import will write, one entry per entity instance, capped at 20 in first-appearance order. `entities` stays exact regardless.
+             * What this import will write, one entry per entity instance, capped at 6 per mapping target in first-appearance order, so no target crowds another out. `entities` stays exact regardless: `entities[slug]` minus the entries listed for that slug is how many are not shown.
              */
             entity_details?: /* One entity instance the import will write, attributed to the mapping target that produces it. */ ErpImportEntityDetail[];
-            /**
-             * More entities exist than `entity_details` lists.
-             */
-            entity_details_truncated?: boolean;
             /**
              * Whole-file issues, at most one per `code`. Do not expect the length to match blocking + warnings: those also count per-row problems, which are recorded for support but never listed here. Warnings here are what `ack_warnings` on `:execute` acknowledges.
              */

package/docs/integration-toolkit.md

@@ -3707,10 +3707,11 @@ const { data } = await client.createErpImport(
           "entity_schema": "string",
           "business_key": {},
           "variants": 0,
-          "versions": 0
+          "versions": 0,
+          "condition_attributes": ["grid_area"],
+          "version_attribute": "valid_from"
         }
       ],
-      "entity_details_truncated": true,
       "issues": [
         {
           "code": "UNIQUE_ID_COLUMN_MISSING",
@@ -3796,10 +3797,11 @@ const { data } = await client.listErpImports({
             "entity_schema": "string",
             "business_key": {},
             "variants": 0,
-            "versions": 0
+            "versions": 0,
+            "condition_attributes": ["grid_area"],
+            "version_attribute": "valid_from"
           }
         ],
-        "entity_details_truncated": true,
         "issues": [
           {
             "code": "UNIQUE_ID_COLUMN_MISSING",
@@ -3878,10 +3880,11 @@ const { data } = await client.getErpImport({
         "entity_schema": "string",
         "business_key": {},
         "variants": 0,
-        "versions": 0
+        "versions": 0,
+        "condition_attributes": ["grid_area"],
+        "version_attribute": "valid_from"
       }
     ],
-    "entity_details_truncated": true,
     "issues": [
       {
         "code": "UNIQUE_ID_COLUMN_MISSING",
@@ -4188,8 +4191,9 @@ type ErpImportValidation = {
     business_key: Record<string, string>
     variants?: number
     versions?: number
+    condition_attributes?: string[]
+    version_attribute?: string
   }>
-  entity_details_truncated?: boolean
   issues?: Array<{
     code: "UNIQUE_ID_COLUMN_MISSING" | "MAPPED_COLUMN_MISSING" | "MALFORMED_ROW" | "INVALID_ENCODING" | "EMPTY_FILE" | "TOO_MANY_ROWS" | "BLANK_ROWS_SKIPPED" | "TIER_ROWS_NOT_GROUPED" | "TIER_BANDS_CONFLICT" | "CONDITION_VALUE_MISSING" | "VARIANT_VALUE_CONFLICT" | "ATTRIBUTE_NOT_OVERRIDABLE" | "ATTRIBUTE_NOT_IN_SCHEMA" | "IS_CONDITIONAL_NOT_CONSTANT" | "SCHEMA_NOT_CONDITIONABLE" | "SCHEMA_NOT_FOUND" | "SCHEMA_DECLARES_NO_CONDITIONS" | "GROUPING_KEY_NOT_A_COLUMN" | "GROUPING_KEY_IS_SORT_COLUMN" | "CONDITIONAL_TARGET_MODE_UNSUPPORTED"
     severity: "warning" | "blocking"
@@ -4214,6 +4218,8 @@ type ErpImportEntityDetail = {
   business_key: Record<string, string>
   variants?: number
   versions?: number
+  condition_attributes?: string[]
+  version_attribute?: string
 }
 ```
 
@@ -4285,7 +4291,6 @@ type CreateErpImportResponse = {
       warnings: { ... }
       entities: { ... }
       entity_details?: { ... }
-      entity_details_truncated?: { ... }
       issues?: { ... }
     }
     progress?: {
@@ -4336,8 +4341,9 @@ type ErpImportJob = {
       business_key: { ... }
       variants?: { ... }
       versions?: { ... }
+      condition_attributes?: { ... }
+      version_attribute?: { ... }
     }>
-    entity_details_truncated?: boolean
     issues?: Array<{
       code: { ... }
       severity: { ... }
@@ -4385,7 +4391,6 @@ type ErpImportList = {
       warnings: { ... }
       entities: { ... }
       entity_details?: { ... }
-      entity_details_truncated?: { ... }
       issues?: { ... }
     }
     progress?: {

package/package.json

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