@gzeoneth/gov-tracker 0.1.0

package/dist/types/timelock.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Timelock-related types for Arbitrum Governance
+ */
+import { BigNumber } from "ethers";
+/**
+ * Timelock operation state
+ */
+export type TimelockOperationState = "UNKNOWN" | "PENDING" | "READY" | "DONE";
+/**
+ * Serialized CallScheduledData for JSON storage
+ */
+export interface SerializedCallScheduledData {
+    operationId: string;
+    index: string;
+    target: string;
+    value: string;
+    data: string;
+    predecessor: string;
+    delay: string;
+    blockNumber: number;
+    txHash: string;
+    logIndex: number;
+    timelockAddress: string;
+}
+/**
+ * Parsed CallScheduled event data
+ */
+export interface CallScheduledData {
+    operationId: string;
+    index: BigNumber;
+    target: string;
+    value: BigNumber;
+    data: string;
+    predecessor: string;
+    delay: BigNumber;
+    blockNumber: number;
+    txHash: string;
+    logIndex: number;
+    timelockAddress: string;
+}
+/**
+ * Parsed CallExecuted event data
+ */
+export interface CallExecutedData {
+    operationId: string;
+    index: BigNumber;
+    target: string;
+    value: BigNumber;
+    data: string;
+    blockNumber: number;
+    txHash: string;
+    logIndex: number;
+}
+/**
+ * Parameters for a timelock operation
+ */
+export interface TimelockParams {
+    target: string;
+    value: BigNumber;
+    data: string;
+    predecessor: string;
+    salt: string;
+}
+/**
+ * Parameters for a batch timelock operation
+ */
+export interface TimelockBatchParams {
+    targets: string[];
+    values: BigNumber[];
+    payloads: string[];
+    predecessor: string;
+    salt: string;
+}
+/**
+ * Combined state of a timelock operation
+ */
+export interface TimelockState {
+    operationId: string;
+    state: TimelockOperationState;
+    eta?: number;
+    isReady: boolean;
+    isDone: boolean;
+    scheduledData?: CallScheduledData;
+    allScheduledData?: CallScheduledData[];
+    executedData?: CallExecutedData;
+    isBatch?: boolean;
+}
+/**
+ * Operation state from timelock contract state checks
+ */
+export interface OperationState {
+    isOperation: boolean;
+    isPending: boolean;
+    isReady: boolean;
+    isDone: boolean;
+    state: string;
+    timestamp: BigNumber;
+}
+/**
+ * Link from proposal to timelock operation
+ */
+export interface TimelockLink {
+    txHash: string;
+    operationId: string;
+    timelockAddress: string;
+    queueBlockNumber: number;
+}
+//# sourceMappingURL=timelock.d.ts.map

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

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

package/dist/types/timelock.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Timelock-related types for Arbitrum Governance
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=timelock.js.map

package/dist/types/timelock.js.map

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

