@dependabit/monitor 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# @dependabit/monitor
+
+## 0.1.1
+
+### Patch Changes
+
+- Publish release setup updates and action metadata.
+- Updated dependencies
+  - @dependabit/manifest@0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-present Pradeep Mouli
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,33 @@
+# @dependabit/monitor
+
+Change detection and monitoring logic for external dependencies.
+
+## Overview
+
+This package implements the monitoring and change detection logic for tracking updates to external dependencies.
+
+## Features
+
+- Multi-strategy dependency checking
+- GitHub repository monitoring
+- Documentation URL content tracking
+- OpenAPI spec semantic diffing
+- Severity classification
+
+## Installation
+
+```bash
+pnpm add @dependabit/monitor
+```
+
+## Usage
+
+```typescript
+import { monitor } from '@dependabit/monitor';
+
+// Coming soon in Phase 5
+```
+
+## License
+
+MIT

package/dist/checkers/github-repo.d.ts

@@ -0,0 +1,17 @@
+/**
+ * GitHub Repository Checker
+ * Monitors GitHub repositories for new releases and changes
+ */
+import type { Checker, DependencySnapshot, ChangeDetection, AccessConfig } from '../types.js';
+export declare class GitHubRepoChecker implements Checker {
+    /**
+     * Fetches latest release information from a GitHub repository
+     */
+    fetch(config: AccessConfig): Promise<DependencySnapshot>;
+    private fetchLatestCommit;
+    /**
+     * Compares two snapshots to detect version/state changes
+     */
+    compare(prev: DependencySnapshot, curr: DependencySnapshot): Promise<ChangeDetection>;
+}
+//# sourceMappingURL=github-repo.d.ts.map

package/dist/checkers/github-repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-repo.d.ts","sourceRoot":"","sources":["../../src/checkers/github-repo.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG9F,qBAAa,iBAAkB,YAAW,OAAO;IAC/C;;OAEG;IACG,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA+D7D;YAKa,iBAAiB;IA4C/B;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CAqB1F;CACF"}

package/dist/checkers/github-repo.js

