@hasna/snapshots 0.1.0

package/dist/runtime.js

@@ -0,0 +1,91 @@
+import { captureAll } from "./capture/index.js";
+import { SnapshotStore } from "./storage.js";
+import { createRestorePlan } from "./restore.js";
+export async function captureSnapshot(options = {}) {
+    const store = new SnapshotStore({ path: options.dbPath });
+    try {
+        const capture = await captureAll(options);
+        const snapshot = store.saveSnapshot(capture.resources, {
+            name: options.name,
+            diagnostics: capture.diagnostics
+        });
+        return {
+            snapshot,
+            resource_count: capture.resources.length,
+            diagnostic_count: capture.diagnostics.length,
+            duplicate: Boolean(snapshot.duplicateOf)
+        };
+    }
+    finally {
+        store.close();
+    }
+}
+export function listSnapshots(options = {}) {
+    const store = new SnapshotStore({ path: options.dbPath });
+    try {
+        return store.listSnapshots(options.limit ?? 50);
+    }
+    finally {
+        store.close();
+    }
+}
+export function getSnapshotEnvelope(options) {
+    const store = new SnapshotStore({ path: options.dbPath });
+    try {
+        const snapshot = store.getSnapshot(options.id);
+        if (!snapshot)
+            throw new Error(`Snapshot not found: ${options.id}`);
+        return {
+            snapshot,
+            resources: store.getSnapshotResources(options.id)
+        };
+    }
+    finally {
+        store.close();
+    }
+}
+export function listResources(options = {}) {
+    const store = new SnapshotStore({ path: options.dbPath });
+    try {
+        return {
+            resources: store.listResources(options.limit ?? 200)
+        };
+    }
+    finally {
+        store.close();
+    }
+}
+export function planSnapshotRestore(options) {
+    const store = new SnapshotStore({ path: options.dbPath });
+    try {
+        const snapshot = store.getSnapshot(options.id);
+        if (!snapshot)
+            throw new Error(`Snapshot not found: ${options.id}`);
+        const resources = store.getSnapshotResources(options.id);
+        const plan = createRestorePlan(snapshot, resources, store.listPolicies(), options);
+        store.saveRestorePlan(plan);
+        return plan;
+    }
+    finally {
+        store.close();
+    }
+}
+export function upsertPolicy(options) {
+    const store = new SnapshotStore({ path: options.dbPath });
+    try {
+        return store.upsertPolicy(options.selector, options.mode, options.reason);
+    }
+    finally {
+        store.close();
+    }
+}
+export function listPolicies(options = {}) {
+    const store = new SnapshotStore({ path: options.dbPath });
+    try {
+        return store.listPolicies();
+    }
+    finally {
+        store.close();
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"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"}

package/dist/server/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":""}

package/dist/server/index.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env bun
+import { captureSnapshot, getSnapshotEnvelope, listSnapshots, planSnapshotRestore } from "../runtime.js";
+const port = Number(process.env.SNAPSHOTS_PORT ?? process.env.PORT ?? 7337);
+function json(value, status = 200) {
+    return new Response(JSON.stringify(value, null, 2), {
+        status,
+        headers: { "content-type": "application/json" }
+    });
+}
+function pathParts(url) {
+    return url.pathname.split("/").filter(Boolean);
+}
+Bun.serve({
+    port,
+    async fetch(request) {
+        const url = new URL(request.url);
+        const parts = pathParts(url);
+        try {
+            if (request.method === "GET" && url.pathname === "/health") {
+                return json({ ok: true, service: "@hasna/snapshots" });
+            }
+            if (request.method === "GET" && url.pathname === "/snapshots") {
+                return json({ snapshots: listSnapshots({ limit: Number(url.searchParams.get("limit") ?? 50) }) });
+            }
+            if (request.method === "POST" && url.pathname === "/snapshots") {
+                const body = await readBody(request);
+                return json(await captureSnapshot({
+                    name: typeof body.name === "string" ? body.name : undefined,
+                    include: Array.isArray(body.include) ? body.include.map(String) : undefined
+                }));
+            }
+            if (request.method === "GET" && parts[0] === "snapshots" && parts[1]) {
+                return json(getSnapshotEnvelope({ id: parts[1] }));
+            }
+            if (request.method === "POST" && parts[0] === "restore" && parts[1] === "plan" && parts[2]) {
+                return json(planSnapshotRestore({ id: parts[2] }));
+            }
+            return json({ ok: false, error: "not found" }, 404);
+        }
+        catch (error) {
+            return json({ ok: false, error: error instanceof Error ? error.message : String(error) }, 500);
+        }
+    }
+});
+console.log(JSON.stringify({ event: "listening", port }));
+async function readBody(request) {
+    if (!request.headers.get("content-type")?.includes("application/json"))
+        return {};
+    return (await request.json());
+}
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"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"}

