@grafema/core 0.2.5-beta → 0.2.7

package/dist/core/nodes/ExpressMountNode.js

@@ -0,0 +1,61 @@
+/**
+ * ExpressMountNode - contract for express:mount nodes
+ *
+ * Represents an Express.js mount point (app.use('/prefix', router)).
+ * Created by ExpressAnalyzer.
+ *
+ * ID format: express:mount#${prefix}#${file}#${line}
+ */
+export class ExpressMountNode {
+    static TYPE = 'express:mount';
+    static REQUIRED = ['prefix', 'file', 'line', 'column'];
+    static OPTIONAL = ['targetFunction', 'targetVariable', 'mountedOn'];
+    /**
+     * Create express:mount node
+     *
+     * @param prefix - Mount path prefix (e.g., "/api", "/users")
+     * @param file - File path where mount is defined
+     * @param line - Line number
+     * @param column - Column number
+     * @param options - Optional fields
+     */
+    static create(prefix, file, line, column, options = {}) {
+        const id = `express:mount#${prefix}#${file}#${line}`;
+        const node = {
+            id,
+            type: this.TYPE,
+            name: `mount:${prefix}`,
+            file,
+            line,
+            column,
+        };
+        node.prefix = prefix;
+        if (options.targetFunction !== undefined) {
+            node.targetFunction = options.targetFunction;
+        }
+        if (options.targetVariable !== undefined) {
+            node.targetVariable = options.targetVariable;
+        }
+        if (options.mountedOn !== undefined) {
+            node.mountedOn = options.mountedOn;
+        }
+        return node;
+    }
+    /**
+     * Validate express:mount node structure
+     */
+    static validate(node) {
+        const errors = [];
+        if (node.type !== this.TYPE) {
+            errors.push(`Expected type ${this.TYPE}, got ${node.type}`);
+        }
+        const record = node;
+        for (const field of this.REQUIRED) {
+            if (record[field] === undefined) {
+                errors.push(`Missing required field: ${field}`);
+            }
+        }
+        return errors;
+    }
+}
+//# sourceMappingURL=ExpressMountNode.js.map

package/dist/core/nodes/ExpressMountNode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpressMountNode.js","sourceRoot":"","sources":["../../../src/core/nodes/ExpressMountNode.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAoBH,MAAM,OAAO,gBAAgB;IAC3B,MAAM,CAAU,IAAI,GAAG,eAAwB,CAAC;IAEhD,MAAM,CAAU,QAAQ,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAU,CAAC;IACzE,MAAM,CAAU,QAAQ,GAAG,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,WAAW,CAAU,CAAC;IAEtF;;;;;;;;OAQG;IACH,MAAM,CAAC,MAAM,CACX,MAAc,EACd,IAAY,EACZ,IAAY,EACZ,MAAc,EACd,UAAmC,EAAE;QAErC,MAAM,EAAE,GAAG,iBAAiB,MAAM,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;QAErD,MAAM,IAAI,GAA2B;YACnC,EAAE;YACF,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,SAAS,MAAM,EAAE;YACvB,IAAI;YACJ,IAAI;YACJ,MAAM;SACP,CAAC;QAED,IAAgC,CAAC,MAAM,GAAG,MAAM,CAAC;QAElD,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;YACxC,IAAgC,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;QAC5E,CAAC;QACD,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;YACxC,IAAgC,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;QAC5E,CAAC;QACD,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACnC,IAAgC,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QAClE,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAA4B;QAC1C,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,MAAM,GAAG,IAA0C,CAAC;QAC1D,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC;gBAChC,MAAM,CAAC,IAAI,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC"}

package/dist/core/nodes/ExternalApiNode.d.ts

