@grafema/core 0.2.5-beta → 0.2.7

package/dist/core/nodes/RustModuleNode.js

@@ -0,0 +1,57 @@
+/**
+ * RustModuleNode - contract for RUST_MODULE node
+ *
+ * Represents a Rust source file (.rs) indexed from packages/rfdb-server/src/.
+ * Created by RustModuleIndexer during the INDEXING phase.
+ *
+ * ID format: RUST_MODULE#<moduleName>#<relativePath>
+ * Example: RUST_MODULE#ffi::napi_bindings#ffi/napi_bindings.rs
+ */
+export class RustModuleNode {
+    static TYPE = 'RUST_MODULE';
+    static REQUIRED = ['name', 'file', 'contentHash'];
+    static OPTIONAL = ['isLib', 'isMod', 'isTest'];
+    /**
+     * Create RUST_MODULE node
+     *
+     * @param moduleName - Rust module name (e.g., "crate", "ffi::napi_bindings")
+     * @param file - Absolute file path
+     * @param contentHash - SHA-256 hash of file content
+     * @param prefixedPath - Relative path, possibly prefixed for multi-root workspaces
+     * @param options - Optional flags (isLib, isMod, isTest)
+     */
+    static create(moduleName, file, contentHash, prefixedPath, options = {}) {
+        if (!moduleName)
+            throw new Error('RustModuleNode.create: moduleName is required');
+        if (!file)
+            throw new Error('RustModuleNode.create: file is required');
+        if (!contentHash)
+            throw new Error('RustModuleNode.create: contentHash is required');
+        if (!prefixedPath)
+            throw new Error('RustModuleNode.create: prefixedPath is required');
+        return {
+            id: `RUST_MODULE#${moduleName}#${prefixedPath}`,
+            type: this.TYPE,
+            name: moduleName,
+            file,
+            contentHash,
+            isLib: options.isLib || false,
+            isMod: options.isMod || false,
+            isTest: options.isTest || false,
+        };
+    }
+    static validate(node) {
+        const errors = [];
+        if (node.type !== this.TYPE) {
+            errors.push(`Expected type ${this.TYPE}, got ${node.type}`);
+        }
+        const nodeRecord = node;
+        for (const field of this.REQUIRED) {
+            if (!nodeRecord[field]) {
+                errors.push(`Missing required field: ${field}`);
+            }
+        }
+        return errors;
+    }
+}
+//# sourceMappingURL=RustModuleNode.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RustModuleNode.js","sourceRoot":"","sources":["../../../src/core/nodes/RustModuleNode.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAkBH,MAAM,OAAO,cAAc;IACzB,MAAM,CAAU,IAAI,GAAG,aAAsB,CAAC;IAE9C,MAAM,CAAU,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,CAAU,CAAC;IACpE,MAAM,CAAU,QAAQ,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAU,CAAC;IAEjE;;;;;;;;OAQG;IACH,MAAM,CAAC,MAAM,CACX,UAAkB,EAClB,IAAY,EACZ,WAAmB,EACnB,YAAoB,EACpB,UAAiC,EAAE;QAEnC,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QAClF,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QACtE,IAAI,CAAC,WAAW;YAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpF,IAAI,CAAC,YAAY;YAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QAEtF,OAAO;YACL,EAAE,EAAE,eAAe,UAAU,IAAI,YAAY,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,UAAU;YAChB,IAAI;YACJ,WAAW;YACX,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,KAAK;YAC7B,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,KAAK;YAC7B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;SAChC,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,IAAoB;QAClC,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,MAAM,UAAU,GAAG,IAA0C,CAAC;QAC9D,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBACvB,MAAM,CAAC,IAAI,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC"}

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