package/dist/types/tracking.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Tracking context, results, checkpoint, and execution types
+ */
+import { BigNumber } from "ethers";
+import { ChainType, StageType } from "./core";
+import { TrackedStage } from "./stages";
+import { CallScheduledData } from "./timelock";
+import { ProposalType, ProposalData, ProposalState } from "./governor";
+import { TimelockState, TimelockLink } from "./timelock";
+export interface PrepareOptions {
+    salt?: string;
+    predecessor?: string;
+    skipSaltValidation?: boolean;
+    skipRetryableValueCalculation?: boolean;
+    force?: boolean;
+    /** Proposal description (needed for salt derivation if not in stage data) */
+    description?: string;
+}
+export type PrepareResult = {
+    success: true;
+    prepared: PreparedTransaction;
+} | {
+    success: false;
+    error: string;
+};
+export interface PreparedTransaction {
+    to: string;
+    data: string;
+    value: string;
+    chain: ChainType;
+    description: string;
+    operationId?: string;
+    hashValidation?: {
+        isValid: boolean;
+        error?: string;
+    };
+}
+export interface ExecutionResult {
+    success: boolean;
+    txHash: string;
+    blockNumber: number;
+    gasUsed: BigNumber;
+    error?: string;
+    prepared?: PreparedTransaction;
+}
+/**
+ * Input for tracking from a governor proposal
+ */
+export interface GovernorTrackingInput {
+    type: "governor";
+    governorAddress: string;
+    proposalId: string;
+    creationTxHash: string;
+}
+/**
+ * Input for tracking from a timelock operation
+ */
+export interface TimelockTrackingInput {
+    type: "timelock";
+    timelockAddress: string;
+    operationId: string;
+    scheduledTxHash: string;
+}
+/**
+ * Input for discovery metadata checkpoint
+ */
+export interface DiscoveryTrackingInput {
+    type: "discovery";
+    id: "watermarks";
+}
+/**
+ * Union type for all tracking entry points
+ */
+export type TrackingInput = GovernorTrackingInput | TimelockTrackingInput | DiscoveryTrackingInput;
+/**
+ * Common context for stage tracking operations
+ */
+export interface StageTrackingContext {
+    fromBlock?: number;
+    toBlock?: number;
+    direction?: "forward" | "backward";
+    cachedData?: {
+        txHash?: string;
+        operationId?: string;
+        callScheduledData?: CallScheduledData | CallScheduledData[];
+        executionTxHash?: string;
+    };
+    checkpoint?: TrackingCheckpoint;
+}
+/**
+ * Hints for the next stage in the pipeline
+ */
+export interface NextStageHints {
+    fromBlock?: number;
+    timelockAddress?: string;
+    operationId?: string;
+    callScheduledData?: CallScheduledData | CallScheduledData[];
+    executionTxHash?: string;
+    firstExecutableBlock?: number;
+    messagePosition?: string;
+}
+/**
+ * Result structure for stage tracking functions
+ */
+export interface StageTrackResult {
+    stage: TrackedStage;
+    hints: NextStageHints;
+}
+/**
+ * Extend StageTrackResult with additional stage-specific data
+ */
+export type StageTrackResultWith<TExtra> = StageTrackResult & TExtra;
+/**
+ * Discovery target keys (shared between watermarks and targets)
+ */
+export type DiscoveryKey = "constitutionalGovernor" | "nonConstitutionalGovernor" | "electionNomineeGovernor" | "electionMemberGovernor" | "l2ConstitutionalTimelock" | "l2NonConstitutionalTimelock";
+/** Discovery watermarks for incremental block scanning */
+export type DiscoveryWatermarks = Partial<Record<DiscoveryKey, number>>;
+/** Discovery targets configuration */
+export type DiscoveryTargets = Partial<Record<DiscoveryKey, boolean>>;
+/**
+ * Checkpoint for resuming tracking
+ */
+export interface TrackingCheckpoint {
+    version: 1;
+    createdAt: number;
+    input: TrackingInput;
+    lastProcessedStage: StageType | null;
+    lastProcessedBlock: {
+        l1: number;
+        l2: number;
+        nova?: number;
+    };
+    cachedData: {
+        completedStages?: TrackedStage[];
+        discoveryWatermarks?: DiscoveryWatermarks;
+    };
+    metadata?: {
+        errorCount: number;
+        lastTrackedAt: number;
+    };
+}
+/**
+ * Aggregated cache statistics
+ */
+export interface TrackerStats {
+    total: number;
+    proposals: {
+        total: number;
+        complete: number;
+        active: number;
+        errored: number;
+    };
+    timelocks: {
+        total: number;
+        complete: number;
+        active: number;
+        errored: number;
+    };
+    elections: {
+        total: number;
+        complete: number;
+    };
+}
+/**
+ * Full tracking result
+ */
+export interface TrackingResult {
+    input: TrackingInput;
+    stages: TrackedStage[];
+    checkpoint: TrackingCheckpoint;
+    isComplete: boolean;
+    proposalType?: ProposalType;
+    proposalData?: ProposalData;
+    timelockState?: TimelockState;
+    timelockLink?: TimelockLink;
+    currentState?: ProposalState;
+    isElection?: boolean;
+}
+//# sourceMappingURL=tracking.d.ts.map

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

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