@@ -0,0 +1,29 @@
+/**
+ * ExternalApiNode - contract for EXTERNAL nodes
+ *
+ * Represents an external API domain detected from HTTP requests.
+ * Created by FetchAnalyzer when URLs point to external hosts.
+ *
+ * ID format: EXTERNAL#${domain}
+ */
+import type { BaseNodeRecord } from '@grafema/types';
+interface ExternalApiNodeRecord extends BaseNodeRecord {
+    type: 'EXTERNAL';
+}
+export declare class ExternalApiNode {
+    static readonly TYPE: "EXTERNAL";
+    static readonly REQUIRED: readonly ["name"];
+    static readonly OPTIONAL: readonly ["domain"];
+    /**
+     * Create EXTERNAL node for an API domain
+     *
+     * @param domain - External API domain (e.g., "api.github.com")
+     */
+    static create(domain: string): ExternalApiNodeRecord;
+    /**
+     * Validate EXTERNAL node structure
+     */
+    static validate(node: ExternalApiNodeRecord): string[];
+}
+export type { ExternalApiNodeRecord };
+//# sourceMappingURL=ExternalApiNode.d.ts.map

package/dist/core/nodes/ExternalApiNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExternalApiNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/ExternalApiNode.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,UAAU,qBAAsB,SAAQ,cAAc;IACpD,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,qBAAa,eAAe;IAC1B,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAU;IAE3C,MAAM,CAAC,QAAQ,CAAC,QAAQ,oBAAqB;IAC7C,MAAM,CAAC,QAAQ,CAAC,QAAQ,sBAAuB;IAE/C;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,qBAAqB;IAWpD;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,EAAE;CAUvD;AAED,YAAY,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/core/nodes/ExternalApiNode.js

@@ -0,0 +1,41 @@
+/**
+ * ExternalApiNode - contract for EXTERNAL nodes
+ *
+ * Represents an external API domain detected from HTTP requests.
+ * Created by FetchAnalyzer when URLs point to external hosts.
+ *
+ * ID format: EXTERNAL#${domain}
+ */
+export class ExternalApiNode {
+    static TYPE = 'EXTERNAL';
+    static REQUIRED = ['name'];
+    static OPTIONAL = ['domain'];
+    /**
+     * Create EXTERNAL node for an API domain
+     *
+     * @param domain - External API domain (e.g., "api.github.com")
+     */
+    static create(domain) {
+        const id = `EXTERNAL#${domain}`;
+        return {
+            id,
+            type: this.TYPE,
+            name: domain,
+            domain,
+        };
+    }
+    /**
+     * Validate EXTERNAL node structure
+     */
+    static validate(node) {
+        const errors = [];
+        if (node.type !== this.TYPE) {
+            errors.push(`Expected type ${this.TYPE}, got ${node.type}`);
+        }
+        if (!node.name) {
+            errors.push('Missing required field: name');
+        }
+        return errors;
+    }
+}
+//# sourceMappingURL=ExternalApiNode.js.map

package/dist/core/nodes/ExternalApiNode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExternalApiNode.js","sourceRoot":"","sources":["../../../src/core/nodes/ExternalApiNode.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,MAAM,OAAO,eAAe;IAC1B,MAAM,CAAU,IAAI,GAAG,UAAmB,CAAC;IAE3C,MAAM,CAAU,QAAQ,GAAG,CAAC,MAAM,CAAU,CAAC;IAC7C,MAAM,CAAU,QAAQ,GAAG,CAAC,QAAQ,CAAU,CAAC;IAE/C;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,MAAc;QAC1B,MAAM,EAAE,GAAG,YAAY,MAAM,EAAE,CAAC;QAEhC,OAAO;YACL,EAAE;YACF,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,MAAM;YACZ,MAAM;SACkB,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAA2B;QACzC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC"}

package/dist/core/nodes/ExternalFunctionNode.d.ts

