@dependabit/monitor 0.1.1

package/dist/comparator.js

@@ -0,0 +1,53 @@
+/**
+ * State Comparator
+ * Generic comparison logic for dependency state snapshots
+ */
+export class StateComparator {
+    /**
+     * Compares two dependency snapshots to detect changes
+     */
+    compare(oldState, newState) {
+        const changes = [];
+        // Check state hash
+        if (oldState.stateHash !== newState.stateHash) {
+            changes.push('stateHash');
+        }
+        // Check version
+        if (oldState.version !== newState.version) {
+            changes.push('version');
+        }
+        // Check metadata changes (shallow comparison)
+        if (this.hasMetadataChanges(oldState.metadata, newState.metadata)) {
+            changes.push('metadata');
+        }
+        return {
+            hasChanged: changes.length > 0,
+            changes,
+            oldVersion: oldState.version,
+            newVersion: newState.version
+        };
+    }
+    /**
+     * Checks if metadata has changed (shallow comparison)
+     */
+    hasMetadataChanges(oldMeta, newMeta) {
+        if (!oldMeta && !newMeta) {
+            return false;
+        }
+        if (!oldMeta || !newMeta) {
+            return true;
+        }
+        const oldKeys = Object.keys(oldMeta);
+        const newKeys = Object.keys(newMeta);
+        if (oldKeys.length !== newKeys.length) {
+            return true;
+        }
+        for (const key of oldKeys) {
+            if (oldMeta[key] !== newMeta[key]) {
+                return true;
+            }
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=comparator.js.map

package/dist/comparator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparator.js","sourceRoot":"","sources":["../src/comparator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,OAAO,eAAe;IAC1B;;OAEG;IACH,OAAO,CAAC,QAA4B,EAAE,QAA4B,EAAmB;QACnF,MAAM,OAAO,GAAa,EAAE,CAAC;QAE7B,mBAAmB;QACnB,IAAI,QAAQ,CAAC,SAAS,KAAK,QAAQ,CAAC,SAAS,EAAE,CAAC;YAC9C,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC5B,CAAC;QAED,gBAAgB;QAChB,IAAI,QAAQ,CAAC,OAAO,KAAK,QAAQ,CAAC,OAAO,EAAE,CAAC;YAC1C,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1B,CAAC;QAED,8CAA8C;QAC9C,IAAI,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC3B,CAAC;QAED,OAAO;YACL,UAAU,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC;YAC9B,OAAO;YACP,UAAU,EAAE,QAAQ,CAAC,OAAO;YAC5B,UAAU,EAAE,QAAQ,CAAC,OAAO;SAC7B,CAAC;IAAA,CACH;IAED;;OAEG;IACK,kBAAkB,CACxB,OAAiC,EACjC,OAAiC,EACxB;QACT,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAErC,IAAI,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClC,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IAAA,CACd;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @dependabit/monitor - Dependency change detection and monitoring
+ */
+export { Monitor } from './monitor.js';
+export type { DependencyConfig, CheckResult } from './monitor.js';
+export { GitHubRepoChecker } from './checkers/github-repo.js';
+export { URLContentChecker } from './checkers/url-content.js';
+export { OpenAPIChecker } from './checkers/openapi.js';
+export { StateComparator } from './comparator.js';
+export { SeverityClassifier } from './severity.js';
+export type { Severity } from './severity.js';
+export { normalizeHTML, normalizeURL } from './normalizer.js';
+export { Scheduler } from './scheduler.js';
+export type { Checker, DependencySnapshot, ChangeDetection, AccessConfig } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAElE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE9D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,YAAY,EAAE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * @dependabit/monitor - Dependency change detection and monitoring
+ */
+export { Monitor } from './monitor.js';
+export { GitHubRepoChecker } from './checkers/github-repo.js';
+export { URLContentChecker } from './checkers/url-content.js';
+export { OpenAPIChecker } from './checkers/openapi.js';
+export { StateComparator } from './comparator.js';
+export { SeverityClassifier } from './severity.js';
+export { normalizeHTML, normalizeURL } from './normalizer.js';
+export { Scheduler } from './scheduler.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGnD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE9D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/monitor.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Monitor Orchestrator
+ * Coordinates dependency checking across multiple access methods
+ */
+import type { Checker, AccessConfig, DependencySnapshot, ChangeDetection } from './types.js';
+export interface DependencyConfig extends AccessConfig {
+    id: string;
+    name?: string;
+    type?: string;
+    currentStateHash: string;
+    currentVersion?: string;
+    lastChecked?: string;
+    monitoring?: {
+        enabled?: boolean;
+        ignoreChanges?: boolean;
+    };
+}
+export interface CheckResult {
+    dependency: DependencyConfig;
+    hasChanged: boolean;
+    changes?: ChangeDetection;
+    severity?: 'breaking' | 'major' | 'minor' | undefined;
+    newSnapshot?: DependencySnapshot;
+    error?: string;
+}
+export declare class Monitor {
+    private checkers;
+    private classifier;
+    constructor();
+    /**
+     * Checks a single dependency for changes
+     */
+    checkDependency(dependency: DependencyConfig): Promise<CheckResult>;
+    /**
+     * Checks multiple dependencies, respecting monitoring rules
+     */
+    checkAll(dependencies: DependencyConfig[]): Promise<CheckResult[]>;
+    /**
+     * Registers a custom checker for an access method
+     */
+    registerChecker(accessMethod: string, checker: Checker): void;
+}
+//# sourceMappingURL=monitor.d.ts.map

package/dist/monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor.d.ts","sourceRoot":"","sources":["../src/monitor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7F,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IACpD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE;QACX,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,gBAAgB,CAAC;IAC7B,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,QAAQ,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;IACtD,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,UAAU,CAAqB;IAEvC,cAOC;IAED;;OAEG;IACG,eAAe,CAAC,UAAU,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAyCxE;IAED;;OAEG;IACG,QAAQ,CAAC,YAAY,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAgBvE;IAED;;OAEG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAE5D;CACF"}

package/dist/monitor.js

@@ -0,0 +1,85 @@
+/**
+ * Monitor Orchestrator
+ * Coordinates dependency checking across multiple access methods
+ */
+import { GitHubRepoChecker } from './checkers/github-repo.js';
+import { URLContentChecker } from './checkers/url-content.js';
+import { OpenAPIChecker } from './checkers/openapi.js';
+import { SeverityClassifier } from './severity.js';
+export class Monitor {
+    checkers;
+    classifier;
+    constructor() {
+        this.checkers = new Map();
+        this.checkers.set('github-api', new GitHubRepoChecker());
+        this.checkers.set('http', new URLContentChecker());
+        this.checkers.set('openapi', new OpenAPIChecker());
+        this.classifier = new SeverityClassifier();
+    }
+    /**
+     * Checks a single dependency for changes
+     */
+    async checkDependency(dependency) {
+        try {
+            // Get appropriate checker for access method
+            const checker = this.checkers.get(dependency.accessMethod);
+            if (!checker) {
+                throw new Error(`Unsupported access method: ${dependency.accessMethod}`);
+            }
+            // Fetch current state
+            const newSnapshot = await checker.fetch(dependency);
+            // Create old snapshot from stored data
+            const oldSnapshot = {
+                stateHash: dependency.currentStateHash,
+                version: dependency.currentVersion,
+                fetchedAt: dependency.lastChecked ? new Date(dependency.lastChecked) : new Date()
+            };
+            // Compare states
+            const changes = await checker.compare(oldSnapshot, newSnapshot);
+            // Classify severity if changes detected
+            let severity;
+            if (changes.hasChanged) {
+                severity = this.classifier.classify(changes);
+            }
+            return {
+                dependency,
+                hasChanged: changes.hasChanged,
+                changes,
+                severity,
+                newSnapshot
+            };
+        }
+        catch (error) {
+            return {
+                dependency,
+                hasChanged: false,
+                error: error.message
+            };
+        }
+    }
+    /**
+     * Checks multiple dependencies, respecting monitoring rules
+     */
+    async checkAll(dependencies) {
+        // Filter out disabled dependencies
+        const enabledDeps = dependencies.filter((dep) => {
+            if (dep.monitoring?.enabled === false) {
+                return false;
+            }
+            if (dep.monitoring?.ignoreChanges === true) {
+                return false;
+            }
+            return true;
+        });
+        // Check all dependencies in parallel
+        const results = await Promise.all(enabledDeps.map((dep) => this.checkDependency(dep)));
+        return results;
+    }
+    /**
+     * Registers a custom checker for an access method
+     */
+    registerChecker(accessMethod, checker) {
+        this.checkers.set(accessMethod, checker);
+    }
+}
+//# sourceMappingURL=monitor.js.map

package/dist/monitor.js.map

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

package/dist/normalizer.d.ts

@@ -0,0 +1,24 @@
+/**
+ * HTML Normalizer for content-based change detection
+ *
+ * Implements 6-step normalization to reduce false positives:
+ * 1. Remove <script> and <style> tags
+ * 2. Strip HTML comments
+ * 3. Normalize whitespace
+ * 4. Remove timestamp patterns
+ * 5. Remove analytics/tracking parameters
+ * 6. Preserve meaningful content
+ */
+/**
+ * Normalizes HTML content for consistent comparison
+ * @param html Raw HTML content
+ * @returns Normalized HTML string
+ */
+export declare function normalizeHTML(html: string): string;
+/**
+ * Normalizes a URL by removing tracking parameters
+ * @param url URL string
+ * @returns Normalized URL
+ */
+export declare function normalizeURL(url: string): string;
+//# sourceMappingURL=normalizer.d.ts.map

package/dist/normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizer.d.ts","sourceRoot":"","sources":["../src/normalizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAiElD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAgChD"}

package/dist/normalizer.js

@@ -0,0 +1,97 @@
+/**
+ * HTML Normalizer for content-based change detection
+ *
+ * Implements 6-step normalization to reduce false positives:
+ * 1. Remove <script> and <style> tags
+ * 2. Strip HTML comments
+ * 3. Normalize whitespace
+ * 4. Remove timestamp patterns
+ * 5. Remove analytics/tracking parameters
+ * 6. Preserve meaningful content
+ */
+/**
+ * Normalizes HTML content for consistent comparison
+ * @param html Raw HTML content
+ * @returns Normalized HTML string
+ */
+export function normalizeHTML(html) {
+    if (!html || html.trim() === '') {
+        return '';
+    }
+    let normalized = html;
+    // Step 1: Remove script and style tags (with content)
+    // Use a simpler, more secure approach - remove everything between opening and closing tags
+    // This handles variations like </script >, </script\n>, etc.
+    let prevLength = 0;
+    while (normalized.length !== prevLength) {
+        prevLength = normalized.length;
+        // Match <script...> then any content, then </script with any whitespace/attributes before >
+        normalized = normalized.replace(/<script\b[^>]*>[\s\S]*?<\/script\s*[^>]*>/gi, '');
+    }
+    prevLength = 0;
+    while (normalized.length !== prevLength) {
+        prevLength = normalized.length;
+        normalized = normalized.replace(/<style\b[^>]*>[\s\S]*?<\/style\s*[^>]*>/gi, '');
+    }
+    // Step 2: Strip HTML comments - iterative to handle nested comments
+    prevLength = 0;
+    while (normalized.length !== prevLength) {
+        prevLength = normalized.length;
+        normalized = normalized.replace(/<!--[\s\S]*?-->/g, '');
+    }
+    // Step 3: Normalize whitespace (collapse multiple spaces/newlines)
+    normalized = normalized.replace(/\s+/g, ' ');
+    normalized = normalized.trim();
+    // Step 4: Remove common timestamp patterns
+    // Patterns like "Updated: 2024-01-01" or "Last modified: Jan 1, 2024"
+    normalized = normalized.replace(/\b(Updated|Last\s+modified|Modified|Created|Published):\s*[^<\n]+/gi, '');
+    // Remove ISO timestamps
+    normalized = normalized.replace(/\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})?/g, '');
+    // Remove common date formats
+    normalized = normalized.replace(/\b(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)\s+\d{1,2},?\s+\d{4}\b/gi, '');
+    // Step 5: Remove analytics/tracking parameters from URLs
+    // UTM parameters, tracking IDs, session IDs, etc.
+    normalized = normalized.replace(/[?&](utm_[^&\s"']+|fbclid|gclid|msclkid|mc_[^&\s"']+|_ga|sessionid)[^&\s"']*/gi, '');
+    // Step 6: Final cleanup - preserve meaningful content structure
+    // Remove extra spaces that may have been introduced
+    normalized = normalized.replace(/\s+/g, ' ');
+    normalized = normalized.trim();
+    return normalized;
+}
+/**
+ * Normalizes a URL by removing tracking parameters
+ * @param url URL string
+ * @returns Normalized URL
+ */
+export function normalizeURL(url) {
+    try {
+        const urlObj = new URL(url);
+        // Remove common tracking parameters
+        const trackingParams = [
+            'utm_source',
+            'utm_medium',
+            'utm_campaign',
+            'utm_term',
+            'utm_content',
+            'fbclid',
+            'gclid',
+            'msclkid',
+            'mc_cid',
+            'mc_eid',
+            '_ga',
+            '_gac',
+            'sessionid',
+            'sid',
+            'SSID'
+        ];
+        trackingParams.forEach((param) => {
+            urlObj.searchParams.delete(param);
+        });
+        return urlObj.toString();
+    }
+    catch {
+        // If URL parsing fails, return original
+        return url;
+    }
+}
+//# sourceMappingURL=normalizer.js.map

package/dist/normalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizer.js","sourceRoot":"","sources":["../src/normalizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAU;IAClD,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAChC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,UAAU,GAAG,IAAI,CAAC;IAEtB,sDAAsD;IACtD,2FAA2F;IAC3F,6DAA6D;IAC7D,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,OAAO,UAAU,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACxC,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC;QAC/B,4FAA4F;QAC5F,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,6CAA6C,EAAE,EAAE,CAAC,CAAC;IACrF,CAAC;IACD,UAAU,GAAG,CAAC,CAAC;IACf,OAAO,UAAU,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACxC,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC;QAC/B,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,2CAA2C,EAAE,EAAE,CAAC,CAAC;IACnF,CAAC;IAED,oEAAoE;IACpE,UAAU,GAAG,CAAC,CAAC;IACf,OAAO,UAAU,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACxC,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC;QAC/B,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,mEAAmE;IACnE,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7C,UAAU,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;IAE/B,2CAA2C;IAC3C,sEAAsE;IACtE,UAAU,GAAG,UAAU,CAAC,OAAO,CAC7B,qEAAqE,EACrE,EAAE,CACH,CAAC;IAEF,wBAAwB;IACxB,UAAU,GAAG,UAAU,CAAC,OAAO,CAC7B,kEAAkE,EAClE,EAAE,CACH,CAAC;IAEF,6BAA6B;IAC7B,UAAU,GAAG,UAAU,CAAC,OAAO,CAC7B,6EAA6E,EAC7E,EAAE,CACH,CAAC;IAEF,yDAAyD;IACzD,kDAAkD;IAClD,UAAU,GAAG,UAAU,CAAC,OAAO,CAC7B,gFAAgF,EAChF,EAAE,CACH,CAAC;IAEF,gEAAgE;IAChE,oDAAoD;IACpD,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7C,UAAU,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;IAE/B,OAAO,UAAU,CAAC;AAAA,CACnB;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW,EAAU;IAChD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAE5B,oCAAoC;QACpC,MAAM,cAAc,GAAG;YACrB,YAAY;YACZ,YAAY;YACZ,cAAc;YACd,UAAU;YACV,aAAa;YACb,QAAQ;YACR,OAAO;YACP,SAAS;YACT,QAAQ;YACR,QAAQ;YACR,KAAK;YACL,MAAM;YACN,WAAW;YACX,KAAK;YACL,MAAM;SACP,CAAC;QAEF,cAAc,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;YAChC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAAA,CACnC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;IAAC,MAAO,CAAC;QACR,wCAAwC;QACxC,OAAO,GAAG,CAAC;IACb,CAAC;AAAA,CACF"}

package/dist/scheduler.d.ts

@@ -0,0 +1,64 @@
+import { type DependencyEntry, type DependabitConfig } from '@dependabit/manifest';
+export interface SchedulerOptions {
+    currentTime?: Date;
+}
+/**
+ * Scheduler for per-dependency monitoring
+ *
+ * Determines which dependencies should be checked based on:
+ * - Check frequency (hourly, daily, weekly, monthly)
+ * - Last checked timestamp
+ * - Enabled/disabled status
+ * - IgnoreChanges flag
+ * - Config overrides
+ */
+export declare class Scheduler {
+    /**
+     * Check if a dependency should be checked now
+     *
+     * @param dependency Dependency entry
+     * @param config Configuration
+     * @param currentTime Current time (defaults to now)
+     * @returns true if dependency should be checked
+     */
+    shouldCheckDependency(dependency: DependencyEntry, config: DependabitConfig, currentTime?: Date): boolean;
+    /**
+     * Filter dependencies that should be checked
+     *
+     * @param dependencies Array of dependencies
+     * @param config Configuration
+     * @param currentTime Current time (defaults to now)
+     * @returns Filtered array of dependencies to check
+     */
+    filterDependenciesToCheck(dependencies: DependencyEntry[], config: DependabitConfig, currentTime?: Date): DependencyEntry[];
+    /**
+     * Get interval in milliseconds for a check frequency
+     *
+     * @param frequency Check frequency
+     * @returns Interval in milliseconds
+     */
+    private getIntervalMs;
+    /**
+     * Get next check time for a dependency
+     *
+     * @param dependency Dependency entry
+     * @param config Configuration
+     * @returns Next check time
+     */
+    getNextCheckTime(dependency: DependencyEntry, config: DependabitConfig): Date;
+    /**
+     * Get schedule summary for all dependencies
+     *
+     * @param dependencies Array of dependencies
+     * @param config Configuration
+     * @returns Schedule summary grouped by frequency
+     */
+    getScheduleSummary(dependencies: DependencyEntry[], config: DependabitConfig): {
+        hourly: number;
+        daily: number;
+        weekly: number;
+        monthly: number;
+        disabled: number;
+    };
+}
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EAEtB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,IAAI,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,qBAAa,SAAS;IACpB;;;;;;;OAOG;IACH,qBAAqB,CACnB,UAAU,EAAE,eAAe,EAC3B,MAAM,EAAE,gBAAgB,EACxB,WAAW,GAAE,IAAiB,GAC7B,OAAO,CAoCT;IAED;;;;;;;OAOG;IACH,yBAAyB,CACvB,YAAY,EAAE,eAAe,EAAE,EAC/B,MAAM,EAAE,gBAAgB,EACxB,WAAW,GAAE,IAAiB,GAC7B,eAAe,EAAE,CAEnB;IAED;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAerB;;;;;;OAMG;IACH,gBAAgB,CAAC,UAAU,EAAE,eAAe,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAS5E;IAED;;;;;;OAMG;IACH,kBAAkB,CAChB,YAAY,EAAE,eAAe,EAAE,EAC/B,MAAM,EAAE,gBAAgB,GACvB;QACD,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;KAClB,CA+BA;CACF"}

package/dist/scheduler.js

@@ -0,0 +1,132 @@
+import { getEffectiveMonitoringRules } from '@dependabit/manifest';
+/**
+ * Scheduler for per-dependency monitoring
+ *
+ * Determines which dependencies should be checked based on:
+ * - Check frequency (hourly, daily, weekly, monthly)
+ * - Last checked timestamp
+ * - Enabled/disabled status
+ * - IgnoreChanges flag
+ * - Config overrides
+ */
+export class Scheduler {
+    /**
+     * Check if a dependency should be checked now
+     *
+     * @param dependency Dependency entry
+     * @param config Configuration
+     * @param currentTime Current time (defaults to now)
+     * @returns true if dependency should be checked
+     */
+    shouldCheckDependency(dependency, config, currentTime = new Date()) {
+        // Check dependency's own monitoring rules first
+        if (dependency.monitoring) {
+            if (!dependency.monitoring.enabled) {
+                return false;
+            }
+            if (dependency.monitoring.ignoreChanges) {
+                return false;
+            }
+        }
+        // Get effective monitoring rules (applies config overrides)
+        const rules = getEffectiveMonitoringRules(config, dependency.url);
+        // Check if monitoring is enabled at config level
+        if (!rules.enabled) {
+            return false;
+        }
+        // Check if changes should be ignored at config level
+        if (rules.ignoreChanges) {
+            return false;
+        }
+        // Get last checked time
+        const lastChecked = new Date(dependency.lastChecked);
+        const timeSinceCheck = currentTime.getTime() - lastChecked.getTime();
+        // Determine frequency to use (dependency's own monitoring rules take precedence)
+        const checkFrequency = dependency.monitoring?.checkFrequency || rules.checkFrequency;
+        // Determine if enough time has passed based on frequency
+        const intervalMs = this.getIntervalMs(checkFrequency);
+        return timeSinceCheck >= intervalMs;
+    }
+    /**
+     * Filter dependencies that should be checked
+     *
+     * @param dependencies Array of dependencies
+     * @param config Configuration
+     * @param currentTime Current time (defaults to now)
+     * @returns Filtered array of dependencies to check
+     */
+    filterDependenciesToCheck(dependencies, config, currentTime = new Date()) {
+        return dependencies.filter((dep) => this.shouldCheckDependency(dep, config, currentTime));
+    }
+    /**
+     * Get interval in milliseconds for a check frequency
+     *
+     * @param frequency Check frequency
+     * @returns Interval in milliseconds
+     */
+    getIntervalMs(frequency) {
+        switch (frequency) {
+            case 'hourly':
+                return 60 * 60 * 1000; // 1 hour
+            case 'daily':
+                return 24 * 60 * 60 * 1000; // 24 hours
+            case 'weekly':
+                return 7 * 24 * 60 * 60 * 1000; // 7 days
+            case 'monthly':
+                return 30 * 24 * 60 * 60 * 1000; // 30 days (approximate)
+            default:
+                return 24 * 60 * 60 * 1000; // Default to daily
+        }
+    }
+    /**
+     * Get next check time for a dependency
+     *
+     * @param dependency Dependency entry
+     * @param config Configuration
+     * @returns Next check time
+     */
+    getNextCheckTime(dependency, config) {
+        const rules = getEffectiveMonitoringRules(config, dependency.url);
+        const lastChecked = new Date(dependency.lastChecked);
+        // Determine frequency to use (dependency's own monitoring rules take precedence)
+        const checkFrequency = dependency.monitoring?.checkFrequency || rules.checkFrequency;
+        const intervalMs = this.getIntervalMs(checkFrequency);
+        return new Date(lastChecked.getTime() + intervalMs);
+    }
+    /**
+     * Get schedule summary for all dependencies
+     *
+     * @param dependencies Array of dependencies
+     * @param config Configuration
+     * @returns Schedule summary grouped by frequency
+     */
+    getScheduleSummary(dependencies, config) {
+        const summary = {
+            hourly: 0,
+            daily: 0,
+            weekly: 0,
+            monthly: 0,
+            disabled: 0
+        };
+        for (const dep of dependencies) {
+            // Check dependency's own monitoring rules first
+            if (dep.monitoring) {
+                if (!dep.monitoring.enabled || dep.monitoring.ignoreChanges) {
+                    summary.disabled++;
+                    continue;
+                }
+            }
+            const rules = getEffectiveMonitoringRules(config, dep.url);
+            if (!rules.enabled || rules.ignoreChanges) {
+                summary.disabled++;
+            }
+            else {
+                // Use dependency-level frequency if available, otherwise use rules
+                const checkFrequency = dep.monitoring?.checkFrequency ?? rules.checkFrequency;
+                summary[checkFrequency]++;
+            }
+        }
+        return summary;
+    }
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/scheduler.js.map

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

package/dist/severity.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Severity Classifier
+ * Classifies dependency changes into breaking, major, or minor severity levels
+ */
+import type { ChangeDetection } from './types.js';
+export type Severity = 'breaking' | 'major' | 'minor';
+export declare class SeverityClassifier {
+    /**
+     * Classifies the severity of a change based on version changes and change types
+     */
+    classify(changes: ChangeDetection): Severity;
+    /**
+     * Classifies severity based on semantic versioning
+     * @returns Severity level or undefined if version format not recognized
+     */
+    private classifyVersionChange;
+    /**
+     * Parses a version string into [major, minor, patch]
+     */
+    private parseVersion;
+}
+//# sourceMappingURL=severity.d.ts.map

package/dist/severity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"severity.d.ts","sourceRoot":"","sources":["../src/severity.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;AAEtD,qBAAa,kBAAkB;IAC7B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,QAAQ,CAsC3C;IAED;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IA+B7B;;OAEG;IACH,OAAO,CAAC,YAAY;CAoBrB"}