@epilot/cli 0.1.115 → 0.1.117

package/README.md

@@ -29,7 +29,7 @@ npm install -g @epilot/cli
 
 <!-- usage-help -->
 ```
-epilot v0.1.115 — CLI for epilot APIs
+epilot v0.1.117 — CLI for epilot APIs
 
 USAGE
   epilot <api> <operationId> [params...] [flags]

package/definitions/billing.json

@@ -660,6 +660,12 @@
             "schema": {
               "type": "string"
             }
+          },
+          {
+            "$ref": "#/components/parameters/HistoryChangeTypes"
+          },
+          {
+            "$ref": "#/components/parameters/IncludeHistory"
           }
         ],
         "responses": {
@@ -693,6 +699,12 @@
             "schema": {
               "type": "string"
             }
+          },
+          {
+            "$ref": "#/components/parameters/HistoryChangeTypes"
+          },
+          {
+            "$ref": "#/components/parameters/IncludeHistory"
           }
         ],
         "responses": {
@@ -730,6 +742,9 @@
           {
             "$ref": "#/components/parameters/ConfigurationHistoryChangeType"
           },
+          {
+            "$ref": "#/components/parameters/HistoryChangeTypes"
+          },
           {
             "$ref": "#/components/parameters/From"
           },
@@ -772,6 +787,9 @@
           {
             "$ref": "#/components/parameters/ConfigurationHistoryChangeType"
           },
+          {
+            "$ref": "#/components/parameters/HistoryChangeTypes"
+          },
           {
             "$ref": "#/components/parameters/From"
           },
@@ -877,11 +895,33 @@
         "schema": {
           "type": "string",
           "enum": [
-            "installment_amount_changed"
+            "installment_amount_changed",
+            "contract_pricing_changed"
           ],
           "default": "installment_amount_changed"
         },
         "description": "Billing configuration change type to return."
+      },
+      "HistoryChangeTypes": {
+        "name": "history_change_types",
+        "in": "query",
+        "required": false,
+        "schema": {
+          "type": "string",
+          "pattern": "^(installment_amount_changed|contract_pricing_changed)(,(installment_amount_changed|contract_pricing_changed))*$",
+          "example": "installment_amount_changed,contract_pricing_changed"
+        },
+        "description": "Comma-separated billing configuration change types to return. When omitted, installment history is returned by default."
+      },
+      "IncludeHistory": {
+        "name": "include_history",
+        "in": "query",
+        "required": false,
+        "schema": {
+          "type": "boolean",
+          "default": true
+        },
+        "description": "Include recent configuration history in the pricing information response. Set to false when using the dedicated configuration history endpoint."
       }
     },
     "securitySchemes": {
@@ -1856,6 +1896,10 @@
           "price_title": {
             "type": "string"
           },
+          "tariff_type": {
+            "type": "string",
+            "description": "Semantic tariff register for the price component, such as HT or NT."
+          },
           "pricing_model": {
             "type": "string"
           },
@@ -1941,12 +1985,59 @@
           "base_price": {
             "$ref": "#/components/schemas/PriceContext"
           },
+          "base_prices": {
+            "type": "array",
+            "description": "Canonically ordered base-price components. The singular base_price remains for compatibility.",
+            "items": {
+              "$ref": "#/components/schemas/PriceContext"
+            }
+          },
           "working_price": {
             "$ref": "#/components/schemas/PriceContext"
+          },
+          "working_prices": {
+            "type": "array",
+            "description": "Canonically ordered working-price components, including separate HT and NT prices when present. The singular working_price remains for compatibility.",
+            "items": {
+              "$ref": "#/components/schemas/PriceContext"
+            }
           }
         }
       },
-      "ConfigurationHistoryRow": {
+      "ContractTariffContext": {
+        "type": "object",
+        "properties": {
+          "product_id": {
+            "type": "string"
+          },
+          "product_title": {
+            "type": "string"
+          }
+        }
+      },
+      "ContractPricingContext": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/ConfigurationHistoryContext"
+          },
+          {
+            "type": "object",
+            "properties": {
+              "tariff": {
+                "$ref": "#/components/schemas/ContractTariffContext"
+              },
+              "tariffs": {
+                "type": "array",
+                "description": "Canonically ordered tariff products for composite Contracts. The singular tariff is populated when exactly one tariff product exists.",
+                "items": {
+                  "$ref": "#/components/schemas/ContractTariffContext"
+                }
+              }
+            }
+          }
+        ]
+      },
+      "ConfigurationHistoryRowBase": {
         "type": "object",
         "required": [
           "event_id",
@@ -1957,8 +2048,7 @@
           "schema_version",
           "changed_at",
           "created_at",
-          "source",
-          "new_value"
+          "source"
         ],
         "properties": {
           "event_id": {
@@ -1977,12 +2067,6 @@
           "entity_id": {
             "type": "string"
           },
-          "change_type": {
-            "type": "string",
-            "enum": [
-              "installment_amount_changed"
-            ]
-          },
           "schema_version": {
             "type": "integer",
             "example": 1
@@ -2021,20 +2105,112 @@
           },
           "source_reference": {
             "type": "string"
+          }
+        }
+      },
+      "InstallmentAmountChangedHistoryRow": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/ConfigurationHistoryRowBase"
           },
-          "previous_value": {
-            "nullable": true,
-            "allOf": [
-              {
+          {
+            "type": "object",
+            "required": [
+              "change_type",
+              "new_value"
+            ],
+            "properties": {
+              "change_type": {
+                "type": "string",
+                "enum": [
+                  "installment_amount_changed"
+                ]
+              },
+              "previous_value": {
+                "nullable": true,
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/InstallmentAmountValue"
+                  }
+                ]
+              },
+              "new_value": {
                 "$ref": "#/components/schemas/InstallmentAmountValue"
+              },
+              "context": {
+                "$ref": "#/components/schemas/ConfigurationHistoryContext"
               }
-            ]
+            }
+          }
+        ]
+      },
+      "ContractPricingChangedHistoryRow": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/ConfigurationHistoryRowBase"
           },
-          "new_value": {
-            "$ref": "#/components/schemas/InstallmentAmountValue"
+          {
+            "type": "object",
+            "required": [
+              "change_type",
+              "previous_context",
+              "new_context",
+              "changed_fields"
+            ],
+            "properties": {
+              "change_type": {
+                "type": "string",
+                "enum": [
+                  "contract_pricing_changed"
+                ]
+              },
+              "previous_context": {
+                "nullable": true,
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/ContractPricingContext"
+                  }
+                ]
+              },
+              "new_context": {
+                "nullable": true,
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/ContractPricingContext"
+                  }
+                ]
+              },
+              "changed_fields": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "enum": [
+                    "tariff",
+                    "base_price",
+                    "working_price",
+                    "discount",
+                    "dynamic_tariff_configuration"
+                  ]
+                }
+              }
+            }
+          }
+        ]
+      },
+      "ConfigurationHistoryRow": {
+        "oneOf": [
+          {
+            "$ref": "#/components/schemas/InstallmentAmountChangedHistoryRow"
           },
-          "context": {
-            "$ref": "#/components/schemas/ConfigurationHistoryContext"
+          {
+            "$ref": "#/components/schemas/ContractPricingChangedHistoryRow"
+          }
+        ],
+        "discriminator": {
+          "propertyName": "change_type",
+          "mapping": {
+            "installment_amount_changed": "#/components/schemas/InstallmentAmountChangedHistoryRow",
+            "contract_pricing_changed": "#/components/schemas/ContractPricingChangedHistoryRow"
           }
         }
       },

package/definitions/integration-toolkit.json

@@ -2,7 +2,7 @@
   "openapi": "3.0.3",
   "info": {
     "title": "Integration Toolkit API",
-    "version": "1.17.0",
+    "version": "1.18.0",
     "description": "API for integrating with external systems in a standardised way."
   },
   "tags": [
@@ -3977,7 +3977,7 @@
       "post": {
         "operationId": "createErpImport",
         "summary": "createErpImport",
-        "description": "Register an already-uploaded file (S3 ref) as a pricing-file import job. Returns the job and a file preview. Nothing runs yet: no use case is chosen and no validation starts here. Optionally rank candidates with POST /v2/erp/imports/{importId}:suggest-use-cases, then start validation with POST /v2/erp/imports/{importId}:validate.",
+        "description": "Register an already-uploaded file (S3 ref) as a pricing-file import job. Returns the job and a file preview. Nothing runs yet: no use case is chosen and no validation starts here. Optionally rank candidates with POST /v2/erp/imports/{importId}:suggest-use-cases, then start validation with POST /v2/erp/imports/{importId}:validate.\nPass `import_id` to repoint an existing PENDING import at a different file instead, keeping its id and its place in the history.",
         "tags": [
           "erp-imports"
         ],
@@ -3992,8 +3992,18 @@
           }
         },
         "responses": {
+          "200": {
+            "description": "The named import now points at this file. Returned only when `import_id` was supplied — no `Location`, because nothing was created.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CreateErpImportResponse"
+                }
+              }
+            }
+          },
           "201": {
-            "description": "Import job created",
+            "description": "Import job created. Returned only when `import_id` was omitted.",
             "headers": {
               "Location": {
                 "description": "URL of the created job (`/v2/erp/imports/{importId}`).",
@@ -4016,6 +4026,12 @@
           "403": {
             "$ref": "#/components/responses/Forbidden"
           },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "409": {
+            "$ref": "#/components/responses/Conflict"
+          },
           "500": {
             "$ref": "#/components/responses/InternalServerError"
           }
@@ -4403,6 +4419,10 @@
             "type": "boolean",
             "default": false,
             "description": "Return a sample of the file's first rows in `preview`. Only controls whether the sample comes BACK — the head is read either way, because that read is how an unreadable file gets refused."
+          },
+          "import_id": {
+            "type": "string",
+            "description": "Repoint an EXISTING import at this file instead of registering a new one — same row, same id, so iterating on which file to import leaves one entry in the history rather than one per attempt.\nOnly a PENDING import may be repointed; any other status returns 409 with code `IMPORT_NOT_REPLACEABLE`. Past the first check the previous verdict is what tells the user what to fix, and a job that reached the execute phase may already have published rows under `correlation_id`.\nAn id that names nothing returns 404. It never falls back to registering a new import: a stale id must fail loudly rather than quietly produce a second one."
           }
         }
       },
@@ -8473,7 +8493,7 @@
       },
       "FileProxyUploadConfig": {
         "type": "object",
-        "description": "Upload-side settings for a file_proxy use case with `direction: upload`.\nEverything about WHAT is sent lives on the outbound mapping\n(see `FileProxyDeliveryConfig`); this object only governs HOW the transfer is bounded\nand judged.\n",
+        "description": "Upload-side settings for a file_proxy use case with `direction: upload`.\nThe surrounding file_proxy configuration owns WHAT and HOW to send: `fan_out`,\n`file_source`, `params_mapping`, lookups, constants, auth, and steps. This nested object\ngoverns upload-specific limits and how the final external response is judged. The\noutbound mapping remains a pure pointer to the recipe (see `FileProxyDeliveryConfig`).\n",
         "properties": {
           "max_file_bytes": {
             "type": "integer",
@@ -8486,7 +8506,7 @@
             "minimum": 1,
             "maximum": 100,
             "default": 8,
-            "description": "Maximum delivery attempts per item before the delivery is marked failed and the\nmessage is dead-lettered. Attempts are spaced by an exponential, jittered backoff\nspanning roughly 16 hours over the default 8 attempts, so an ERP maintenance window\ndoes not exhaust them.\n\nLives here rather than on the outbound delivery because how hard to retry is a\nproperty of the transport — the same judgement as `max_file_bytes` — and the outbound\ndelivery is a pure pointer.\n"
+            "description": "Maximum delivery attempts per item before the delivery is marked failed. Attempts\nare spaced by an exponential, jittered backoff. The default 8 attempts schedule at\nmost 7 delays, totaling about 7 hours 40 minutes before jitter, so a normal ERP\nmaintenance window does not immediately exhaust them.\n\nLives here rather than on the outbound delivery because how hard to retry is a\nproperty of the transport — the same judgement as `max_file_bytes` — and the outbound\ndelivery is a pure pointer.\n"
           },
           "success_when": {
             "type": "string",
@@ -9025,7 +9045,7 @@
           "id": {
             "type": "string",
             "format": "uuid",
-            "description": "Unique identifier for this mapping"
+            "description": "Unique identifier for this mapping; generated by the API when omitted"
           },
           "name": {
             "type": "string",

package/dist/bin/epilot.js

@@ -11,7 +11,7 @@ import { defineCommand } from "citty";
 var main = defineCommand({
   meta: {
     name: "epilot",
-    version: "0.1.115",
+    version: "0.1.117",
     description: "CLI for epilot APIs"
   },
   args: {
@@ -31,7 +31,7 @@ var main = defineCommand({
     profile: () => import("../profile-OZJL5ZPT.js").then((m) => m.default),
     config: () => import("../config-DGZIMLZK.js").then((m) => m.default),
     completion: () => import("../completion-YY2UW6SA.js").then((m) => m.default),
-    upgrade: () => import("../upgrade-J67DJOAP.js").then((m) => m.default),
+    upgrade: () => import("../upgrade-YQ6STVES.js").then((m) => m.default),
     "access-token": () => import("../access-token-WWE6BDJH.js").then((m) => m.default),
     address: () => import("../address-EH3C4CVB.js").then((m) => m.default),
     "address-suggestions": () => import("../address-suggestions-RRSLOBFW.js").then((m) => m.default),
@@ -134,7 +134,7 @@ process.stderr.on("error", (err) => {
   if (err.code === "EPIPE") process.exit(0);
   throw err;
 });
-var VERSION = true ? "0.1.115" : (await null).default.version;
+var VERSION = true ? "0.1.117" : (await null).default.version;
 var reorderedArgv = hoistFlagsAfterSubcommand(process.argv.slice(2));
 process.argv = [process.argv[0], process.argv[1], ...reorderedArgv];
 var args = process.argv.slice(2);

package/dist/{upgrade-J67DJOAP.js → upgrade-YQ6STVES.js}

@@ -72,7 +72,7 @@ ${GREEN}${BOLD}Upgraded to @epilot/cli@${latest}${RESET}
   }
 });
 var getCurrentVersion = () => {
-  if (true) return "0.1.115";
+  if (true) return "0.1.117";
   try {
     const output = execSync("npm ls -g @epilot/cli --depth=0 --json 2>/dev/null", {
       encoding: "utf-8",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epilot/cli",
-  "version": "0.1.115",
+  "version": "0.1.117",
   "description": "CLI for epilot APIs",
   "type": "module",
   "bin": {