@@ -0,0 +1,40 @@
+/**
+ * ExternalFunctionNode - contract for EXTERNAL_FUNCTION node
+ *
+ * Represents an external function from a Node.js built-in module
+ * (e.g., fs.readFile, path.join, crypto.createHash).
+ *
+ * Created lazily by NodejsBuiltinsResolver when a call to a builtin function is detected.
+ *
+ * ID format: EXTERNAL_FUNCTION:{module}.{function}
+ * Example: EXTERNAL_FUNCTION:fs.readFile, EXTERNAL_FUNCTION:path.join
+ */
+import type { BaseNodeRecord } from '@grafema/types';
+import type { SecurityCategory } from '../../data/builtins/types.js';
+interface ExternalFunctionNodeRecord extends BaseNodeRecord {
+    type: 'EXTERNAL_FUNCTION';
+    isBuiltin: boolean;
+    security?: SecurityCategory;
+    pure?: boolean;
+}
+interface ExternalFunctionOptions {
+    security?: SecurityCategory;
+    pure?: boolean;
+}
+export declare class ExternalFunctionNode {
+    static readonly TYPE: "EXTERNAL_FUNCTION";
+    static readonly REQUIRED: readonly ["name", "isBuiltin"];
+    static readonly OPTIONAL: readonly ["security", "pure"];
+    /**
+     * Create EXTERNAL_FUNCTION node
+     *
+     * @param moduleName - Normalized module name (e.g., 'fs', 'path', 'crypto')
+     * @param functionName - Function name (e.g., 'readFile', 'join')
+     * @param options - Optional security and pure fields
+     * @returns ExternalFunctionNodeRecord
+     */
+    static create(moduleName: string, functionName: string, options?: ExternalFunctionOptions): ExternalFunctionNodeRecord;
+    static validate(node: ExternalFunctionNodeRecord): string[];
+}
+export type { ExternalFunctionNodeRecord, ExternalFunctionOptions };
+//# sourceMappingURL=ExternalFunctionNode.d.ts.map

package/dist/core/nodes/ExternalFunctionNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExternalFunctionNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/ExternalFunctionNode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE,UAAU,0BAA2B,SAAQ,cAAc;IACzD,IAAI,EAAE,mBAAmB,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,UAAU,uBAAuB;IAC/B,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,qBAAa,oBAAoB;IAC/B,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,mBAAmB,CAAU;IAEpD,MAAM,CAAC,QAAQ,CAAC,QAAQ,iCAAkC;IAC1D,MAAM,CAAC,QAAQ,CAAC,QAAQ,gCAAiC;IAEzD;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,GAAE,uBAA4B,GAAG,0BAA0B;IAgB1H,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,0BAA0B,GAAG,MAAM,EAAE;CAiB5D;AAED,YAAY,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/core/nodes/ExternalFunctionNode.js

@@ -0,0 +1,54 @@
+/**
+ * ExternalFunctionNode - contract for EXTERNAL_FUNCTION node
+ *
+ * Represents an external function from a Node.js built-in module
+ * (e.g., fs.readFile, path.join, crypto.createHash).
+ *
+ * Created lazily by NodejsBuiltinsResolver when a call to a builtin function is detected.
+ *
+ * ID format: EXTERNAL_FUNCTION:{module}.{function}
+ * Example: EXTERNAL_FUNCTION:fs.readFile, EXTERNAL_FUNCTION:path.join
+ */
+export class ExternalFunctionNode {
+    static TYPE = 'EXTERNAL_FUNCTION';
+    static REQUIRED = ['name', 'isBuiltin'];
+    static OPTIONAL = ['security', 'pure'];
+    /**
+     * Create EXTERNAL_FUNCTION node
+     *
+     * @param moduleName - Normalized module name (e.g., 'fs', 'path', 'crypto')
+     * @param functionName - Function name (e.g., 'readFile', 'join')
+     * @param options - Optional security and pure fields
+     * @returns ExternalFunctionNodeRecord
+     */
+    static create(moduleName, functionName, options = {}) {
+        if (!moduleName)
+            throw new Error('ExternalFunctionNode.create: moduleName is required');
+        if (!functionName)
+            throw new Error('ExternalFunctionNode.create: functionName is required');
+        return {
+            id: `EXTERNAL_FUNCTION:${moduleName}.${functionName}`,
+            type: this.TYPE,
+            name: `${moduleName}.${functionName}`,
+            file: '',
+            line: 0,
+            isBuiltin: true,
+            ...(options.security && { security: options.security }),
+            ...(options.pure !== undefined && { pure: options.pure }),
+        };
+    }
+    static validate(node) {
+        const errors = [];
+        if (node.type !== this.TYPE) {
+            errors.push(`Expected type ${this.TYPE}, got ${node.type}`);
+        }
+        if (!node.name) {
+            errors.push('Missing required field: name');
+        }
+        if (node.isBuiltin === undefined) {
+            errors.push('Missing required field: isBuiltin');
+        }
+        return errors;
+    }
+}
+//# sourceMappingURL=ExternalFunctionNode.js.map

