@epilot/cli 0.1.96 → 0.1.97

package/README.md

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

package/definitions/design.json

@@ -302,6 +302,71 @@
         }
       }
     },
+    "/v1/designs/{designId}/duplicate": {
+      "post": {
+        "operationId": "duplicateDesign",
+        "summary": "duplicateDesign",
+        "description": "Duplicate an existing design owned by the user organization. The copy carries over the style, custom CSS and name (marked as a copy) but does NOT carry over journey/portal relations, so the new design starts with 0 consumers, exactly like a freshly created design.",
+        "tags": [
+          "design-builder"
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "designId",
+            "required": true,
+            "schema": {
+              "$ref": "#/components/schemas/DesignId"
+            }
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "Success - design duplicated with success.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/AddDesignRes"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Validation Errors",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResp"
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Authentication Errors",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResp"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No design found"
+          },
+          "500": {
+            "description": "Other errors",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResp"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/v1/designs/{designId}/parse": {
       "get": {
         "operationId": "getThemeFromDesign",

package/definitions/integration-toolkit.json

@@ -2,7 +2,7 @@
   "openapi": "3.0.3",
   "info": {
     "title": "Integration Toolkit API",
-    "version": "1.7.0",
+    "version": "1.8.0",
     "description": "API for integrating with external systems in a standardised way."
   },
   "tags": [
@@ -7932,6 +7932,20 @@
               "$ref": "#/components/schemas/MeterReadingUpdate"
             }
           },
+          "prune_scope_updates": {
+            "type": "array",
+            "description": "Resolved prune scopes produced by entity mappings using `upsert-prune-scope-purge` / `upsert-prune-scope-delete`. Each entry describes the entities that would be deleted at runtime because they exist in scope but were not part of this payload.",
+            "items": {
+              "$ref": "#/components/schemas/EntityPruneScopeUpdate"
+            }
+          },
+          "meter_readings_prune_scope_updates": {
+            "type": "array",
+            "description": "Resolved prune scopes produced by meter reading mappings using `upsert-prune-scope`. Each entry describes the readings that would be deleted at runtime for a meter (+ counter) because they were not part of this payload.",
+            "items": {
+              "$ref": "#/components/schemas/MeterReadingPruneScopeUpdate"
+            }
+          },
           "warnings": {
             "type": "array",
             "description": "Validation warnings about the configuration (e.g., unique_ids referencing non-indexed fields)",
@@ -7968,7 +7982,8 @@
         "required": [
           "entity_slug",
           "unique_identifiers",
-          "attributes"
+          "attributes",
+          "mode"
         ],
         "properties": {
           "entity_slug": {
@@ -7984,6 +7999,38 @@
             "type": "object",
             "description": "Mapped attribute values",
             "additionalProperties": true
+          },
+          "pricing": {
+            "type": "object",
+            "description": "Present when the entity mapping has a `pricing` block. Echoes the pricing configuration and the data extracted for it, so mapping authors can see what would be sent to the pricing service.",
+            "required": [
+              "config",
+              "data"
+            ],
+            "properties": {
+              "config": {
+                "type": "object",
+                "additionalProperties": true,
+                "description": "The pricing configuration from the entity mapping"
+              },
+              "data": {
+                "type": "array",
+                "description": "The pricing input data extracted from the payload",
+                "items": {
+                  "type": "object",
+                  "additionalProperties": true
+                }
+              }
+            }
+          },
+          "mode": {
+            "type": "string",
+            "enum": [
+              "upsert",
+              "delete",
+              "purge"
+            ],
+            "description": "Effective operation mode applied to this entity at runtime. `upsert-prune-scope-purge` / `upsert-prune-scope-delete` configurations report `upsert` here, because the individual entities in the payload are upserted — the destructive part of those modes is reported separately in `prune_scope_updates`. For `delete` / `purge`, `attributes` are still mapped and returned but ignored at runtime: only `unique_identifiers` are used to locate the entity to remove."
           }
         }
       },
@@ -7991,7 +8038,8 @@
         "type": "object",
         "required": [
           "meter",
-          "attributes"
+          "attributes",
+          "mode"
         ],
         "properties": {
           "meter": {
@@ -8021,6 +8069,121 @@
             "type": "object",
             "additionalProperties": true,
             "description": "Meter reading attributes. Required: external_id, timestamp, source, value. `timestamp` must be ISO 8601 — either `YYYY-MM-DD` or `YYYY-MM-DDTHH:mm:ss` (with optional fractional seconds and optional `Z` / `±HH:mm` timezone offset); non-ISO formats (e.g. `DD.MM.YYYY` or epoch numbers) are rejected and must be converted upstream via a `jsonataExpression` (e.g. `$fromMillis(...)`). Date-only values are normalized to midnight UTC and offset-less date-times are anchored to UTC before being forwarded to the metering API. `source` must be one of: ECP, ERP, 360, journey-submission. `reason` (optional) must be one of: regular, irregular, last, first, meter_change, contract_change, meter_adjustment (or empty/null)."
+          },
+          "mode": {
+            "type": "string",
+            "enum": [
+              "upsert",
+              "delete"
+            ],
+            "description": "Effective operation mode applied to this reading at runtime. `upsert-prune-scope` configurations report `upsert` here — their destructive part is reported separately in `meter_readings_prune_scope_updates`."
+          }
+        }
+      },
+      "EntityPruneScopeUpdate": {
+        "type": "object",
+        "description": "A resolved entity prune scope. At runtime, entities of `entity_slug` found within `scope` whose unique identifiers are not listed in `keep_unique_ids` are removed using `deletion_mode`.",
+        "required": [
+          "entity_slug",
+          "scope",
+          "keep_unique_ids",
+          "deletion_mode"
+        ],
+        "properties": {
+          "entity_slug": {
+            "type": "string",
+            "description": "The entity type that would be pruned"
+          },
+          "scope": {
+            "type": "object",
+            "description": "The scope configuration resolved against the payload",
+            "required": [
+              "scope_mode"
+            ],
+            "properties": {
+              "scope_mode": {
+                "type": "string",
+                "enum": [
+                  "relations",
+                  "query"
+                ],
+                "description": "How the entities in scope are found"
+              },
+              "schema": {
+                "type": "string",
+                "description": "Schema of the related entity defining the scope (`relations` scope_mode only)"
+              },
+              "unique_ids": {
+                "type": "object",
+                "additionalProperties": true,
+                "description": "Resolved unique identifiers of the related scope entity (`relations` scope_mode only)"
+              },
+              "query": {
+                "type": "object",
+                "additionalProperties": true,
+                "description": "Resolved query parameters used to find entities in scope (`query` scope_mode only)"
+              }
+            }
+          },
+          "keep_unique_ids": {
+            "type": "array",
+            "description": "Unique identifiers of the entities upserted by this payload. Everything else found in scope would be deleted.",
+            "items": {
+              "type": "object",
+              "additionalProperties": true
+            }
+          },
+          "deletion_mode": {
+            "type": "string",
+            "enum": [
+              "delete",
+              "purge"
+            ],
+            "description": "`delete` soft deletes the pruned entities, `purge` removes them permanently"
+          }
+        }
+      },
+      "MeterReadingPruneScopeUpdate": {
+        "type": "object",
+        "description": "A resolved meter reading prune scope. At runtime, readings of the given meter (+ counter) whose external ids are not listed in `keep_external_ids` are deleted.",
+        "required": [
+          "meter",
+          "keep_external_ids"
+        ],
+        "properties": {
+          "meter": {
+            "type": "object",
+            "required": [
+              "$entity_unique_ids"
+            ],
+            "properties": {
+              "$entity_unique_ids": {
+                "type": "object",
+                "additionalProperties": true,
+                "description": "Unique identifiers for the meter"
+              }
+            }
+          },
+          "meter_counter": {
+            "type": "object",
+            "properties": {
+              "$entity_unique_ids": {
+                "type": "object",
+                "additionalProperties": true,
+                "description": "Unique identifiers for the meter counter"
+              }
+            }
+          },
+          "keep_external_ids": {
+            "type": "array",
+            "description": "External ids of the readings present in this payload. All other readings in scope would be deleted. An empty array means every reading in scope would be deleted.",
+            "items": {
+              "type": "string"
+            }
+          },
+          "source": {
+            "type": "string",
+            "description": "When set, only readings with this source are eligible for pruning (e.g. `ERP`)"
           }
         }
       },

package/dist/bin/epilot.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   API_LIST
-} from "../chunk-A4U3GMLI.js";
+} from "../chunk-6BGA56QC.js";
 
 // bin/epilot.ts
 import { runMain } from "citty";
@@ -11,7 +11,7 @@ import { defineCommand } from "citty";
 var main = defineCommand({
   meta: {
     name: "epilot",
-    version: "0.1.96",
+    version: "0.1.97",
     description: "CLI for epilot APIs"
   },
   args: {
@@ -30,8 +30,8 @@ var main = defineCommand({
     auth: () => import("../auth-WMXFMPWE.js").then((m) => m.default),
     profile: () => import("../profile-OZJL5ZPT.js").then((m) => m.default),
     config: () => import("../config-DGZIMLZK.js").then((m) => m.default),
-    completion: () => import("../completion-YMYZM32H.js").then((m) => m.default),
-    upgrade: () => import("../upgrade-VVU7H3SR.js").then((m) => m.default),
+    completion: () => import("../completion-6JGII43G.js").then((m) => m.default),
+    upgrade: () => import("../upgrade-3IF3ARUQ.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,13 +134,13 @@ process.stderr.on("error", (err) => {
   if (err.code === "EPIPE") process.exit(0);
   throw err;
 });
-var VERSION = true ? "0.1.96" : (await null).default.version;
+var VERSION = true ? "0.1.97" : (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);
 var completionsIdx = args.indexOf("--_completions");
 if (completionsIdx >= 0) {
-  const { handleCompletions } = await import("../completion-YMYZM32H.js");
+  const { handleCompletions } = await import("../completion-6JGII43G.js");
   handleCompletions(args[completionsIdx + 1], args[completionsIdx + 2]);
   process.exit(0);
 }

package/dist/{chunk-A4U3GMLI.js → chunk-6BGA56QC.js}

@@ -538,13 +538,14 @@ var API_LIST = [
     kebabName: "design",
     title: "Design Builder API v2",
     serverUrl: "https://design-builder-api.sls.epilot.io",
-    operationCount: 13,
+    operationCount: 14,
     operationIds: [
       "getAllDesigns",
       "addDesign",
       "getDesign",
       "updateDesign",
       "deleteDesign",
+      "duplicateDesign",
       "getThemeFromDesign",
       "getFiles",
       "uploadFile",

package/dist/{completion-YMYZM32H.js → completion-6JGII43G.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   API_LIST
-} from "./chunk-A4U3GMLI.js";
+} from "./chunk-6BGA56QC.js";
 import {
   DIM,
   GREEN,

package/dist/{upgrade-VVU7H3SR.js → upgrade-3IF3ARUQ.js}

@@ -72,7 +72,7 @@ ${GREEN}${BOLD}Upgraded to @epilot/cli@${latest}${RESET}
   }
 });
 var getCurrentVersion = () => {
-  if (true) return "0.1.96";
+  if (true) return "0.1.97";
   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.96",
+  "version": "0.1.97",
   "description": "CLI for epilot APIs",
   "type": "module",
   "bin": {