package/dist/types/tracking.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Tracking context, results, checkpoint, and execution types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=tracking.js.map

package/dist/types/tracking.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Type definitions for Arbitrum Governance Stage Tracking SDK
+ * Re-exports from domain modules in ./types/
+ */
+export * from "./types/index";
+//# 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":"AAAA;;;GAGG;AACH,cAAc,eAAe,CAAC"}

package/dist/types.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Type definitions for Arbitrum Governance Stage Tracking SDK
+ * Re-exports from domain modules in ./types/
+ */
+__exportStar(require("./types/index"), exports);
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/utils/chain.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Chain and address utilities
+ */
+import { ethers } from "ethers";
+import { ChainType } from "../types";
+/**
+ * Get chain type from provider network.
+ */
+export declare function getChainType(provider: ethers.providers.Provider): Promise<ChainType>;
+/**
+ * Case-insensitive address comparison.
+ */
+export declare function addressEquals(a: string, b: string): boolean;
+/**
+ * Check if an address is in a set of addresses (case-insensitive).
+ */
+export declare function isAddressIn(address: string, addresses: readonly string[]): boolean;
+//# sourceMappingURL=chain.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chain.d.ts","sourceRoot":"","sources":["../../src/utils/chain.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAGrC;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,CAK1F;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAGlF"}

package/dist/utils/chain.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * Chain and address utilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getChainType = getChainType;
+exports.addressEquals = addressEquals;
+exports.isAddressIn = isAddressIn;
+const constants_1 = require("../constants");
+/**
+ * Get chain type from provider network.
+ */
+async function getChainType(provider) {
+    const network = await provider.getNetwork();
+    if (network.chainId === constants_1.CHAIN_IDS.NOVA)
+        return "NOVA";
+    if (network.chainId === constants_1.CHAIN_IDS.ARB_ONE)
+        return "L2";
+    return "L1";
+}
+/**
+ * Case-insensitive address comparison.
+ */
+function addressEquals(a, b) {
+    return a.toLowerCase() === b.toLowerCase();
+}
+/**
+ * Check if an address is in a set of addresses (case-insensitive).
+ */
+function isAddressIn(address, addresses) {
+    const normalized = address.toLowerCase();
+    return addresses.some((a) => a.toLowerCase() === normalized);
+}
+//# sourceMappingURL=chain.js.map

package/dist/utils/chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.js","sourceRoot":"","sources":["../../src/utils/chain.ts"],"names":[],"mappings":";AAAA;;GAEG;;AASH,oCAKC;AAKD,sCAEC;AAKD,kCAGC;AAzBD,4CAAyC;AAEzC;;GAEG;AACI,KAAK,UAAU,YAAY,CAAC,QAAmC;IACpE,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC;IAC5C,IAAI,OAAO,CAAC,OAAO,KAAK,qBAAS,CAAC,IAAI;QAAE,OAAO,MAAM,CAAC;IACtD,IAAI,OAAO,CAAC,OAAO,KAAK,qBAAS,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IACvD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,CAAS,EAAE,CAAS;IAChD,OAAO,CAAC,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CAAC,OAAe,EAAE,SAA4B;IACvE,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACzC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC,CAAC;AAC/D,CAAC"}