@@ -0,0 +1,38 @@
+/**
+ * RustStructNode - contract for RUST_STRUCT node
+ *
+ * Represents a Rust struct extracted by RustAnalyzer.
+ * Includes #[napi] attribute detection for FFI linking.
+ *
+ * ID format: RUST_STRUCT#<name>#<file>#<line>
+ * Example: RUST_STRUCT#GraphEngine#src/engine.rs#15
+ */
+import type { BaseNodeRecord } from '@grafema/types';
+interface RustStructNodeRecord extends BaseNodeRecord {
+    type: 'RUST_STRUCT';
+    pub: boolean;
+    napi: boolean;
+    fields: unknown[];
+}
+interface RustStructNodeOptions {
+    pub?: boolean;
+    napi?: boolean;
+    fields?: unknown[];
+}
+export declare class RustStructNode {
+    static readonly TYPE: "RUST_STRUCT";
+    static readonly REQUIRED: readonly ["name", "file", "line"];
+    static readonly OPTIONAL: readonly ["pub", "napi", "fields"];
+    /**
+     * Create RUST_STRUCT node
+     *
+     * @param name - Struct name
+     * @param file - File path
+     * @param line - Line number
+     * @param options - Optional struct attributes
+     */
+    static create(name: string, file: string, line: number, options?: RustStructNodeOptions): RustStructNodeRecord;
+    static validate(node: BaseNodeRecord): string[];
+}
+export type { RustStructNodeRecord };
+//# sourceMappingURL=RustStructNode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RustStructNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/RustStructNode.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,UAAU,oBAAqB,SAAQ,cAAc;IACnD,IAAI,EAAE,aAAa,CAAC;IACpB,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB;AAED,UAAU,qBAAqB;IAC7B,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;CACpB;AAED,qBAAa,cAAc;IACzB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,aAAa,CAAU;IAE9C,MAAM,CAAC,QAAQ,CAAC,QAAQ,oCAAqC;IAC7D,MAAM,CAAC,QAAQ,CAAC,QAAQ,qCAAsC;IAE9D;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,qBAA0B,GAClC,oBAAoB;IAiBvB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,EAAE;CAgBhD;AAED,YAAY,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/core/nodes/RustStructNode.js

@@ -0,0 +1,54 @@
+/**
+ * RustStructNode - contract for RUST_STRUCT node
+ *
+ * Represents a Rust struct extracted by RustAnalyzer.
+ * Includes #[napi] attribute detection for FFI linking.
+ *
+ * ID format: RUST_STRUCT#<name>#<file>#<line>
+ * Example: RUST_STRUCT#GraphEngine#src/engine.rs#15
+ */
+export class RustStructNode {
+    static TYPE = 'RUST_STRUCT';
+    static REQUIRED = ['name', 'file', 'line'];
+    static OPTIONAL = ['pub', 'napi', 'fields'];
+    /**
+     * Create RUST_STRUCT node
+     *
+     * @param name - Struct name
+     * @param file - File path
+     * @param line - Line number
+     * @param options - Optional struct attributes
+     */
+    static create(name, file, line, options = {}) {
+        if (!name)
+            throw new Error('RustStructNode.create: name is required');
+        if (!file)
+            throw new Error('RustStructNode.create: file is required');
+        if (line === undefined)
+            throw new Error('RustStructNode.create: line is required');
+        return {
+            id: `RUST_STRUCT#${name}#${file}#${line}`,
+            type: this.TYPE,
+            name,
+            file,
+            line,
+            pub: options.pub || false,
+            napi: options.napi || false,
+            fields: options.fields || [],
+        };
+    }
+    static validate(node) {
+        const errors = [];
+        if (node.type !== this.TYPE) {
+            errors.push(`Expected type ${this.TYPE}, got ${node.type}`);
+        }
+        const nodeRecord = node;
+        for (const field of this.REQUIRED) {
+            if (!nodeRecord[field]) {
+                errors.push(`Missing required field: ${field}`);
+            }
+        }
+        return errors;
+    }
+}
+//# sourceMappingURL=RustStructNode.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RustStructNode.js","sourceRoot":"","sources":["../../../src/core/nodes/RustStructNode.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAiBH,MAAM,OAAO,cAAc;IACzB,MAAM,CAAU,IAAI,GAAG,aAAsB,CAAC;IAE9C,MAAM,CAAU,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAU,CAAC;IAC7D,MAAM,CAAU,QAAQ,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAU,CAAC;IAE9D;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,CACX,IAAY,EACZ,IAAY,EACZ,IAAY,EACZ,UAAiC,EAAE;QAEnC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QACtE,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QACtE,IAAI,IAAI,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAEnF,OAAO;YACL,EAAE,EAAE,eAAe,IAAI,IAAI,IAAI,IAAI,IAAI,EAAE;YACzC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI;YACJ,IAAI;YACJ,IAAI;YACJ,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,KAAK;YACzB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,KAAK;YAC3B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;SAC7B,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,IAAoB;QAClC,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,MAAM,UAAU,GAAG,IAA0C,CAAC;QAC9D,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBACvB,MAAM,CAAC,IAAI,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC"}

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

