@shadowcoderr/context-graph 0.3.0

package/dist/utils/pom-generator.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.POMGenerator = void 0;
+class POMGenerator {
+    /**
+     * Generates a Playwright Page Object Model (POM) from a page snapshot
+     */
+    generate(snapshot) {
+        const { metadata, locators } = snapshot;
+        const className = this.toPascalCase(metadata.pageName || 'Page');
+        let code = `import { Page, Locator, expect } from '@playwright/test';\n\n`;
+        code += `/**\n * Page Object Model for ${metadata.url}\n * Generated by ContextGraph on ${metadata.timestamp}\n */\n`;
+        code += `export class ${className} {\n`;
+        code += `  private readonly page: Page;\n`;
+        // Add locators as private properties
+        const uniqueLocators = this.filterUniqueLocators(locators.elements);
+        uniqueLocators.forEach((el, index) => {
+            const propertyName = this.toCamelCase(this.getElementName(el, index));
+            code += `  public readonly ${propertyName}: Locator;\n`;
+        });
+        code += `\n  constructor(page: Page) {\n`;
+        code += `    this.page = page;\n`;
+        // Initialize locators
+        uniqueLocators.forEach((el, index) => {
+            const propertyName = this.toCamelCase(this.getElementName(el, index));
+            const bestLocator = el.locators[0]?.value || `page.locator('${el.tagName}')`;
+            code += `    this.${propertyName} = ${bestLocator};\n`;
+        });
+        code += `  }\n\n`;
+        // Add navigation method
+        code += `  async goto() {\n`;
+        code += `    await this.page.goto('${metadata.url}');\n`;
+        code += `  }\n\n`;
+        // Add basic actions for inputs
+        uniqueLocators.filter(el => ['input', 'textarea', 'select'].includes(el.tagName)).forEach((el, index) => {
+            const propertyName = this.toCamelCase(this.getElementName(el, index));
+            const actionName = el.tagName === 'select' ? 'select' : 'fill';
+            code += `  async ${actionName}${this.toPascalCase(propertyName)}(value: string) {\n`;
+            code += `    await this.${propertyName}.${actionName}(value);\n`;
+            code += `  }\n\n`;
+        });
+        // Add click actions for buttons and links
+        uniqueLocators.filter(el => ['button', 'a'].includes(el.tagName) || el.attributes['role'] === 'button').forEach((el, index) => {
+            const propertyName = this.toCamelCase(this.getElementName(el, index));
+            code += `  async click${this.toPascalCase(propertyName)}() {\n`;
+            code += `    await this.${propertyName}.click();\n`;
+            code += `  }\n\n`;
+        });
+        code += `}\n`;
+        return code;
+    }
+    getElementName(el, index) {
+        // Try to get a meaningful name from attributes or text
+        const name = el.attributes['name'] ||
+            el.attributes['id'] ||
+            el.attributes['data-testid'] ||
+            el.attributes['aria-label'] ||
+            el.text?.trim().substring(0, 20) ||
+            `${el.tagName}${index}`;
+        return name.replace(/[^a-zA-Z0-9]/g, '_');
+    }
+    filterUniqueLocators(elements) {
+        const seen = new Set();
+        return elements.filter(el => {
+            const name = this.getElementName(el, 0);
+            if (seen.has(name))
+                return false;
+            seen.add(name);
+            return true;
+        }).slice(0, 50); // Limit to top 50 elements for POM
+    }
+    toCamelCase(str) {
+        return str.replace(/(?:^\w|[A-Z]|\b\w)/g, (word, index) => {
+            return index === 0 ? word.toLowerCase() : word.toUpperCase();
+        }).replace(/\s+/g, '').replace(/_/g, '');
+    }
+    toPascalCase(str) {
+        const camel = this.toCamelCase(str);
+        return camel.charAt(0).toUpperCase() + camel.slice(1);
+    }
+}
+exports.POMGenerator = POMGenerator;
+//# sourceMappingURL=pom-generator.js.map

package/dist/utils/pom-generator.js.map

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

package/dist/utils/validators.d.ts