package/dist/utils/log-filters.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Utilities for filtering and parsing transaction receipt logs
+ *
+ * These helpers reduce duplication across discovery and stage modules
+ * that need to find specific events in transaction receipts.
+ */
+import { ethers } from "ethers";
+type Log = ethers.providers.Log;
+/**
+ * Filter options for finding logs in a receipt
+ */
+export interface LogFilterOptions {
+    /** Event topic (topics[0]) to match */
+    topic?: string;
+    /** Contract address to match */
+    address?: string;
+}
+/**
+ * Filter logs from a receipt by topic and/or address
+ *
+ * @example
+ * // Find all CallScheduled events
+ * const logs = filterLogs(receipt.logs, { topic: EVENT_TOPICS.CALL_SCHEDULED });
+ *
+ * @example
+ * // Find L2ToL1Tx events from ArbSys
+ * const logs = filterLogs(receipt.logs, { topic: l2ToL1Topic, address: ARB_SYS });
+ */
+export declare function filterLogs(logs: Log[], options: LogFilterOptions): Log[];
+/**
+ * Parse logs with a parser function, silently skipping parse failures
+ *
+ * @example
+ * const events = parseLogsSafe(logs, parseCallScheduledEvent);
+ */
+export declare function parseLogsSafe<T>(logs: Log[], parser: (log: Log) => T | null): T[];
+/**
+ * Find and parse logs in one operation
+ *
+ * Combines filterLogs and parseLogsSafe for the common pattern of
+ * filtering logs by topic/address and parsing them.
+ *
+ * @example
+ * const events = findAndParseLogs(
+ *   receipt.logs,
+ *   { topic: EVENT_TOPICS.CALL_SCHEDULED },
+ *   parseCallScheduledEvent
+ * );
+ */
+export declare function findAndParseLogs<T>(logs: Log[], options: LogFilterOptions, parser: (log: Log) => T | null): T[];
+/**
+ * Find first matching log and parse it
+ *
+ * @example
+ * const event = findFirstLog(
+ *   receipt.logs,
+ *   { topic: EVENT_TOPICS.PROPOSAL_CREATED },
+ *   parseProposalCreatedEvent
+ * );
+ */
+export declare function findFirstLog<T>(logs: Log[], options: LogFilterOptions, parser: (log: Log) => T | null): T | null;
+/**
+ * Count logs by address after filtering by topic
+ */
+export declare function countLogsByAddress(logs: Log[], options: Omit<LogFilterOptions, "address">): Map<string, number>;
+export {};
+//# sourceMappingURL=log-filters.d.ts.map

package/dist/utils/log-filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-filters.d.ts","sourceRoot":"","sources":["../../src/utils/log-filters.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,KAAK,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC;AAEhC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,gBAAgB,GAAG,GAAG,EAAE,CAUxE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,IAAI,GAAG,CAAC,EAAE,CAajF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,IAAI,EAAE,GAAG,EAAE,EACX,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,IAAI,GAC7B,CAAC,EAAE,CAGL;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,IAAI,EAAE,GAAG,EAAE,EACX,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,IAAI,GAC7B,CAAC,GAAG,IAAI,CAeV;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,GAAG,EAAE,EACX,OAAO,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,GACzC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAWrB"}

package/dist/utils/log-filters.js

