@epilot/cli 0.1.64 → 0.1.66

package/README.md

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

package/definitions/customer-portal.json

@@ -480,6 +480,142 @@
         }
       }
     },
+    "/v1/portal/exports": {
+      "post": {
+        "operationId": "createExport",
+        "summary": "createExport",
+        "description": "Request an asynchronous CSV export of the portal user's contracts, delivery points and meters. Returns a job id to poll.",
+        "tags": [
+          "ECP"
+        ],
+        "parameters": [
+          {
+            "in": "query",
+            "name": "language",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "enum": [
+                "de",
+                "en"
+              ]
+            },
+            "description": "Output language for headers and value formatting. Defaults to German when omitted or unsupported."
+          }
+        ],
+        "security": [
+          {
+            "PortalAuth": []
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "Export job accepted.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "jobId": {
+                      "type": "string"
+                    },
+                    "status": {
+                      "type": "string",
+                      "enum": [
+                        "queued",
+                        "running",
+                        "ready",
+                        "failed"
+                      ]
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "description": "No export profile configured for this organization."
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        }
+      }
+    },
+    "/v1/portal/exports/{jobId}": {
+      "get": {
+        "operationId": "getExport",
+        "summary": "getExport",
+        "description": "Get the status of an export job, including the download URL once ready.",
+        "tags": [
+          "ECP"
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "jobId",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "The export job id returned by createExport."
+          }
+        ],
+        "security": [
+          {
+            "PortalAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Export job status.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "jobId": {
+                      "type": "string"
+                    },
+                    "status": {
+                      "type": "string",
+                      "enum": [
+                        "queued",
+                        "running",
+                        "ready",
+                        "failed",
+                        "expired"
+                      ]
+                    },
+                    "downloadUrl": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "404": {
+            "description": "Export job not found."
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        }
+      }
+    },
     "/v2/portal/extensions": {
       "get": {
         "operationId": "getPortalExtensions",
@@ -2929,6 +3065,10 @@
                         },
                         "is_main_entity": {
                           "type": "boolean"
+                        },
+                        "journey_registration_email": {
+                          "type": "string",
+                          "description": "The email address registered in the journey's Login & Registration block"
                         }
                       }
                     }