package/dist/core/nodes/ExternalFunctionNode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExternalFunctionNode.js","sourceRoot":"","sources":["../../../src/core/nodes/ExternalFunctionNode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAiBH,MAAM,OAAO,oBAAoB;IAC/B,MAAM,CAAU,IAAI,GAAG,mBAA4B,CAAC;IAEpD,MAAM,CAAU,QAAQ,GAAG,CAAC,MAAM,EAAE,WAAW,CAAU,CAAC;IAC1D,MAAM,CAAU,QAAQ,GAAG,CAAC,UAAU,EAAE,MAAM,CAAU,CAAC;IAEzD;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,CAAC,UAAkB,EAAE,YAAoB,EAAE,UAAmC,EAAE;QAC3F,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACxF,IAAI,CAAC,YAAY;YAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAE5F,OAAO;YACL,EAAE,EAAE,qBAAqB,UAAU,IAAI,YAAY,EAAE;YACrD,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,GAAG,UAAU,IAAI,YAAY,EAAE;YACrC,IAAI,EAAE,EAAE;YACR,IAAI,EAAE,CAAC;YACP,SAAS,EAAE,IAAI;YACf,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;YACvD,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;SAC1D,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,IAAgC;QAC9C,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9D,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QACnD,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC"}

package/dist/core/nodes/FetchRequestNode.d.ts

@@ -0,0 +1,54 @@
+/**
+ * FetchRequestNode - contract for http:request nodes
+ *
+ * Represents an HTTP request call site detected from fetch(), axios,
+ * or custom wrapper patterns. Created by FetchAnalyzer.
+ *
+ * NOT the same as HttpRequestNode (type: HTTP_REQUEST), which is the
+ * older contract for generic HTTP request nodes created by GraphBuilder.
+ * This uses namespaced type 'http:request' for semantic grouping.
+ *
+ * ID format: http:request#${method}:${url}#${file}#${line}
+ */
+import type { BaseNodeRecord } from '@grafema/types';
+interface FetchRequestNodeRecord extends BaseNodeRecord {
+    type: 'http:request';
+    method: string;
+    url: string;
+    library: string;
+    file: string;
+    line: number;
+    column: number;
+    staticUrl: 'yes' | 'no';
+}
+interface FetchRequestNodeOptions {
+    /** Human-readable name (e.g., "GET /api/users") */
+    name?: string;
+    /** How the method was determined */
+    methodSource?: 'explicit' | 'default' | 'unknown';
+    /** ID of CALL node for response.json(), response.text(), etc. */
+    responseDataNode?: string | null;
+}
+export declare class FetchRequestNode {
+    static readonly TYPE: "http:request";
+    static readonly REQUIRED: readonly ["method", "url", "library", "file", "line", "column", "staticUrl"];
+    static readonly OPTIONAL: readonly ["name", "methodSource", "responseDataNode"];
+    /**
+     * Create http:request node
+     *
+     * @param method - HTTP method (GET, POST, etc.)
+     * @param url - Request URL or 'dynamic'/'unknown'
+     * @param library - Library name ('fetch', 'axios', or custom wrapper name)
+     * @param file - File path where request is made
+     * @param line - Line number
+     * @param column - Column number
+     * @param options - Optional fields
+     */
+    static create(method: string, url: string, library: string, file: string, line: number, column: number, options?: FetchRequestNodeOptions): FetchRequestNodeRecord;
+    /**
+     * Validate http:request node structure
+     */
+    static validate(node: FetchRequestNodeRecord): string[];
+}
+export type { FetchRequestNodeRecord, FetchRequestNodeOptions };
+//# sourceMappingURL=FetchRequestNode.d.ts.map

