@epilot/sdk 2.11.4 → 2.11.5

package/dist/{snapshot-runtime-6DV42FVY.cjs → snapshot-runtime-AQJSSXRV.cjs}

@@ -1,5 +1,5 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkYXJ4PBFQcjs = require('./chunk-YXJ4PBFQ.cjs');
+var _chunkVDMPIKANcjs = require('./chunk-VDMPIKAN.cjs');
 require('./chunk-NJK5F5TF.cjs');
-exports. default = _chunkYXJ4PBFQcjs.require_snapshot_runtime.call(void 0, );
+exports. default = _chunkVDMPIKANcjs.require_snapshot_runtime.call(void 0, );

package/dist/{snapshot-runtime-IW57MINC.js → snapshot-runtime-AY7YYSFQ.js}

@@ -1,5 +1,5 @@
 import {
   require_snapshot_runtime
-} from "./chunk-54QNWEPZ.js";
+} from "./chunk-UXY7SWNP.js";
 import "./chunk-YPSWSI3M.js";
 export default require_snapshot_runtime();

package/dist/{snapshot.d-CqefmvuB.d.cts → snapshot.d-DT0zg2CS.d.cts}

@@ -8,13 +8,6 @@ declare namespace Components {
         export type BadRequest = Schemas.Error;
         export type NotFound = Schemas.Error;
         export type Unauthorized = Schemas.Error;
-        export type UnprocessableEntity = /**
-         * Returned (422) when the org inventory contains no capturable resources
-         * after filtering out sensitive, unsupported, and excluded types. The
-         * `skipped_types` array explains why every type was dropped.
-         *
-         */
-        Schemas.EmptyInventoryError;
     }
     namespace Schemas {
         export interface CallerIdentity {
@@ -83,23 +76,6 @@ declare namespace Components {
             status: "creating";
             created_at: string; // date-time
         }
-        /**
-         * Returned (422) when the org inventory contains no capturable resources
-         * after filtering out sensitive, unsupported, and excluded types. The
-         * `skipped_types` array explains why every type was dropped.
-         *
-         */
-        export interface EmptyInventoryError {
-            /**
-             * example:
-             * No capturable resources in the org inventory
-             */
-            message: string;
-            skipped_types: {
-                type: string;
-                reason: string;
-            }[];
-        }
         export interface Error {
             status: number;
             error: string;
@@ -118,6 +94,89 @@ declare namespace Components {
             error?: string;
             triggered_by: CallerIdentity;
         }
+        /**
+         * Enrollment record for a scheduled org snapshot. One row per org.
+         * This table — not EventBridge — is the source of truth; the EventBridge
+         * schedule entry is the materialization of this row (reconciled on write
+         * by Task 6).
+         *
+         */
+        export interface OrgSnapshotSchedule {
+            org_id: string;
+            enabled: boolean;
+            /**
+             * Validated 6-field EventBridge cron. Default `cron(0 2 * * ? *)`.
+             * example:
+             * cron(0 2 * * ? *)
+             */
+            cron_expression: string;
+            /**
+             * IANA timezone. Default `Europe/Berlin`.
+             */
+            timezone: string;
+            retention: /**
+             * Flat retention window for a scheduled snapshot.
+             * Converted to a `ttl` epoch at capture time. Capped at ~24 months.
+             *
+             */
+            RetentionConfig;
+            excluded_types?: string[];
+            /**
+             * Name of the EventBridge Scheduler entry this row owns.
+             * Set at enrollment time as `org-snapshot-{orgId}`.
+             *
+             */
+            schedule_name: string;
+            last_started_at?: string; // date-time
+            last_completed_at?: string; // date-time
+            last_status?: "completed" | "partial" | "failed";
+            created_by: string;
+            created_at: string; // date-time
+            updated_at: string; // date-time
+        }
+        /**
+         * Body for `putOrgSnapshotSchedule`. All fields optional; unset fields
+         * receive defaults on first create and are left unchanged on updates
+         * (except `updated_at`).
+         *
+         */
+        export interface PutOrgSnapshotScheduleRequest {
+            /**
+             * Whether the schedule is active.
+             */
+            enabled?: boolean;
+            /**
+             * 6-field EventBridge cron expression, e.g. `cron(0 2 * * ? *)`.
+             * Validated server-side: minute + hour must be concrete single integers
+             * (no `*`, lists, ranges, or steps) to cap cadence at ≤ once/day.
+             * Exactly one of day-of-month / day-of-week must be `?`.
+             *
+             * example:
+             * cron(0 2 * * ? *)
+             */
+            cron_expression?: string;
+            /**
+             * IANA timezone string passed to EventBridge `ScheduleExpressionTimezone`,
+             * e.g. `Europe/Berlin`. AWS handles DST natively.
+             *
+             * example:
+             * Europe/Berlin
+             */
+            timezone?: string;
+            retention?: /**
+             * Flat retention window for a scheduled snapshot.
+             * Converted to a `ttl` epoch at capture time. Capped at ~24 months.
+             *
+             */
+            RetentionConfig;
+            /**
+             * Resource types to exclude from the scheduled capture, in addition
+             * to the always-excluded sensitive types (`access_token`,
+             * `environment_variable`).
+             *
+             */
+            excluded_types?: string[];
+        }
         export interface ResourceRef {
             /**
              * Resource type (e.g., custom_variable, journey, automation_flow)
@@ -146,6 +205,18 @@ declare namespace Components {
             id: string;
             status: "restoring";
         }
+        /**
+         * Flat retention window for a scheduled snapshot.
+         * Converted to a `ttl` epoch at capture time. Capped at ~24 months.
+         *
+         */
+        export interface RetentionConfig {
+            /**
+             * Numeric quantity of retention (e.g. 90 for "90 days").
+             */
+            value: number;
+            unit: "days" | "weeks" | "months";
+        }
         export interface Snapshot {
             id: string;
             org_id: string;
@@ -284,7 +355,6 @@ declare namespace Paths {
         namespace Responses {
             export type $202 = Components.Schemas.CreateSnapshotResponse;
             export type $401 = Components.Responses.Unauthorized;
-            export type $422 = Components.Responses.UnprocessableEntity;
         }
     }
     namespace CreateSnapshot {
@@ -295,6 +365,14 @@ declare namespace Paths {
             export type $401 = Components.Responses.Unauthorized;
         }
     }
+    namespace DeleteOrgSnapshotSchedule {
+        namespace Responses {
+            export interface $204 {
+            }
+            export type $401 = Components.Responses.Unauthorized;
+            export type $404 = Components.Responses.NotFound;
+        }
+    }
     namespace DeleteSnapshot {
         namespace Responses {
             export interface $204 {
@@ -303,6 +381,20 @@ declare namespace Paths {
             export type $404 = Components.Responses.NotFound;
         }
     }
+    namespace GetOrgSnapshotSchedule {
+        namespace Responses {
+            export type $200 = /**
+             * Enrollment record for a scheduled org snapshot. One row per org.
+             * This table — not EventBridge — is the source of truth; the EventBridge
+             * schedule entry is the materialization of this row (reconciled on write
+             * by Task 6).
+             *
+             */
+            Components.Schemas.OrgSnapshotSchedule;
+            export type $401 = Components.Responses.Unauthorized;
+            export type $404 = Components.Responses.NotFound;
+        }
+    }
     namespace GetSnapshot {
         namespace Responses {
             export type $200 = Components.Schemas.Snapshot;
@@ -370,6 +462,27 @@ declare namespace Paths {
             export type $401 = Components.Responses.Unauthorized;
         }
     }
+    namespace PutOrgSnapshotSchedule {
+        export type RequestBody = /**
+         * Body for `putOrgSnapshotSchedule`. All fields optional; unset fields
+         * receive defaults on first create and are left unchanged on updates
+         * (except `updated_at`).
+         *
+         */
+        Components.Schemas.PutOrgSnapshotScheduleRequest;
+        namespace Responses {
+            export type $200 = /**
+             * Enrollment record for a scheduled org snapshot. One row per org.
+             * This table — not EventBridge — is the source of truth; the EventBridge
+             * schedule entry is the materialization of this row (reconciled on write
+             * by Task 6).
+             *
+             */
+            Components.Schemas.OrgSnapshotSchedule;
+            export type $400 = Components.Responses.BadRequest;
+            export type $401 = Components.Responses.Unauthorized;
+        }
+    }
     namespace RestoreSnapshot {
         export type RequestBody = /**
          * Apply a captured snapshot to its source org. snapshot-api applies the
@@ -457,12 +570,14 @@ interface OperationMethods {
   /**
    * captureOrgSnapshot - captureOrgSnapshot
    * 
-   * Snapshot the caller's whole organization now. Fetches a fresh inventory
-   * of the org's configuration resources from configuration-hub-api, persists
-   * it as an inventory artifact, and starts a `scope: "org"` chunked capture.
-   * Async — returns immediately with a snapshot ID; client polls `getSnapshot`
-   * and watches `capture_summary` fill in until `create.status` moves from
-   * `in_progress` to `completed` or `failed`.
+   * Snapshot the caller's whole organization now. Creates a `scope: "org"`
+   * snapshot row and starts a chunked capture Step Function, then returns
+   * immediately. The capture asynchronously fetches a fresh inventory of the
+   * org's configuration resources from configuration-hub-api, persists it as
+   * an inventory artifact, and captures each resource. Client polls
+   * `getSnapshot` and watches `capture_summary` fill in until `create.status`
+   * moves from `in_progress` to `completed` or `failed`. An org with no
+   * capturable resources finalizes as a completed 0-resource snapshot.
    * 
    * Sensitive types (`access_token`, `environment_variable`), types with no
    * engine adapter, and any `excluded_types` are dropped from the capture and
@@ -539,6 +654,55 @@ interface OperationMethods {
     data?: any,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetSnapshotResource.Responses.$200>
+  /**
+   * getOrgSnapshotSchedule - getOrgSnapshotSchedule
+   * 
+   * Return the scheduled-snapshot enrollment config for the caller's org.
+   * Returns 404 when the org has not yet enrolled.
+   * 
+   */
+  'getOrgSnapshotSchedule'(
+    parameters?: Parameters<UnknownParamsObject> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetOrgSnapshotSchedule.Responses.$200>
+  /**
+   * putOrgSnapshotSchedule - putOrgSnapshotSchedule
+   * 
+   * Create or update the scheduled-snapshot enrollment config for the
+   * caller's org (upsert). The cron expression and retention window are
+   * validated server-side; invalid values are rejected with 400.
+   * 
+   * Defaults applied when a field is omitted on first create:
+   *   - `cron_expression`: `cron(0 2 * * ? *)` (daily at 02:00)
+   *   - `timezone`: `Europe/Berlin`
+   *   - `retention`: `{ value: 90, unit: "days" }`
+   *   - `enabled`: `true`
+   * 
+   * **Note:** this call persists the row only. EventBridge schedule
+   * materialization is performed by a subsequent reconcile step (Task 6).
+   * The row is the authoritative source of truth for the UI.
+   * 
+   */
+  'putOrgSnapshotSchedule'(
+    parameters?: Parameters<UnknownParamsObject> | null,
+    data?: Paths.PutOrgSnapshotSchedule.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.PutOrgSnapshotSchedule.Responses.$200>
+  /**
+   * deleteOrgSnapshotSchedule - deleteOrgSnapshotSchedule
+   * 
+   * Remove the scheduled-snapshot enrollment for the caller's org.
+   * Returns 404 when no schedule exists.
+   * The corresponding EventBridge schedule is removed by a reconcile
+   * step (Task 6).
+   * 
+   */
+  'deleteOrgSnapshotSchedule'(
+    parameters?: Parameters<UnknownParamsObject> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.DeleteOrgSnapshotSchedule.Responses.$204>
   /**
    * listDependencies - listDependencies
    * 
@@ -593,12 +757,14 @@ interface PathsDictionary {
     /**
      * captureOrgSnapshot - captureOrgSnapshot
      * 
-     * Snapshot the caller's whole organization now. Fetches a fresh inventory
-     * of the org's configuration resources from configuration-hub-api, persists
-     * it as an inventory artifact, and starts a `scope: "org"` chunked capture.
-     * Async — returns immediately with a snapshot ID; client polls `getSnapshot`
-     * and watches `capture_summary` fill in until `create.status` moves from
-     * `in_progress` to `completed` or `failed`.
+     * Snapshot the caller's whole organization now. Creates a `scope: "org"`
+     * snapshot row and starts a chunked capture Step Function, then returns
+     * immediately. The capture asynchronously fetches a fresh inventory of the
+     * org's configuration resources from configuration-hub-api, persists it as
+     * an inventory artifact, and captures each resource. Client polls
+     * `getSnapshot` and watches `capture_summary` fill in until `create.status`
+     * moves from `in_progress` to `completed` or `failed`. An org with no
+     * capturable resources finalizes as a completed 0-resource snapshot.
      * 
      * Sensitive types (`access_token`, `environment_variable`), types with no
      * engine adapter, and any `excluded_types` are dropped from the capture and
@@ -684,6 +850,57 @@ interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.GetSnapshotResource.Responses.$200>
   }
+  ['/v1/org-snapshot-schedule']: {
+    /**
+     * getOrgSnapshotSchedule - getOrgSnapshotSchedule
+     * 
+     * Return the scheduled-snapshot enrollment config for the caller's org.
+     * Returns 404 when the org has not yet enrolled.
+     * 
+     */
+    'get'(
+      parameters?: Parameters<UnknownParamsObject> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GetOrgSnapshotSchedule.Responses.$200>
+    /**
+     * putOrgSnapshotSchedule - putOrgSnapshotSchedule
+     * 
+     * Create or update the scheduled-snapshot enrollment config for the
+     * caller's org (upsert). The cron expression and retention window are
+     * validated server-side; invalid values are rejected with 400.
+     * 
+     * Defaults applied when a field is omitted on first create:
+     *   - `cron_expression`: `cron(0 2 * * ? *)` (daily at 02:00)
+     *   - `timezone`: `Europe/Berlin`
+     *   - `retention`: `{ value: 90, unit: "days" }`
+     *   - `enabled`: `true`
+     * 
+     * **Note:** this call persists the row only. EventBridge schedule
+     * materialization is performed by a subsequent reconcile step (Task 6).
+     * The row is the authoritative source of truth for the UI.
+     * 
+     */
+    'put'(
+      parameters?: Parameters<UnknownParamsObject> | null,
+      data?: Paths.PutOrgSnapshotSchedule.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.PutOrgSnapshotSchedule.Responses.$200>
+    /**
+     * deleteOrgSnapshotSchedule - deleteOrgSnapshotSchedule
+     * 
+     * Remove the scheduled-snapshot enrollment for the caller's org.
+     * Returns 404 when no schedule exists.
+     * The corresponding EventBridge schedule is removed by a reconcile
+     * step (Task 6).
+     * 
+     */
+    'delete'(
+      parameters?: Parameters<UnknownParamsObject> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.DeleteOrgSnapshotSchedule.Responses.$204>
+  }
   ['/v1/snapshots:list-dependencies']: {
     /**
      * listDependencies - listDependencies
@@ -710,15 +927,17 @@ type CallerIdentity = Components.Schemas.CallerIdentity;
 type CreateOrgSnapshotRequest = Components.Schemas.CreateOrgSnapshotRequest;
 type CreateSnapshotRequest = Components.Schemas.CreateSnapshotRequest;
 type CreateSnapshotResponse = Components.Schemas.CreateSnapshotResponse;
-type EmptyInventoryError = Components.Schemas.EmptyInventoryError;
 type Error = Components.Schemas.Error;
 type Operation = Components.Schemas.Operation;
+type OrgSnapshotSchedule = Components.Schemas.OrgSnapshotSchedule;
+type PutOrgSnapshotScheduleRequest = Components.Schemas.PutOrgSnapshotScheduleRequest;
 type ResourceRef = Components.Schemas.ResourceRef;
 type RestoreSnapshotRequest = Components.Schemas.RestoreSnapshotRequest;
 type RestoreSnapshotResponse = Components.Schemas.RestoreSnapshotResponse;
+type RetentionConfig = Components.Schemas.RetentionConfig;
 type Snapshot = Components.Schemas.Snapshot;
 type SnapshotResourceDetail = Components.Schemas.SnapshotResourceDetail;
 type SnapshotResourceList = Components.Schemas.SnapshotResourceList;
 type SnapshotResourceSummary = Components.Schemas.SnapshotResourceSummary;
 
-export { type Client as C, type EmptyInventoryError as E, type OperationMethods as O, Paths as P, type ResourceRef as R, type Snapshot as S, Components as a, type PathsDictionary as b, type CallerIdentity as c, type CreateOrgSnapshotRequest as d, type CreateSnapshotRequest as e, type CreateSnapshotResponse as f, type Error as g, type Operation as h, type RestoreSnapshotRequest as i, type RestoreSnapshotResponse as j, type SnapshotResourceDetail as k, type SnapshotResourceList as l, type SnapshotResourceSummary as m };
+export { type Client as C, type Error as E, type OperationMethods as O, Paths as P, type ResourceRef as R, type Snapshot as S, Components as a, type PathsDictionary as b, type CallerIdentity as c, type CreateOrgSnapshotRequest as d, type CreateSnapshotRequest as e, type CreateSnapshotResponse as f, type Operation as g, type OrgSnapshotSchedule as h, type PutOrgSnapshotScheduleRequest as i, type RestoreSnapshotRequest as j, type RestoreSnapshotResponse as k, type RetentionConfig as l, type SnapshotResourceDetail as m, type SnapshotResourceList as n, type SnapshotResourceSummary as o };