@@ -11624,6 +11764,10 @@
       "CommonConfigAttributes": {
         "type": "object",
         "properties": {
+          "mobile_config": {
+            "description": "Mobile app configuration (top-level; moved out of the config blob).",
+            "$ref": "#/components/schemas/MobileConfig"
+          },
           "enabled": {
             "type": "boolean",
             "description": "Enable/Disable the portal access"
@@ -17814,6 +17958,10 @@
       "CommonConfigAttributesV3": {
         "type": "object",
         "properties": {
+          "mobile_config": {
+            "description": "Mobile app configuration (top-level; moved out of the config blob).",
+            "$ref": "#/components/schemas/MobileConfig"
+          },
           "enabled": {
             "type": "boolean",
             "description": "Enable/Disable the portal access"

package/definitions/snapshot.json

@@ -27,6 +27,10 @@
     {
       "name": "Snapshots",
       "description": "Snapshot CRUD and restore operations"
+    },
+    {
+      "name": "ScheduledSnapshots",
+      "description": "Enrollment and configuration for scheduled org snapshots"
     }
   ],
   "paths": {
@@ -160,7 +164,7 @@
       "post": {
         "operationId": "captureOrgSnapshot",
         "summary": "captureOrgSnapshot",
-        "description": "Snapshot the caller's whole organization now. Fetches a fresh inventory\nof the org's configuration resources from configuration-hub-api, persists\nit as an inventory artifact, and starts a `scope: \"org\"` chunked capture.\nAsync — returns immediately with a snapshot ID; client polls `getSnapshot`\nand watches `capture_summary` fill in until `create.status` moves from\n`in_progress` to `completed` or `failed`.\n\nSensitive types (`access_token`, `environment_variable`), types with no\nengine adapter, and any `excluded_types` are dropped from the capture and\nrecorded in the snapshot's coverage report.\n",
+        "description": "Snapshot the caller's whole organization now. Creates a `scope: \"org\"`\nsnapshot row and starts a chunked capture Step Function, then returns\nimmediately. The capture asynchronously fetches a fresh inventory of the\norg's configuration resources from configuration-hub-api, persists it as\nan inventory artifact, and captures each resource. Client polls\n`getSnapshot` and watches `capture_summary` fill in until `create.status`\nmoves from `in_progress` to `completed` or `failed`. An org with no\ncapturable resources finalizes as a completed 0-resource snapshot.\n\nSensitive types (`access_token`, `environment_variable`), types with no\nengine adapter, and any `excluded_types` are dropped from the capture and\nrecorded in the snapshot's coverage report.\n",
         "tags": [
           "Snapshots"
         ],
@@ -187,9 +191,6 @@
           },
           "401": {
             "$ref": "#/components/responses/Unauthorized"
-          },
-          "422": {
-            "$ref": "#/components/responses/UnprocessableEntity"
           }
         }
       }
@@ -383,6 +384,89 @@
         }
       }
     },
+    "/v1/org-snapshot-schedule": {
+      "get": {
+        "operationId": "getOrgSnapshotSchedule",
+        "summary": "getOrgSnapshotSchedule",
+        "description": "Return the scheduled-snapshot enrollment config for the caller's org.\nReturns 404 when the org has not yet enrolled.\n",
+        "tags": [
+          "ScheduledSnapshots"
+        ],
+        "responses": {
+          "200": {
+            "description": "Org snapshot schedule config",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/OrgSnapshotSchedule"
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          }
+        }
+      },
+      "put": {
+        "operationId": "putOrgSnapshotSchedule",
+        "summary": "putOrgSnapshotSchedule",
+        "description": "Create or update the scheduled-snapshot enrollment config for the\ncaller's org (upsert). The cron expression and retention window are\nvalidated server-side; invalid values are rejected with 400.\n\nDefaults applied when a field is omitted on first create:\n  - `cron_expression`: `cron(0 2 * * ? *)` (daily at 02:00)\n  - `timezone`: `Europe/Berlin`\n  - `retention`: `{ value: 90, unit: \"days\" }`\n  - `enabled`: `true`\n\n**Note:** this call persists the row only. EventBridge schedule\nmaterialization is performed by a subsequent reconcile step (Task 6).\nThe row is the authoritative source of truth for the UI.\n",
+        "tags": [
+          "ScheduledSnapshots"
+        ],
+        "requestBody": {
+          "required": false,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PutOrgSnapshotScheduleRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Stored config (after upsert)",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/OrgSnapshotSchedule"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          }
+        }
+      },
+      "delete": {
+        "operationId": "deleteOrgSnapshotSchedule",
+        "summary": "deleteOrgSnapshotSchedule",
+        "description": "Remove the scheduled-snapshot enrollment for the caller's org.\nReturns 404 when no schedule exists.\nThe corresponding EventBridge schedule is removed by a reconcile\nstep (Task 6).\n",
+        "tags": [
+          "ScheduledSnapshots"
+        ],
+        "responses": {
+          "204": {
+            "description": "Deleted"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          }
+        }
+      }
+    },
     "/v1/snapshots:list-dependencies": {
       "post": {
         "operationId": "listDependencies",
@@ -489,16 +573,6 @@
             }
           }
         }
-      },
-      "UnprocessableEntity": {
-        "description": "Unprocessable entity",
-        "content": {
-          "application/json": {
-            "schema": {
-              "$ref": "#/components/schemas/EmptyInventoryError"
-            }
-          }
-        }
       }
     },
     "schemas": {
@@ -517,38 +591,6 @@
           }
         }
       },
