@epilot/sdk 2.8.8 → 2.8.10

package/dist/{snapshot.d-C-n4wkIu.d.ts → snapshot.d-CPTXg4xN.d.ts}

@@ -109,18 +109,19 @@ declare namespace Components {
             started_at: string; // date-time
             completed_at?: string; // date-time
             /**
-             * `partial` indicates the operation completed but skipped at least
-             * one resource — see `skipped`. Only populated by restores triggered
-             * with `mode: 'preserve_edits'`.
+             * `partial` indicates the operation completed but snapshot-api
+             * skipped at least one captured resource via its own drift check
+             * (see `skipped`).
              *
              */
             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.
+             * Captured resources snapshot-api elected to skip — currently
+             * only drift detections (`preserve_modified: true`). Caller-
+             * supplied `exclude_target_ids` skips are NOT echoed here; the
+             * caller built the list, the caller knows.
              *
              */
             skipped?: SkippedResource[];
@@ -133,45 +134,45 @@ declare namespace Components {
             id: string;
         }
         /**
-         * Both flags default to `false`, which restores every captured resource —
-         * Config Hub's manual-restore semantics. blueprint-manifest-api sets
-         * both `true` when reverting a blueprint install so user edits and
-         * cross-blueprint contributions survive. Each flag is independent so a
-         * caller can preserve edits without preserving co-ownership (or vice
-         * versa). Skipped resources surface under `Operation.skipped`.
+         * Apply a captured snapshot to its source org. All filters default to the
+         * open setting (apply everything), which keeps Config Hub's manual-restore
+         * semantics unchanged.
          *
          */
         export interface RestoreSnapshotRequest {
             /**
-             * When `true`, skip captured resources whose live destination payload
-             * has diverged from the install-time fingerprint stored on lineage.
-             * Surfaces under `Operation.skipped` with `reason: 'modified'`.
+             * When `true`, skip captured resources whose live payload's content
+             * fingerprint diverges from the capture-time fingerprint stored on
+             * the manifest entry. snapshot-api fetches the live payload and
+             * hashes it itself; no cross-service lookup. Surfaces under
+             * `Operation.skipped` with `reason: 'modified'`. Legacy snapshots
+             * captured before fingerprints were stored fail open (applied).
              *
              */
             preserve_modified?: boolean;
             /**
-             * When `true`, skip captured resources whose lineage row carries
-             * another blueprint instance's id (co-ownership ≥2). Surfaces under
-             * `Operation.skipped` with `reason: 'co_owned'`.
+             * Target ids the caller has decided not to restore. snapshot-api
+             * applies the manifest minus these ids. Drops are silent — not
+             * echoed in `Operation.skipped` — because the caller supplied the
+             * list and already knows.
              *
              */
-            preserve_co_owned?: boolean;
+            exclude_target_ids?: string[];
         }
         export interface RestoreSnapshotResponse {
             id: string;
             status: "restoring";
         }
         export interface SkippedResource {
-            lineage_id: string;
+            target_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.
+             * - `modified` — live destination payload's content fingerprint
+             *   differs from the capture-time fingerprint stored on the
+             *   manifest entry. Only set when the restore was requested with
+             *   `preserve_modified: true`.
              *
              */
-            reason: "modified" | "co_owned";
+            reason: "modified";
         }
         export interface Snapshot {
             id: string;
@@ -280,10 +281,8 @@ declare namespace Components {
          */
         export interface SnapshotResourceSummary {
             /**
-             * Cross-service correlation key — matches the lineage row id in
-             * blueprint-manifest-api's lineage table for `blueprint_install`
-             * snapshots. Same as `target_id` for snapshots whose capture
-             * doesn't distinguish source vs destination identifiers.
+             * Deprecated alias of `target_id`. Always equals `target_id` (the
+             * implementation never distinguished them). Use `target_id`.
              *
              */
             lineage_id: string;
@@ -376,11 +375,13 @@ declare namespace Paths {
             export type Cursor = string;
             export type Resource = string /* ^[^:]+:.+$ */[];
             export type Size = number;
+            export type Trigger = "manual" | "sync" | "blueprint_install" | "scheduled";
         }
         export interface QueryParameters {
             cursor?: Parameters.Cursor;
             size?: Parameters.Size;
             resource?: Parameters.Resource;
+            trigger?: Parameters.Trigger;
         }
         namespace Responses {
             export interface $200 {
@@ -399,12 +400,9 @@ declare namespace Paths {
     }
     namespace RestoreSnapshot {
         export type RequestBody = /**
-         * Both flags default to `false`, which restores every captured resource —
-         * Config Hub's manual-restore semantics. blueprint-manifest-api sets
-         * both `true` when reverting a blueprint install so user edits and
-         * cross-blueprint contributions survive. Each flag is independent so a
-         * caller can preserve edits without preserving co-ownership (or vice
-         * versa). Skipped resources surface under `Operation.skipped`.
+         * Apply a captured snapshot to its source org. All filters default to the
+         * open setting (apply everything), which keeps Config Hub's manual-restore
+         * semantics unchanged.
          *
          */
         Components.Schemas.RestoreSnapshotRequest;

package/docs/snapshot.md

@@ -91,6 +91,7 @@ const { data } = await client.listSnapshots({
   cursor: 'example',
   size: 1,
   resource: ['...'],
+  trigger: 'example',
 })
 ```
 
@@ -123,7 +124,7 @@ const { data } = await client.listSnapshots({
         },
         "skipped": [
           {
-            "lineage_id": "string",
+            "target_id": "string",
             "reason": "modified"
           }
         ]
@@ -142,7 +143,7 @@ const { data } = await client.listSnapshots({
           },
           "skipped": [
             {
-              "lineage_id": "string",
+              "target_id": "string",
               "reason": "modified"
             }
           ]
@@ -227,7 +228,7 @@ const { data } = await client.getSnapshot({
     },
     "skipped": [
       {
-        "lineage_id": "string",
+        "target_id": "string",
         "reason": "modified"
       }
     ]
@@ -246,7 +247,7 @@ const { data } = await client.getSnapshot({
       },
       "skipped": [
         {
-          "lineage_id": "string",
+          "target_id": "string",
           "reason": "modified"
         }
       ]
@@ -297,7 +298,7 @@ const { data } = await client.restoreSnapshot(
   },
   {
     preserve_modified: false,
-    preserve_co_owned: false
+    exclude_target_ids: ['string']
   },
 )
 ```
@@ -536,16 +537,15 @@ type CreateSnapshotResponse = {
 
 ### `RestoreSnapshotRequest`
 
-Both flags default to `false`, which restores every captured resource —
-Config Hub's manual-restore semantics. blueprint-manifest-api sets
-both `true` when reverting a blueprint install so user edits and
-cross-blueprint contributions survive. Each flag is independent so a
-caller can preserve edits w
+Apply a captured snapshot to its source org. All filters default to the
+open setting (apply everything), which keeps Config Hub's manual-restore
+semantics unchanged.
+
 
 ```ts
 type RestoreSnapshotRequest = {
   preserve_modified?: boolean
-  preserve_co_owned?: boolean
+  exclude_target_ids?: string[]
 }
 ```
 
@@ -581,7 +581,7 @@ type Snapshot = {
       token_id?: { ... }
     }
     skipped?: Array<{
-      lineage_id: { ... }
+      target_id: { ... }
       reason: { ... }
     }>
   }
@@ -597,7 +597,7 @@ type Snapshot = {
       token_id?: { ... }
     }
     skipped?: Array<{
-      lineage_id: { ... }
+      target_id: { ... }
       reason: { ... }
     }>
   }>
@@ -628,8 +628,8 @@ type Operation = {
     token_id?: string
   }
   skipped?: Array<{
-    lineage_id: string
-    reason: "modified" | "co_owned"
+    target_id: string
+    reason: "modified"
   }>
 }
 ```
@@ -638,8 +638,8 @@ type Operation = {
 
 ```ts
 type SkippedResource = {
-  lineage_id: string
-  reason: "modified" | "co_owned"
+  target_id: string
+  reason: "modified"
 }
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epilot/sdk",
-  "version": "2.8.8",
+  "version": "2.8.10",
   "description": "JavaScript/TypeScript SDK for epilot APIs",
   "type": "module",
   "main": "./dist/index.cjs",

package/dist/chunk-4SZCKUY2.js

@@ -1,14 +0,0 @@
-import {
-  __commonJS
-} from "./chunk-YPSWSI3M.js";
-
-// src/definitions/snapshot-runtime.json
-var require_snapshot_runtime = __commonJS({
-  "src/definitions/snapshot-runtime.json"(exports, module) {
-    module.exports = { s: "https://snapshot.sls.epilot.io", o: [["createSnapshot", "post", "/v1/snapshots", null, 1], ["listSnapshots", "get", "/v1/snapshots", [["cursor", "q"], ["size", "q"], ["resource", "q"]]], ["captureOrgSnapshot", "post", "/v1/snapshots:capture-org", null, 1], ["getSnapshot", "get", "/v1/snapshots/{id}"], ["deleteSnapshot", "delete", "/v1/snapshots/{id}"], ["restoreSnapshot", "post", "/v1/snapshots/{id}:restore", null, 1], ["listSnapshotResources", "get", "/v1/snapshots/{id}/resources"], ["getSnapshotResource", "get", "/v1/snapshots/{id}/resources/{lineage_id}"], ["listDependencies", "post", "/v1/snapshots:list-dependencies", null, 1]], v: "3.0.3", pp: { "/v1/snapshots/{id}": [["id", "p", true]], "/v1/snapshots/{id}:restore": [["id", "p", true]], "/v1/snapshots/{id}/resources": [["id", "p", true]], "/v1/snapshots/{id}/resources/{lineage_id}": [["id", "p", true], ["lineage_id", "p", true]] } };
-  }
-});
-
-export {
-  require_snapshot_runtime
-};

package/dist/chunk-ULKFBO7E.cjs

@@ -1,14 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
-
-var _chunkNJK5F5TFcjs = require('./chunk-NJK5F5TF.cjs');
-
-// src/definitions/snapshot-runtime.json
-var require_snapshot_runtime = _chunkNJK5F5TFcjs.__commonJS.call(void 0, {
-  "src/definitions/snapshot-runtime.json"(exports, module) {
-    module.exports = { s: "https://snapshot.sls.epilot.io", o: [["createSnapshot", "post", "/v1/snapshots", null, 1], ["listSnapshots", "get", "/v1/snapshots", [["cursor", "q"], ["size", "q"], ["resource", "q"]]], ["captureOrgSnapshot", "post", "/v1/snapshots:capture-org", null, 1], ["getSnapshot", "get", "/v1/snapshots/{id}"], ["deleteSnapshot", "delete", "/v1/snapshots/{id}"], ["restoreSnapshot", "post", "/v1/snapshots/{id}:restore", null, 1], ["listSnapshotResources", "get", "/v1/snapshots/{id}/resources"], ["getSnapshotResource", "get", "/v1/snapshots/{id}/resources/{lineage_id}"], ["listDependencies", "post", "/v1/snapshots:list-dependencies", null, 1]], v: "3.0.3", pp: { "/v1/snapshots/{id}": [["id", "p", true]], "/v1/snapshots/{id}:restore": [["id", "p", true]], "/v1/snapshots/{id}/resources": [["id", "p", true]], "/v1/snapshots/{id}/resources/{lineage_id}": [["id", "p", true], ["lineage_id", "p", true]] } };
-  }
-});
-
-
-
-exports.require_snapshot_runtime = require_snapshot_runtime;

package/dist/snapshot-GDJOEFJQ.js

@@ -1,7 +0,0 @@
-import "./chunk-YPSWSI3M.js";
-
-// src/docs/snapshot.json
-var snapshot_default = '# Snapshot API\n\n- **Base URL:** `https://snapshot.sls.epilot.io`\n- **Full API Docs:** [https://docs.epilot.io/api/snapshot](https://docs.epilot.io/api/snapshot)\n\n## Usage\n\n```ts\nimport { epilot } from \'@epilot/sdk\'\n\nepilot.authorize(() => \'<token>\')\nconst { data } = await epilot.snapshot.createSnapshot(...)\n```\n\n### Tree-shakeable import\n\n```ts\nimport { getClient, authorize } from \'@epilot/sdk/snapshot\'\n\nconst snapshotClient = getClient()\nauthorize(snapshotClient, () => \'<token>\')\nconst { data } = await snapshotClient.createSnapshot(...)\n```\n\n## Operations\n\n**Snapshots**\n- [`createSnapshot`](#createsnapshot)\n- [`listSnapshots`](#listsnapshots)\n- [`captureOrgSnapshot`](#captureorgsnapshot)\n- [`getSnapshot`](#getsnapshot)\n- [`deleteSnapshot`](#deletesnapshot)\n- [`restoreSnapshot`](#restoresnapshot)\n- [`listSnapshotResources`](#listsnapshotresources)\n- [`getSnapshotResource`](#getsnapshotresource)\n- [`listDependencies`](#listdependencies)\n\n**Schemas**\n- [`Error`](#error)\n- [`EmptyInventoryError`](#emptyinventoryerror)\n- [`ResourceRef`](#resourceref)\n- [`SnapshotResourceSummary`](#snapshotresourcesummary)\n- [`SnapshotResourceList`](#snapshotresourcelist)\n- [`SnapshotResourceDetail`](#snapshotresourcedetail)\n- [`CreateSnapshotRequest`](#createsnapshotrequest)\n- [`CreateOrgSnapshotRequest`](#createorgsnapshotrequest)\n- [`CreateSnapshotResponse`](#createsnapshotresponse)\n- [`RestoreSnapshotRequest`](#restoresnapshotrequest)\n- [`RestoreSnapshotResponse`](#restoresnapshotresponse)\n- [`Snapshot`](#snapshot)\n- [`Operation`](#operation)\n- [`SkippedResource`](#skippedresource)\n- [`CallerIdentity`](#calleridentity)\n\n### `createSnapshot`\n\nCreate a new snapshot of the given resources. Async \u2014 returns immediately\nwith a snapshot ID; client polls `getSnapshot` until `create.status`\nmoves from `in_progress` to `completed` or `failed`.\n\n`POST /v1/snapshots`\n\n```ts\nconst { data } = await client.createSnapshot(\n  null,\n  {\n    name: \'string\',\n    description: \'string\',\n    trigger: \'manual\',\n    blueprint_instance_id: \'string\',\n    resources: [\n      {\n        type: \'string\',\n        id: \'string\'\n      }\n    ]\n  },\n)\n```\n\n---\n\n### `listSnapshots`\n\nList snapshots for the caller\'s organization, newest first.\n\n`GET /v1/snapshots`\n\n```ts\nconst { data } = await client.listSnapshots({\n  cursor: \'example\',\n  size: 1,\n  resource: [\'...\'],\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "page_size": 0,\n  "cursor": "string",\n  "results": [\n    {\n      "id": "string",\n      "org_id": "string",\n      "name": "string",\n      "description": "string",\n      "trigger": "manual",\n      "blueprint_instance_id": "string",\n      "resource_counts": {},\n      "create": {\n        "type": "create",\n        "started_at": "1970-01-01T00:00:00.000Z",\n        "completed_at": "1970-01-01T00:00:00.000Z",\n        "status": "in_progress",\n        "error": "string",\n        "triggered_by": {\n          "name": "string",\n          "user_id": "string",\n          "token_id": "string"\n        },\n        "skipped": [\n          {\n            "lineage_id": "string",\n            "reason": "modified"\n          }\n        ]\n      },\n      "restores": [\n        {\n          "type": "create",\n          "started_at": "1970-01-01T00:00:00.000Z",\n          "completed_at": "1970-01-01T00:00:00.000Z",\n          "status": "in_progress",\n          "error": "string",\n          "triggered_by": {\n            "name": "string",\n            "user_id": "string",\n            "token_id": "string"\n          },\n          "skipped": [\n            {\n              "lineage_id": "string",\n              "reason": "modified"\n            }\n          ]\n        }\n      ],\n      "matched_count": 0,\n      "scope": "selection",\n      "expires_at": "1970-01-01T00:00:00.000Z",\n      "capture_summary": {\n        "total": 0,\n        "captured": 0,\n        "skipped": 0,\n        "failed": 0\n      }\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `captureOrgSnapshot`\n\nSnapshot 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\n\n`POST /v1/snapshots:capture-org`\n\n```ts\nconst { data } = await client.captureOrgSnapshot(\n  null,\n  {\n    name: \'string\',\n    retention: {\n      value: 1,\n      unit: \'days\'\n    },\n    excluded_types: [\'string\']\n  },\n)\n```\n\n---\n\n### `getSnapshot`\n\nFetch a snapshot\'s metadata. Poll this endpoint to track create/restore progress.\n\n`GET /v1/snapshots/{id}`\n\n```ts\nconst { data } = await client.getSnapshot({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "id": "string",\n  "org_id": "string",\n  "name": "string",\n  "description": "string",\n  "trigger": "manual",\n  "blueprint_instance_id": "string",\n  "resource_counts": {},\n  "create": {\n    "type": "create",\n    "started_at": "1970-01-01T00:00:00.000Z",\n    "completed_at": "1970-01-01T00:00:00.000Z",\n    "status": "in_progress",\n    "error": "string",\n    "triggered_by": {\n      "name": "string",\n      "user_id": "string",\n      "token_id": "string"\n    },\n    "skipped": [\n      {\n        "lineage_id": "string",\n        "reason": "modified"\n      }\n    ]\n  },\n  "restores": [\n    {\n      "type": "create",\n      "started_at": "1970-01-01T00:00:00.000Z",\n      "completed_at": "1970-01-01T00:00:00.000Z",\n      "status": "in_progress",\n      "error": "string",\n      "triggered_by": {\n        "name": "string",\n        "user_id": "string",\n        "token_id": "string"\n      },\n      "skipped": [\n        {\n          "lineage_id": "string",\n          "reason": "modified"\n        }\n      ]\n    }\n  ],\n  "matched_count": 0,\n  "scope": "selection",\n  "expires_at": "1970-01-01T00:00:00.000Z",\n  "capture_summary": {\n    "total": 0,\n    "captured": 0,\n    "skipped": 0,\n    "failed": 0\n  }\n}\n```\n\n</details>\n\n---\n\n### `deleteSnapshot`\n\nDelete a snapshot\'s metadata and S3 manifest.\n\n`DELETE /v1/snapshots/{id}`\n\n```ts\nconst { data } = await client.deleteSnapshot({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n})\n```\n\n---\n\n### `restoreSnapshot`\n\nRestore a snapshot to the org. Async \u2014 returns immediately; client polls\n`getSnapshot` until the latest entry in `restores` moves from\n`in_progress` to one of `completed | partial | failed`.\n\n`POST /v1/snapshots/{id}:restore`\n\n```ts\nconst { data } = await client.restoreSnapshot(\n  {\n    id: \'123e4567-e89b-12d3-a456-426614174000\',\n  },\n  {\n    preserve_modified: false,\n    preserve_co_owned: false\n  },\n)\n```\n\n---\n\n### `listSnapshotResources`\n\nList the resources captured in this snapshot. Returns lightweight\nidentity fields per resource \u2014 payloads are fetched via the\nsingle-resource endpoint when needed.\n\n`GET /v1/snapshots/{id}/resources`\n\n```ts\nconst { data } = await client.listSnapshotResources({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "resources": [\n    {\n      "lineage_id": "string",\n      "target_id": "string",\n      "type": "string",\n      "name": "string"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `getSnapshotResource`\n\nFetch one captured resource with its full payload. For UI views\nthat diff the captured state against the current destination.\n\n`GET /v1/snapshots/{id}/resources/{lineage_id}`\n\n```ts\nconst { data } = await client.getSnapshotResource({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n  lineage_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "lineage_id": "string",\n  "target_id": "string",\n  "type": "string",\n  "name": "string",\n  "captured": {}\n}\n```\n\n</details>\n\n---\n\n### `listDependencies`\n\nWalk the dependency tree for a set of resources and return the full\ntransitive closure, topologically sorted.\n\n`POST /v1/snapshots:list-dependencies`\n\n```ts\nconst { data } = await client.listDependencies(\n  null,\n  {\n    resources: [\n      {\n        type: \'string\',\n        id: \'string\'\n      }\n    ]\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "dependencies": [\n    {\n      "type": "string",\n      "id": "string"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n## Schemas\n\n### `Error`\n\n```ts\ntype Error = {\n  status: number\n  error: string\n}\n```\n\n### `EmptyInventoryError`\n\nReturned (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\n\n```ts\ntype EmptyInventoryError = {\n  message: string\n  skipped_types: Array<{\n    type: string\n    reason: string\n  }>\n}\n```\n\n### `ResourceRef`\n\n```ts\ntype ResourceRef = {\n  type: string\n  id: string\n}\n```\n\n### `SnapshotResourceSummary`\n\nLightweight identity for a captured resource. Returned by\n`listSnapshotResources`; the full payload is fetched separately via\n`getSnapshotResource` when needed.\n\n\n```ts\ntype SnapshotResourceSummary = {\n  lineage_id: string\n  target_id: string\n  type: string\n  name?: string\n}\n```\n\n### `SnapshotResourceList`\n\n```ts\ntype SnapshotResourceList = {\n  resources: Array<{\n    lineage_id: string\n    target_id: string\n    type: string\n    name?: string\n  }>\n}\n```\n\n### `SnapshotResourceDetail`\n\nA single captured resource with its full payload. The identity fields\nmatch `SnapshotResourceSummary`; the `captured` payload is the\npre-install state at snapshot time.\n\n\n```ts\ntype SnapshotResourceDetail = {\n  lineage_id: string\n  target_id: string\n  type: string\n  name?: string\n  captured: Record<string, unknown>\n}\n```\n\n### `CreateSnapshotRequest`\n\n```ts\ntype CreateSnapshotRequest = {\n  name: string\n  description?: string\n  trigger?: "manual" | "sync" | "blueprint_install" | "scheduled"\n  blueprint_instance_id?: string\n  resources: Array<{\n    type: string\n    id: string\n  }>\n}\n```\n\n### `CreateOrgSnapshotRequest`\n\nRequest body for `captureOrgSnapshot`. All fields optional \u2014 an empty body\nsnapshots the whole org with a default name and the 90-day default TTL.\n\n\n```ts\ntype CreateOrgSnapshotRequest = {\n  name?: string\n  retention?: {\n    value: number\n    unit: "days" | "weeks" | "months"\n  }\n  excluded_types?: string[]\n}\n```\n\n### `CreateSnapshotResponse`\n\n```ts\ntype CreateSnapshotResponse = {\n  id: string\n  name: string\n  status: "creating"\n  created_at: string // date-time\n}\n```\n\n### `RestoreSnapshotRequest`\n\nBoth flags default to `false`, which restores every captured resource \u2014\nConfig Hub\'s manual-restore semantics. blueprint-manifest-api sets\nboth `true` when reverting a blueprint install so user edits and\ncross-blueprint contributions survive. Each flag is independent so a\ncaller can preserve edits w\n\n```ts\ntype RestoreSnapshotRequest = {\n  preserve_modified?: boolean\n  preserve_co_owned?: boolean\n}\n```\n\n### `RestoreSnapshotResponse`\n\n```ts\ntype RestoreSnapshotResponse = {\n  id: string\n  status: "restoring"\n}\n```\n\n### `Snapshot`\n\n```ts\ntype Snapshot = {\n  id: string\n  org_id: string\n  name: string\n  description?: string\n  trigger: "manual" | "sync" | "blueprint_install" | "scheduled"\n  blueprint_instance_id?: string\n  resource_counts: Record<string, number>\n  create: {\n    type: "create" | "restore"\n    started_at: string // date-time\n    completed_at?: string // date-time\n    status: "in_progress" | "completed" | "partial" | "failed"\n    error?: string\n    triggered_by: {\n      name: { ... }\n      user_id?: { ... }\n      token_id?: { ... }\n    }\n    skipped?: Array<{\n      lineage_id: { ... }\n      reason: { ... }\n    }>\n  }\n  restores: Array<{\n    type: "create" | "restore"\n    started_at: string // date-time\n    completed_at?: string // date-time\n    status: "in_progress" | "completed" | "partial" | "failed"\n    error?: string\n    triggered_by: {\n      name: { ... }\n      user_id?: { ... }\n      token_id?: { ... }\n    }\n    skipped?: Array<{\n      lineage_id: { ... }\n      reason: { ... }\n    }>\n  }>\n  matched_count?: number\n  scope?: "selection" | "org"\n  expires_at?: string // date-time\n  capture_summary?: {\n    total: number\n    captured: number\n    skipped: number\n    failed: number\n  }\n}\n```\n\n### `Operation`\n\n```ts\ntype Operation = {\n  type: "create" | "restore"\n  started_at: string // date-time\n  completed_at?: string // date-time\n  status: "in_progress" | "completed" | "partial" | "failed"\n  error?: string\n  triggered_by: {\n    name: string\n    user_id?: string\n    token_id?: string\n  }\n  skipped?: Array<{\n    lineage_id: string\n    reason: "modified" | "co_owned"\n  }>\n}\n```\n\n### `SkippedResource`\n\n```ts\ntype SkippedResource = {\n  lineage_id: string\n  reason: "modified" | "co_owned"\n}\n```\n\n### `CallerIdentity`\n\n```ts\ntype CallerIdentity = {\n  name: string\n  user_id?: string\n  token_id?: string\n}\n```\n';
-export {
-  snapshot_default as default
-};

package/dist/snapshot-UKV54UQQ.cjs

@@ -1,7 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('./chunk-NJK5F5TF.cjs');
-
-// src/docs/snapshot.json
-var snapshot_default = '# Snapshot API\n\n- **Base URL:** `https://snapshot.sls.epilot.io`\n- **Full API Docs:** [https://docs.epilot.io/api/snapshot](https://docs.epilot.io/api/snapshot)\n\n## Usage\n\n```ts\nimport { epilot } from \'@epilot/sdk\'\n\nepilot.authorize(() => \'<token>\')\nconst { data } = await epilot.snapshot.createSnapshot(...)\n```\n\n### Tree-shakeable import\n\n```ts\nimport { getClient, authorize } from \'@epilot/sdk/snapshot\'\n\nconst snapshotClient = getClient()\nauthorize(snapshotClient, () => \'<token>\')\nconst { data } = await snapshotClient.createSnapshot(...)\n```\n\n## Operations\n\n**Snapshots**\n- [`createSnapshot`](#createsnapshot)\n- [`listSnapshots`](#listsnapshots)\n- [`captureOrgSnapshot`](#captureorgsnapshot)\n- [`getSnapshot`](#getsnapshot)\n- [`deleteSnapshot`](#deletesnapshot)\n- [`restoreSnapshot`](#restoresnapshot)\n- [`listSnapshotResources`](#listsnapshotresources)\n- [`getSnapshotResource`](#getsnapshotresource)\n- [`listDependencies`](#listdependencies)\n\n**Schemas**\n- [`Error`](#error)\n- [`EmptyInventoryError`](#emptyinventoryerror)\n- [`ResourceRef`](#resourceref)\n- [`SnapshotResourceSummary`](#snapshotresourcesummary)\n- [`SnapshotResourceList`](#snapshotresourcelist)\n- [`SnapshotResourceDetail`](#snapshotresourcedetail)\n- [`CreateSnapshotRequest`](#createsnapshotrequest)\n- [`CreateOrgSnapshotRequest`](#createorgsnapshotrequest)\n- [`CreateSnapshotResponse`](#createsnapshotresponse)\n- [`RestoreSnapshotRequest`](#restoresnapshotrequest)\n- [`RestoreSnapshotResponse`](#restoresnapshotresponse)\n- [`Snapshot`](#snapshot)\n- [`Operation`](#operation)\n- [`SkippedResource`](#skippedresource)\n- [`CallerIdentity`](#calleridentity)\n\n### `createSnapshot`\n\nCreate a new snapshot of the given resources. Async \u2014 returns immediately\nwith a snapshot ID; client polls `getSnapshot` until `create.status`\nmoves from `in_progress` to `completed` or `failed`.\n\n`POST /v1/snapshots`\n\n```ts\nconst { data } = await client.createSnapshot(\n  null,\n  {\n    name: \'string\',\n    description: \'string\',\n    trigger: \'manual\',\n    blueprint_instance_id: \'string\',\n    resources: [\n      {\n        type: \'string\',\n        id: \'string\'\n      }\n    ]\n  },\n)\n```\n\n---\n\n### `listSnapshots`\n\nList snapshots for the caller\'s organization, newest first.\n\n`GET /v1/snapshots`\n\n```ts\nconst { data } = await client.listSnapshots({\n  cursor: \'example\',\n  size: 1,\n  resource: [\'...\'],\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "page_size": 0,\n  "cursor": "string",\n  "results": [\n    {\n      "id": "string",\n      "org_id": "string",\n      "name": "string",\n      "description": "string",\n      "trigger": "manual",\n      "blueprint_instance_id": "string",\n      "resource_counts": {},\n      "create": {\n        "type": "create",\n        "started_at": "1970-01-01T00:00:00.000Z",\n        "completed_at": "1970-01-01T00:00:00.000Z",\n        "status": "in_progress",\n        "error": "string",\n        "triggered_by": {\n          "name": "string",\n          "user_id": "string",\n          "token_id": "string"\n        },\n        "skipped": [\n          {\n            "lineage_id": "string",\n            "reason": "modified"\n          }\n        ]\n      },\n      "restores": [\n        {\n          "type": "create",\n          "started_at": "1970-01-01T00:00:00.000Z",\n          "completed_at": "1970-01-01T00:00:00.000Z",\n          "status": "in_progress",\n          "error": "string",\n          "triggered_by": {\n            "name": "string",\n            "user_id": "string",\n            "token_id": "string"\n          },\n          "skipped": [\n            {\n              "lineage_id": "string",\n              "reason": "modified"\n            }\n          ]\n        }\n      ],\n      "matched_count": 0,\n      "scope": "selection",\n      "expires_at": "1970-01-01T00:00:00.000Z",\n      "capture_summary": {\n        "total": 0,\n        "captured": 0,\n        "skipped": 0,\n        "failed": 0\n      }\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `captureOrgSnapshot`\n\nSnapshot 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\n\n`POST /v1/snapshots:capture-org`\n\n```ts\nconst { data } = await client.captureOrgSnapshot(\n  null,\n  {\n    name: \'string\',\n    retention: {\n      value: 1,\n      unit: \'days\'\n    },\n    excluded_types: [\'string\']\n  },\n)\n```\n\n---\n\n### `getSnapshot`\n\nFetch a snapshot\'s metadata. Poll this endpoint to track create/restore progress.\n\n`GET /v1/snapshots/{id}`\n\n```ts\nconst { data } = await client.getSnapshot({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "id": "string",\n  "org_id": "string",\n  "name": "string",\n  "description": "string",\n  "trigger": "manual",\n  "blueprint_instance_id": "string",\n  "resource_counts": {},\n  "create": {\n    "type": "create",\n    "started_at": "1970-01-01T00:00:00.000Z",\n    "completed_at": "1970-01-01T00:00:00.000Z",\n    "status": "in_progress",\n    "error": "string",\n    "triggered_by": {\n      "name": "string",\n      "user_id": "string",\n      "token_id": "string"\n    },\n    "skipped": [\n      {\n        "lineage_id": "string",\n        "reason": "modified"\n      }\n    ]\n  },\n  "restores": [\n    {\n      "type": "create",\n      "started_at": "1970-01-01T00:00:00.000Z",\n      "completed_at": "1970-01-01T00:00:00.000Z",\n      "status": "in_progress",\n      "error": "string",\n      "triggered_by": {\n        "name": "string",\n        "user_id": "string",\n        "token_id": "string"\n      },\n      "skipped": [\n        {\n          "lineage_id": "string",\n          "reason": "modified"\n        }\n      ]\n    }\n  ],\n  "matched_count": 0,\n  "scope": "selection",\n  "expires_at": "1970-01-01T00:00:00.000Z",\n  "capture_summary": {\n    "total": 0,\n    "captured": 0,\n    "skipped": 0,\n    "failed": 0\n  }\n}\n```\n\n</details>\n\n---\n\n### `deleteSnapshot`\n\nDelete a snapshot\'s metadata and S3 manifest.\n\n`DELETE /v1/snapshots/{id}`\n\n```ts\nconst { data } = await client.deleteSnapshot({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n})\n```\n\n---\n\n### `restoreSnapshot`\n\nRestore a snapshot to the org. Async \u2014 returns immediately; client polls\n`getSnapshot` until the latest entry in `restores` moves from\n`in_progress` to one of `completed | partial | failed`.\n\n`POST /v1/snapshots/{id}:restore`\n\n```ts\nconst { data } = await client.restoreSnapshot(\n  {\n    id: \'123e4567-e89b-12d3-a456-426614174000\',\n  },\n  {\n    preserve_modified: false,\n    preserve_co_owned: false\n  },\n)\n```\n\n---\n\n### `listSnapshotResources`\n\nList the resources captured in this snapshot. Returns lightweight\nidentity fields per resource \u2014 payloads are fetched via the\nsingle-resource endpoint when needed.\n\n`GET /v1/snapshots/{id}/resources`\n\n```ts\nconst { data } = await client.listSnapshotResources({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "resources": [\n    {\n      "lineage_id": "string",\n      "target_id": "string",\n      "type": "string",\n      "name": "string"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `getSnapshotResource`\n\nFetch one captured resource with its full payload. For UI views\nthat diff the captured state against the current destination.\n\n`GET /v1/snapshots/{id}/resources/{lineage_id}`\n\n```ts\nconst { data } = await client.getSnapshotResource({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n  lineage_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "lineage_id": "string",\n  "target_id": "string",\n  "type": "string",\n  "name": "string",\n  "captured": {}\n}\n```\n\n</details>\n\n---\n\n### `listDependencies`\n\nWalk the dependency tree for a set of resources and return the full\ntransitive closure, topologically sorted.\n\n`POST /v1/snapshots:list-dependencies`\n\n```ts\nconst { data } = await client.listDependencies(\n  null,\n  {\n    resources: [\n      {\n        type: \'string\',\n        id: \'string\'\n      }\n    ]\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "dependencies": [\n    {\n      "type": "string",\n      "id": "string"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n## Schemas\n\n### `Error`\n\n```ts\ntype Error = {\n  status: number\n  error: string\n}\n```\n\n### `EmptyInventoryError`\n\nReturned (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\n\n```ts\ntype EmptyInventoryError = {\n  message: string\n  skipped_types: Array<{\n    type: string\n    reason: string\n  }>\n}\n```\n\n### `ResourceRef`\n\n```ts\ntype ResourceRef = {\n  type: string\n  id: string\n}\n```\n\n### `SnapshotResourceSummary`\n\nLightweight identity for a captured resource. Returned by\n`listSnapshotResources`; the full payload is fetched separately via\n`getSnapshotResource` when needed.\n\n\n```ts\ntype SnapshotResourceSummary = {\n  lineage_id: string\n  target_id: string\n  type: string\n  name?: string\n}\n```\n\n### `SnapshotResourceList`\n\n```ts\ntype SnapshotResourceList = {\n  resources: Array<{\n    lineage_id: string\n    target_id: string\n    type: string\n    name?: string\n  }>\n}\n```\n\n### `SnapshotResourceDetail`\n\nA single captured resource with its full payload. The identity fields\nmatch `SnapshotResourceSummary`; the `captured` payload is the\npre-install state at snapshot time.\n\n\n```ts\ntype SnapshotResourceDetail = {\n  lineage_id: string\n  target_id: string\n  type: string\n  name?: string\n  captured: Record<string, unknown>\n}\n```\n\n### `CreateSnapshotRequest`\n\n```ts\ntype CreateSnapshotRequest = {\n  name: string\n  description?: string\n  trigger?: "manual" | "sync" | "blueprint_install" | "scheduled"\n  blueprint_instance_id?: string\n  resources: Array<{\n    type: string\n    id: string\n  }>\n}\n```\n\n### `CreateOrgSnapshotRequest`\n\nRequest body for `captureOrgSnapshot`. All fields optional \u2014 an empty body\nsnapshots the whole org with a default name and the 90-day default TTL.\n\n\n```ts\ntype CreateOrgSnapshotRequest = {\n  name?: string\n  retention?: {\n    value: number\n    unit: "days" | "weeks" | "months"\n  }\n  excluded_types?: string[]\n}\n```\n\n### `CreateSnapshotResponse`\n\n```ts\ntype CreateSnapshotResponse = {\n  id: string\n  name: string\n  status: "creating"\n  created_at: string // date-time\n}\n```\n\n### `RestoreSnapshotRequest`\n\nBoth flags default to `false`, which restores every captured resource \u2014\nConfig Hub\'s manual-restore semantics. blueprint-manifest-api sets\nboth `true` when reverting a blueprint install so user edits and\ncross-blueprint contributions survive. Each flag is independent so a\ncaller can preserve edits w\n\n```ts\ntype RestoreSnapshotRequest = {\n  preserve_modified?: boolean\n  preserve_co_owned?: boolean\n}\n```\n\n### `RestoreSnapshotResponse`\n\n```ts\ntype RestoreSnapshotResponse = {\n  id: string\n  status: "restoring"\n}\n```\n\n### `Snapshot`\n\n```ts\ntype Snapshot = {\n  id: string\n  org_id: string\n  name: string\n  description?: string\n  trigger: "manual" | "sync" | "blueprint_install" | "scheduled"\n  blueprint_instance_id?: string\n  resource_counts: Record<string, number>\n  create: {\n    type: "create" | "restore"\n    started_at: string // date-time\n    completed_at?: string // date-time\n    status: "in_progress" | "completed" | "partial" | "failed"\n    error?: string\n    triggered_by: {\n      name: { ... }\n      user_id?: { ... }\n      token_id?: { ... }\n    }\n    skipped?: Array<{\n      lineage_id: { ... }\n      reason: { ... }\n    }>\n  }\n  restores: Array<{\n    type: "create" | "restore"\n    started_at: string // date-time\n    completed_at?: string // date-time\n    status: "in_progress" | "completed" | "partial" | "failed"\n    error?: string\n    triggered_by: {\n      name: { ... }\n      user_id?: { ... }\n      token_id?: { ... }\n    }\n    skipped?: Array<{\n      lineage_id: { ... }\n      reason: { ... }\n    }>\n  }>\n  matched_count?: number\n  scope?: "selection" | "org"\n  expires_at?: string // date-time\n  capture_summary?: {\n    total: number\n    captured: number\n    skipped: number\n    failed: number\n  }\n}\n```\n\n### `Operation`\n\n```ts\ntype Operation = {\n  type: "create" | "restore"\n  started_at: string // date-time\n  completed_at?: string // date-time\n  status: "in_progress" | "completed" | "partial" | "failed"\n  error?: string\n  triggered_by: {\n    name: string\n    user_id?: string\n    token_id?: string\n  }\n  skipped?: Array<{\n    lineage_id: string\n    reason: "modified" | "co_owned"\n  }>\n}\n```\n\n### `SkippedResource`\n\n```ts\ntype SkippedResource = {\n  lineage_id: string\n  reason: "modified" | "co_owned"\n}\n```\n\n### `CallerIdentity`\n\n```ts\ntype CallerIdentity = {\n  name: string\n  user_id?: string\n  token_id?: string\n}\n```\n';
-
-
-exports.default = snapshot_default;