package/dist/service.d.ts

@@ -0,0 +1,16 @@
+import type { JsonObject } from "./types.js";
+export interface ServicePlanOptions {
+    command?: string;
+    intervalSeconds?: number;
+    platform?: NodeJS.Platform;
+}
+export interface ServicePlan {
+    kind: "systemd" | "launchd";
+    path: string;
+    content: string;
+    applyCommand: string[];
+    note: string;
+}
+export declare function planService(options?: ServicePlanOptions): ServicePlan;
+export declare function applyServicePlan(plan: ServicePlan, yes: boolean): JsonObject;
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,WAAW,CAqBzE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,OAAO,GAAG,UAAU,CAkB5E"}

package/dist/service.js

@@ -0,0 +1,84 @@
+import { existsSync, writeFileSync } from "node:fs";
+import { homedir, platform } from "node:os";
+import { join } from "node:path";
+import { ensureDir } from "./util.js";
+export function planService(options = {}) {
+    const targetPlatform = options.platform ?? platform();
+    const command = options.command ?? "snapshots-agent run --interval 300";
+    if (targetPlatform === "darwin") {
+        const path = join(homedir(), "Library", "LaunchAgents", "com.hasna.snapshots.plist");
+        return {
+            kind: "launchd",
+            path,
+            content: launchdPlist(command, options.intervalSeconds ?? 300),
+            applyCommand: ["launchctl", "load", path],
+            note: "launchd plan is dry-run until service install --apply --yes is used."
+        };
+    }
+    const path = join(homedir(), ".config", "systemd", "user", "hasna-snapshots.service");
+    return {
+        kind: "systemd",
+        path,
+        content: systemdUnit(command),
+        applyCommand: ["systemctl", "--user", "enable", "--now", "hasna-snapshots.service"],
+        note: "systemd plan is dry-run until service install --apply --yes is used."
+    };
+}
+export function applyServicePlan(plan, yes) {
+    if (!yes) {
+        return {
+            applied: false,
+            reason: "Writing service files requires --apply --yes.",
+            plan: plan
+        };
+    }
+    ensureDir(plan.path.split("/").slice(0, -1).join("/"));
+    if (existsSync(plan.path)) {
+        return { applied: false, reason: `Service file already exists: ${plan.path}`, plan: plan };
+    }
+    writeFileSync(plan.path, plan.content, "utf8");
+    return {
+        applied: true,
+        path: plan.path,
+        next_command: plan.applyCommand
+    };
+}
+function systemdUnit(command) {
+    return `[Unit]
+Description=Hasna snapshots agent
+
+[Service]
+Type=simple
+ExecStart=${command}
+Restart=on-failure
+RestartSec=10
+
+[Install]
+WantedBy=default.target
+`;
+}
+function launchdPlist(command, intervalSeconds) {
+    const [program, ...args] = command.split(/\s+/);
+    const array = [program, ...args].map((arg) => `    <string>${escapeXml(arg)}</string>`).join("\n");
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>com.hasna.snapshots</string>
+  <key>ProgramArguments</key>
+  <array>
+${array}
+  </array>
+  <key>StartInterval</key>
+  <integer>${intervalSeconds}</integer>
+  <key>RunAtLoad</key>
+  <true/>
+</dict>
+</plist>
+`;
+}
+function escapeXml(value) {
+    return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;");
+}
+//# sourceMappingURL=service.js.map

package/dist/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"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"}

package/dist/storage.d.ts

@@ -0,0 +1,25 @@
+import { Database } from "bun:sqlite";
+import type { JsonObject, RestorePolicy, SnapshotRecord, SnapshotResource, SnapshotSaveOptions, StoredSnapshotResource, StorageOptions } from "./types.js";
+export declare class SnapshotStore {
+    readonly path: string;
+    readonly db: Database;
+    constructor(options?: StorageOptions);
+    close(): void;
+    migrate(): void;
+    saveSnapshot(resources: SnapshotResource[], options?: SnapshotSaveOptions): SnapshotRecord;
+    listSnapshots(limit?: number): SnapshotRecord[];
+    getSnapshot(id: string): SnapshotRecord | undefined;
+    getSnapshotByHash(hash: string): SnapshotRecord | undefined;
+    getSnapshotResources(snapshotId: string): StoredSnapshotResource[];
+    listResources(limit?: number): StoredSnapshotResource[];
+    upsertPolicy(selector: string, mode: RestorePolicy["mode"], reason?: string): RestorePolicy;
+    listPolicies(): RestorePolicy[];
+    saveRestorePlan(plan: JsonObject & {
+        id: string;
+        snapshotId: string;
+        createdAt: string;
+    }): void;
+}
+export declare function toStoredResource(resource: SnapshotResource): StoredSnapshotResource;
+export declare function defaultSnapshotName(): string;
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,KAAK,EAEV,UAAU,EACV,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,cAAc,EACf,MAAM,YAAY,CAAC;AAKpB,qBAAa,aAAa;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;gBAEV,OAAO,GAAE,cAAmB;IASxC,KAAK,IAAI,IAAI;IAIb,OAAO,IAAI,IAAI;IAoDf,YAAY,CAAC,SAAS,EAAE,gBAAgB,EAAE,EAAE,OAAO,GAAE,mBAAwB,GAAG,cAAc;IA6E9F,aAAa,CAAC,KAAK,SAAK,GAAG,cAAc,EAAE;IAI3C,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAKnD,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAK3D,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,sBAAsB,EAAE;IAOlE,aAAa,CAAC,KAAK,SAAM,GAAG,sBAAsB,EAAE;IAOpD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa;IAY3F,YAAY,IAAI,aAAa,EAAE;IAI/B,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;CAKhG;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,sBAAsB,CAanF;AAwCD,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C"}

package/dist/storage.js

@@ -0,0 +1,215 @@
+import { Database } from "bun:sqlite";
+import { basename } from "node:path";
+import { defaultDbPath, ensureParentDir, nowIso, sha256, stableJson } from "./util.js";
+export class SnapshotStore {
+    path;
+    db;
+    constructor(options = {}) {
+        this.path = options.path ?? defaultDbPath();
+        ensureParentDir(this.path);
+        this.db = new Database(this.path);
+        this.db.exec("PRAGMA journal_mode = WAL");
+        this.db.exec("PRAGMA foreign_keys = ON");
+        this.migrate();
+    }
+    close() {
+        this.db.close();
+    }
+    migrate() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS resources (
+        id TEXT PRIMARY KEY,
+        kind TEXT NOT NULL,
+        name TEXT NOT NULL,
+        source TEXT NOT NULL,
+        parent_id TEXT,
+        hash TEXT NOT NULL,
+        payload TEXT NOT NULL,
+        first_seen_at TEXT NOT NULL,
+        last_seen_at TEXT NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS snapshots (
+        id TEXT PRIMARY KEY,
+        name TEXT,
+        hash TEXT NOT NULL UNIQUE,
+        created_at TEXT NOT NULL,
+        resource_count INTEGER NOT NULL,
+        summary TEXT NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS snapshot_resources (
+        snapshot_id TEXT NOT NULL,
+        resource_id TEXT NOT NULL,
+        kind TEXT NOT NULL,
+        name TEXT NOT NULL,
+        source TEXT NOT NULL,
+        parent_id TEXT,
+        hash TEXT NOT NULL,
+        payload TEXT NOT NULL,
+        PRIMARY KEY (snapshot_id, resource_id),
+        FOREIGN KEY (snapshot_id) REFERENCES snapshots(id) ON DELETE CASCADE
+      );
+
+      CREATE TABLE IF NOT EXISTS policies (
+        selector TEXT PRIMARY KEY,
+        mode TEXT NOT NULL,
+        reason TEXT,
+        updated_at TEXT NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS restore_plans (
+        id TEXT PRIMARY KEY,
+        snapshot_id TEXT NOT NULL,
+        created_at TEXT NOT NULL,
+        payload TEXT NOT NULL
+      );
+    `);
+    }
+    saveSnapshot(resources, options = {}) {
+        const createdAt = options.createdAt ?? nowIso();
+        const storedResources = resources.map(toStoredResource).sort((a, b) => a.id.localeCompare(b.id));
+        const snapshotHash = sha256(stableJson(storedResources.map((resource) => ({
+            id: resource.id,
+            hash: resource.hash
+        }))));
+        const existing = this.getSnapshotByHash(snapshotHash);
+        if (existing) {
+            return { ...existing, duplicateOf: existing.id };
+        }
+        const id = options.id ?? `snap_${createdAt.replace(/[-:.TZ]/g, "").slice(0, 14)}_${snapshotHash.slice(0, 12)}`;
+        const summary = summarizeResources(storedResources, options.diagnostics ?? []);
+        const insertResource = this.db.query(`
+      INSERT INTO resources (id, kind, name, source, parent_id, hash, payload, first_seen_at, last_seen_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT(id) DO UPDATE SET
+        kind = excluded.kind,
+        name = excluded.name,
+        source = excluded.source,
+        parent_id = excluded.parent_id,
+        hash = excluded.hash,
+        payload = excluded.payload,
+        last_seen_at = excluded.last_seen_at
+    `);
+        const insertSnapshot = this.db.query(`
+      INSERT INTO snapshots (id, name, hash, created_at, resource_count, summary)
+      VALUES (?, ?, ?, ?, ?, ?)
+    `);
+        const insertSnapshotResource = this.db.query(`
+      INSERT INTO snapshot_resources (snapshot_id, resource_id, kind, name, source, parent_id, hash, payload)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+        const transaction = this.db.transaction(() => {
+            for (const resource of storedResources) {
+                insertResource.run(resource.id, resource.kind, resource.name, resource.source, resource.parentId ?? null, resource.hash, JSON.stringify(resource), createdAt, createdAt);
+            }
+            insertSnapshot.run(id, options.name ?? null, snapshotHash, createdAt, storedResources.length, JSON.stringify(summary));
+            for (const resource of storedResources) {
+                insertSnapshotResource.run(id, resource.id, resource.kind, resource.name, resource.source, resource.parentId ?? null, resource.hash, JSON.stringify(resource));
+            }
+        });
+        transaction();
+        return {
+            id,
+            name: options.name,
+            hash: snapshotHash,
+            createdAt,
+            resourceCount: storedResources.length,
+            summary
+        };
+    }
+    listSnapshots(limit = 50) {
+        return this.db.query("SELECT * FROM snapshots ORDER BY created_at DESC LIMIT ?").all(limit).map(snapshotFromRow);
+    }
+    getSnapshot(id) {
+        const row = this.db.query("SELECT * FROM snapshots WHERE id = ?").get(id);
+        return row ? snapshotFromRow(row) : undefined;
+    }
+    getSnapshotByHash(hash) {
+        const row = this.db.query("SELECT * FROM snapshots WHERE hash = ?").get(hash);
+        return row ? snapshotFromRow(row) : undefined;
+    }
+    getSnapshotResources(snapshotId) {
+        return this.db
+            .query("SELECT payload FROM snapshot_resources WHERE snapshot_id = ? ORDER BY kind, name, resource_id")
+            .all(snapshotId)
+            .map((row) => JSON.parse(String(row.payload)));
+    }
+    listResources(limit = 200) {
+        return this.db
+            .query("SELECT payload FROM resources ORDER BY last_seen_at DESC LIMIT ?")
+            .all(limit)
+            .map((row) => JSON.parse(String(row.payload)));
+    }
+    upsertPolicy(selector, mode, reason) {
+        const updatedAt = nowIso();
+        this.db
+            .query(`INSERT INTO policies (selector, mode, reason, updated_at)
+         VALUES (?, ?, ?, ?)
+         ON CONFLICT(selector) DO UPDATE SET mode = excluded.mode, reason = excluded.reason, updated_at = excluded.updated_at`)
+            .run(selector, mode, reason ?? null, updatedAt);
+        return { selector, mode, reason, updatedAt };
+    }
+    listPolicies() {
+        return this.db.query("SELECT * FROM policies ORDER BY selector").all().map(policyFromRow);
+    }
+    saveRestorePlan(plan) {
+        this.db
+            .query("INSERT OR REPLACE INTO restore_plans (id, snapshot_id, created_at, payload) VALUES (?, ?, ?, ?)")
+            .run(plan.id, plan.snapshotId, plan.createdAt, JSON.stringify(plan));
+    }
+}
+export function toStoredResource(resource) {
+    const payload = {
+        id: resource.id,
+        kind: resource.kind,
+        name: resource.name,
+        source: resource.source,
+        attributes: resource.attributes
+    };
+    if (resource.parentId)
+        payload.parentId = resource.parentId;
+    return {
+        ...resource,
+        hash: sha256(stableJson(payload))
+    };
+}
+function summarizeResources(resources, diagnostics) {
+    const byKind = {};
+    const bySource = {};
+    for (const resource of resources) {
+        byKind[resource.kind] = (byKind[resource.kind] ?? 0) + 1;
+        bySource[resource.source] = (bySource[resource.source] ?? 0) + 1;
+    }
+    return {
+        by_kind: byKind,
+        by_source: bySource,
+        diagnostics: diagnostics.map((diagnostic) => ({
+            source: diagnostic.source,
+            level: diagnostic.level,
+            message: diagnostic.message
+        }))
+    };
+}
+function snapshotFromRow(row) {
+    return {
+        id: String(row.id),
+        name: row.name == null ? undefined : String(row.name),
+        hash: String(row.hash),
+        createdAt: String(row.created_at),
+        resourceCount: Number(row.resource_count),
+        summary: JSON.parse(String(row.summary))
+    };
+}
+function policyFromRow(row) {
+    return {
+        selector: String(row.selector),
+        mode: row.mode,
+        reason: row.reason == null ? undefined : String(row.reason),
+        updatedAt: String(row.updated_at)
+    };
+}
+export function defaultSnapshotName() {
+    return `${basename(process.cwd())}-${nowIso()}`;
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,90 @@
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
+export interface JsonObject {
+    [key: string]: JsonValue;
+}
+export type ResourceKind = "machine" | "project" | "tmux-session" | "tmux-window" | "tmux-pane" | "process" | "service" | "session" | "browser-state" | "desktop-window" | "diagnostic";
+export interface SnapshotResource {
+    id: string;
+    kind: ResourceKind;
+    name: string;
+    source: string;
+    parentId?: string;
+    attributes: JsonObject;
+    observedAt: string;
+}
+export interface StoredSnapshotResource extends SnapshotResource {
+    hash: string;
+}
+export interface SnapshotRecord {
+    id: string;
+    name?: string;
+    hash: string;
+    createdAt: string;
+    resourceCount: number;
+    summary: JsonObject;
+    duplicateOf?: string;
+}
+export interface CaptureDiagnostic {
+    source: string;
+    level: "info" | "warning" | "error";
+    message: string;
+    detail?: JsonValue;
+}
+export interface CaptureResult {
+    resources: SnapshotResource[];
+    diagnostics: CaptureDiagnostic[];
+}
+export type PolicyMode = "observe" | "restore" | "ignore";
+export interface RestorePolicy {
+    selector: string;
+    mode: PolicyMode;
+    reason?: string;
+    updatedAt: string;
+}
+export type RestoreOperationStatus = "planned" | "noop" | "blocked" | "skipped" | "applied" | "failed";
+export interface RestoreOperation {
+    id: string;
+    kind: string;
+    resourceId: string;
+    resourceKind: ResourceKind;
+    summary: string;
+    status: RestoreOperationStatus;
+    command?: string[];
+    reason?: string;
+    resource?: StoredSnapshotResource;
+}
+export interface RestorePlan {
+    id: string;
+    snapshotId: string;
+    createdAt: string;
+    apply: boolean;
+    operations: RestoreOperation[];
+    summary: {
+        planned: number;
+        noop: number;
+        blocked: number;
+        skipped: number;
+        applied: number;
+        failed: number;
+    };
+}
+export interface StorageOptions {
+    path?: string;
+}
+export interface CaptureOptions {
+    include?: string[];
+    cwd?: string;
+    now?: string;
+}
+export interface SnapshotSaveOptions {
+    id?: string;
+    name?: string;
+    createdAt?: string;
+    diagnostics?: CaptureDiagnostic[];
+}
+export interface RestoreExecutionOptions {
+    apply?: boolean;
+    yes?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}