-      "EmptyInventoryError": {
-        "type": "object",
-        "required": [
-          "message",
-          "skipped_types"
-        ],
-        "description": "Returned (422) when the org inventory contains no capturable resources\nafter filtering out sensitive, unsupported, and excluded types. The\n`skipped_types` array explains why every type was dropped.\n",
-        "properties": {
-          "message": {
-            "type": "string",
-            "example": "No capturable resources in the org inventory"
-          },
-          "skipped_types": {
-            "type": "array",
-            "items": {
-              "type": "object",
-              "required": [
-                "type",
-                "reason"
-              ],
-              "properties": {
-                "type": {
-                  "type": "string"
-                },
-                "reason": {
-                  "type": "string"
-                }
-              }
-            }
-          }
-        }
-      },
       "ResourceRef": {
         "type": "object",
         "required": [
@@ -929,6 +971,132 @@
             "type": "string"
           }
         }
+      },
+      "RetentionConfig": {
+        "type": "object",
+        "required": [
+          "value",
+          "unit"
+        ],
+        "description": "Flat retention window for a scheduled snapshot.\nConverted to a `ttl` epoch at capture time. Capped at ~24 months.\n",
+        "properties": {
+          "value": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Numeric quantity of retention (e.g. 90 for \"90 days\")."
+          },
+          "unit": {
+            "type": "string",
+            "enum": [
+              "days",
+              "weeks",
+              "months"
+            ]
+          }
+        }
+      },
+      "PutOrgSnapshotScheduleRequest": {
+        "type": "object",
+        "description": "Body for `putOrgSnapshotSchedule`. All fields optional; unset fields\nreceive defaults on first create and are left unchanged on updates\n(except `updated_at`).\n",
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "default": true,
+            "description": "Whether the schedule is active."
+          },
+          "cron_expression": {
+            "type": "string",
+            "description": "6-field EventBridge cron expression, e.g. `cron(0 2 * * ? *)`.\nValidated server-side: minute + hour must be concrete single integers\n(no `*`, lists, ranges, or steps) to cap cadence at ≤ once/day.\nExactly one of day-of-month / day-of-week must be `?`.\n",
+            "example": "cron(0 2 * * ? *)"
+          },
+          "timezone": {
+            "type": "string",
+            "description": "IANA timezone string passed to EventBridge `ScheduleExpressionTimezone`,\ne.g. `Europe/Berlin`. AWS handles DST natively.\n",
+            "example": "Europe/Berlin"
+          },
+          "retention": {
+            "$ref": "#/components/schemas/RetentionConfig"
+          },
+          "excluded_types": {
+            "type": "array",
+            "description": "Resource types to exclude from the scheduled capture, in addition\nto the always-excluded sensitive types (`access_token`,\n`environment_variable`).\n",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      },
+      "OrgSnapshotSchedule": {
+        "type": "object",
+        "required": [
+          "org_id",
+          "enabled",
+          "cron_expression",
+          "timezone",
+          "retention",
+          "schedule_name",
+          "created_by",
+          "created_at",
+          "updated_at"
+        ],
+        "description": "Enrollment record for a scheduled org snapshot. One row per org.\nThis table — not EventBridge — is the source of truth; the EventBridge\nschedule entry is the materialization of this row (reconciled on write\nby Task 6).\n",
+        "properties": {
+          "org_id": {
+            "type": "string"
+          },
+          "enabled": {
+            "type": "boolean"
+          },
+          "cron_expression": {
+            "type": "string",
+            "description": "Validated 6-field EventBridge cron. Default `cron(0 2 * * ? *)`.",
+            "example": "cron(0 2 * * ? *)"
+          },
+          "timezone": {
+            "type": "string",
+            "description": "IANA timezone. Default `Europe/Berlin`."
+          },
+          "retention": {
+            "$ref": "#/components/schemas/RetentionConfig"
+          },
+          "excluded_types": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "schedule_name": {
+            "type": "string",
+            "description": "Name of the EventBridge Scheduler entry this row owns.\nSet at enrollment time as `org-snapshot-{orgId}`.\n"
+          },
+          "last_started_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "last_completed_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "last_status": {
+            "type": "string",
+            "enum": [
+              "completed",
+              "partial",
+              "failed"
+            ]
+          },
+          "created_by": {
+            "type": "string"
+          },
+          "created_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "updated_at": {
+            "type": "string",
+            "format": "date-time"
+          }
+        }
       }
     }
   }