@@ -0,0 +1,7 @@
+export declare function isValidUrl(url: string): boolean;
+export declare function isValidDirectory(path: string): boolean;
+export declare function validateConfig(config: any): {
+    valid: boolean;
+    errors: string[];
+};
+//# sourceMappingURL=validators.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../src/utils/validators.ts"],"names":[],"mappings":"AACA,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO/C;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,GAAG,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAkChF"}

package/dist/utils/validators.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidUrl = isValidUrl;
+exports.isValidDirectory = isValidDirectory;
+exports.validateConfig = validateConfig;
+// Developer: Shadow Coderr, Architect
+function isValidUrl(url) {
+    try {
+        new URL(url);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isValidDirectory(path) {
+    return typeof path === 'string' && path.length > 0;
+}
+function validateConfig(config) {
+    const errors = [];
+    if (!config.browser) {
+        errors.push('Browser configuration is required');
+    }
+    else {
+        if (!['msedge', 'chromium', 'firefox'].includes(config.browser.channel)) {
+            errors.push('Invalid browser channel');
+        }
+        if (typeof config.browser.headless !== 'boolean') {
+            errors.push('Headless must be a boolean');
+        }
+    }
+    if (!config.capture) {
+        errors.push('Capture configuration is required');
+    }
+    if (!config.security) {
+        errors.push('Security configuration is required');
+    }
+    if (!config.storage) {
+        errors.push('Storage configuration is required');
+    }
+    else {
+        if (!isValidDirectory(config.storage.outputDir)) {
+            errors.push('Invalid output directory');
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+//# sourceMappingURL=validators.js.map

package/dist/utils/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../../src/utils/validators.ts"],"names":[],"mappings":";;AACA,gCAOC;AAED,4CAEC;AAED,wCAkCC;AAhDD,sCAAsC;AACtC,SAAgB,UAAU,CAAC,GAAW;IACpC,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAgB,gBAAgB,CAAC,IAAY;IAC3C,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;AACrD,CAAC;AAED,SAAgB,cAAc,CAAC,MAAW;IACxC,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IACnD,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACxE,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACzC,CAAC;QACD,IAAI,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACjD,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IACpD,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IACnD,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YAChD,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC1B,MAAM;KACP,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@shadowcoderr/context-graph",
+  "version": "0.3.0",
+  "description": "A deterministic 'Flight Data Recorder' for web applications that transforms manual exploration into structured, AI-ready intelligence.",
+  "main": "dist/cli/index.js",
+  "bin": {
+    "context-graph": "dist/cli/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/cli/index.js",
+    "dev": "ts-node src/cli/index.ts",
+    "lint": "eslint src/**/*.ts",
+    "format": "prettier --write src/**/*.ts",
+    "test": "jest && npx playwright test",
+    "test:watch": "jest --watch",
+    "test:playwright": "npx playwright test",
+    "clean": "rimraf dist"
+  },
+  "keywords": [
+    "web-capture",
+    "playwright",
+    "automation",
+    "testing",
+    "ai",
+    "cli"
+  ],
+  "author": "shadowcoderr",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/shadowcoderr/ContextGraph.git"
+  },
+  "bugs": {
+    "url": "https://github.com/shadowcoderr/ContextGraph/issues"
+  },
+  "homepage": "https://github.com/shadowcoderr/ContextGraph#readme",
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@playwright/test": "^1.40.0",
+    "commander": "^11.0.0",
+    "chalk": "^5.3.0",
+    "ora": "^7.0.1",
+    "inquirer": "^9.2.12",
+    "fs-extra": "^11.2.0",
+    "sharp": "^0.33.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^9.0.7",
+    "typescript": "^5.0.0",
+    "eslint": "^8.55.0",
+    "@typescript-eslint/eslint-plugin": "^6.15.0",
+    "@typescript-eslint/parser": "^6.15.0",
+    "prettier": "^3.1.1",
+    "jest": "^29.7.0",
+    "@types/jest": "^29.5.8",
+    "ts-jest": "^29.1.1",
+    "ts-node": "^10.9.2",
+    "rimraf": "^5.0.5"
+  }
+}