package/dist/core/nodes/FetchRequestNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FetchRequestNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/FetchRequestNode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,UAAU,sBAAuB,SAAQ,cAAc;IACrD,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,KAAK,GAAG,IAAI,CAAC;CACzB;AAED,UAAU,uBAAuB;IAC/B,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,YAAY,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;IAClD,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,qBAAa,gBAAgB;IAC3B,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,cAAc,CAAU;IAE/C,MAAM,CAAC,QAAQ,CAAC,QAAQ,+EAAgF;IACxG,MAAM,CAAC,QAAQ,CAAC,QAAQ,wDAAyD;IAEjF;;;;;;;;;;OAUG;IACH,MAAM,CAAC,MAAM,CACX,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,uBAA4B,GACpC,sBAAsB;IA0BzB;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,sBAAsB,GAAG,MAAM,EAAE;CAaxD;AAED,YAAY,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/core/nodes/FetchRequestNode.js

@@ -0,0 +1,67 @@
+/**
+ * FetchRequestNode - contract for http:request nodes
+ *
+ * Represents an HTTP request call site detected from fetch(), axios,
+ * or custom wrapper patterns. Created by FetchAnalyzer.
+ *
+ * NOT the same as HttpRequestNode (type: HTTP_REQUEST), which is the
+ * older contract for generic HTTP request nodes created by GraphBuilder.
+ * This uses namespaced type 'http:request' for semantic grouping.
+ *
+ * ID format: http:request#${method}:${url}#${file}#${line}
+ */
+export class FetchRequestNode {
+    static TYPE = 'http:request';
+    static REQUIRED = ['method', 'url', 'library', 'file', 'line', 'column', 'staticUrl'];
+    static OPTIONAL = ['name', 'methodSource', 'responseDataNode'];
+    /**
+     * Create http:request node
+     *
+     * @param method - HTTP method (GET, POST, etc.)
+     * @param url - Request URL or 'dynamic'/'unknown'
+     * @param library - Library name ('fetch', 'axios', or custom wrapper name)
+     * @param file - File path where request is made
+     * @param line - Line number
+     * @param column - Column number
+     * @param options - Optional fields
+     */
+    static create(method, url, library, file, line, column, options = {}) {
+        const id = `http:request#${method}:${url}#${file}#${line}`;
+        const node = {
+            id,
+            type: this.TYPE,
+            name: options.name || `${method} ${url}`,
+            method,
+            url,
+            library,
+            file,
+            line,
+            column,
+            staticUrl: url !== 'dynamic' && url !== 'unknown' ? 'yes' : 'no',
+        };
+        if (options.methodSource !== undefined) {
+            node.methodSource = options.methodSource;
+        }
+        if (options.responseDataNode !== undefined) {
+            node.responseDataNode = options.responseDataNode;
+        }
+        return node;
+    }
+    /**
+     * Validate http:request node structure
+     */
+    static validate(node) {
+        const errors = [];
+        if (node.type !== this.TYPE) {
+            errors.push(`Expected type ${this.TYPE}, got ${node.type}`);
+        }
+        const record = node;
+        for (const field of this.REQUIRED) {
+            if (record[field] === undefined) {
+                errors.push(`Missing required field: ${field}`);
+            }
+        }
+        return errors;
+    }
+}
+//# sourceMappingURL=FetchRequestNode.js.map

package/dist/core/nodes/FetchRequestNode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FetchRequestNode.js","sourceRoot":"","sources":["../../../src/core/nodes/FetchRequestNode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAwBH,MAAM,OAAO,gBAAgB;IAC3B,MAAM,CAAU,IAAI,GAAG,cAAuB,CAAC;IAE/C,MAAM,CAAU,QAAQ,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAU,CAAC;IACxG,MAAM,CAAU,QAAQ,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,kBAAkB,CAAU,CAAC;IAEjF;;;;;;;;;;OAUG;IACH,MAAM,CAAC,MAAM,CACX,MAAc,EACd,GAAW,EACX,OAAe,EACf,IAAY,EACZ,IAAY,EACZ,MAAc,EACd,UAAmC,EAAE;QAErC,MAAM,EAAE,GAAG,gBAAgB,MAAM,IAAI,GAAG,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;QAE3D,MAAM,IAAI,GAA2B;YACnC,EAAE;YACF,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,GAAG,MAAM,IAAI,GAAG,EAAE;YACxC,MAAM;YACN,GAAG;YACH,OAAO;YACP,IAAI;YACJ,IAAI;YACJ,MAAM;YACN,SAAS,EAAE,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;SACjE,CAAC;QAEF,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACtC,IAAgC,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QACxE,CAAC;QACD,IAAI,OAAO,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;YAC1C,IAAgC,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;QAChF,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAA4B;QAC1C,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,MAAM,GAAG,IAA0C,CAAC;QAC1D,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC;gBAChC,MAAM,CAAC,IAAI,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC"}