@@ -0,0 +1,40 @@
+/**
+ * RustTraitNode - contract for RUST_TRAIT node
+ *
+ * Represents a Rust trait extracted by RustAnalyzer.
+ *
+ * ID format: RUST_TRAIT#<name>#<file>#<line>
+ * Example: RUST_TRAIT#QueryEngine#src/traits.rs#10
+ */
+import type { BaseNodeRecord } from '@grafema/types';
+interface RustTraitMethodRecord {
+    name: string;
+    params: string[];
+    returnType: string;
+}
+interface RustTraitNodeRecord extends BaseNodeRecord {
+    type: 'RUST_TRAIT';
+    pub: boolean;
+    methods: RustTraitMethodRecord[];
+}
+interface RustTraitNodeOptions {
+    pub?: boolean;
+    methods?: RustTraitMethodRecord[];
+}
+export declare class RustTraitNode {
+    static readonly TYPE: "RUST_TRAIT";
+    static readonly REQUIRED: readonly ["name", "file", "line"];
+    static readonly OPTIONAL: readonly ["pub", "methods"];
+    /**
+     * Create RUST_TRAIT node
+     *
+     * @param name - Trait name
+     * @param file - File path
+     * @param line - Line number
+     * @param options - Optional trait attributes
+     */
+    static create(name: string, file: string, line: number, options?: RustTraitNodeOptions): RustTraitNodeRecord;
+    static validate(node: BaseNodeRecord): string[];
+}
+export type { RustTraitNodeRecord, RustTraitMethodRecord };
+//# sourceMappingURL=RustTraitNode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RustTraitNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/RustTraitNode.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,UAAU,qBAAqB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,mBAAoB,SAAQ,cAAc;IAClD,IAAI,EAAE,YAAY,CAAC;IACnB,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,qBAAqB,EAAE,CAAC;CAClC;AAED,UAAU,oBAAoB;IAC5B,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACnC;AAED,qBAAa,aAAa;IACxB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,YAAY,CAAU;IAE7C,MAAM,CAAC,QAAQ,CAAC,QAAQ,oCAAqC;IAC7D,MAAM,CAAC,QAAQ,CAAC,QAAQ,8BAA+B;IAEvD;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,oBAAyB,GACjC,mBAAmB;IAgBtB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,EAAE;CAgBhD;AAED,YAAY,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/core/nodes/RustTraitNode.js