@@ -0,0 +1,115 @@
+/**
+ * GitHub Repository Checker
+ * Monitors GitHub repositories for new releases and changes
+ */
+import crypto from 'node:crypto';
+export class GitHubRepoChecker {
+    /**
+     * Fetches latest release information from a GitHub repository
+     */
+    async fetch(config) {
+        const { url } = config;
+        // Extract owner and repo from GitHub URL
+        const match = url.match(/github\.com\/([^/]+)\/([^/]+)/);
+        if (!match || !match[1] || !match[2]) {
+            throw new Error(`Invalid GitHub URL: ${url}`);
+        }
+        const owner = match[1];
+        const repo = match[2];
+        const cleanRepo = repo.replace(/\.git$/, '');
+        try {
+            // Fetch latest release from GitHub API
+            const apiUrl = `https://api.github.com/repos/${owner}/${cleanRepo}/releases/latest`;
+            const response = await fetch(apiUrl, {
+                headers: {
+                    Accept: 'application/vnd.github+json',
+                    'User-Agent': 'dependabit',
+                    ...(config.auth?.secret && { Authorization: `Bearer ${config.auth.secret}` })
+                }
+            });
+            if (response.status === 404) {
+                // No releases found, fall back to latest commit
+                return this.fetchLatestCommit(owner, cleanRepo, config.auth?.secret);
+            }
+            if (!response.ok) {
+                throw new Error(`GitHub API error: ${response.status} ${response.statusText}`);
+            }
+            const release = (await response.json());
+            // Create state hash from release info
+            const stateContent = JSON.stringify({
+                tagName: release.tag_name,
+                name: release.name,
+                publishedAt: release.published_at
+            });
+            const stateHash = crypto.createHash('sha256').update(stateContent).digest('hex');
+            return {
+                version: release.tag_name,
+                stateHash,
+                fetchedAt: new Date(),
+                metadata: {
+                    name: release.name,
+                    publishedAt: release.published_at,
+                    body: release.body,
+                    htmlUrl: release.html_url
+                }
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to fetch GitHub release: ${error.message}`);
+        }
+    }
+    /**
+     * Fallback: Fetch latest commit when no releases exist
+     */
+    async fetchLatestCommit(owner, repo, token) {
+        const apiUrl = `https://api.github.com/repos/${owner}/${repo}/commits?per_page=1`;
+        const response = await fetch(apiUrl, {
+            headers: {
+                Accept: 'application/vnd.github+json',
+                'User-Agent': 'dependabit',
+                ...(token && { Authorization: `Bearer ${token}` })
+            }
+        });
+        if (!response.ok) {
+            throw new Error(`GitHub API error: ${response.status} ${response.statusText}`);
+        }
+        const commits = (await response.json());
+        if (commits.length === 0 || !commits[0]) {
+            throw new Error('No commits found in repository');
+        }
+        const latestCommit = commits[0];
+        const stateHash = latestCommit.sha;
+        return {
+            stateHash,
+            fetchedAt: new Date(),
+            metadata: {
+                sha: latestCommit.sha,
+                message: latestCommit.commit.message,
+                date: latestCommit.commit.author.date
+            }
+        };
+    }
+    /**
+     * Compares two snapshots to detect version/state changes
+     */
+    async compare(prev, curr) {
+        const changes = [];
+        // Check version change
+        if (prev.version !== curr.version) {
+            if (prev.version && curr.version) {
+                changes.push('version');
+            }
+        }
+        // Check state hash change
+        if (prev.stateHash !== curr.stateHash) {
+            changes.push('stateHash');
+        }
+        return {
+            hasChanged: changes.length > 0,
+            changes,
+            oldVersion: prev.version,
+            newVersion: curr.version
+        };
+    }
+}
+//# sourceMappingURL=github-repo.js.map

package/dist/checkers/github-repo.js.map

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

package/dist/checkers/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Dependency checkers for different access methods
+ */
+export { GitHubRepoChecker } from './github-repo.js';
+export { URLContentChecker } from './url-content.js';
+export { OpenAPIChecker } from './openapi.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/checkers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/checkers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/checkers/index.js

@@ -0,0 +1,7 @@
+/**
+ * Dependency checkers for different access methods
+ */
+export { GitHubRepoChecker } from './github-repo.js';
+export { URLContentChecker } from './url-content.js';
+export { OpenAPIChecker } from './openapi.js';
+//# sourceMappingURL=index.js.map

package/dist/checkers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/checkers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/checkers/openapi.d.ts

@@ -0,0 +1,24 @@
+/**
+ * OpenAPI Spec Checker
+ * Monitors OpenAPI/Swagger specifications for changes with semantic diffing
+ */
+import type { Checker, DependencySnapshot, ChangeDetection, AccessConfig } from '../types.js';
+export declare class OpenAPIChecker implements Checker {
+    /**
+     * Fetches and parses OpenAPI specification
+     */
+    fetch(config: AccessConfig): Promise<DependencySnapshot>;
+    /**
+     * Extract endpoints from OpenAPI spec
+     */
+    private extractEndpoints;
+    /**
+     * Extract schemas from OpenAPI spec
+     */
+    private extractSchemas;
+    /**
+     * Compares two OpenAPI snapshots with semantic diffing
+     */
+    compare(prev: DependencySnapshot, curr: DependencySnapshot): Promise<ChangeDetection>;
+}
+//# sourceMappingURL=openapi.d.ts.map

package/dist/checkers/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../src/checkers/openapi.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA2D9F,qBAAa,cAAe,YAAW,OAAO;IAC5C;;OAEG;IACG,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAqE7D;IAED;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgCxB;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CA4H1F;CACF"}

package/dist/checkers/openapi.js

@@ -0,0 +1,221 @@
+/**
+ * OpenAPI Spec Checker
+ * Monitors OpenAPI/Swagger specifications for changes with semantic diffing
+ */
+import crypto from 'node:crypto';
+import { parse as parseYAML } from 'yaml';
+export class OpenAPIChecker {
+    /**
+     * Fetches and parses OpenAPI specification
+     */
+    async fetch(config) {
+        const { url } = config;
+        try {
+            const headers = {
+                Accept: 'application/json, application/yaml, text/yaml, */*',
+                'User-Agent': 'dependabit-monitor/1.0'
+            };
+            if (config.auth?.secret) {
+                if (config.auth.type === 'token' || config.auth.type === 'oauth') {
+                    headers['Authorization'] = `Bearer ${config.auth.secret}`;
+                }
+                else if (config.auth.type === 'basic') {
+                    headers['Authorization'] = `Basic ${config.auth.secret}`;
+                }
+            }
+            const response = await fetch(url, {
+                headers
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP error: ${response.status} ${response.statusText}`);
+            }
+            const contentType = response.headers.get('content-type') || '';
+            const content = await response.text();
+            // Parse the OpenAPI spec
+            let spec;
+            if (contentType.includes('yaml') || url.endsWith('.yaml') || url.endsWith('.yml')) {
+                // Parse YAML using standard yaml library
+                spec = parseYAML(content);
+            }
+            else {
+                spec = JSON.parse(content);
+            }
+            // Extract key information for semantic comparison
+            const endpoints = this.extractEndpoints(spec);
+            const schemas = this.extractSchemas(spec);
+            const version = spec.info?.version;
+            // Create a deterministic hash from the semantic content
+            const semanticContent = JSON.stringify({
+                version,
+                endpoints: Object.keys(endpoints).sort(),
+                schemas: Object.keys(schemas).sort(),
+                endpointDetails: endpoints,
+                schemaDetails: schemas
+            });
+            const stateHash = crypto.createHash('sha256').update(semanticContent).digest('hex');
+            return {
+                version,
+                stateHash,
+                fetchedAt: new Date(),
+                metadata: {
+                    title: spec.info?.title,
+                    description: spec.info?.description,
+                    specVersion: spec.openapi || spec.swagger,
+                    endpointCount: Object.keys(endpoints).length,
+                    schemaCount: Object.keys(schemas).length,
+                    endpoints,
+                    schemas
+                }
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to fetch OpenAPI spec: ${error.message}`);
+        }
+    }
+    /**
+     * Extract endpoints from OpenAPI spec
+     */
+    extractEndpoints(spec) {
+        const endpoints = {};
+        if (!spec.paths)
+            return endpoints;
+        for (const [path, pathItem] of Object.entries(spec.paths)) {
+            const methods = [];
+            const httpMethods = [
+                'get',
+                'post',
+                'put',
+                'patch',
+                'delete',
+                'options',
+                'head',
+                'trace'
+            ];
+            for (const method of httpMethods) {
+                if (pathItem[method]) {
+                    methods.push(method.toUpperCase());
+                }
+            }
+            if (methods.length > 0) {
+                endpoints[path] = methods;
+            }
+        }
+        return endpoints;
+    }
+    /**
+     * Extract schemas from OpenAPI spec
+     */
+    extractSchemas(spec) {
+        return spec.components?.schemas || {};
+    }
+    /**
+     * Compares two OpenAPI snapshots with semantic diffing
+     */
+    async compare(prev, curr) {
+        const changes = [];
+        let severity = 'minor';
+        // Extract endpoints and schemas from metadata
+        let prevEndpoints = prev.metadata?.['endpoints'] || {};
+        let currEndpoints = curr.metadata?.['endpoints'] || {};
+        let prevSchemas = prev.metadata?.['schemas'] || {};
+        let currSchemas = curr.metadata?.['schemas'] || {};
+        // If the state hashes match but previous metadata is missing, avoid spurious diffs
+        if (prev.stateHash !== undefined &&
+            curr.stateHash !== undefined &&
+            prev.stateHash === curr.stateHash) {
+            prevEndpoints = currEndpoints;
+            prevSchemas = currSchemas;
+        }
+        const diff = {
+            addedEndpoints: [],
+            removedEndpoints: [],
+            modifiedEndpoints: [],
+            addedSchemas: [],
+            removedSchemas: [],
+            modifiedSchemas: [],
+            versionChanged: prev.version !== curr.version
+        };
+        if (prev.version !== undefined) {
+            diff.oldVersion = prev.version;
+        }
+        if (curr.version !== undefined) {
+            diff.newVersion = curr.version;
+        }
+        // Compare endpoints
+        const prevEndpointKeys = Object.keys(prevEndpoints);
+        const currEndpointKeys = Object.keys(currEndpoints);
+        for (const path of currEndpointKeys) {
+            if (!prevEndpointKeys.includes(path)) {
+                diff.addedEndpoints.push(path);
+            }
+            else if (JSON.stringify(prevEndpoints[path]) !== JSON.stringify(currEndpoints[path])) {
+                diff.modifiedEndpoints.push(path);
+            }
+        }
+        for (const path of prevEndpointKeys) {
+            if (!currEndpointKeys.includes(path)) {
+                diff.removedEndpoints.push(path);
+            }
+        }
+        // Compare schemas
+        const prevSchemaKeys = Object.keys(prevSchemas);
+        const currSchemaKeys = Object.keys(currSchemas);
+        for (const schema of currSchemaKeys) {
+            if (!prevSchemaKeys.includes(schema)) {
+                diff.addedSchemas.push(schema);
+            }
+            else if (JSON.stringify(prevSchemas[schema]) !== JSON.stringify(currSchemas[schema])) {
+                diff.modifiedSchemas.push(schema);
+            }
+        }
+        for (const schema of prevSchemaKeys) {
+            if (!currSchemaKeys.includes(schema)) {
+                diff.removedSchemas.push(schema);
+            }
+        }
+        // Determine changes and severity
+        if (diff.removedEndpoints.length > 0) {
+            changes.push('endpoints_removed');
+            severity = 'breaking';
+        }
+        if (diff.removedSchemas.length > 0) {
+            changes.push('schemas_removed');
+            severity = 'breaking';
+        }
+        if (diff.modifiedEndpoints.length > 0) {
+            changes.push('endpoints_modified');
+            if (severity !== 'breaking')
+                severity = 'major';
+        }
+        if (diff.modifiedSchemas.length > 0) {
+            changes.push('schemas_modified');
+            if (severity !== 'breaking')
+                severity = 'major';
+        }
+        if (diff.addedEndpoints.length > 0) {
+            changes.push('endpoints_added');
+        }
+        if (diff.addedSchemas.length > 0) {
+            changes.push('schemas_added');
+        }
+        if (diff.versionChanged) {
+            changes.push('version');
+        }
+        // Check overall hash change
+        if (prev.stateHash !== curr.stateHash && changes.length === 0) {
+            changes.push('content');
+        }
+        const result = {
+            hasChanged: changes.length > 0,
+            changes,
+            oldVersion: prev.version,
+            newVersion: curr.version,
+            diff
+        };
+        if (changes.length > 0) {
+            result.severity = severity;
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=openapi.js.map

package/dist/checkers/openapi.js.map

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

package/dist/checkers/url-content.d.ts

@@ -0,0 +1,16 @@
+/**
+ * URL Content Checker
+ * Monitors documentation URLs for content changes using SHA256 hashing
+ */
+import type { Checker, DependencySnapshot, ChangeDetection, AccessConfig } from '../types.js';
+export declare class URLContentChecker implements Checker {
+    /**
+     * Fetches and hashes URL content
+     */
+    fetch(config: AccessConfig): Promise<DependencySnapshot>;
+    /**
+     * Compares two snapshots to detect content changes
+     */
+    compare(prev: DependencySnapshot, curr: DependencySnapshot): Promise<ChangeDetection>;
+}
+//# sourceMappingURL=url-content.d.ts.map

package/dist/checkers/url-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-content.d.ts","sourceRoot":"","sources":["../../src/checkers/url-content.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI9F,qBAAa,iBAAkB,YAAW,OAAO;IAC/C;;OAEG;IACG,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA8C7D;IAED;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CAY1F;CACF"}

package/dist/checkers/url-content.js

@@ -0,0 +1,66 @@
+/**
+ * URL Content Checker
+ * Monitors documentation URLs for content changes using SHA256 hashing
+ */
+import { normalizeHTML } from '../normalizer.js';
+import crypto from 'node:crypto';
+export class URLContentChecker {
+    /**
+     * Fetches and hashes URL content
+     */
+    async fetch(config) {
+        const { url } = config;
+        try {
+            const response = await fetch(url, {
+                headers: {
+                    'User-Agent': 'dependabit-monitor/1.0'
+                }
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP error: ${response.status} ${response.statusText}`);
+            }
+            const contentType = response.headers.get('content-type') || '';
+            const content = await response.text();
+            let normalizedContent;
+            // Apply HTML normalization if content is HTML
+            if (contentType.includes('text/html') ||
+                content.trim().startsWith('<!DOCTYPE') ||
+                content.trim().startsWith('<html')) {
+                normalizedContent = normalizeHTML(content);
+            }
+            else {
+                // For non-HTML content (markdown, plain text, etc.), just normalize whitespace
+                normalizedContent = content.replace(/\s+/g, ' ').trim();
+            }
+            // Generate SHA256 hash of normalized content
+            const stateHash = crypto.createHash('sha256').update(normalizedContent).digest('hex');
+            return {
+                stateHash,
+                fetchedAt: new Date(),
+                metadata: {
+                    contentType,
+                    contentLength: content.length,
+                    normalizedLength: normalizedContent.length
+                }
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to fetch URL content: ${error.message}`);
+        }
+    }
+    /**
+     * Compares two snapshots to detect content changes
+     */
+    async compare(prev, curr) {
+        const changes = [];
+        // Content changed if hashes differ
+        if (prev.stateHash !== curr.stateHash) {
+            changes.push('content');
+        }
+        return {
+            hasChanged: changes.length > 0,
+            changes
+        };
+    }
+}
+//# sourceMappingURL=url-content.js.map

package/dist/checkers/url-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-content.js","sourceRoot":"","sources":["../../src/checkers/url-content.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,MAAM,OAAO,iBAAiB;IAC5B;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,MAAoB,EAA+B;QAC7D,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC;QAEvB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,OAAO,EAAE;oBACP,YAAY,EAAE,wBAAwB;iBACvC;aACF,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,eAAe,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YAC3E,CAAC;YAED,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;YAC/D,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAEtC,IAAI,iBAAyB,CAAC;YAE9B,8CAA8C;YAC9C,IACE,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC;gBACjC,OAAO,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC;gBACtC,OAAO,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAClC,CAAC;gBACD,iBAAiB,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;YAC7C,CAAC;iBAAM,CAAC;gBACN,+EAA+E;gBAC/E,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;YAC1D,CAAC;YAED,6CAA6C;YAC7C,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAEtF,OAAO;gBACL,SAAS;gBACT,SAAS,EAAE,IAAI,IAAI,EAAE;gBACrB,QAAQ,EAAE;oBACR,WAAW;oBACX,aAAa,EAAE,OAAO,CAAC,MAAM;oBAC7B,gBAAgB,EAAE,iBAAiB,CAAC,MAAM;iBAC3C;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,gCAAiC,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9E,CAAC;IAAA,CACF;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,IAAwB,EAAE,IAAwB,EAA4B;QAC1F,MAAM,OAAO,GAAa,EAAE,CAAC;QAE7B,mCAAmC;QACnC,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1B,CAAC;QAED,OAAO;YACL,UAAU,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC;YAC9B,OAAO;SACR,CAAC;IAAA,CACH;CACF"}

package/dist/comparator.d.ts

@@ -0,0 +1,16 @@
+/**
+ * State Comparator
+ * Generic comparison logic for dependency state snapshots
+ */
+import type { DependencySnapshot, ChangeDetection } from './types.js';
+export declare class StateComparator {
+    /**
+     * Compares two dependency snapshots to detect changes
+     */
+    compare(oldState: DependencySnapshot, newState: DependencySnapshot): ChangeDetection;
+    /**
+     * Checks if metadata has changed (shallow comparison)
+     */
+    private hasMetadataChanges;
+}
+//# sourceMappingURL=comparator.d.ts.map

package/dist/comparator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparator.d.ts","sourceRoot":"","sources":["../src/comparator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEtE,qBAAa,eAAe;IAC1B;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,kBAAkB,EAAE,QAAQ,EAAE,kBAAkB,GAAG,eAAe,CAwBnF;IAED;;OAEG;IACH,OAAO,CAAC,kBAAkB;CA2B3B"}