@gzeoneth/gov-tracker 0.1.0

package/dist/tracker.js

@@ -0,0 +1,556 @@
+"use strict";
+/**
+ * ProposalStageTracker - Main entry point
+ *
+ * Tracks Arbitrum governance proposal lifecycle stages from
+ * either a governor proposal or a timelock operation.
+ *
+ * This file is the public API that composes focused modules:
+ * - tracker/context.ts: Functional TrackingContext for stage tracking
+ * - tracker/pipeline.ts: Pure functions that track stages
+ * - tracker/discovery.ts: Proposal and timelock discovery
+ * - tracker/query.ts: Checkpoint query operations
+ * - tracker/execute.ts: Transaction preparation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProposalStageTracker = void 0;
+exports.extractTimelockLink = extractTimelockLink;
+exports.createTracker = createTracker;
+const ethers_1 = require("ethers");
+const logger_1 = require("./utils/logger");
+const constants_1 = require("./constants");
+const election_1 = require("./election");
+const governor_discovery_1 = require("./discovery/governor-discovery");
+const timelock_discovery_1 = require("./discovery/timelock-discovery");
+const base_1 = require("./stages/base");
+const { tracker: logTracker, discovery: logDiscovery } = logger_1.loggers;
+// Import context and pipeline from tracker modules
+const context_1 = require("./tracker/context");
+const pipeline_1 = require("./tracker/pipeline");
+// Import from focused modules
+const state_1 = require("./tracker/state");
+const discovery_1 = require("./tracker/discovery");
+const discovery_2 = require("./tracker/discovery");
+const query_1 = require("./tracker/query");
+const execute_1 = require("./tracker/execute");
+/**
+ * Extract TimelockLink from stages if PROPOSAL_QUEUED is completed
+ */
+function extractTimelockLink(stages) {
+    const queuedStage = (0, base_1.findStage)(stages, "PROPOSAL_QUEUED");
+    if (!queuedStage || queuedStage.status !== "COMPLETED") {
+        return undefined;
+    }
+    const txHash = queuedStage.transactions[0]?.hash;
+    const operationId = queuedStage.data.operationId;
+    const timelockAddress = queuedStage.data.timelockAddress;
+    const queueBlockNumber = queuedStage.transactions[0]?.blockNumber;
+    if (!txHash || !operationId || !timelockAddress || !queueBlockNumber) {
+        return undefined;
+    }
+    return {
+        txHash,
+        operationId,
+        timelockAddress,
+        queueBlockNumber,
+    };
+}
+/**
+ * Main proposal stage tracker class
+ *
+ * @example
+ * ```typescript
+ * const tracker = new ProposalStageTracker({
+ *   l2Provider: new ethers.providers.JsonRpcProvider(ARB1_RPC),
+ *   l1Provider: new ethers.providers.JsonRpcProvider(ETH_RPC),
+ * });
+ *
+ * // Track by transaction hash (recommended)
+ * const results = await tracker.trackByTxHash(creationTxHash);
+ *
+ * for (const stage of results[0].stages) {
+ *   console.log(`${stage.type}: ${stage.status}`);
+ * }
+ *
+ * // Resume from checkpoint
+ * const resumedTracker = createTracker({
+ *   l2Provider,
+ *   l1Provider,
+ *   checkpoint: savedCheckpoint
+ * });
+ * const fresh = await resumedTracker.trackByTxHash(creationTxHash);
+ * ```
+ */
+class ProposalStageTracker {
+    constructor(options) {
+        if (!options.l1Provider) {
+            throw new Error("l1Provider is required");
+        }
+        this.l1Provider = options.l1Provider;
+        this.l2Provider =
+            options.l2Provider ?? new ethers_1.ethers.providers.JsonRpcProvider(constants_1.DEFAULT_RPC_URLS.ARB_ONE);
+        this.novaProvider =
+            options.novaProvider ?? new ethers_1.ethers.providers.JsonRpcProvider(constants_1.DEFAULT_RPC_URLS.NOVA);
+        this.onProgress = options.onProgress;
+        this.chunkingConfig = options.chunkingConfig ?? constants_1.DEFAULT_CHUNKING_CONFIG;
+        // Initialize cache: prefer direct cache adapter, fallback to cachePath
+        if (options.cache) {
+            this.cache = options.cache;
+        }
+        else if (options.cachePath) {
+            this.cache = new state_1.FileCache(options.cachePath);
+        }
+    }
+    // Static Cache Access
+    /**
+     * Read all cache data without requiring RPC providers.
+     * Use this for status/dashboard views that only need cached data.
+     *
+     * This is the ONLY way to access cache data outside of a full tracker instance.
+     * All cache access goes through this class to maintain single-system ownership.
+     *
+     * @param cachePath - Path to the cache file (tracker creates FileCache internally)
+     */
+    static async readCacheStatus(cachePath) {
+        return (0, state_1.readCacheStatus)(cachePath);
+    }
+    // Watermark Management
+    /**
+     * Load discovery watermarks from cache.
+     * Watermarks are stored as a TrackingCheckpoint for unified cache format.
+     * Returns empty object if no watermarks are cached.
+     */
+    async loadWatermarks() {
+        return (0, discovery_1.loadWatermarks)(this.cache);
+    }
+    /**
+     * Save discovery watermarks to cache.
+     * Watermarks are stored as TrackingCheckpoint with proper metadata,
+     * following the same pattern as proposal/timelock checkpoints.
+     */
+    async saveWatermarks(watermarks) {
+        return (0, discovery_1.saveWatermarks)(watermarks, this.cache);
+    }
+    // Discovery API
+    /**
+     * Discover proposals from a governor in a block range.
+     *
+     * @param governorAddress - Governor contract address
+     * @param fromBlock - Start block (exclusive - searches from fromBlock + 1)
+     * @param toBlock - End block (inclusive)
+     * @returns Array of discovered proposals
+     */
+    async discoverProposals(governorAddress, fromBlock, toBlock) {
+        return (0, discovery_2.discoverProposals)(governorAddress, fromBlock, toBlock, this.l2Provider);
+    }
+    /**
+     * Discover timelock operations from a timelock in a block range.
+     *
+     * @param timelockAddress - Timelock contract address
+     * @param fromBlock - Start block (exclusive - searches from fromBlock + 1)
+     * @param toBlock - End block (inclusive)
+     * @returns Array of discovered timelock operations
+     */
+    async discoverTimelockOps(timelockAddress, fromBlock, toBlock) {
+        return (0, discovery_2.discoverTimelockOps)(timelockAddress, fromBlock, toBlock, this.l2Provider);
+    }
+    /**
+     * Discover all proposals and timelock operations with auto-watermark management.
+     *
+     * This is the unified discovery API that handles everything internally:
+     * - Loads watermarks from cache (or uses provided fromWatermarks)
+     * - Discovers from all enabled targets in parallel
+     * - Auto-saves updated watermarks to cache
+     *
+     * @param targets - Which governors/timelocks to scan
+     * @param toBlock - End block for discovery
+     * @param fromWatermarks - Optional starting watermarks (overrides cached watermarks)
+     * @returns Discovered proposals, timelock ops, and updated watermarks
+     */
+    async discoverAll(targets, toBlock, fromWatermarks) {
+        // Load watermarks from cache (or use provided override)
+        const watermarks = fromWatermarks ?? (await this.loadWatermarks());
+        const result = await (0, discovery_2.discoverAll)(targets, toBlock, this.l2Provider, this.cache, watermarks, { chunkSize: this.chunkingConfig.l2ChunkSize });
+        // Auto-save updated watermarks
+        await this.saveWatermarks(result.watermarks);
+        return result;
+    }
+    // Checkpoint Query API
+    /**
+     * List all checkpoint keys in the cache.
+     */
+    async listCheckpointKeys() {
+        return (0, query_1.listCheckpointKeys)(this.cache);
+    }
+    /**
+     * Get a specific checkpoint from cache by key.
+     */
+    async getCheckpoint(key) {
+        return (0, query_1.getCheckpoint)(this.cache, key);
+    }
+    /**
+     * Get all checkpoints from cache.
+     */
+    async getAllCheckpoints() {
+        return (0, query_1.getAllCheckpoints)(this.cache);
+    }
+    /**
+     * Query incomplete checkpoints that should be re-tracked.
+     *
+     * @param options.maxAgeDays - Skip items older than this (default: 60)
+     * @param options.maxErrorCount - Skip items with more consecutive errors (default: 5)
+     */
+    async queryIncompleteCheckpoints(options = {}) {
+        return (0, query_1.queryIncompleteCheckpoints)(this.cache, options);
+    }
+    /**
+     * Get aggregated cache statistics.
+     *
+     * @param maxErrorCount - Items with this many or more errors are counted as "errored" (default: 5)
+     */
+    async getStats(maxErrorCount = 5) {
+        return (0, query_1.getStats)(this.cache, maxErrorCount);
+    }
+    // Main Tracking Entry Points
+    /**
+     * Track from transaction hash (primary tracking entry point)
+     *
+     * Auto-detects whether the transaction contains a governor proposal or
+     * timelock operations and tracks accordingly.
+     *
+     * Returns an array because a single transaction may contain multiple
+     * timelock operations (e.g., SC rotation with 4 operations).
+     *
+     * When cache is configured on the tracker:
+     * - Automatically loads existing checkpoint from cache (zero-RPC resume)
+     * - Automatically saves checkpoint to cache after tracking
+     *
+     * @example
+     * ```typescript
+     * const results = await tracker.trackByTxHash("0x...");
+     * for (const result of results) {
+     *   console.log(`Found ${result.stages.length} stages`);
+     * }
+     * ```
+     */
+    async trackByTxHash(txHash) {
+        logTracker("trackByTxHash %s", txHash);
+        // Cache key for this transaction
+        const cacheKey = (0, state_1.txHashCacheKey)(txHash);
+        // Load checkpoint from cache for resume
+        let checkpoint;
+        if (this.cache) {
+            checkpoint = (await this.cache.get(cacheKey)) ?? undefined;
+            if (checkpoint) {
+                logTracker("loaded checkpoint from cache: %s", cacheKey);
+            }
+        }
+        try {
+            return await this.trackByTxHashInternal(txHash, cacheKey, checkpoint);
+        }
+        catch (error) {
+            // Save checkpoint on error with incremented error count
+            if (this.cache) {
+                const input = {
+                    type: "governor",
+                    governorAddress: "",
+                    proposalId: "",
+                    creationTxHash: txHash,
+                };
+                const prevErrorCount = checkpoint?.metadata?.errorCount ?? 0;
+                const errorCheckpoint = checkpoint ?? {
+                    version: 1,
+                    createdAt: Date.now(),
+                    input,
+                    lastProcessedStage: null,
+                    lastProcessedBlock: { l1: 0, l2: 0 },
+                    cachedData: {},
+                };
+                errorCheckpoint.metadata = { errorCount: prevErrorCount + 1, lastTrackedAt: Date.now() };
+                await this.cache.set(cacheKey, errorCheckpoint);
+                logTracker("saved checkpoint on error: %s (errorCount=%d)", cacheKey, prevErrorCount + 1);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Internal implementation of trackByTxHash.
+     *
+     * Uses PipelineContext for stateful tracking - no parameter passing between stages.
+     */
+    async trackByTxHashInternal(txHash, cacheKey, checkpoint) {
+        // RESUME PATH: If we have a checkpoint, check what type it is
+        if (checkpoint && checkpoint.input.type !== "discovery") {
+            logTracker("RESUME: found checkpoint for tx, type=%s", checkpoint.input.type);
+            if (checkpoint.input.type === "governor") {
+                const input = checkpoint.input;
+                const result = await this.trackGovernorWithPipeline(input.governorAddress, input.proposalId, input.creationTxHash, checkpoint, cacheKey);
+                return [result];
+            }
+            else if (checkpoint.input.type === "timelock") {
+                const input = checkpoint.input;
+                const result = await this.trackTimelockWithPipeline(input.timelockAddress, input.operationId, input.scheduledTxHash, checkpoint, cacheKey);
+                return [result];
+            }
+        }
+        // Try as proposal first
+        const proposal = await (0, governor_discovery_1.discoverProposalByTxHash)(txHash, this.l2Provider);
+        if (proposal) {
+            logDiscovery("found proposal in tx, proposalId=%s", proposal.proposalId);
+            const result = await this.trackGovernorWithPipeline(proposal.governorAddress, proposal.proposalId, proposal.creationTxHash, checkpoint, cacheKey);
+            return [result];
+        }
+        // Try as timelock operations (may be batch with multiple ops)
+        const callScheduledEvents = await (0, timelock_discovery_1.findCallScheduledByTxHash)(txHash, this.l2Provider);
+        if (callScheduledEvents && callScheduledEvents.length > 0) {
+            logDiscovery("found %d timelock operation(s) in tx", callScheduledEvents.length);
+            // Group by unique operationId (batch operations have multiple calls with same operationId)
+            const seenOperationIds = new Set();
+            const results = [];
+            for (const event of callScheduledEvents) {
+                if (seenOperationIds.has(event.operationId))
+                    continue;
+                seenOperationIds.add(event.operationId);
+                const result = await this.trackTimelockWithPipeline(event.timelockAddress, event.operationId, txHash, checkpoint, cacheKey, event);
+                results.push(result);
+            }
+            return results;
+        }
+        logTracker("no proposal or timelock operations found in tx");
+        return [];
+    }
+    /**
+     * Track governor proposal using TrackingContext (stateful tracking)
+     */
+    async trackGovernorWithPipeline(governorAddress, proposalId, creationTxHash, checkpoint, cacheKey) {
+        const input = {
+            type: "governor",
+            governorAddress,
+            proposalId,
+            creationTxHash,
+        };
+        // Create tracking context
+        const initialState = (0, context_1.createTrackingContext)({
+            providers: {
+                l2: this.l2Provider,
+                l1: this.l1Provider,
+                nova: this.novaProvider,
+            },
+            input,
+            onProgress: this.onProgress,
+            chunkingConfig: this.chunkingConfig,
+            checkpoint,
+            cacheKey,
+        });
+        // Run the governor pipeline (stages 1-7)
+        const finalState = await (0, pipeline_1.trackGovernorPipeline)(initialState);
+        // Build result from state
+        const result = this.buildResultFromState(finalState);
+        // Save checkpoint to cache
+        if (this.cache && cacheKey) {
+            result.checkpoint.metadata = { errorCount: 0, lastTrackedAt: Date.now() };
+            await this.cache.set(cacheKey, result.checkpoint);
+            logTracker("saved checkpoint to cache: %s", cacheKey);
+        }
+        return result;
+    }
+    /**
+     * Track timelock operation using TrackingContext (stateful tracking)
+     */
+    async trackTimelockWithPipeline(timelockAddress, operationId, scheduledTxHash, checkpoint, cacheKey, callScheduledEvent) {
+        const input = {
+            type: "timelock",
+            timelockAddress,
+            operationId,
+            scheduledTxHash,
+        };
+        // Create tracking context with bootstrap data
+        const initialState = (0, context_1.createTrackingContext)({
+            providers: {
+                l2: this.l2Provider,
+                l1: this.l1Provider,
+                nova: this.novaProvider,
+            },
+            input,
+            onProgress: this.onProgress,
+            chunkingConfig: this.chunkingConfig,
+            checkpoint,
+            cacheKey,
+            callScheduledData: callScheduledEvent ? [callScheduledEvent] : undefined,
+        });
+        // Run the timelock pipeline (stages 4-7)
+        const finalState = await (0, pipeline_1.trackTimelockPipeline)(initialState);
+        // Build result from state
+        const result = this.buildResultFromState(finalState);
+        // Save checkpoint to cache
+        if (this.cache && cacheKey) {
+            result.checkpoint.metadata = { errorCount: 0, lastTrackedAt: Date.now() };
+            await this.cache.set(cacheKey, result.checkpoint);
+            logTracker("saved checkpoint to cache: %s", cacheKey);
+        }
+        return result;
+    }
+    /**
+     * Build TrackingResult from TrackingContext
+     */
+    buildResultFromState(state) {
+        const stages = state.stages;
+        const checkpoint = (0, context_1.createCheckpoint)(state);
+        const timelockLink = extractTimelockLink(stages);
+        return {
+            input: state.input,
+            stages,
+            checkpoint,
+            isComplete: (0, context_1.isComplete)(state),
+            proposalType: (0, context_1.getProposalType)(state),
+            proposalData: (0, context_1.getProposalData)(state),
+            timelockLink,
+            currentState: (0, context_1.getProposalState)(state),
+            isElection: (0, context_1.getIsElection)(state),
+        };
+    }
+    /**
+     * Track from a cached checkpoint.
+     *
+     * This is a convenience method that extracts the transaction hash from the
+     * checkpoint and dispatches to trackByTxHash. Use this when re-tracking
+     * items from queryIncompleteCheckpoints().
+     *
+     * @example
+     * ```typescript
+     * const incomplete = await tracker.queryIncompleteCheckpoints({ maxAgeDays: 60 });
+     * for (const { checkpoint } of incomplete) {
+     *   const result = await tracker.trackFromCheckpoint(checkpoint);
+     *   // ... handle result
+     * }
+     * ```
+     */
+    async trackFromCheckpoint(checkpoint) {
+        const input = checkpoint.input;
+        if (input.type === "governor") {
+            if (!input.creationTxHash) {
+                throw new Error("Governor checkpoint missing creationTxHash");
+            }
+            const results = await this.trackByTxHash(input.creationTxHash);
+            if (results.length === 0) {
+                throw new Error(`No proposal found in tx ${input.creationTxHash}`);
+            }
+            if (results.length > 1) {
+                logTracker("WARNING: trackFromCheckpoint found %d results in tx %s, returning first only. " +
+                    "Use trackByTxHash() to get all results.", results.length, input.creationTxHash);
+            }
+            return results[0];
+        }
+        else if (input.type === "timelock") {
+            if (!input.scheduledTxHash) {
+                throw new Error("Timelock checkpoint missing scheduledTxHash");
+            }
+            const results = await this.trackByTxHash(input.scheduledTxHash);
+            if (results.length === 0) {
+                throw new Error(`No timelock operation found in tx ${input.scheduledTxHash}`);
+            }
+            if (results.length > 1) {
+                logTracker("WARNING: trackFromCheckpoint found %d results in tx %s, returning first only. " +
+                    "Use trackByTxHash() to get all results.", results.length, input.scheduledTxHash);
+            }
+            return results[0];
+        }
+        else {
+            throw new Error(`Unsupported checkpoint input type: ${input.type}`);
+        }
+    }
+    // Transaction Preparation
+    /**
+     * Prepare a transaction for a READY stage without sending it.
+     *
+     * Returns PrepareResult with the prepared transaction data.
+     * Consumer is responsible for signing and sending the transaction.
+     *
+     * @param stage - The stage to prepare
+     * @param options - Preparation options
+     * @param allStages - Optional array of all stages (used to extract description for salt resolution)
+     *
+     * @example
+     * ```typescript
+     * const result = await tracker.prepareTransaction(readyStage);
+     * if (result.success) {
+     *   console.log(`To: ${result.prepared.to}`);
+     *   console.log(`Data: ${result.prepared.data}`);
+     *   console.log(`Chain: ${result.prepared.chain}`);
+     *
+     *   // Execute with your own signer
+     *   const tx = await signer.sendTransaction({
+     *     to: result.prepared.to,
+     *     data: result.prepared.data,
+     *     value: result.prepared.value,
+     *   });
+     *   await tx.wait();
+     * } else {
+     *   console.error(result.error);
+     * }
+     * ```
+     *
+     * @note Salt is now pre-computed during tracking and stored in stage.data
+     */
+    async prepareTransaction(stage, options = {}) {
+        return (0, execute_1.prepareTransaction)(stage, {
+            l1Provider: this.l1Provider,
+            l2Provider: this.l2Provider,
+            novaProvider: this.novaProvider,
+        }, options);
+    }
+    // Provider Access
+    /**
+     * Get the current providers
+     */
+    getProviders() {
+        return {
+            l1: this.l1Provider,
+            l2: this.l2Provider,
+            nova: this.novaProvider,
+        };
+    }
+    // Election Support
+    /**
+     * Check Security Council election status and prepare available actions
+     *
+     * @param options.nomineeGovernorAddress - Override the nominee election governor address
+     * @returns Election status with prepared transactions for available actions
+     */
+    async checkElection(options = {}) {
+        const nomineeGovernor = options.nomineeGovernorAddress ?? constants_1.ADDRESSES.ELECTION_NOMINEE_GOVERNOR;
+        logTracker("checkElection for %s", nomineeGovernor);
+        const status = await (0, election_1.checkElectionStatus)(this.l2Provider, this.l1Provider, nomineeGovernor);
+        const result = {
+            status,
+            canCreate: status.canCreateElection,
+            canTriggerMember: false,
+            prepared: {},
+        };
+        if (status.canCreateElection) {
+            const { transaction } = (0, election_1.prepareElectionCreation)(status, nomineeGovernor);
+            result.prepared.createElection = transaction;
+        }
+        if (status.electionCount > 0) {
+            const currentElectionIndex = status.electionCount - 1;
+            const electionStatus = await (0, election_1.trackElectionProposal)(currentElectionIndex, this.l2Provider, this.l1Provider);
+            result.currentElection = electionStatus;
+            result.canTriggerMember = electionStatus.canProceedToMemberPhase;
+            if (electionStatus.canProceedToMemberPhase) {
+                const memberTx = await (0, election_1.prepareMemberElectionTrigger)(electionStatus, this.l2Provider);
+                if (memberTx) {
+                    result.prepared.triggerMember = memberTx;
+                }
+            }
+        }
+        return result;
+    }
+}
+exports.ProposalStageTracker = ProposalStageTracker;
+/**
+ * Factory function to create a tracker instance
+ */
+function createTracker(options) {
+    return new ProposalStageTracker(options);
+}
+//# sourceMappingURL=tracker.js.map

package/dist/tracker.js.map

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

package/dist/types/config.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Configuration types for the tracker
+ */
+import { ethers } from "ethers";
+import { TrackedStage } from "./stages";
+/**
+ * Chunking configuration for log searches
+ */
+export interface ChunkingConfig {
+    l2ChunkSize: number;
+    l1ChunkSize: number;
+    novaChunkSize?: number;
+    delayBetweenChunks: number;
+}
+/**
+ * Retry configuration for RPC calls
+ */
+export interface RetryConfig {
+    maxRetries: number;
+    initialDelay: number;
+    maxDelay: number;
+    backoffMultiplier: number;
+}
+/**
+ * Progress callback for monitoring stage tracking
+ */
+export interface TrackingProgress {
+    stage: TrackedStage;
+    stages: TrackedStage[];
+    currentIndex: number;
+    totalStages: number;
+    isComplete: boolean;
+}
+/**
+ * Progress callback function type
+ */
+export type OnProgressCallback = (progress: TrackingProgress) => void | Promise<void>;
+/**
+ * Main tracker options
+ */
+export interface TrackerOptions {
+    l2Provider: ethers.providers.Provider;
+    l1Provider: ethers.providers.Provider;
+    novaProvider?: ethers.providers.Provider;
+    chunkingConfig?: ChunkingConfig;
+    onProgress?: OnProgressCallback;
+    /**
+     * Path to cache file (Node.js only). Creates a FileCache internally.
+     * For browser environments, use the `cache` option instead.
+     */
+    cachePath?: string;
+    /**
+     * Custom cache adapter instance. Use this for browser environments
+     * or custom storage backends.
+     *
+     * @example
+     * ```typescript
+     * // Browser with localStorage
+     * cache: new LocalStorageCache("arb-gov:")
+     *
+     * // In-memory (no persistence)
+     * cache: new MemoryCache()
+     *
+     * // Custom adapter
+     * cache: new MyRedisCache(redisClient)
+     * ```
+     */
+    cache?: CacheAdapter;
+}
+/**
+ * Cache adapter interface
+ */
+export interface CacheAdapter {
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T): Promise<void>;
+    delete(key: string): Promise<void>;
+    clear(): Promise<void>;
+    has(key: string): Promise<boolean>;
+    keys(prefix?: string): Promise<string[]> | string[] | IterableIterator<string>;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEtF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC;IACzC,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACvC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,MAAM,EAAE,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;CAChF"}

package/dist/types/config.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Configuration types for the tracker
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

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