@nocoo/otter 1.0.0

package/dist/snapshot/builder.js

@@ -0,0 +1,68 @@
+import { randomUUID } from "node:crypto";
+import { execSync } from "node:child_process";
+import { hostname, platform, release, arch, userInfo, homedir } from "node:os";
+/**
+ * Get the user-friendly computer name on macOS via `scutil --get ComputerName`.
+ * Returns undefined on non-macOS platforms or if the command fails.
+ */
+function getComputerName() {
+    if (platform() !== "darwin")
+        return undefined;
+    try {
+        return execSync("scutil --get ComputerName", { encoding: "utf-8" }).trim();
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Gather current machine information for the snapshot.
+ */
+function getMachineInfo() {
+    const user = userInfo();
+    return {
+        hostname: hostname(),
+        computerName: getComputerName(),
+        platform: platform(),
+        osVersion: release(),
+        arch: arch(),
+        username: user.username,
+        homeDir: homedir(),
+        nodeVersion: process.version,
+    };
+}
+/**
+ * Run a single collector, catching any crashes and converting
+ * them into error entries within the result.
+ */
+async function runCollector(collector) {
+    try {
+        return await collector.collect();
+    }
+    catch (err) {
+        return {
+            id: collector.id,
+            label: collector.label,
+            category: collector.category,
+            files: [],
+            lists: [],
+            errors: [`Collector '${collector.id}' crashed: ${err.message}`],
+            durationMs: 0,
+        };
+    }
+}
+/**
+ * Build a complete snapshot by running all provided collectors
+ * and assembling results into the unified Snapshot format.
+ */
+export async function buildSnapshot(collectors) {
+    const results = await Promise.all(collectors.map(runCollector));
+    return {
+        version: 1,
+        createdAt: new Date().toISOString(),
+        id: randomUUID(),
+        machine: getMachineInfo(),
+        collectors: results,
+    };
+}
+//# sourceMappingURL=builder.js.map

package/dist/snapshot/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../src/snapshot/builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAG/E;;;GAGG;AACH,SAAS,eAAe;IACtB,IAAI,QAAQ,EAAE,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC9C,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,2BAA2B,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,cAAc;IACrB,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC;IACxB,OAAO;QACL,QAAQ,EAAE,QAAQ,EAAE;QACpB,YAAY,EAAE,eAAe,EAAE;QAC/B,QAAQ,EAAE,QAAQ,EAAE;QACpB,SAAS,EAAE,OAAO,EAAE;QACpB,IAAI,EAAE,IAAI,EAAE;QACZ,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,OAAO,EAAE,OAAO,EAAE;QAClB,WAAW,EAAE,OAAO,CAAC,OAAO;KAC7B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,YAAY,CAAC,SAAoB;IAC9C,IAAI,CAAC;QACH,OAAO,MAAM,SAAS,CAAC,OAAO,EAAE,CAAC;IACnC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,SAAS,CAAC,EAAE;YAChB,KAAK,EAAE,SAAS,CAAC,KAAK;YACtB,QAAQ,EAAE,SAAS,CAAC,QAAQ;YAC5B,KAAK,EAAE,EAAE;YACT,KAAK,EAAE,EAAE;YACT,MAAM,EAAE,CAAC,cAAc,SAAS,CAAC,EAAE,cAAe,GAAa,CAAC,OAAO,EAAE,CAAC;YAC1E,UAAU,EAAE,CAAC;SACd,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,UAAuB;IAEvB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;IAEhE,OAAO;QACL,OAAO,EAAE,CAAC;QACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,EAAE,EAAE,UAAU,EAAE;QAChB,OAAO,EAAE,cAAc,EAAE;QACzB,UAAU,EAAE,OAAO;KACpB,CAAC;AACJ,CAAC"}

package/dist/storage/local.d.ts

@@ -0,0 +1,44 @@
+import type { Snapshot } from "@otter/core";
+/** Metadata for a locally-stored snapshot (without loading full content) */
+export interface SnapshotMeta {
+    /** Full UUID */
+    id: string;
+    /** First 8 characters of UUID — used as short reference */
+    shortId: string;
+    /** ISO 8601 creation timestamp */
+    createdAt: string;
+    /** Filename on disk */
+    filename: string;
+    /** File size in bytes */
+    sizeBytes: number;
+    /** Number of collectors in the snapshot */
+    collectorCount: number;
+    /** Total collected files across all collectors */
+    fileCount: number;
+    /** Total list items across all collectors */
+    listCount: number;
+}
+/**
+ * Local snapshot storage manager.
+ * Persists snapshots as JSON files in a dedicated directory.
+ */
+export declare class SnapshotStore {
+    private readonly storageDir;
+    constructor(storageDir: string);
+    /**
+     * Save a snapshot to local storage.
+     * Creates the storage directory if it doesn't exist.
+     * @returns The filename of the saved snapshot.
+     */
+    save(snapshot: Snapshot): Promise<string>;
+    /**
+     * List all locally-stored snapshots, sorted by creation date (newest first).
+     */
+    list(): Promise<SnapshotMeta[]>;
+    /**
+     * Load a snapshot by its short ID prefix (first 8 chars of UUID).
+     * Returns null if no matching snapshot is found.
+     */
+    load(shortId: string): Promise<Snapshot | null>;
+}
+//# sourceMappingURL=local.d.ts.map

package/dist/storage/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/storage/local.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,4EAA4E;AAC5E,MAAM,WAAW,YAAY;IAC3B,gBAAgB;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,cAAc,EAAE,MAAM,CAAC;IACvB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;CACnB;AAwDD;;;GAGG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,MAAM;IAE/C;;;;OAIG;IACG,IAAI,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ/C;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IA6BrC;;;OAGG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;CAiBtD"}

package/dist/storage/local.js

@@ -0,0 +1,107 @@
+import { readFile, writeFile, readdir, mkdir, stat } from "node:fs/promises";
+import { join } from "node:path";
+/**
+ * Convert an ISO 8601 timestamp to a filesystem-safe string.
+ * Replaces colons with dashes to avoid issues on Windows.
+ * Example: "2026-03-06T12:30:00.000Z" → "2026-03-06T12-30-00"
+ */
+function toFileTimestamp(iso) {
+    return iso.replace(/:/g, "-").replace(/\.\d{3}Z$/, "");
+}
+/**
+ * Build the snapshot filename from its metadata.
+ * Format: `{timestamp}_{shortId}.json`
+ */
+function buildFilename(snapshot) {
+    const ts = toFileTimestamp(snapshot.createdAt);
+    const shortId = snapshot.id.slice(0, 8);
+    return `${ts}_${shortId}.json`;
+}
+/**
+ * Parse snapshot metadata from a stored JSON file without loading
+ * the full collector content into memory. Reads only what's needed.
+ */
+async function parseMetaFromFile(filePath, filename) {
+    try {
+        const info = await stat(filePath);
+        const raw = await readFile(filePath, "utf-8");
+        const snapshot = JSON.parse(raw);
+        return {
+            id: snapshot.id,
+            shortId: snapshot.id.slice(0, 8),
+            createdAt: snapshot.createdAt,
+            filename,
+            sizeBytes: info.size,
+            collectorCount: snapshot.collectors.length,
+            fileCount: snapshot.collectors.reduce((sum, c) => sum + c.files.length, 0),
+            listCount: snapshot.collectors.reduce((sum, c) => sum + c.lists.length, 0),
+        };
+    }
+    catch {
+        // Corrupt or unreadable file — skip it
+        return null;
+    }
+}
+/**
+ * Local snapshot storage manager.
+ * Persists snapshots as JSON files in a dedicated directory.
+ */
+export class SnapshotStore {
+    storageDir;
+    constructor(storageDir) {
+        this.storageDir = storageDir;
+    }
+    /**
+     * Save a snapshot to local storage.
+     * Creates the storage directory if it doesn't exist.
+     * @returns The filename of the saved snapshot.
+     */
+    async save(snapshot) {
+        await mkdir(this.storageDir, { recursive: true });
+        const filename = buildFilename(snapshot);
+        const filePath = join(this.storageDir, filename);
+        await writeFile(filePath, JSON.stringify(snapshot, null, 2) + "\n");
+        return filename;
+    }
+    /**
+     * List all locally-stored snapshots, sorted by creation date (newest first).
+     */
+    async list() {
+        let entries;
+        try {
+            entries = await readdir(this.storageDir);
+        }
+        catch {
+            // Directory doesn't exist yet — no snapshots stored
+            return [];
+        }
+        const jsonFiles = entries.filter((f) => f.endsWith(".json"));
+        const metas = [];
+        for (const filename of jsonFiles) {
+            const meta = await parseMetaFromFile(join(this.storageDir, filename), filename);
+            if (meta)
+                metas.push(meta);
+        }
+        // Sort newest first
+        metas.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+        return metas;
+    }
+    /**
+     * Load a snapshot by its short ID prefix (first 8 chars of UUID).
+     * Returns null if no matching snapshot is found.
+     */
+    async load(shortId) {
+        const metas = await this.list();
+        const match = metas.find((m) => m.shortId === shortId || m.id === shortId);
+        if (!match)
+            return null;
+        try {
+            const raw = await readFile(join(this.storageDir, match.filename), "utf-8");
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=local.js.map

package/dist/storage/local.js.map

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

package/dist/uploader/icons.d.ts

@@ -0,0 +1,41 @@
+/** Configuration for icon uploads to R2 */
+export interface IconUploadConfig {
+    r2Endpoint: string;
+    r2AccessKeyId: string;
+    r2SecretAccessKey: string;
+    r2Bucket: string;
+    /** Public domain for the R2 bucket (e.g. "https://s.zhe.to") */
+    r2PublicDomain: string;
+    /** R2 key prefix (default: "apps/otter") */
+    prefix?: string;
+}
+/** Result of uploading a single icon */
+export interface IconUploadResult {
+    appName: string;
+    key: string;
+    publicUrl: string;
+    /** Whether the file was actually uploaded (false = already existed) */
+    uploaded: boolean;
+}
+/**
+ * Generate a deterministic hash from an app name.
+ * Returns the first 12 hex chars of SHA-256(appName).
+ */
+export declare function hashAppName(appName: string): string;
+/** Reset the cached S3 client (for testing). */
+export declare function resetIconUploadClient(): void;
+/**
+ * Upload a single icon PNG to R2.
+ * Key format: {prefix}/{hash}.png
+ * Skips upload if the object already exists (same app name = same key).
+ */
+export declare function uploadIcon(pngPath: string, appName: string, config: IconUploadConfig): Promise<IconUploadResult>;
+/**
+ * Upload multiple icon PNGs to R2 in sequence.
+ * Returns results for all successful exports.
+ */
+export declare function uploadIcons(icons: Array<{
+    appName: string;
+    pngPath: string;
+}>, config: IconUploadConfig, onProgress?: (result: IconUploadResult) => void): Promise<IconUploadResult[]>;
+//# sourceMappingURL=icons.d.ts.map

package/dist/uploader/icons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../src/uploader/icons.ts"],"names":[],"mappings":"AAIA,2CAA2C;AAC3C,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,cAAc,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wCAAwC;AACxC,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAiBD,gDAAgD;AAChD,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAkBD;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,gBAAgB,CAAC,CA2B3B;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,EAClD,MAAM,EAAE,gBAAgB,EACxB,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,GAC9C,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAU7B"}

package/dist/uploader/icons.js

@@ -0,0 +1,80 @@
+import { createHash } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import { S3Client, PutObjectCommand, HeadObjectCommand } from "@aws-sdk/client-s3";
+/**
+ * Generate a deterministic hash from an app name.
+ * Returns the first 12 hex chars of SHA-256(appName).
+ */
+export function hashAppName(appName) {
+    return createHash("sha256").update(appName).digest("hex").slice(0, 12);
+}
+let _client = null;
+function getClient(config) {
+    if (_client)
+        return _client;
+    _client = new S3Client({
+        region: "auto",
+        endpoint: config.r2Endpoint,
+        credentials: {
+            accessKeyId: config.r2AccessKeyId,
+            secretAccessKey: config.r2SecretAccessKey,
+        },
+    });
+    return _client;
+}
+/** Reset the cached S3 client (for testing). */
+export function resetIconUploadClient() {
+    _client = null;
+}
+/**
+ * Check if an object already exists in R2.
+ */
+async function objectExists(client, bucket, key) {
+    try {
+        await client.send(new HeadObjectCommand({ Bucket: bucket, Key: key }));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Upload a single icon PNG to R2.
+ * Key format: {prefix}/{hash}.png
+ * Skips upload if the object already exists (same app name = same key).
+ */
+export async function uploadIcon(pngPath, appName, config) {
+    const prefix = config.prefix ?? "apps/otter";
+    const hash = hashAppName(appName);
+    const key = `${prefix}/${hash}.png`;
+    const publicUrl = `${config.r2PublicDomain}/${key}`;
+    const client = getClient(config);
+    // Skip if already uploaded (same app name = same hash = same key)
+    const exists = await objectExists(client, config.r2Bucket, key);
+    if (exists) {
+        return { appName, key, publicUrl, uploaded: false };
+    }
+    const body = await readFile(pngPath);
+    await client.send(new PutObjectCommand({
+        Bucket: config.r2Bucket,
+        Key: key,
+        Body: body,
+        ContentType: "image/png",
+        CacheControl: "public, max-age=31536000, immutable",
+    }));
+    return { appName, key, publicUrl, uploaded: true };
+}
+/**
+ * Upload multiple icon PNGs to R2 in sequence.
+ * Returns results for all successful exports.
+ */
+export async function uploadIcons(icons, config, onProgress) {
+    const results = [];
+    for (const { appName, pngPath } of icons) {
+        const result = await uploadIcon(pngPath, appName, config);
+        results.push(result);
+        onProgress?.(result);
+    }
+    return results;
+}
+//# sourceMappingURL=icons.js.map

package/dist/uploader/icons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.js","sourceRoot":"","sources":["../../src/uploader/icons.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAuBnF;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACzE,CAAC;AAED,IAAI,OAAO,GAAoB,IAAI,CAAC;AAEpC,SAAS,SAAS,CAAC,MAAwB;IACzC,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAC5B,OAAO,GAAG,IAAI,QAAQ,CAAC;QACrB,MAAM,EAAE,MAAM;QACd,QAAQ,EAAE,MAAM,CAAC,UAAU;QAC3B,WAAW,EAAE;YACX,WAAW,EAAE,MAAM,CAAC,aAAa;YACjC,eAAe,EAAE,MAAM,CAAC,iBAAiB;SAC1C;KACF,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,qBAAqB;IACnC,OAAO,GAAG,IAAI,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,YAAY,CACzB,MAAgB,EAChB,MAAc,EACd,GAAW;IAEX,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,iBAAiB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QACvE,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,OAAe,EACf,OAAe,EACf,MAAwB;IAExB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,YAAY,CAAC;IAC7C,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,GAAG,MAAM,IAAI,IAAI,MAAM,CAAC;IACpC,MAAM,SAAS,GAAG,GAAG,MAAM,CAAC,cAAc,IAAI,GAAG,EAAE,CAAC;IAEpD,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAEjC,kEAAkE;IAClE,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAChE,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IACtD,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;IAErC,MAAM,MAAM,CAAC,IAAI,CACf,IAAI,gBAAgB,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC,QAAQ;QACvB,GAAG,EAAE,GAAG;QACR,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,WAAW;QACxB,YAAY,EAAE,qCAAqC;KACpD,CAAC,CACH,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAkD,EAClD,MAAwB,EACxB,UAA+C;IAE/C,MAAM,OAAO,GAAuB,EAAE,CAAC;IAEvC,KAAK,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,KAAK,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1D,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,UAAU,EAAE,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/uploader/webhook.d.ts

@@ -0,0 +1,7 @@
+import type { Snapshot, UploaderConfig, UploadResult } from "@otter/core";
+/**
+ * Upload a snapshot to the configured webhook URL via HTTP POST.
+ * The payload is gzip-compressed to reduce transfer size.
+ */
+export declare function uploadSnapshot(snapshot: Snapshot, config: UploaderConfig): Promise<UploadResult>;
+//# sourceMappingURL=webhook.d.ts.map

package/dist/uploader/webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../src/uploader/webhook.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI1E;;;GAGG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,YAAY,CAAC,CAoDvB"}

package/dist/uploader/webhook.js

@@ -0,0 +1,54 @@
+import { gzipSync } from "node:zlib";
+const DEFAULT_TIMEOUT_MS = 30_000;
+/**
+ * Upload a snapshot to the configured webhook URL via HTTP POST.
+ * The payload is gzip-compressed to reduce transfer size.
+ */
+export async function uploadSnapshot(snapshot, config) {
+    const timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    const start = performance.now();
+    try {
+        const jsonBody = JSON.stringify(snapshot);
+        const compressed = gzipSync(jsonBody);
+        const response = await fetch(config.webhookUrl, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "Content-Encoding": "gzip",
+            },
+            body: compressed,
+            signal: controller.signal,
+        });
+        const durationMs = Math.round(performance.now() - start);
+        if (response.ok) {
+            return {
+                success: true,
+                statusCode: response.status,
+                durationMs,
+            };
+        }
+        return {
+            success: false,
+            statusCode: response.status,
+            error: `Upload failed with status ${response.status} ${response.statusText}`,
+            durationMs,
+        };
+    }
+    catch (err) {
+        const durationMs = Math.round(performance.now() - start);
+        const message = err instanceof DOMException && err.name === "AbortError"
+            ? `Upload timed out after ${timeoutMs}ms`
+            : err.message;
+        return {
+            success: false,
+            error: message,
+            durationMs,
+        };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=webhook.js.map

package/dist/uploader/webhook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.js","sourceRoot":"","sources":["../../src/uploader/webhook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGrC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAAkB,EAClB,MAAsB;IAEtB,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,kBAAkB,CAAC;IACzD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;IAE9D,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAEhC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC1C,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAEtC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,UAAU,EAAE;YAC9C,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,kBAAkB,EAAE,MAAM;aAC3B;YACD,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;QAEH,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;QAEzD,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;YAChB,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,UAAU,EAAE,QAAQ,CAAC,MAAM;gBAC3B,UAAU;aACX,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,KAAK;YACd,UAAU,EAAE,QAAQ,CAAC,MAAM;YAC3B,KAAK,EAAE,6BAA6B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE;YAC5E,UAAU;SACX,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;QACzD,MAAM,OAAO,GACX,GAAG,YAAY,YAAY,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY;YACtD,CAAC,CAAC,0BAA0B,SAAS,IAAI;YACzC,CAAC,CAAE,GAAa,CAAC,OAAO,CAAC;QAE7B,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;YACd,UAAU;SACX,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC"}

package/dist/utils/icons.d.ts

@@ -0,0 +1,34 @@
+/** Result of extracting a single app icon */
+export interface IconExportResult {
+    /** App name (without .app) */
+    appName: string;
+    /** Whether the icon was exported successfully */
+    success: boolean;
+    /** Output PNG path (when successful) */
+    outputPath?: string;
+    /** Error message (when failed) */
+    error?: string;
+}
+/** Options for the export-icons operation */
+export interface ExportIconsOptions {
+    /** Applications directory (default: /Applications) */
+    appsDir?: string;
+    /** Output directory for PNG icons */
+    outputDir: string;
+    /** Icon width in pixels (default: 128) */
+    size?: number;
+    /** Called after each icon is processed */
+    onProgress?: (result: IconExportResult) => void;
+}
+/**
+ * Extract CFBundleIconFile from an XML Info.plist.
+ * Uses simple regex to avoid needing an XML parser dependency.
+ * Exported for testing.
+ */
+export declare function extractIconFileName(plistContent: string): string | null;
+/**
+ * Export app icons from /Applications as PNG files to a target directory.
+ * Uses macOS `sips` for conversion (no external dependencies).
+ */
+export declare function exportIcons(options: ExportIconsOptions): Promise<IconExportResult[]>;
+//# sourceMappingURL=icons.d.ts.map

package/dist/utils/icons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../src/utils/icons.ts"],"names":[],"mappings":"AAQA,6CAA6C;AAC7C,MAAM,WAAW,gBAAgB;IAC/B,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,OAAO,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,6CAA6C;AAC7C,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACjD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAavE;AA2CD;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,gBAAgB,EAAE,CAAC,CA8D7B"}

package/dist/utils/icons.js

@@ -0,0 +1,113 @@
+import { readdir, readFile, mkdir, access } from "node:fs/promises";
+import { join } from "node:path";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+/**
+ * Extract CFBundleIconFile from an XML Info.plist.
+ * Uses simple regex to avoid needing an XML parser dependency.
+ * Exported for testing.
+ */
+export function extractIconFileName(plistContent) {
+    // Match <key>CFBundleIconFile</key> followed by <string>value</string>
+    const pattern = /<key>CFBundleIconFile<\/key>\s*<string>([^<]+)<\/string>/;
+    const match = plistContent.match(pattern);
+    if (!match)
+        return null;
+    let iconFile = match[1].trim();
+    // Ensure .icns extension (some plists omit it)
+    if (!iconFile.endsWith(".icns")) {
+        iconFile += ".icns";
+    }
+    return iconFile;
+}
+/**
+ * Resolve the .icns file path for a given .app bundle.
+ * Returns null if the icon cannot be found.
+ */
+async function resolveIconPath(appPath) {
+    const plistPath = join(appPath, "Contents", "Info.plist");
+    try {
+        const plistContent = await readFile(plistPath, "utf-8");
+        const iconFile = extractIconFileName(plistContent);
+        if (!iconFile)
+            return null;
+        const iconPath = join(appPath, "Contents", "Resources", iconFile);
+        await access(iconPath);
+        return iconPath;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Convert a .icns file to .png using macOS built-in sips.
+ * Returns the output path on success, or throws on failure.
+ */
+async function convertIcnsToPng(icnsPath, outputPath, size) {
+    await execFileAsync("/usr/bin/sips", [
+        "-s",
+        "format",
+        "png",
+        "--resampleWidth",
+        String(size),
+        icnsPath,
+        "--out",
+        outputPath,
+    ]);
+}
+/**
+ * Export app icons from /Applications as PNG files to a target directory.
+ * Uses macOS `sips` for conversion (no external dependencies).
+ */
+export async function exportIcons(options) {
+    const { appsDir = "/Applications", outputDir, size = 128, onProgress, } = options;
+    // Ensure output directory exists
+    await mkdir(outputDir, { recursive: true });
+    const results = [];
+    let entries;
+    try {
+        entries = await readdir(appsDir, { withFileTypes: true });
+    }
+    catch {
+        return results;
+    }
+    const apps = entries.filter((e) => e.isDirectory() && e.name.endsWith(".app"));
+    for (const app of apps) {
+        const appName = app.name.replace(/\.app$/, "");
+        const appPath = join(appsDir, app.name);
+        const icnsPath = await resolveIconPath(appPath);
+        if (!icnsPath) {
+            const result = {
+                appName,
+                success: false,
+                error: "No icon found in Info.plist",
+            };
+            results.push(result);
+            onProgress?.(result);
+            continue;
+        }
+        const outputPath = join(outputDir, `${appName}.png`);
+        try {
+            await convertIcnsToPng(icnsPath, outputPath, size);
+            const result = {
+                appName,
+                success: true,
+                outputPath,
+            };
+            results.push(result);
+            onProgress?.(result);
+        }
+        catch (err) {
+            const result = {
+                appName,
+                success: false,
+                error: `sips conversion failed: ${err.message}`,
+            };
+            results.push(result);
+            onProgress?.(result);
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=icons.js.map

package/dist/utils/icons.js.map

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

package/dist/utils/redact.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Credential redaction utilities.
+ *
+ * Strips sensitive values from file content before including
+ * them in snapshots. Works on both structured (JSON) and
+ * line-oriented (ini-like) config formats.
+ */
+/**
+ * Redact sensitive values in a JSON string.
+ * Returns the original string if no redaction was needed or parsing fails.
+ */
+export declare function redactJsonSecrets(jsonContent: string): string;
+/**
+ * Redact sensitive lines in ini-style / line-oriented config files.
+ * Each matching line has its value portion replaced with [REDACTED].
+ */
+export declare function redactLineSecrets(content: string): string;
+/**
+ * Redact sensitive variable assignments in shell scripts.
+ * Catches patterns like:
+ *   export MY_API_KEY="sk-..."
+ *   GITHUB_TOKEN=ghp_xxx
+ *   export Z_AI_API_KEY="..."
+ */
+export declare function redactShellSecrets(content: string): string;
+/**
+ * Redact credential-like values in JSONL content (one JSON object per line).
+ * Applies both key-based (sensitive key names) and value-based (credential
+ * patterns like JWTs, API keys, bearer tokens) redaction.
+ */
+export declare function redactJsonlSecrets(content: string): string;
+/**
+ * Redact credentials from file content.
+ * Auto-detects format based on file path extension or filename.
+ *
+ * @param content  Raw file content
+ * @param filePath File path (used to determine format)
+ * @returns Content with sensitive values replaced by [REDACTED]
+ */
+export declare function redactSecrets(content: string, filePath: string): string;
+//# sourceMappingURL=redact.d.ts.map

package/dist/utils/redact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../src/utils/redact.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2DH;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAW7D;AAiDD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAazD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAiB1D;AA8FD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA2B1D;AAMD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CA8BvE"}