@@ -0,0 +1,52 @@
+/**
+ * RustTraitNode - contract for RUST_TRAIT node
+ *
+ * Represents a Rust trait extracted by RustAnalyzer.
+ *
+ * ID format: RUST_TRAIT#<name>#<file>#<line>
+ * Example: RUST_TRAIT#QueryEngine#src/traits.rs#10
+ */
+export class RustTraitNode {
+    static TYPE = 'RUST_TRAIT';
+    static REQUIRED = ['name', 'file', 'line'];
+    static OPTIONAL = ['pub', 'methods'];
+    /**
+     * Create RUST_TRAIT node
+     *
+     * @param name - Trait name
+     * @param file - File path
+     * @param line - Line number
+     * @param options - Optional trait attributes
+     */
+    static create(name, file, line, options = {}) {
+        if (!name)
+            throw new Error('RustTraitNode.create: name is required');
+        if (!file)
+            throw new Error('RustTraitNode.create: file is required');
+        if (line === undefined)
+            throw new Error('RustTraitNode.create: line is required');
+        return {
+            id: `RUST_TRAIT#${name}#${file}#${line}`,
+            type: this.TYPE,
+            name,
+            file,
+            line,
+            pub: options.pub || false,
+            methods: options.methods || [],
+        };
+    }
+    static validate(node) {
+        const errors = [];
+        if (node.type !== this.TYPE) {
+            errors.push(`Expected type ${this.TYPE}, got ${node.type}`);
+        }
+        const nodeRecord = node;
+        for (const field of this.REQUIRED) {
+            if (!nodeRecord[field]) {
+                errors.push(`Missing required field: ${field}`);
+            }
+        }
+        return errors;
+    }
+}
+//# sourceMappingURL=RustTraitNode.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RustTraitNode.js","sourceRoot":"","sources":["../../../src/core/nodes/RustTraitNode.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAqBH,MAAM,OAAO,aAAa;IACxB,MAAM,CAAU,IAAI,GAAG,YAAqB,CAAC;IAE7C,MAAM,CAAU,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAU,CAAC;IAC7D,MAAM,CAAU,QAAQ,GAAG,CAAC,KAAK,EAAE,SAAS,CAAU,CAAC;IAEvD;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,CACX,IAAY,EACZ,IAAY,EACZ,IAAY,EACZ,UAAgC,EAAE;QAElC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QACrE,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QACrE,IAAI,IAAI,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAElF,OAAO;YACL,EAAE,EAAE,cAAc,IAAI,IAAI,IAAI,IAAI,IAAI,EAAE;YACxC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI;YACJ,IAAI;YACJ,IAAI;YACJ,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,KAAK;YACzB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;SAC/B,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,IAAoB;QAClC,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,MAAM,UAAU,GAAG,IAA0C,CAAC;QAC9D,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBACvB,MAAM,CAAC,IAAI,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC"}

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

@@ -0,0 +1,85 @@
+/**
+ * ServiceLayerNode - contracts for service layer domain-specific nodes
+ *
+ * Types: SERVICE_CLASS, SERVICE_INSTANCE, SERVICE_REGISTRATION, SERVICE_USAGE
+ *
+ * Used by ServiceLayerAnalyzer for detecting Service Layer Pattern.
+ *
+ * ID formats:
+ * - SERVICE_CLASS: <file>:SERVICE_CLASS:<className>:<line>
+ * - SERVICE_INSTANCE: <file>:SERVICE_INSTANCE:<className>:<line>
+ * - SERVICE_REGISTRATION: <file>:SERVICE_REGISTRATION:<serviceName>:<line>
+ * - SERVICE_USAGE: <file>:SERVICE_USAGE:<serviceName>:<line>
+ */
+import type { BaseNodeRecord } from '@grafema/types';
+export interface ServiceClassNodeRecord extends BaseNodeRecord {
+    type: 'SERVICE_CLASS';
+    name: string;
+    methods: string[];
+    file: string;
+    line: number;
+}
+export interface ServiceInstanceNodeRecord extends BaseNodeRecord {
+    type: 'SERVICE_INSTANCE';
+    serviceClass: string;
+    file: string;
+    line: number;
+}
+export interface ServiceRegistrationNodeRecord extends BaseNodeRecord {
+    type: 'SERVICE_REGISTRATION';
+    serviceName: string;
+    objectName: string;
+    file: string;
+    line: number;
+}
+export interface ServiceUsageNodeRecord extends BaseNodeRecord {
+    type: 'SERVICE_USAGE';
+    serviceName: string;
+    file: string;
+    line: number;
+}
+export declare class ServiceLayerNode {
+    /**
+     * Create a SERVICE_CLASS node.
+     *
+     * @param className - Service class name (e.g., 'UserService')
+     * @param file - File path
+     * @param line - Line number
+     * @param methods - List of method names in the service class
+     */
+    static createClass(className: string, file: string, line: number, methods: string[]): ServiceClassNodeRecord;
+    /**
+     * Create a SERVICE_INSTANCE node.
+     *
+     * @param serviceClass - Name of the service class being instantiated
+     * @param file - File path
+     * @param line - Line number
+     */
+    static createInstance(serviceClass: string, file: string, line: number): ServiceInstanceNodeRecord;
+    /**
+     * Create a SERVICE_REGISTRATION node.
+     *
+     * @param serviceName - Registered service name
+     * @param objectName - Object used for registration (e.g., 'app')
+     * @param file - File path
+     * @param line - Line number
+     */
+    static createRegistration(serviceName: string, objectName: string, file: string, line: number): ServiceRegistrationNodeRecord;
+    /**
+     * Create a SERVICE_USAGE node.
+     *
+     * @param serviceName - Name of the service being used
+     * @param file - File path
+     * @param line - Line number
+     */
+    static createUsage(serviceName: string, file: string, line: number): ServiceUsageNodeRecord;
+    /**
+     * Check if a type belongs to the service layer domain.
+     */
+    static isServiceLayerType(type: string): boolean;
+    /**
+     * Validate a service layer domain node.
+     */
+    static validate(node: BaseNodeRecord): string[];
+}
+//# sourceMappingURL=ServiceLayerNode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceLayerNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/ServiceLayerNode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAIrD,MAAM,WAAW,sBAAuB,SAAQ,cAAc;IAC5D,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAID,MAAM,WAAW,yBAA0B,SAAQ,cAAc;IAC/D,IAAI,EAAE,kBAAkB,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAID,MAAM,WAAW,6BAA8B,SAAQ,cAAc;IACnE,IAAI,EAAE,sBAAsB,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAID,MAAM,WAAW,sBAAuB,SAAQ,cAAc;IAC5D,IAAI,EAAE,eAAe,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,gBAAgB;IAC3B;;;;;;;OAOG;IACH,MAAM,CAAC,WAAW,CAChB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EAAE,GAChB,sBAAsB;IAczB;;;;;;OAMG;IACH,MAAM,CAAC,cAAc,CACnB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,yBAAyB;IAc5B;;;;;;;OAOG;IACH,MAAM,CAAC,kBAAkB,CACvB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,6BAA6B;IAehC;;;;;;OAMG;IACH,MAAM,CAAC,WAAW,CAChB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,sBAAsB;IAczB;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAKhD;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,EAAE;CAWhD"}