package/definitions/webhooks.json

@@ -1715,6 +1715,10 @@
             "type": "string",
             "description": "stringified payload of the webhook request"
           },
+          "original_payload": {
+            "type": "string",
+            "description": "Stringified pre-transform original payload — the raw input captured before any JSONata transform was applied. Returned by getEventById for non-catalog events that have a locally stored original source (inline or claim-checked to S3, hydrated here). Omitted when no original source exists or when the payload would exceed the inline response size limit. Catalog-backed events (event_-prefixed) do not carry a local original — their pre-transform payload is sourced from the event catalog instead."
+          },
           "retry_attempt": {
             "type": "integer",
             "description": "Number of automatic delivery retries that preceded this terminal outcome. 0 means the event was delivered (or finally failed) on the first attempt."

package/dist/bin/epilot.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   API_LIST
-} from "../chunk-36WJHV3M.js";
+} from "../chunk-BI57DDAE.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.64",
+    version: "0.1.66",
     description: "CLI for epilot APIs"
   },
   args: {
@@ -30,8 +30,8 @@ var main = defineCommand({
     auth: () => import("../auth-4HG7B2GC.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-H6LKKRG6.js").then((m) => m.default),
-    upgrade: () => import("../upgrade-ZXBNY2DJ.js").then((m) => m.default),
+    completion: () => import("../completion-3GW2YDYA.js").then((m) => m.default),
+    upgrade: () => import("../upgrade-XPAZQL23.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.64" : (await null).default.version;
+var VERSION = true ? "0.1.66" : (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-H6LKKRG6.js");
+  const { handleCompletions } = await import("../completion-3GW2YDYA.js");
   handleCompletions(args[completionsIdx + 1], args[completionsIdx + 2]);
   process.exit(0);
 }

package/dist/{chunk-36WJHV3M.js → chunk-BI57DDAE.js}

@@ -268,7 +268,7 @@ var API_LIST = [
     kebabName: "customer-portal",
     title: "Portal API",
     serverUrl: "https://customer-portal-api.sls.epilot.io",
-    operationCount: 156,
+    operationCount: 158,
     operationIds: [
       "upsertPortal",
       "createUser",
@@ -278,6 +278,8 @@ var API_LIST = [
       "getPortalConfigByDomain",
       "getPortalConfig",
       "deletePortal",
+      "createExport",
+      "getExport",
       "getPortalExtensions",
       "getPublicPortalExtensionDetails",
       "getPortalExtensionsV3",
@@ -1200,7 +1202,7 @@ var API_LIST = [
     kebabName: "snapshot",
     title: "Snapshot API",
     serverUrl: "https://snapshot.sls.epilot.io",
-    operationCount: 9,
+    operationCount: 12,
     operationIds: [
       "listSnapshots",
       "createSnapshot",
@@ -1210,6 +1212,9 @@ var API_LIST = [
       "restoreSnapshot",
       "listSnapshotResources",
       "getSnapshotResource",
+      "getOrgSnapshotSchedule",
+      "putOrgSnapshotSchedule",
+      "deleteOrgSnapshotSchedule",
       "listDependencies"
     ]
   },

package/dist/{completion-H6LKKRG6.js → completion-3GW2YDYA.js}

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

package/dist/{upgrade-ZXBNY2DJ.js → upgrade-XPAZQL23.js}

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