@epilot/sdk 2.8.3 → 2.8.4

package/dist/{snapshot.d-DvoJ2n-v.d.cts → snapshot.d-BX0xhQlH.d.cts}

@@ -56,9 +56,22 @@ declare namespace Components {
             type: "create" | "restore";
             started_at: string; // date-time
             completed_at?: string; // date-time
-            status: "in_progress" | "completed" | "failed";
+            /**
+             * `partial` indicates the operation completed but skipped at least
+             * one resource — see `skipped`. Only populated by restores triggered
+             * with `mode: 'preserve_edits'`.
+             *
+             */
+            status: "in_progress" | "completed" | "partial" | "failed";
             error?: string;
             triggered_by: CallerIdentity;
+            /**
+             * Per-resource skips, populated only for restores triggered with
+             * `mode: 'preserve_edits'`. Empty / absent for Config Hub's
+             * default overwrite-mode restores.
+             *
+             */
+            skipped?: SkippedResource[];
         }
         export interface ResourceRef {
             /**
@@ -67,10 +80,42 @@ declare namespace Components {
             type: string;
             id: string;
         }
+        export interface RestoreSnapshotRequest {
+            /**
+             * How to handle destination resources whose content has been modified
+             * since the snapshot was captured:
+             *
+             * - `overwrite` (default) — apply every captured payload regardless
+             *   of current destination state. Matches the manual-restore
+             *   semantics Config Hub relies on.
+             * - `preserve_edits` — for each captured resource, compare the live
+             *   destination payload's fingerprint against the install-time
+             *   fingerprint on lineage. If modified, skip and surface the
+             *   entry under `Operation.skipped`. Also skips co-owned resources
+             *   (lineage row carrying ≥2 distinct blueprint_instance_ids).
+             *   Used by blueprint-manifest-api when reverting a blueprint
+             *   install so user edits and other blueprints' contributions
+             *   survive.
+             *
+             */
+            mode?: "overwrite" | "preserve_edits";
+        }
         export interface RestoreSnapshotResponse {
             id: string;
             status: "restoring";
         }