package/dist/core/nodes/HttpRouteNode.d.ts

@@ -0,0 +1,58 @@
+/**
+ * HttpRouteNode - contract for http:route nodes
+ *
+ * Represents an HTTP route endpoint detected from framework patterns.
+ * Used by ExpressAnalyzer, ExpressRouteAnalyzer, and NestJSRouteAnalyzer.
+ *
+ * Each analyzer may add different optional fields, but all share
+ * the same core: method, path, file, line.
+ *
+ * ID format: http:route#${method}:${path}#${file}#${line}
+ */
+import type { BaseNodeRecord } from '@grafema/types';
+interface HttpRouteNodeRecord extends BaseNodeRecord {
+    type: 'http:route';
+    method: string;
+    path: string;
+    file: string;
+    line: number;
+    column?: number;
+}
+interface HttpRouteNodeOptions {
+    /** Human-readable name (e.g., "GET /api/users") */
+    name?: string;
+    column?: number;
+    /** Local path before mounting */
+    localPath?: string;
+    /** Router/app variable name this route is mounted on */
+    mountedOn?: string;
+    /** Router variable name (alternative to mountedOn) */
+    routerName?: string;
+    /** Framework that defined this route */
+    framework?: string;
+    /** Handler function name (e.g., "UserController.findAll") */
+    handlerName?: string;
+    /** Arbitrary metadata (handler location, etc.) */
+    metadata?: Record<string, unknown>;
+}
+export declare class HttpRouteNode {
+    static readonly TYPE: "http:route";
+    static readonly REQUIRED: readonly ["method", "path", "file", "line"];
+    static readonly OPTIONAL: readonly ["name", "column", "localPath", "mountedOn", "routerName", "framework", "handlerName", "metadata"];
+    /**
+     * Create http:route node
+     *
+     * @param method - HTTP method (GET, POST, PUT, DELETE, etc.)
+     * @param path - Route path (e.g., "/api/users", "/users/:id")
+     * @param file - File path where route is defined
+     * @param line - Line number of route definition
+     * @param options - Optional fields for framework-specific metadata
+     */
+    static create(method: string, path: string, file: string, line: number, options?: HttpRouteNodeOptions): HttpRouteNodeRecord;
+    /**
+     * Validate http:route node structure
+     */
+    static validate(node: HttpRouteNodeRecord): string[];
+}
+export type { HttpRouteNodeRecord, HttpRouteNodeOptions };
+//# sourceMappingURL=HttpRouteNode.d.ts.map

package/dist/core/nodes/HttpRouteNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpRouteNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/HttpRouteNode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,UAAU,mBAAoB,SAAQ,cAAc;IAClD,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,oBAAoB;IAC5B,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,qBAAa,aAAa;IACxB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,YAAY,CAAU;IAE7C,MAAM,CAAC,QAAQ,CAAC,QAAQ,8CAA+C;IACvE,MAAM,CAAC,QAAQ,CAAC,QAAQ,8GAGb;IAEX;;;;;;;;OAQG;IACH,MAAM,CAAC,MAAM,CACX,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,oBAAyB,GACjC,mBAAmB;IAwBtB;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,EAAE;CAarD;AAED,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/core/nodes/HttpRouteNode.js