package/dist/core/nodes/ServiceLayerNode.js

@@ -0,0 +1,122 @@
+/**
+ * ServiceLayerNode - contracts for service layer domain-specific nodes
+ *
+ * Types: SERVICE_CLASS, SERVICE_INSTANCE, SERVICE_REGISTRATION, SERVICE_USAGE
+ *
+ * Used by ServiceLayerAnalyzer for detecting Service Layer Pattern.
+ *
+ * ID formats:
+ * - SERVICE_CLASS: <file>:SERVICE_CLASS:<className>:<line>
+ * - SERVICE_INSTANCE: <file>:SERVICE_INSTANCE:<className>:<line>
+ * - SERVICE_REGISTRATION: <file>:SERVICE_REGISTRATION:<serviceName>:<line>
+ * - SERVICE_USAGE: <file>:SERVICE_USAGE:<serviceName>:<line>
+ */
+export class ServiceLayerNode {
+    /**
+     * Create a SERVICE_CLASS node.
+     *
+     * @param className - Service class name (e.g., 'UserService')
+     * @param file - File path
+     * @param line - Line number
+     * @param methods - List of method names in the service class
+     */
+    static createClass(className, file, line, methods) {
+        if (!className)
+            throw new Error('ServiceLayerNode.createClass: className is required');
+        if (!file)
+            throw new Error('ServiceLayerNode.createClass: file is required');
+        return {
+            id: `${file}:SERVICE_CLASS:${className}:${line}`,
+            type: 'SERVICE_CLASS',
+            name: className,
+            methods,
+            file,
+            line,
+        };
+    }
+    /**
+     * Create a SERVICE_INSTANCE node.
+     *
+     * @param serviceClass - Name of the service class being instantiated
+     * @param file - File path
+     * @param line - Line number
+     */
+    static createInstance(serviceClass, file, line) {
+        if (!serviceClass)
+            throw new Error('ServiceLayerNode.createInstance: serviceClass is required');
+        if (!file)
+            throw new Error('ServiceLayerNode.createInstance: file is required');
+        return {
+            id: `${file}:SERVICE_INSTANCE:${serviceClass}:${line}`,
+            type: 'SERVICE_INSTANCE',
+            name: serviceClass,
+            serviceClass,
+            file,
+            line,
+        };
+    }
+    /**
+     * Create a SERVICE_REGISTRATION node.
+     *
+     * @param serviceName - Registered service name
+     * @param objectName - Object used for registration (e.g., 'app')
+     * @param file - File path
+     * @param line - Line number
+     */
+    static createRegistration(serviceName, objectName, file, line) {
+        if (!serviceName)
+            throw new Error('ServiceLayerNode.createRegistration: serviceName is required');
+        if (!file)
+            throw new Error('ServiceLayerNode.createRegistration: file is required');
+        return {
+            id: `${file}:SERVICE_REGISTRATION:${serviceName}:${line}`,
+            type: 'SERVICE_REGISTRATION',
+            name: serviceName,
+            serviceName,
+            objectName,
+            file,
+            line,
+        };
+    }
+    /**
+     * Create a SERVICE_USAGE node.
+     *
+     * @param serviceName - Name of the service being used
+     * @param file - File path
+     * @param line - Line number
+     */
+    static createUsage(serviceName, file, line) {
+        if (!serviceName)
+            throw new Error('ServiceLayerNode.createUsage: serviceName is required');
+        if (!file)
+            throw new Error('ServiceLayerNode.createUsage: file is required');
+        return {
+            id: `${file}:SERVICE_USAGE:${serviceName}:${line}`,
+            type: 'SERVICE_USAGE',
+            name: serviceName,
+            serviceName,
+            file,
+            line,
+        };
+    }
+    /**
+     * Check if a type belongs to the service layer domain.
+     */
+    static isServiceLayerType(type) {
+        return type === 'SERVICE_CLASS' || type === 'SERVICE_INSTANCE' ||
+            type === 'SERVICE_REGISTRATION' || type === 'SERVICE_USAGE';
+    }
+    /**
+     * Validate a service layer domain node.
+     */
+    static validate(node) {
+        const errors = [];
+        if (!ServiceLayerNode.isServiceLayerType(node.type)) {
+            errors.push(`Expected SERVICE_* type, got ${node.type}`);
+        }
+        if (!node.id)
+            errors.push('Missing required field: id');
+        return errors;
+    }
+}
+//# sourceMappingURL=ServiceLayerNode.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceLayerNode.js","sourceRoot":"","sources":["../../../src/core/nodes/ServiceLayerNode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA0CH,MAAM,OAAO,gBAAgB;IAC3B;;;;;;;OAOG;IACH,MAAM,CAAC,WAAW,CAChB,SAAiB,EACjB,IAAY,EACZ,IAAY,EACZ,OAAiB;QAEjB,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACvF,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QAE7E,OAAO;YACL,EAAE,EAAE,GAAG,IAAI,kBAAkB,SAAS,IAAI,IAAI,EAAE;YAChD,IAAI,EAAE,eAAe;YACrB,IAAI,EAAE,SAAS;YACf,OAAO;YACP,IAAI;YACJ,IAAI;SACL,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,cAAc,CACnB,YAAoB,EACpB,IAAY,EACZ,IAAY;QAEZ,IAAI,CAAC,YAAY;YAAE,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;QAChG,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QAEhF,OAAO;YACL,EAAE,EAAE,GAAG,IAAI,qBAAqB,YAAY,IAAI,IAAI,EAAE;YACtD,IAAI,EAAE,kBAAkB;YACxB,IAAI,EAAE,YAAY;YAClB,YAAY;YACZ,IAAI;YACJ,IAAI;SACL,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,kBAAkB,CACvB,WAAmB,EACnB,UAAkB,EAClB,IAAY,EACZ,IAAY;QAEZ,IAAI,CAAC,WAAW;YAAE,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;QAClG,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAEpF,OAAO;YACL,EAAE,EAAE,GAAG,IAAI,yBAAyB,WAAW,IAAI,IAAI,EAAE;YACzD,IAAI,EAAE,sBAAsB;YAC5B,IAAI,EAAE,WAAW;YACjB,WAAW;YACX,UAAU;YACV,IAAI;YACJ,IAAI;SACL,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,WAAW,CAChB,WAAmB,EACnB,IAAY,EACZ,IAAY;QAEZ,IAAI,CAAC,WAAW;YAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAC3F,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QAE7E,OAAO;YACL,EAAE,EAAE,GAAG,IAAI,kBAAkB,WAAW,IAAI,IAAI,EAAE;YAClD,IAAI,EAAE,eAAe;YACrB,IAAI,EAAE,WAAW;YACjB,WAAW;YACX,IAAI;YACJ,IAAI;SACL,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,IAAY;QACpC,OAAO,IAAI,KAAK,eAAe,IAAI,IAAI,KAAK,kBAAkB;YACvD,IAAI,KAAK,sBAAsB,IAAI,IAAI,KAAK,eAAe,CAAC;IACrE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAoB;QAClC,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACpD,MAAM,CAAC,IAAI,CAAC,gCAAgC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3D,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAExD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

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