@@ -0,0 +1,116 @@
+"use strict";
+/**
+ * Utilities for filtering and parsing transaction receipt logs
+ *
+ * These helpers reduce duplication across discovery and stage modules
+ * that need to find specific events in transaction receipts.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.filterLogs = filterLogs;
+exports.parseLogsSafe = parseLogsSafe;
+exports.findAndParseLogs = findAndParseLogs;
+exports.findFirstLog = findFirstLog;
+exports.countLogsByAddress = countLogsByAddress;
+const chain_1 = require("./chain");
+/**
+ * Filter logs from a receipt by topic and/or address
+ *
+ * @example
+ * // Find all CallScheduled events
+ * const logs = filterLogs(receipt.logs, { topic: EVENT_TOPICS.CALL_SCHEDULED });
+ *
+ * @example
+ * // Find L2ToL1Tx events from ArbSys
+ * const logs = filterLogs(receipt.logs, { topic: l2ToL1Topic, address: ARB_SYS });
+ */
+function filterLogs(logs, options) {
+    return logs.filter((log) => {
+        if (options.topic && log.topics[0] !== options.topic) {
+            return false;
+        }
+        if (options.address && !(0, chain_1.addressEquals)(log.address, options.address)) {
+            return false;
+        }
+        return true;
+    });
+}
+/**
+ * Parse logs with a parser function, silently skipping parse failures
+ *
+ * @example
+ * const events = parseLogsSafe(logs, parseCallScheduledEvent);
+ */
+function parseLogsSafe(logs, parser) {
+    const results = [];
+    for (const log of logs) {
+        try {
+            const parsed = parser(log);
+            if (parsed !== null) {
+                results.push(parsed);
+            }
+        }
+        catch {
+            // Skip logs that fail to parse
+        }
+    }
+    return results;
+}
+/**
+ * Find and parse logs in one operation
+ *
+ * Combines filterLogs and parseLogsSafe for the common pattern of
+ * filtering logs by topic/address and parsing them.
+ *
+ * @example
+ * const events = findAndParseLogs(
+ *   receipt.logs,
+ *   { topic: EVENT_TOPICS.CALL_SCHEDULED },
+ *   parseCallScheduledEvent
+ * );
+ */
+function findAndParseLogs(logs, options, parser) {
+    const filtered = filterLogs(logs, options);
+    return parseLogsSafe(filtered, parser);
+}
+/**
+ * Find first matching log and parse it
+ *
+ * @example
+ * const event = findFirstLog(
+ *   receipt.logs,
+ *   { topic: EVENT_TOPICS.PROPOSAL_CREATED },
+ *   parseProposalCreatedEvent
+ * );
+ */
+function findFirstLog(logs, options, parser) {
+    for (const log of logs) {
+        if (options.topic && log.topics[0] !== options.topic)
+            continue;
+        if (options.address && !(0, chain_1.addressEquals)(log.address, options.address))
+            continue;
+        try {
+            const parsed = parser(log);
+            if (parsed !== null) {
+                return parsed;
+            }
+        }
+        catch {
+            // Continue to next log
+        }
+    }
+    return null;
+}
+/**
+ * Count logs by address after filtering by topic
+ */
+function countLogsByAddress(logs, options) {
+    const counts = new Map();
+    for (const log of logs) {
+        if (options.topic && log.topics[0] !== options.topic)
+            continue;
+        const addr = log.address.toLowerCase();
+        counts.set(addr, (counts.get(addr) ?? 0) + 1);
+    }
+    return counts;
+}
+//# sourceMappingURL=log-filters.js.map

package/dist/utils/log-filters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-filters.js","sourceRoot":"","sources":["../../src/utils/log-filters.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AA4BH,gCAUC;AAQD,sCAaC;AAeD,4CAOC;AAYD,oCAmBC;AAKD,gDAcC;AAhID,mCAAwC;AAcxC;;;;;;;;;;GAUG;AACH,SAAgB,UAAU,CAAC,IAAW,EAAE,OAAyB;IAC/D,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE;QACzB,IAAI,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC;YACrD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,OAAO,CAAC,OAAO,IAAI,CAAC,IAAA,qBAAa,EAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACpE,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,SAAgB,aAAa,CAAI,IAAW,EAAE,MAA8B;IAC1E,MAAM,OAAO,GAAQ,EAAE,CAAC;IACxB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAC3B,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,+BAA+B;QACjC,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAgB,gBAAgB,CAC9B,IAAW,EACX,OAAyB,EACzB,MAA8B;IAE9B,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C,OAAO,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,YAAY,CAC1B,IAAW,EACX,OAAyB,EACzB,MAA8B;IAE9B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,KAAK;YAAE,SAAS;QAC/D,IAAI,OAAO,CAAC,OAAO,IAAI,CAAC,IAAA,qBAAa,EAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC;YAAE,SAAS;QAE9E,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAC3B,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,uBAAuB;QACzB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAChC,IAAW,EACX,OAA0C;IAE1C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEzC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,KAAK;YAAE,SAAS;QAE/D,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}