@@ -0,0 +1,72 @@
+/**
+ * HttpRouteNode - contract for http:route nodes
+ *
+ * Represents an HTTP route endpoint detected from framework patterns.
+ * Used by ExpressAnalyzer, ExpressRouteAnalyzer, and NestJSRouteAnalyzer.
+ *
+ * Each analyzer may add different optional fields, but all share
+ * the same core: method, path, file, line.
+ *
+ * ID format: http:route#${method}:${path}#${file}#${line}
+ */
+export class HttpRouteNode {
+    static TYPE = 'http:route';
+    static REQUIRED = ['method', 'path', 'file', 'line'];
+    static OPTIONAL = [
+        'name', 'column', 'localPath', 'mountedOn', 'routerName',
+        'framework', 'handlerName', 'metadata'
+    ];
+    /**
+     * Create http:route node
+     *
+     * @param method - HTTP method (GET, POST, PUT, DELETE, etc.)
+     * @param path - Route path (e.g., "/api/users", "/users/:id")
+     * @param file - File path where route is defined
+     * @param line - Line number of route definition
+     * @param options - Optional fields for framework-specific metadata
+     */
+    static create(method, path, file, line, options = {}) {
+        const id = `http:route#${method}:${path}#${file}#${line}`;
+        const node = {
+            id,
+            type: this.TYPE,
+            name: options.name || `${method} ${path}`,
+            method,
+            path,
+            file,
+            line,
+        };
+        if (options.column !== undefined)
+            node.column = options.column;
+        if (options.localPath !== undefined)
+            node.localPath = options.localPath;
+        if (options.mountedOn !== undefined)
+            node.mountedOn = options.mountedOn;
+        if (options.routerName !== undefined)
+            node.routerName = options.routerName;
+        if (options.framework !== undefined)
+            node.framework = options.framework;
+        if (options.handlerName !== undefined)
+            node.handlerName = options.handlerName;
+        if (options.metadata !== undefined)
+            node.metadata = options.metadata;
+        return node;
+    }
+    /**
+     * Validate http:route node structure
+     */
+    static validate(node) {
+        const errors = [];
+        if (node.type !== this.TYPE) {
+            errors.push(`Expected type ${this.TYPE}, got ${node.type}`);
+        }
+        const record = node;
+        for (const field of this.REQUIRED) {
+            if (record[field] === undefined) {
+                errors.push(`Missing required field: ${field}`);
+            }
+        }
+        return errors;
+    }
+}
+//# sourceMappingURL=HttpRouteNode.js.map

package/dist/core/nodes/HttpRouteNode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpRouteNode.js","sourceRoot":"","sources":["../../../src/core/nodes/HttpRouteNode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAoCH,MAAM,OAAO,aAAa;IACxB,MAAM,CAAU,IAAI,GAAG,YAAqB,CAAC;IAE7C,MAAM,CAAU,QAAQ,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAU,CAAC;IACvE,MAAM,CAAU,QAAQ,GAAG;QACzB,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY;QACxD,WAAW,EAAE,aAAa,EAAE,UAAU;KAC9B,CAAC;IAEX;;;;;;;;OAQG;IACH,MAAM,CAAC,MAAM,CACX,MAAc,EACd,IAAY,EACZ,IAAY,EACZ,IAAY,EACZ,UAAgC,EAAE;QAElC,MAAM,EAAE,GAAG,cAAc,MAAM,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;QAE1D,MAAM,IAAI,GAAwB;YAChC,EAAE;YACF,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,GAAG,MAAM,IAAI,IAAI,EAAE;YACzC,MAAM;YACN,IAAI;YACJ,IAAI;YACJ,IAAI;SACL,CAAC;QAEF,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC/D,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS;YAAG,IAAgC,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACrG,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS;YAAG,IAAgC,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACrG,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS;YAAG,IAAgC,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACxG,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS;YAAG,IAAgC,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACrG,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS;YAAG,IAAgC,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QAC3G,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS;YAAE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QAErE,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAyB;QACvC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,MAAM,GAAG,IAA0C,CAAC;QAC1D,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC;gBAChC,MAAM,CAAC,IAAI,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC"}

package/dist/core/nodes/NodeKind.d.ts