@@ -0,0 +1,71 @@
+/**
+ * SocketIONode - contract for Socket.IO domain-specific nodes
+ *
+ * Types: socketio:emit, socketio:on, socketio:room, socketio:event
+ *
+ * ID formats:
+ * - socketio:emit#<event>#<file>#<line>
+ * - socketio:on#<event>#<file>#<line>
+ * - socketio:room#<roomName>#<file>#<line>
+ * - socketio:event#<eventName> (singleton per event name)
+ */
+import type { BaseNodeRecord } from '@grafema/types';
+export interface SocketIOEmitNodeRecord extends BaseNodeRecord {
+    type: 'socketio:emit';
+    event: string;
+    room: string | null;
+    namespace: string | null;
+    broadcast: boolean;
+    objectName: string;
+    column: number;
+}
+export interface SocketIOListenerNodeRecord extends BaseNodeRecord {
+    type: 'socketio:on';
+    event: string;
+    objectName: string;
+    handlerName: string;
+    handlerLine: number;
+    column: number;
+}
+export interface SocketIORoomNodeRecord extends BaseNodeRecord {
+    type: 'socketio:room';
+    room: string;
+    objectName: string;
+    column: number;
+}
+export interface SocketIOEventNodeRecord extends BaseNodeRecord {
+    type: 'socketio:event';
+    event: string;
+}
+export declare class SocketIONode {
+    static readonly REQUIRED: readonly ["id", "type"];
+    /**
+     * Create a socketio:emit node.
+     */
+    static createEmit(event: string, objectName: string, file: string, line: number, column: number, options?: {
+        room?: string | null;
+        namespace?: string | null;
+        broadcast?: boolean;
+    }): SocketIOEmitNodeRecord;
+    /**
+     * Create a socketio:on listener node.
+     */
+    static createListener(event: string, objectName: string, handlerName: string, handlerLine: number, file: string, line: number, column: number): SocketIOListenerNodeRecord;
+    /**
+     * Create a socketio:room node.
+     */
+    static createRoom(roomName: string, objectName: string, file: string, line: number, column: number): SocketIORoomNodeRecord;
+    /**
+     * Create a socketio:event channel node (singleton per event name).
+     */
+    static createEvent(eventName: string): SocketIOEventNodeRecord;
+    /**
+     * Validate a Socket.IO domain node.
+     */
+    static validate(node: BaseNodeRecord): string[];
+    /**
+     * Check if a type belongs to the Socket.IO domain.
+     */
+    static isSocketIOType(type: string): boolean;
+}
+//# sourceMappingURL=SocketIONode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SocketIONode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/SocketIONode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAKrD,MAAM,WAAW,sBAAuB,SAAQ,cAAc;IAC5D,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,WAAW,0BAA2B,SAAQ,cAAc;IAChE,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,WAAW,sBAAuB,SAAQ,cAAc;IAC5D,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,WAAW,uBAAwB,SAAQ,cAAc;IAC7D,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,YAAY;IACvB,MAAM,CAAC,QAAQ,CAAC,QAAQ,0BAA2B;IAEnD;;OAEG;IACH,MAAM,CAAC,UAAU,CACf,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAO,GACrF,sBAAsB;IAmBzB;;OAEG;IACH,MAAM,CAAC,cAAc,CACnB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,0BAA0B;IAkB7B;;OAEG;IACH,MAAM,CAAC,UAAU,CACf,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,sBAAsB;IAgBzB;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,uBAAuB;IAW9D;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,EAAE;IAY/C;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAI7C"}