@nocoo/otter 1.0.0

package/dist/bin.d.ts

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

package/dist/bin.d.ts.map

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

package/dist/bin.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { runMain } from "citty";
+import { main } from "./cli.js";
+runMain(main);
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+export declare const main: import("citty").CommandDef<import("citty").ArgsDef>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AA2ZA,eAAO,MAAM,IAAI,qDAcf,CAAC"}

package/dist/cli.js

@@ -0,0 +1,365 @@
+import { defineCommand } from "citty";
+import { consola } from "consola";
+import pc from "picocolors";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { createDefaultCollectors } from "./collectors/index.js";
+import { executeScan } from "./commands/scan.js";
+import { executeConfig } from "./commands/config.js";
+import { formatSnapshotList, formatSnapshotDetail, diffSnapshots, formatSnapshotDiff } from "./commands/snapshot.js";
+import { ConfigManager } from "./config/manager.js";
+import { SnapshotStore } from "./storage/local.js";
+import { uploadSnapshot } from "./uploader/webhook.js";
+import { uploadIcons } from "./uploader/icons.js";
+import { exportIcons } from "./utils/icons.js";
+const otterConfigDir = join(homedir(), ".config", "otter");
+const configManager = new ConfigManager(otterConfigDir);
+const snapshotStore = new SnapshotStore(join(otterConfigDir, "snapshots"));
+const scanCommand = defineCommand({
+    meta: {
+        name: "scan",
+        description: "Scan and collect configuration files and environment data",
+    },
+    args: {
+        json: {
+            type: "boolean",
+            description: "Output snapshot as JSON to stdout",
+            default: false,
+        },
+        slim: {
+            type: "boolean",
+            description: "Exclude behavior data (history.jsonl, session summaries) for a smaller snapshot",
+            default: false,
+        },
+        save: {
+            type: "boolean",
+            description: "Save the snapshot locally after scanning",
+            default: false,
+        },
+    },
+    async run({ args }) {
+        // When --json is set, redirect all progress output to stderr
+        // so that stdout contains only valid JSON
+        if (args.json) {
+            consola.options.stdout = process.stderr;
+        }
+        consola.start("Scanning your Mac environment...\n");
+        const collectors = createDefaultCollectors(homedir(), {
+            slim: args.slim,
+        });
+        const snapshot = await executeScan(collectors, {
+            onProgress: (_id, result) => {
+                const fileCount = result.files.length;
+                const listCount = result.lists.length;
+                const errorCount = result.errors.length;
+                const status = errorCount > 0 ? pc.yellow("⚠") : pc.green("✓");
+                consola.log(`  ${status} ${pc.bold(result.label)}: ${fileCount} files, ${listCount} list items${errorCount > 0 ? `, ${pc.yellow(`${errorCount} errors`)}` : ""} ${pc.dim(`(${result.durationMs}ms)`)}`);
+            },
+        });
+        if (args.save) {
+            const filename = await snapshotStore.save(snapshot);
+            consola.success(`Snapshot saved locally: ${pc.dim(filename)}`);
+        }
+        if (args.json) {
+            process.stdout.write(JSON.stringify(snapshot, null, 2) + "\n");
+        }
+        else {
+            const totalFiles = snapshot.collectors.reduce((sum, c) => sum + c.files.length, 0);
+            const totalLists = snapshot.collectors.reduce((sum, c) => sum + c.lists.length, 0);
+            consola.success(`\nScan complete: ${pc.bold(String(totalFiles))} files, ${pc.bold(String(totalLists))} list items from ${pc.bold(String(snapshot.collectors.length))} collectors`);
+            consola.info(`Snapshot ID: ${pc.dim(snapshot.id)}`);
+        }
+    },
+});
+const backupCommand = defineCommand({
+    meta: {
+        name: "backup",
+        description: "Scan, build snapshot, and upload to webhook",
+    },
+    args: {
+        slim: {
+            type: "boolean",
+            description: "Exclude behavior data (history.jsonl, session summaries) for a smaller snapshot",
+            default: false,
+        },
+    },
+    async run({ args }) {
+        const config = await configManager.load();
+        if (!config.webhookUrl) {
+            consola.error("No webhook URL configured. Run " +
+                pc.bold("otter config set webhookUrl <url>") +
+                " first.");
+            process.exitCode = 1;
+            return;
+        }
+        consola.start("Scanning your Mac environment...\n");
+        const collectors = createDefaultCollectors(homedir(), {
+            slim: args.slim,
+        });
+        const snapshot = await executeScan(collectors, {
+            onProgress: (_id, result) => {
+                const status = result.errors.length > 0 ? pc.yellow("⚠") : pc.green("✓");
+                consola.log(`  ${status} ${pc.bold(result.label)} ${pc.dim(`(${result.durationMs}ms)`)}`);
+            },
+        });
+        consola.start("\nUploading snapshot...");
+        const uploadResult = await uploadSnapshot(snapshot, {
+            webhookUrl: config.webhookUrl,
+        });
+        if (uploadResult.success) {
+            consola.success(`Backup uploaded successfully ${pc.dim(`(${uploadResult.durationMs}ms)`)}`);
+            // Auto-save locally after successful upload
+            const filename = await snapshotStore.save(snapshot);
+            consola.success(`Snapshot saved locally: ${pc.dim(filename)}`);
+            consola.info(`Snapshot ID: ${pc.dim(snapshot.id)}`);
+        }
+        else {
+            consola.error(`Upload failed: ${uploadResult.error}`);
+            process.exitCode = 1;
+        }
+    },
+});
+const configCommand = defineCommand({
+    meta: {
+        name: "config",
+        description: "Manage CLI configuration",
+    },
+    args: {
+        action: {
+            type: "positional",
+            description: "Action: get, set, or show",
+            required: false,
+        },
+        key: {
+            type: "positional",
+            description: "Config key (e.g., webhookUrl)",
+            required: false,
+        },
+        value: {
+            type: "positional",
+            description: "Value to set",
+            required: false,
+        },
+    },
+    async run({ args }) {
+        const action = args.action || "show";
+        if (action === "show") {
+            const result = await executeConfig(configManager, { action: "show" });
+            consola.info("Current configuration:");
+            consola.log(JSON.stringify(result, null, 2));
+            consola.log(pc.dim(`\nConfig file: ${configManager.configPath}`));
+            return;
+        }
+        if (action === "get") {
+            if (!args.key) {
+                consola.error("Usage: otter config get <key>");
+                process.exitCode = 1;
+                return;
+            }
+            const result = await executeConfig(configManager, {
+                action: "get",
+                key: args.key,
+            });
+            if (result !== undefined) {
+                consola.log(result);
+            }
+            else {
+                consola.warn(`Key '${args.key}' is not set`);
+            }
+            return;
+        }
+        if (action === "set") {
+            if (!args.key || !args.value) {
+                consola.error("Usage: otter config set <key> <value>");
+                process.exitCode = 1;
+                return;
+            }
+            await executeConfig(configManager, {
+                action: "set",
+                key: args.key,
+                value: args.value,
+            });
+            consola.success(`Set ${pc.bold(args.key)} = ${args.value}`);
+            return;
+        }
+        consola.error(`Unknown action: ${action}. Use get, set, or show.`);
+        process.exitCode = 1;
+    },
+});
+const snapshotListCommand = defineCommand({
+    meta: {
+        name: "list",
+        description: "List locally-saved snapshots",
+    },
+    async run() {
+        const metas = await snapshotStore.list();
+        consola.log(formatSnapshotList(metas));
+    },
+});
+const snapshotShowCommand = defineCommand({
+    meta: {
+        name: "show",
+        description: "Show details of a saved snapshot",
+    },
+    args: {
+        id: {
+            type: "positional",
+            description: "Short ID (first 8 chars) or full UUID of the snapshot",
+            required: true,
+        },
+    },
+    async run({ args }) {
+        const snapshot = await snapshotStore.load(args.id);
+        if (!snapshot) {
+            consola.error(`Snapshot not found: ${pc.bold(args.id)}`);
+            process.exitCode = 1;
+            return;
+        }
+        consola.log(formatSnapshotDetail(snapshot));
+    },
+});
+const snapshotDiffCommand = defineCommand({
+    meta: {
+        name: "diff",
+        description: "Compare two snapshots (file + list level)",
+    },
+    args: {
+        id1: {
+            type: "positional",
+            description: "Short ID of the older snapshot",
+            required: true,
+        },
+        id2: {
+            type: "positional",
+            description: "Short ID of the newer snapshot",
+            required: true,
+        },
+    },
+    async run({ args }) {
+        const oldSnap = await snapshotStore.load(args.id1);
+        if (!oldSnap) {
+            consola.error(`Snapshot not found: ${pc.bold(args.id1)}`);
+            process.exitCode = 1;
+            return;
+        }
+        const newSnap = await snapshotStore.load(args.id2);
+        if (!newSnap) {
+            consola.error(`Snapshot not found: ${pc.bold(args.id2)}`);
+            process.exitCode = 1;
+            return;
+        }
+        const diff = diffSnapshots(oldSnap, newSnap);
+        consola.log(formatSnapshotDiff(diff));
+    },
+});
+const snapshotCommand = defineCommand({
+    meta: {
+        name: "snapshot",
+        description: "Manage locally-saved snapshots",
+    },
+    subCommands: {
+        list: snapshotListCommand,
+        show: snapshotShowCommand,
+        diff: snapshotDiffCommand,
+    },
+});
+const exportIconsCommand = defineCommand({
+    meta: {
+        name: "export-icons",
+        description: "Export application icons as PNG files",
+    },
+    args: {
+        output: {
+            type: "string",
+            description: "Output directory for PNG icons",
+            alias: "o",
+            required: false,
+        },
+        size: {
+            type: "string",
+            description: "Icon size in pixels (default: 128)",
+            alias: "s",
+            required: false,
+        },
+        upload: {
+            type: "boolean",
+            description: "Upload icons to R2 after export",
+            alias: "u",
+            required: false,
+        },
+    },
+    async run({ args }) {
+        const outputDir = args.output || join(homedir(), ".otter", "icons");
+        const size = parseInt(args.size || "128", 10);
+        consola.start(`Exporting app icons to ${pc.bold(outputDir)}...\n`);
+        const results = await exportIcons({
+            outputDir,
+            size,
+            onProgress: (result) => {
+                if (result.success) {
+                    consola.log(`  ${pc.green("✓")} ${result.appName}`);
+                }
+                else {
+                    consola.log(`  ${pc.yellow("⚠")} ${result.appName}: ${pc.dim(result.error ?? "unknown error")}`);
+                }
+            },
+        });
+        const succeeded = results.filter((r) => r.success).length;
+        const failed = results.filter((r) => !r.success).length;
+        consola.success(`\nExported ${pc.bold(String(succeeded))} icons` +
+            (failed > 0 ? ` (${pc.yellow(String(failed))} skipped)` : ""));
+        consola.info(`Output: ${pc.dim(outputDir)}`);
+        // Upload to R2 if requested
+        if (args.upload) {
+            const config = await configManager.load();
+            const r2Endpoint = config.iconR2Endpoint;
+            const r2AccessKeyId = config.iconR2AccessKeyId;
+            const r2SecretAccessKey = config.iconR2SecretAccessKey;
+            const r2Bucket = config.iconR2Bucket;
+            const r2PublicDomain = config.iconR2PublicDomain;
+            if (!r2Endpoint || !r2AccessKeyId || !r2SecretAccessKey || !r2Bucket || !r2PublicDomain) {
+                consola.error("R2 icon upload config not set. Run:\n" +
+                    `  otter config set iconR2Endpoint <endpoint>\n` +
+                    `  otter config set iconR2AccessKeyId <key>\n` +
+                    `  otter config set iconR2SecretAccessKey <secret>\n` +
+                    `  otter config set iconR2Bucket <bucket>\n` +
+                    `  otter config set iconR2PublicDomain <domain>`);
+                process.exit(1);
+            }
+            const uploadConfig = {
+                r2Endpoint,
+                r2AccessKeyId,
+                r2SecretAccessKey,
+                r2Bucket,
+                r2PublicDomain,
+            };
+            const exportedIcons = results
+                .filter((r) => r.success && r.outputPath)
+                .map((r) => ({ appName: r.appName, pngPath: r.outputPath }));
+            consola.start(`\nUploading ${pc.bold(String(exportedIcons.length))} icons to R2...\n`);
+            const uploadResults = await uploadIcons(exportedIcons, uploadConfig, (result) => {
+                const status = result.uploaded ? pc.green("↑") : pc.dim("=");
+                consola.log(`  ${status} ${result.appName} ${pc.dim(result.publicUrl)}`);
+            });
+            const uploaded = uploadResults.filter((r) => r.uploaded).length;
+            const skipped = uploadResults.filter((r) => !r.uploaded).length;
+            consola.success(`Uploaded ${pc.bold(String(uploaded))} icons` +
+                (skipped > 0 ? ` (${pc.dim(String(skipped))} unchanged)` : ""));
+        }
+    },
+});
+export const main = defineCommand({
+    meta: {
+        name: "otter",
+        version: "1.0.0",
+        description: "Backup and restore your Mac development environment configuration",
+    },
+    subCommands: {
+        scan: scanCommand,
+        backup: backupCommand,
+        config: configCommand,
+        snapshot: snapshotCommand,
+        "export-icons": exportIconsCommand,
+    },
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/collectors/applications.d.ts

@@ -0,0 +1,19 @@
+import { BaseCollector } from "./base.js";
+import type { CollectorCategory, CollectorResult } from "@otter/core";
+/**
+ * Collects a list of installed applications from the Applications directory.
+ * List-only: no binary content is collected.
+ *
+ * When `iconBaseUrl` is provided, each item includes `meta.iconUrl` pointing
+ * to a deterministic R2 URL (SHA-256 hash of app name).
+ */
+export declare class ApplicationsCollector extends BaseCollector {
+    private readonly appsDir;
+    private readonly iconBaseUrl?;
+    constructor(homeDir: string, appsDir?: string, iconBaseUrl?: string | undefined);
+    readonly id = "applications";
+    readonly label = "Installed Applications";
+    readonly category: CollectorCategory;
+    collect(): Promise<CollectorResult>;
+}
+//# sourceMappingURL=applications.d.ts.map

package/dist/collectors/applications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applications.d.ts","sourceRoot":"","sources":["../../src/collectors/applications.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EAEhB,MAAM,aAAa,CAAC;AAQrB;;;;;;GAMG;AACH,qBAAa,qBAAsB,SAAQ,aAAa;IAGpD,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;gBAF7B,OAAO,EAAE,MAAM,EACE,OAAO,GAAE,MAAwB,EACjC,WAAW,CAAC,EAAE,MAAM,YAAA;IAKvC,QAAQ,CAAC,EAAE,kBAAkB;IAC7B,QAAQ,CAAC,KAAK,4BAA4B;IAC1C,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAiB;IAE/C,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC;CA0B1C"}

package/dist/collectors/applications.js

@@ -0,0 +1,51 @@
+import { createHash } from "node:crypto";
+import { readdir } from "node:fs/promises";
+import { BaseCollector } from "./base.js";
+/** Generate a deterministic icon URL from an app name and base URL */
+function iconUrl(appName, baseUrl) {
+    const hash = createHash("sha256").update(appName).digest("hex").slice(0, 12);
+    return `${baseUrl}/${hash}.png`;
+}
+/**
+ * Collects a list of installed applications from the Applications directory.
+ * List-only: no binary content is collected.
+ *
+ * When `iconBaseUrl` is provided, each item includes `meta.iconUrl` pointing
+ * to a deterministic R2 URL (SHA-256 hash of app name).
+ */
+export class ApplicationsCollector extends BaseCollector {
+    appsDir;
+    iconBaseUrl;
+    constructor(homeDir, appsDir = "/Applications", iconBaseUrl) {
+        super(homeDir);
+        this.appsDir = appsDir;
+        this.iconBaseUrl = iconBaseUrl;
+    }
+    id = "applications";
+    label = "Installed Applications";
+    category = "environment";
+    async collect() {
+        return this.timed(async (result) => {
+            try {
+                const entries = await readdir(this.appsDir, { withFileTypes: true });
+                const apps = entries
+                    .filter((entry) => entry.isDirectory() && entry.name.endsWith(".app"))
+                    .map((entry) => {
+                    const name = entry.name.replace(/\.app$/, "");
+                    const item = { name };
+                    if (this.iconBaseUrl) {
+                        item.meta = { iconUrl: iconUrl(name, this.iconBaseUrl) };
+                    }
+                    return item;
+                });
+                result.lists.push(...apps);
+            }
+            catch (err) {
+                if (err.code !== "ENOENT") {
+                    result.errors.push(`Failed to read applications directory: ${err.message}`);
+                }
+            }
+        });
+    }
+}
+//# sourceMappingURL=applications.js.map

package/dist/collectors/applications.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"applications.js","sourceRoot":"","sources":["../../src/collectors/applications.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAO1C,sEAAsE;AACtE,SAAS,OAAO,CAAC,OAAe,EAAE,OAAe;IAC/C,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7E,OAAO,GAAG,OAAO,IAAI,IAAI,MAAM,CAAC;AAClC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,OAAO,qBAAsB,SAAQ,aAAa;IAGnC;IACA;IAHnB,YACE,OAAe,EACE,UAAkB,eAAe,EACjC,WAAoB;QAErC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHE,YAAO,GAAP,OAAO,CAA0B;QACjC,gBAAW,GAAX,WAAW,CAAS;IAGvC,CAAC;IAEQ,EAAE,GAAG,cAAc,CAAC;IACpB,KAAK,GAAG,wBAAwB,CAAC;IACjC,QAAQ,GAAsB,aAAa,CAAC;IAErD,KAAK,CAAC,OAAO;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;YACjC,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;gBACrE,MAAM,IAAI,GAAwB,OAAO;qBACtC,MAAM,CACL,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAC9D;qBACA,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;oBACb,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;oBAC9C,MAAM,IAAI,GAAsB,EAAE,IAAI,EAAE,CAAC;oBACzC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;wBACrB,IAAI,CAAC,IAAI,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;oBAC3D,CAAC;oBACD,OAAO,IAAI,CAAC;gBACd,CAAC,CAAC,CAAC;gBACL,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;YAC7B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACrD,MAAM,CAAC,MAAM,CAAC,IAAI,CAChB,0CAA2C,GAAa,CAAC,OAAO,EAAE,CACnE,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/collectors/base.d.ts

@@ -0,0 +1,52 @@
+import type { Collector, CollectorCategory, CollectorResult, CollectedFile } from "@otter/core";
+/** Options for safeReadFile */
+export interface SafeReadOptions {
+    /** Override the default max file size (bytes) */
+    maxSize?: number;
+    /** If true, apply credential redaction based on file type */
+    redact?: boolean;
+}
+/** Options for collectDir to allow per-call customization */
+export interface CollectDirOptions {
+    /** Custom filter — return false to skip a file */
+    filter?: (filePath: string) => boolean;
+    /** Override the default max file size (bytes) */
+    maxFileSize?: number;
+    /** Additional directory names to exclude */
+    excludeDirs?: Set<string>;
+    /** If true, apply credential redaction to collected files */
+    redact?: boolean;
+}
+/**
+ * Base class for all collectors. Provides common file reading utilities
+ * and standardized result creation.
+ */
+export declare abstract class BaseCollector implements Collector {
+    protected readonly homeDir: string;
+    abstract readonly id: string;
+    abstract readonly label: string;
+    abstract readonly category: CollectorCategory;
+    constructor(homeDir: string);
+    abstract collect(): Promise<CollectorResult>;
+    /** Create an empty result skeleton */
+    protected createResult(): CollectorResult;
+    /**
+     * Safely read a single file. Returns null if file doesn't exist,
+     * can't be read, exceeds size limit, or is binary.
+     *
+     * @param redact If true, apply credential redaction based on file type
+     */
+    protected safeReadFile(filePath: string, result: CollectorResult, { maxSize, redact }?: SafeReadOptions): Promise<CollectedFile | null>;
+    /**
+     * Recursively collect all files in a directory.
+     *
+     * Safety features:
+     *  - Skips excluded directories (.git, node_modules, cache, build output, etc.)
+     *  - Skips binary files (by extension and known basenames)
+     *  - Skips files exceeding size limit (default 512 KB)
+     */
+    protected collectDir(dirPath: string, result: CollectorResult, opts?: CollectDirOptions): Promise<CollectedFile[]>;
+    /** Measure execution time of the collect operation */
+    protected timed(fn: (result: CollectorResult) => Promise<void>): Promise<CollectorResult>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/collectors/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/collectors/base.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,aAAa,EACd,MAAM,aAAa,CAAC;AAoErB,+BAA+B;AAC/B,MAAM,WAAW,eAAe;IAC9B,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IAChC,kDAAkD;IAClD,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;IACvC,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,6DAA6D;IAC7D,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAcD;;;GAGG;AACH,8BAAsB,aAAc,YAAW,SAAS;IAK1C,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM;IAJ9C,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;gBAEf,OAAO,EAAE,MAAM;IAE9C,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC;IAE5C,sCAAsC;IACtC,SAAS,CAAC,YAAY,IAAI,eAAe;IAYzC;;;;;OAKG;cACa,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,eAAe,EACvB,EAAE,OAA6B,EAAE,MAAc,EAAE,GAAE,eAAoB,GACtE,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAsChC;;;;;;;OAOG;cACa,UAAU,CACxB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,eAAe,EACvB,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC,aAAa,EAAE,CAAC;IAoC3B,sDAAsD;cACtC,KAAK,CACnB,EAAE,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,GAC7C,OAAO,CAAC,eAAe,CAAC;CAO5B"}