@@ -20,6 +20,7 @@ export declare const NODE_TYPE: {
     readonly CONSTANT: "CONSTANT";
     readonly LITERAL: "LITERAL";
     readonly EXPRESSION: "EXPRESSION";
+    readonly TYPE_PARAMETER: "TYPE_PARAMETER";
     readonly MODULE: "MODULE";
     readonly IMPORT: "IMPORT";
     readonly EXPORT: "EXPORT";

package/dist/core/nodes/NodeKind.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NodeKind.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/NodeKind.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;CA+BZ,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,OAAO,SAAS,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAKpE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;CAuClB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,OAAO,eAAe,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAGtF,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,kBAAkB,GAAG,MAAM,CAAC;AAIlE;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG5D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIpD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAIxD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAK1D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAa7E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGzD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGvD"}
+{"version":3,"file":"NodeKind.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/NodeKind.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;CAgCZ,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,OAAO,SAAS,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAKpE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;CAuClB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,OAAO,eAAe,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAGtF,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,kBAAkB,GAAG,MAAM,CAAC;AAIlE;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG5D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIpD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAIxD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAK1D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAa7E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGzD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGvD"}

package/dist/core/nodes/NodeKind.js

@@ -23,6 +23,7 @@ export const NODE_TYPE = {
     CONSTANT: 'CONSTANT',
     LITERAL: 'LITERAL',
     EXPRESSION: 'EXPRESSION', // Generic expression node for data flow tracking
+    TYPE_PARAMETER: 'TYPE_PARAMETER',
     // Module system
     MODULE: 'MODULE',
     IMPORT: 'IMPORT',

package/dist/core/nodes/NodeKind.js.map

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

package/dist/core/nodes/ReactNode.d.ts

@@ -0,0 +1,53 @@
+/**
+ * ReactNode - contract for React domain-specific nodes
+ *
+ * Handles all namespaced types from ReactAnalyzer:
+ * - react:component, react:state, react:effect, react:layout-effect,
+ *   react:insertion-effect, react:callback, react:memo, react:ref,
+ *   react:reducer, react:context, react:context-use, react:imperative-handle
+ * - dom:event
+ * - browser:timer, browser:blocking, browser:async, browser:storage,
+ *   browser:dom, browser:history, browser:clipboard, browser:geolocation,
+ *   browser:media-query
+ * - canvas:draw
+ *
+ * Issue nodes (issue:stale-closure, issue:missing-cleanup, issue:raf-leak)
+ * are handled by the existing IssueNode contract.
+ *
+ * These nodes use domain-specific ID formats generated by the analyzer
+ * helpers (react-internal/), so the contract provides a generic create()
+ * that validates required fields and brands the node.
+ */
+import type { BaseNodeRecord } from '@grafema/types';
+export interface ReactNodeRecord extends BaseNodeRecord {
+    type: string;
+    [key: string]: unknown;
+}
+export declare class ReactNode {
+    static readonly REQUIRED: readonly ["id", "type", "file", "line"];
+    /**
+     * Create a React domain node from pre-built fields.
+     *
+     * The analyzers' helper modules (react-internal/) build the full node
+     * shape including ID. This method validates required fields and returns
+     * a properly typed record ready for branding.
+     *
+     * @param fields - Complete node fields including id, type, file, line
+     * @returns ReactNodeRecord ready for brandNodeInternal()
+     */
+    static create<T extends {
+        id: string;
+        type: string;
+        file: string;
+        line: number;
+    }>(fields: T): ReactNodeRecord;
+    /**
+     * Validate a React domain node.
+     */
+    static validate(node: BaseNodeRecord): string[];
+    /**
+     * Check if a type belongs to the React domain.
+     */
+    static isReactDomainType(type: string): boolean;
+}
+//# sourceMappingURL=ReactNode.d.ts.map

package/dist/core/nodes/ReactNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReactNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/ReactNode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGrD,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAID,qBAAa,SAAS;IACpB,MAAM,CAAC,QAAQ,CAAC,QAAQ,0CAA2C;IAEnE;;;;;;;;;OASG;IACH,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,MAAM,EAAE,CAAC,GAAG,eAAe;IAS7G;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,EAAE;IAa/C;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAKhD"}