+        export interface SkippedResource {
+            lineage_id: string;
+            /**
+             * - `modified` — current destination payload's fingerprint differs
+             *   from the install-time fingerprint on the lineage row.
+             * - `co_owned` — lineage row has ≥2 distinct
+             *   `blueprint_instance_ids`; restoring would unilaterally affect
+             *   another blueprint instance's contribution.
+             *
+             */
+            reason: "modified" | "co_owned";
+        }
         export interface Snapshot {
             id: string;
             org_id: string;
@@ -217,58 +262,7 @@ declare namespace Paths {
     namespace ListSnapshots {
         namespace Parameters {
             export type Cursor = string;
-            export type Resource = [
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?
-            ];
+            export type Resource = string /* ^[^:]+:.+$ */[];
             export type Size = number;
         }
         export interface QueryParameters {
@@ -292,6 +286,7 @@ declare namespace Paths {
         }
     }
     namespace RestoreSnapshot {
+        export type RequestBody = Components.Schemas.RestoreSnapshotRequest;
         namespace Responses {
             export type $202 = Components.Schemas.RestoreSnapshotResponse;
             export type $401 = Components.Responses.Unauthorized;
@@ -391,7 +386,7 @@ interface OperationMethods {
    * 
    * Restore a snapshot to the org. Async — returns immediately; client polls
    * `getSnapshot` until the latest entry in `restores` moves from
-   * `in_progress` to `completed` or `failed`.
+   * `in_progress` to one of `completed | partial | failed`.
    * 
    * v1: full restore only. Cherry-pick (`resources?` body filter) is an open
    * question — see RFC OQ #1.
@@ -399,7 +394,7 @@ interface OperationMethods {
    */
   'restoreSnapshot'(
     parameters?: Parameters<Paths.V1Snapshots$IdRestore.PathParameters> | null,
-    data?: any,
+    data?: Paths.RestoreSnapshot.RequestBody,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.RestoreSnapshot.Responses.$202>
   /**
@@ -509,7 +504,7 @@ interface PathsDictionary {
      * 
      * Restore a snapshot to the org. Async — returns immediately; client polls
      * `getSnapshot` until the latest entry in `restores` moves from
-     * `in_progress` to `completed` or `failed`.
+     * `in_progress` to one of `completed | partial | failed`.
      * 
      * v1: full restore only. Cherry-pick (`resources?` body filter) is an open
      * question — see RFC OQ #1.
@@ -517,7 +512,7 @@ interface PathsDictionary {
      */
     'post'(
       parameters?: Parameters<Paths.V1Snapshots$IdRestore.PathParameters> | null,
-      data?: any,
+      data?: Paths.RestoreSnapshot.RequestBody,
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.RestoreSnapshot.Responses.$202>
   }
@@ -582,10 +577,12 @@ type CreateSnapshotResponse = Components.Schemas.CreateSnapshotResponse;
 type Error = Components.Schemas.Error;
 type Operation = Components.Schemas.Operation;
 type ResourceRef = Components.Schemas.ResourceRef;
+type RestoreSnapshotRequest = Components.Schemas.RestoreSnapshotRequest;
 type RestoreSnapshotResponse = Components.Schemas.RestoreSnapshotResponse;
+type SkippedResource = Components.Schemas.SkippedResource;
 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 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 CreateSnapshotRequest as d, type CreateSnapshotResponse as e, type Operation as f, type RestoreSnapshotResponse as g, type SnapshotResourceDetail as h, type SnapshotResourceList as i, type SnapshotResourceSummary as j };
+export { type Client as C, type Error as E, type OperationMethods as O, Paths as P, type ResourceRef as R, type SkippedResource as S, Components as a, type PathsDictionary as b, type CallerIdentity as c, type CreateSnapshotRequest as d, type CreateSnapshotResponse as e, type Operation as f, type RestoreSnapshotRequest as g, type RestoreSnapshotResponse as h, type Snapshot as i, type SnapshotResourceDetail as j, type SnapshotResourceList as k, type SnapshotResourceSummary as l };

package/dist/{snapshot.d-DvoJ2n-v.d.ts → snapshot.d-BX0xhQlH.d.ts}

@@ -56,9 +56,22 @@ declare namespace Components {
             type: "create" | "restore";
             started_at: string; // date-time
             completed_at?: string; // date-time
-            status: "in_progress" | "completed" | "failed";
+            /**
+             * `partial` indicates the operation completed but skipped at least
+             * one resource — see `skipped`. Only populated by restores triggered
+             * with `mode: 'preserve_edits'`.
+             *
+             */
+            status: "in_progress" | "completed" | "partial" | "failed";
             error?: string;
             triggered_by: CallerIdentity;
+            /**
+             * Per-resource skips, populated only for restores triggered with
+             * `mode: 'preserve_edits'`. Empty / absent for Config Hub's
+             * default overwrite-mode restores.
+             *
+             */
+            skipped?: SkippedResource[];
         }
         export interface ResourceRef {
             /**
@@ -67,10 +80,42 @@ declare namespace Components {
             type: string;
             id: string;
         }
+        export interface RestoreSnapshotRequest {
+            /**
+             * How to handle destination resources whose content has been modified
+             * since the snapshot was captured:
+             *
+             * - `overwrite` (default) — apply every captured payload regardless
+             *   of current destination state. Matches the manual-restore
+             *   semantics Config Hub relies on.
+             * - `preserve_edits` — for each captured resource, compare the live
+             *   destination payload's fingerprint against the install-time
+             *   fingerprint on lineage. If modified, skip and surface the
+             *   entry under `Operation.skipped`. Also skips co-owned resources
+             *   (lineage row carrying ≥2 distinct blueprint_instance_ids).
+             *   Used by blueprint-manifest-api when reverting a blueprint
+             *   install so user edits and other blueprints' contributions
+             *   survive.
+             *
+             */
+            mode?: "overwrite" | "preserve_edits";
+        }
         export interface RestoreSnapshotResponse {
             id: string;
             status: "restoring";
         }
+        export interface SkippedResource {
+            lineage_id: string;
+            /**
+             * - `modified` — current destination payload's fingerprint differs
+             *   from the install-time fingerprint on the lineage row.
+             * - `co_owned` — lineage row has ≥2 distinct
+             *   `blueprint_instance_ids`; restoring would unilaterally affect
+             *   another blueprint instance's contribution.
+             *
+             */
+            reason: "modified" | "co_owned";
+        }
         export interface Snapshot {
             id: string;
             org_id: string;
@@ -217,58 +262,7 @@ declare namespace Paths {
     namespace ListSnapshots {
         namespace Parameters {
             export type Cursor = string;
-            export type Resource = [
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?,
-                string?
-            ];
+            export type Resource = string /* ^[^:]+:.+$ */[];
             export type Size = number;
         }
         export interface QueryParameters {
@@ -292,6 +286,7 @@ declare namespace Paths {
         }
     }
     namespace RestoreSnapshot {
+        export type RequestBody = Components.Schemas.RestoreSnapshotRequest;
         namespace Responses {
             export type $202 = Components.Schemas.RestoreSnapshotResponse;
             export type $401 = Components.Responses.Unauthorized;
@@ -391,7 +386,7 @@ interface OperationMethods {
    * 
    * Restore a snapshot to the org. Async — returns immediately; client polls
    * `getSnapshot` until the latest entry in `restores` moves from
-   * `in_progress` to `completed` or `failed`.
+   * `in_progress` to one of `completed | partial | failed`.
    * 
    * v1: full restore only. Cherry-pick (`resources?` body filter) is an open
    * question — see RFC OQ #1.
@@ -399,7 +394,7 @@ interface OperationMethods {
    */
   'restoreSnapshot'(
     parameters?: Parameters<Paths.V1Snapshots$IdRestore.PathParameters> | null,
-    data?: any,
+    data?: Paths.RestoreSnapshot.RequestBody,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.RestoreSnapshot.Responses.$202>
   /**
@@ -509,7 +504,7 @@ interface PathsDictionary {
      * 
      * Restore a snapshot to the org. Async — returns immediately; client polls
      * `getSnapshot` until the latest entry in `restores` moves from
-     * `in_progress` to `completed` or `failed`.
+     * `in_progress` to one of `completed | partial | failed`.
      * 
      * v1: full restore only. Cherry-pick (`resources?` body filter) is an open
      * question — see RFC OQ #1.
@@ -517,7 +512,7 @@ interface PathsDictionary {
      */
     'post'(
       parameters?: Parameters<Paths.V1Snapshots$IdRestore.PathParameters> | null,
-      data?: any,
+      data?: Paths.RestoreSnapshot.RequestBody,
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.RestoreSnapshot.Responses.$202>
   }
@@ -582,10 +577,12 @@ type CreateSnapshotResponse = Components.Schemas.CreateSnapshotResponse;
 type Error = Components.Schemas.Error;
 type Operation = Components.Schemas.Operation;
 type ResourceRef = Components.Schemas.ResourceRef;
+type RestoreSnapshotRequest = Components.Schemas.RestoreSnapshotRequest;
 type RestoreSnapshotResponse = Components.Schemas.RestoreSnapshotResponse;
+type SkippedResource = Components.Schemas.SkippedResource;
 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 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 CreateSnapshotRequest as d, type CreateSnapshotResponse as e, type Operation as f, type RestoreSnapshotResponse as g, type SnapshotResourceDetail as h, type SnapshotResourceList as i, type SnapshotResourceSummary as j };
+export { type Client as C, type Error as E, type OperationMethods as O, Paths as P, type ResourceRef as R, type SkippedResource as S, Components as a, type PathsDictionary as b, type CallerIdentity as c, type CreateSnapshotRequest as d, type CreateSnapshotResponse as e, type Operation as f, type RestoreSnapshotRequest as g, type RestoreSnapshotResponse as h, type Snapshot as i, type SnapshotResourceDetail as j, type SnapshotResourceList as k, type SnapshotResourceSummary as l };