@grafema/core 0.2.5-beta → 0.2.7

package/dist/core/factories/RustFactory.d.ts

@@ -0,0 +1,62 @@
+/**
+ * RustFactory - factory methods for Rust-specific graph nodes
+ *
+ * Handles: RUST_MODULE, RUST_FUNCTION, RUST_STRUCT, RUST_IMPL,
+ * RUST_METHOD, RUST_TRAIT, RUST_CALL
+ */
+import { type RustCallType, type RustTraitMethodRecord } from '../nodes/index.js';
+export declare class RustFactory {
+    static createRustModule(moduleName: string, file: string, contentHash: string, prefixedPath: string, options?: {
+        isLib?: boolean;
+        isMod?: boolean;
+        isTest?: boolean;
+    }): import("@grafema/types").BrandedNode<import("../nodes/RustModuleNode.js").RustModuleNodeRecord>;
+    static createRustFunction(name: string, file: string, line: number, column: number, options?: {
+        pub?: boolean;
+        async?: boolean;
+        unsafe?: boolean;
+        const?: boolean;
+        napi?: boolean;
+        napiJsName?: string | null;
+        napiConstructor?: boolean;
+        napiGetter?: string | null;
+        napiSetter?: string | null;
+        params?: string[];
+        returnType?: string | null;
+        unsafeBlocks?: number;
+    }): import("@grafema/types").BrandedNode<import("../nodes/RustFunctionNode.js").RustFunctionNodeRecord>;
+    static createRustStruct(name: string, file: string, line: number, options?: {
+        pub?: boolean;
+        napi?: boolean;
+        fields?: unknown[];
+    }): import("@grafema/types").BrandedNode<import("../nodes/RustStructNode.js").RustStructNodeRecord>;
+    static createRustImpl(targetType: string, file: string, line: number, options?: {
+        traitName?: string | null;
+    }): import("@grafema/types").BrandedNode<import("../nodes/RustImplNode.js").RustImplNodeRecord>;
+    static createRustMethod(name: string, file: string, line: number, column: number, implId: string, implType: string, options?: {
+        pub?: boolean;
+        async?: boolean;
+        unsafe?: boolean;
+        const?: boolean;
+        napi?: boolean;
+        napiJsName?: string | null;
+        napiConstructor?: boolean;
+        napiGetter?: string | null;
+        napiSetter?: string | null;
+        params?: string[];
+        returnType?: string | null;
+        selfType?: string | null;
+        unsafeBlocks?: number;
+    }): import("@grafema/types").BrandedNode<import("../nodes/RustMethodNode.js").RustMethodNodeRecord>;
+    static createRustTrait(name: string, file: string, line: number, options?: {
+        pub?: boolean;
+        methods?: RustTraitMethodRecord[];
+    }): import("@grafema/types").BrandedNode<import("../nodes/RustTraitNode.js").RustTraitNodeRecord>;
+    static createRustCall(parentName: string, file: string, line: number, column: number, callType: RustCallType, argsCount: number, options?: {
+        name?: string | null;
+        receiver?: string | null;
+        method?: string | null;
+        sideEffect?: string | null;
+    }): import("@grafema/types").BrandedNode<import("../nodes/RustCallNode.js").RustCallNodeRecord>;
+}
+//# sourceMappingURL=RustFactory.d.ts.map

package/dist/core/factories/RustFactory.d.ts.map

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

package/dist/core/factories/RustFactory.js

@@ -0,0 +1,32 @@
+/**
+ * RustFactory - factory methods for Rust-specific graph nodes
+ *
+ * Handles: RUST_MODULE, RUST_FUNCTION, RUST_STRUCT, RUST_IMPL,
+ * RUST_METHOD, RUST_TRAIT, RUST_CALL
+ */
+import { RustModuleNode, RustFunctionNode, RustStructNode, RustImplNode, RustMethodNode, RustTraitNode, RustCallNode, } from '../nodes/index.js';
+import { brandNodeInternal } from '../brandNodeInternal.js';
+export class RustFactory {
+    static createRustModule(moduleName, file, contentHash, prefixedPath, options = {}) {
+        return brandNodeInternal(RustModuleNode.create(moduleName, file, contentHash, prefixedPath, options));
+    }
+    static createRustFunction(name, file, line, column, options = {}) {
+        return brandNodeInternal(RustFunctionNode.create(name, file, line, column, options));
+    }
+    static createRustStruct(name, file, line, options = {}) {
+        return brandNodeInternal(RustStructNode.create(name, file, line, options));
+    }
+    static createRustImpl(targetType, file, line, options = {}) {
+        return brandNodeInternal(RustImplNode.create(targetType, file, line, options));
+    }
+    static createRustMethod(name, file, line, column, implId, implType, options = {}) {
+        return brandNodeInternal(RustMethodNode.create(name, file, line, column, implId, implType, options));
+    }
+    static createRustTrait(name, file, line, options = {}) {
+        return brandNodeInternal(RustTraitNode.create(name, file, line, options));
+    }
+    static createRustCall(parentName, file, line, column, callType, argsCount, options = {}) {
+        return brandNodeInternal(RustCallNode.create(parentName, file, line, column, callType, argsCount, options));
+    }
+}
+//# sourceMappingURL=RustFactory.js.map

package/dist/core/factories/RustFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RustFactory.js","sourceRoot":"","sources":["../../../src/core/factories/RustFactory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,cAAc,EACd,aAAa,EACb,YAAY,GAGb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,MAAM,OAAO,WAAW;IACtB,MAAM,CAAC,gBAAgB,CACrB,UAAkB,EAClB,IAAY,EACZ,WAAmB,EACnB,YAAoB,EACpB,UAAkE,EAAE;QAEpE,OAAO,iBAAiB,CAAC,cAAc,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;IACxG,CAAC;IAED,MAAM,CAAC,kBAAkB,CACvB,IAAY,EACZ,IAAY,EACZ,IAAY,EACZ,MAAc,EACd,UAaI,EAAE;QAEN,OAAO,iBAAiB,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACvF,CAAC;IAED,MAAM,CAAC,gBAAgB,CACrB,IAAY,EACZ,IAAY,EACZ,IAAY,EACZ,UAAiE,EAAE;QAEnE,OAAO,iBAAiB,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,CAAC,cAAc,CACnB,UAAkB,EAClB,IAAY,EACZ,IAAY,EACZ,UAAyC,EAAE;QAE3C,OAAO,iBAAiB,CAAC,YAAY,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,CAAC,gBAAgB,CACrB,IAAY,EACZ,IAAY,EACZ,IAAY,EACZ,MAAc,EACd,MAAc,EACd,QAAgB,EAChB,UAcI,EAAE;QAEN,OAAO,iBAAiB,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IACvG,CAAC;IAED,MAAM,CAAC,eAAe,CACpB,IAAY,EACZ,IAAY,EACZ,IAAY,EACZ,UAGI,EAAE;QAEN,OAAO,iBAAiB,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,CAAC,cAAc,CACnB,UAAkB,EAClB,IAAY,EACZ,IAAY,EACZ,MAAc,EACd,QAAsB,EACtB,SAAiB,EACjB,UAKI,EAAE;QAEN,OAAO,iBAAiB,CAAC,YAAY,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9G,CAAC;CACF"}

package/dist/core/factories/ServiceFactory.d.ts

@@ -0,0 +1,12 @@
+/**
+ * ServiceFactory - factory methods for service layer graph nodes
+ *
+ * Handles: SERVICE_CLASS, SERVICE_INSTANCE, SERVICE_REGISTRATION, SERVICE_USAGE
+ */
+export declare class ServiceFactory {
+    static createServiceClass(className: string, file: string, line: number, methods: string[]): import("@grafema/types").BrandedNode<import("../nodes/ServiceLayerNode.js").ServiceClassNodeRecord>;
+    static createServiceInstance(serviceClass: string, file: string, line: number): import("@grafema/types").BrandedNode<import("../nodes/ServiceLayerNode.js").ServiceInstanceNodeRecord>;
+    static createServiceRegistration(serviceName: string, objectName: string, file: string, line: number): import("@grafema/types").BrandedNode<import("../nodes/ServiceLayerNode.js").ServiceRegistrationNodeRecord>;
+    static createServiceUsage(serviceName: string, file: string, line: number): import("@grafema/types").BrandedNode<import("../nodes/ServiceLayerNode.js").ServiceUsageNodeRecord>;
+}
+//# sourceMappingURL=ServiceFactory.d.ts.map

package/dist/core/factories/ServiceFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceFactory.d.ts","sourceRoot":"","sources":["../../../src/core/factories/ServiceFactory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,qBAAa,cAAc;IACzB,MAAM,CAAC,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;IAI1F,MAAM,CAAC,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAI7E,MAAM,CAAC,yBAAyB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAIpG,MAAM,CAAC,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAG1E"}

package/dist/core/factories/ServiceFactory.js

@@ -0,0 +1,22 @@
+/**
+ * ServiceFactory - factory methods for service layer graph nodes
+ *
+ * Handles: SERVICE_CLASS, SERVICE_INSTANCE, SERVICE_REGISTRATION, SERVICE_USAGE
+ */
+import { ServiceLayerNode } from '../nodes/index.js';
+import { brandNodeInternal } from '../brandNodeInternal.js';
+export class ServiceFactory {
+    static createServiceClass(className, file, line, methods) {
+        return brandNodeInternal(ServiceLayerNode.createClass(className, file, line, methods));
+    }
+    static createServiceInstance(serviceClass, file, line) {
+        return brandNodeInternal(ServiceLayerNode.createInstance(serviceClass, file, line));
+    }
+    static createServiceRegistration(serviceName, objectName, file, line) {
+        return brandNodeInternal(ServiceLayerNode.createRegistration(serviceName, objectName, file, line));
+    }
+    static createServiceUsage(serviceName, file, line) {
+        return brandNodeInternal(ServiceLayerNode.createUsage(serviceName, file, line));
+    }
+}
+//# sourceMappingURL=ServiceFactory.js.map

package/dist/core/factories/ServiceFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceFactory.js","sourceRoot":"","sources":["../../../src/core/factories/ServiceFactory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,MAAM,OAAO,cAAc;IACzB,MAAM,CAAC,kBAAkB,CAAC,SAAiB,EAAE,IAAY,EAAE,IAAY,EAAE,OAAiB;QACxF,OAAO,iBAAiB,CAAC,gBAAgB,CAAC,WAAW,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACzF,CAAC;IAED,MAAM,CAAC,qBAAqB,CAAC,YAAoB,EAAE,IAAY,EAAE,IAAY;QAC3E,OAAO,iBAAiB,CAAC,gBAAgB,CAAC,cAAc,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IACtF,CAAC;IAED,MAAM,CAAC,yBAAyB,CAAC,WAAmB,EAAE,UAAkB,EAAE,IAAY,EAAE,IAAY;QAClG,OAAO,iBAAiB,CAAC,gBAAgB,CAAC,kBAAkB,CAAC,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IACrG,CAAC;IAED,MAAM,CAAC,kBAAkB,CAAC,WAAmB,EAAE,IAAY,EAAE,IAAY;QACvE,OAAO,iBAAiB,CAAC,gBAAgB,CAAC,WAAW,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAClF,CAAC;CACF"}

package/dist/core/factories/SocketFactory.d.ts

@@ -0,0 +1,31 @@
+/**
+ * SocketFactory - factory methods for Socket.IO and net socket graph nodes
+ *
+ * Handles: socketio:emit, socketio:on, socketio:room, socketio:event,
+ * os:unix-socket, net:tcp-connection, os:unix-server, net:tcp-server
+ */
+export declare class SocketFactory {
+    static createSocketIOEmit(event: string, objectName: string, file: string, line: number, column: number, options?: {
+        room?: string | null;
+        namespace?: string | null;
+        broadcast?: boolean;
+    }): import("@grafema/types").BrandedNode<import("../nodes/SocketIONode.js").SocketIOEmitNodeRecord>;
+    static createSocketIOListener(event: string, objectName: string, handlerName: string, handlerLine: number, file: string, line: number, column: number): import("@grafema/types").BrandedNode<import("../nodes/SocketIONode.js").SocketIOListenerNodeRecord>;
+    static createSocketIORoom(roomName: string, objectName: string, file: string, line: number, column: number): import("@grafema/types").BrandedNode<import("../nodes/SocketIONode.js").SocketIORoomNodeRecord>;
+    static createSocketIOEvent(eventName: string): import("@grafema/types").BrandedNode<import("../nodes/SocketIONode.js").SocketIOEventNodeRecord>;
+    static createUnixSocket(path: string, file: string, line: number, column: number, options?: {
+        library?: string;
+    }): import("@grafema/types").BrandedNode<import("../nodes/SocketNode.js").UnixSocketNodeRecord>;
+    static createTcpConnection(host: string, port: number, file: string, line: number, column: number, options?: {
+        library?: string;
+    }): import("@grafema/types").BrandedNode<import("../nodes/SocketNode.js").TcpConnectionNodeRecord>;
+    static createUnixServer(path: string, file: string, line: number, column: number, options?: {
+        library?: string;
+        backlog?: number;
+    }): import("@grafema/types").BrandedNode<import("../nodes/SocketNode.js").UnixServerNodeRecord>;
+    static createTcpServer(host: string, port: number, file: string, line: number, column: number, options?: {
+        library?: string;
+        backlog?: number;
+    }): import("@grafema/types").BrandedNode<import("../nodes/SocketNode.js").TcpServerNodeRecord>;
+}
+//# sourceMappingURL=SocketFactory.d.ts.map

package/dist/core/factories/SocketFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SocketFactory.d.ts","sourceRoot":"","sources":["../../../src/core/factories/SocketFactory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,qBAAa,aAAa;IACxB,MAAM,CAAC,kBAAkB,CACvB,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;IAKxF,MAAM,CAAC,sBAAsB,CAC3B,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;IAKhB,MAAM,CAAC,kBAAkB,CACvB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM;IAKhB,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,MAAM;IAI5C,MAAM,CAAC,gBAAgB,CACrB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO;IAKpC,MAAM,CAAC,mBAAmB,CACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO;IAKpC,MAAM,CAAC,gBAAgB,CACrB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO;IAKtD,MAAM,CAAC,eAAe,CACpB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO;CAIvD"}

package/dist/core/factories/SocketFactory.js

@@ -0,0 +1,35 @@
+/**
+ * SocketFactory - factory methods for Socket.IO and net socket graph nodes
+ *
+ * Handles: socketio:emit, socketio:on, socketio:room, socketio:event,
+ * os:unix-socket, net:tcp-connection, os:unix-server, net:tcp-server
+ */
+import { SocketIONode, SocketConnectionNode, } from '../nodes/index.js';
+import { brandNodeInternal } from '../brandNodeInternal.js';
+export class SocketFactory {
+    static createSocketIOEmit(event, objectName, file, line, column, options = {}) {
+        return brandNodeInternal(SocketIONode.createEmit(event, objectName, file, line, column, options));
+    }
+    static createSocketIOListener(event, objectName, handlerName, handlerLine, file, line, column) {
+        return brandNodeInternal(SocketIONode.createListener(event, objectName, handlerName, handlerLine, file, line, column));
+    }
+    static createSocketIORoom(roomName, objectName, file, line, column) {
+        return brandNodeInternal(SocketIONode.createRoom(roomName, objectName, file, line, column));
+    }
+    static createSocketIOEvent(eventName) {
+        return brandNodeInternal(SocketIONode.createEvent(eventName));
+    }
+    static createUnixSocket(path, file, line, column, options = {}) {
+        return brandNodeInternal(SocketConnectionNode.createUnixSocket(path, file, line, column, options));
+    }
+    static createTcpConnection(host, port, file, line, column, options = {}) {
+        return brandNodeInternal(SocketConnectionNode.createTcpConnection(host, port, file, line, column, options));
+    }
+    static createUnixServer(path, file, line, column, options = {}) {
+        return brandNodeInternal(SocketConnectionNode.createUnixServer(path, file, line, column, options));
+    }
+    static createTcpServer(host, port, file, line, column, options = {}) {
+        return brandNodeInternal(SocketConnectionNode.createTcpServer(host, port, file, line, column, options));
+    }
+}
+//# sourceMappingURL=SocketFactory.js.map

package/dist/core/factories/SocketFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SocketFactory.js","sourceRoot":"","sources":["../../../src/core/factories/SocketFactory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,YAAY,EACZ,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,MAAM,OAAO,aAAa;IACxB,MAAM,CAAC,kBAAkB,CACvB,KAAa,EACb,UAAkB,EAClB,IAAY,EACZ,IAAY,EACZ,MAAc,EACd,UAAoF,EAAE;QAEtF,OAAO,iBAAiB,CAAC,YAAY,CAAC,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACpG,CAAC;IAED,MAAM,CAAC,sBAAsB,CAC3B,KAAa,EACb,UAAkB,EAClB,WAAmB,EACnB,WAAmB,EACnB,IAAY,EACZ,IAAY,EACZ,MAAc;QAEd,OAAO,iBAAiB,CAAC,YAAY,CAAC,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IACzH,CAAC;IAED,MAAM,CAAC,kBAAkB,CACvB,QAAgB,EAChB,UAAkB,EAClB,IAAY,EACZ,IAAY,EACZ,MAAc;QAEd,OAAO,iBAAiB,CAAC,YAAY,CAAC,UAAU,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9F,CAAC;IAED,MAAM,CAAC,mBAAmB,CAAC,SAAiB;QAC1C,OAAO,iBAAiB,CAAC,YAAY,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,CAAC,gBAAgB,CACrB,IAAY,EACZ,IAAY,EACZ,IAAY,EACZ,MAAc,EACd,UAAgC,EAAE;QAElC,OAAO,iBAAiB,CAAC,oBAAoB,CAAC,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrG,CAAC;IAED,MAAM,CAAC,mBAAmB,CACxB,IAAY,EACZ,IAAY,EACZ,IAAY,EACZ,IAAY,EACZ,MAAc,EACd,UAAgC,EAAE;QAElC,OAAO,iBAAiB,CAAC,oBAAoB,CAAC,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9G,CAAC;IAED,MAAM,CAAC,gBAAgB,CACrB,IAAY,EACZ,IAAY,EACZ,IAAY,EACZ,MAAc,EACd,UAAkD,EAAE;QAEpD,OAAO,iBAAiB,CAAC,oBAAoB,CAAC,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrG,CAAC;IAED,MAAM,CAAC,eAAe,CACpB,IAAY,EACZ,IAAY,EACZ,IAAY,EACZ,IAAY,EACZ,MAAc,EACd,UAAkD,EAAE;QAEpD,OAAO,iBAAiB,CAAC,oBAAoB,CAAC,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1G,CAAC;CACF"}

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

@@ -0,0 +1,85 @@
+/**
+ * DatabaseNode - contracts for database domain-specific nodes
+ *
+ * Types: db:connection, db:query, db:table
+ *
+ * Used by DatabaseAnalyzer and SQLiteAnalyzer for database access patterns.
+ * NOT the same as DatabaseQueryNode which handles legacy DATABASE_QUERY type.
+ *
+ * ID formats:
+ * - db:connection: EXTERNAL_DATABASE:<name>
+ * - db:query (DatabaseAnalyzer): <file>:DATABASE_QUERY:<counter>
+ * - db:query (SQLiteAnalyzer): <file>:DATABASE_QUERY:<method>:<line>
+ * - db:table: TABLE:<tableName>
+ */
+import type { BaseNodeRecord } from '@grafema/types';
+export interface DbConnectionNodeRecord extends BaseNodeRecord {
+    type: 'db:connection';
+    name: string;
+}
+export interface DbQueryNodeRecord extends BaseNodeRecord {
+    type: 'db:query';
+    file: string;
+    line: number;
+    column: number;
+}
+export interface DbTableNodeRecord extends BaseNodeRecord {
+    type: 'db:table';
+    name: string;
+}
+export declare class DatabaseNode {
+    /**
+     * Create a db:connection node (singleton per database name).
+     *
+     * @param name - Database name (e.g., '__database__')
+     */
+    static createConnection(name: string): DbConnectionNodeRecord;
+    /**
+     * Create a db:query node for DatabaseAnalyzer.
+     *
+     * @param file - File path
+     * @param queryCounter - Sequential query counter within the file
+     * @param sql - Raw SQL string
+     * @param operation - SQL operation type (SELECT, INSERT, UPDATE, DELETE, etc.)
+     * @param options - Additional query metadata
+     */
+    static createQuery(file: string, queryCounter: number, sql: string, operation: string, options?: {
+        sqlSnippet?: string;
+        tableName?: string | null;
+        object?: string;
+        method?: string;
+        line?: number;
+        column?: number;
+    }): DbQueryNodeRecord;
+    /**
+     * Create a db:query node for SQLiteAnalyzer.
+     *
+     * @param file - File path
+     * @param method - SQLite method name (e.g., 'all', 'get', 'run')
+     * @param line - Line number
+     * @param query - Raw SQL string
+     * @param operationType - SQL operation type
+     * @param options - Additional query metadata
+     */
+    static createSQLiteQuery(file: string, method: string, line: number, query: string, operationType: string, options?: {
+        params?: string | null;
+        tableName?: string | null;
+        column?: number;
+        promiseWrapped?: boolean;
+    }): DbQueryNodeRecord;
+    /**
+     * Create a db:table node (singleton per table name).
+     *
+     * @param tableName - Table name
+     */
+    static createTable(tableName: string): DbTableNodeRecord;
+    /**
+     * Check if a type belongs to the database domain.
+     */
+    static isDatabaseType(type: string): boolean;
+    /**
+     * Validate a database domain node.
+     */
+    static validate(node: BaseNodeRecord): string[];
+}
+//# sourceMappingURL=DatabaseNode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/DatabaseNode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;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;CACd;AAID,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,YAAY;IACvB;;;;OAIG;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB;IAU7D;;;;;;;;OAQG;IACH,MAAM,CAAC,WAAW,CAChB,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;QACP,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;KACZ,GACL,iBAAiB;IAmBpB;;;;;;;;;OASG;IACH,MAAM,CAAC,iBAAiB,CACtB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,cAAc,CAAC,EAAE,OAAO,CAAC;KACrB,GACL,iBAAiB;IAmBpB;;;;OAIG;IACH,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB;IAUxD;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI5C;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,EAAE;CAWhD"}

package/dist/core/nodes/DatabaseNode.js

@@ -0,0 +1,118 @@
+/**
+ * DatabaseNode - contracts for database domain-specific nodes
+ *
+ * Types: db:connection, db:query, db:table
+ *
+ * Used by DatabaseAnalyzer and SQLiteAnalyzer for database access patterns.
+ * NOT the same as DatabaseQueryNode which handles legacy DATABASE_QUERY type.
+ *
+ * ID formats:
+ * - db:connection: EXTERNAL_DATABASE:<name>
+ * - db:query (DatabaseAnalyzer): <file>:DATABASE_QUERY:<counter>
+ * - db:query (SQLiteAnalyzer): <file>:DATABASE_QUERY:<method>:<line>
+ * - db:table: TABLE:<tableName>
+ */
+export class DatabaseNode {
+    /**
+     * Create a db:connection node (singleton per database name).
+     *
+     * @param name - Database name (e.g., '__database__')
+     */
+    static createConnection(name) {
+        if (!name)
+            throw new Error('DatabaseNode.createConnection: name is required');
+        return {
+            id: `EXTERNAL_DATABASE:${name}`,
+            type: 'db:connection',
+            name,
+        };
+    }
+    /**
+     * Create a db:query node for DatabaseAnalyzer.
+     *
+     * @param file - File path
+     * @param queryCounter - Sequential query counter within the file
+     * @param sql - Raw SQL string
+     * @param operation - SQL operation type (SELECT, INSERT, UPDATE, DELETE, etc.)
+     * @param options - Additional query metadata
+     */
+    static createQuery(file, queryCounter, sql, operation, options = {}) {
+        if (!file)
+            throw new Error('DatabaseNode.createQuery: file is required');
+        return {
+            id: `${file}:DATABASE_QUERY:${queryCounter}`,
+            type: 'db:query',
+            name: sql,
+            sql,
+            sqlSnippet: options.sqlSnippet ?? (sql.length > 50 ? sql.substring(0, 50) + '...' : sql),
+            operation,
+            tableName: options.tableName ?? null,
+            object: options.object,
+            method: options.method,
+            file,
+            line: options.line ?? 0,
+            column: options.column ?? 0,
+        };
+    }
+    /**
+     * Create a db:query node for SQLiteAnalyzer.
+     *
+     * @param file - File path
+     * @param method - SQLite method name (e.g., 'all', 'get', 'run')
+     * @param line - Line number
+     * @param query - Raw SQL string
+     * @param operationType - SQL operation type
+     * @param options - Additional query metadata
+     */
+    static createSQLiteQuery(file, method, line, query, operationType, options = {}) {
+        if (!file)
+            throw new Error('DatabaseNode.createSQLiteQuery: file is required');
+        return {
+            id: `${file}:DATABASE_QUERY:${method}:${line}`,
+            type: 'db:query',
+            name: query,
+            method: method.toUpperCase(),
+            query,
+            params: options.params ?? null,
+            operationType,
+            tableName: options.tableName ?? null,
+            file,
+            line,
+            column: options.column ?? 0,
+            promiseWrapped: options.promiseWrapped,
+        };
+    }
+    /**
+     * Create a db:table node (singleton per table name).
+     *
+     * @param tableName - Table name
+     */
+    static createTable(tableName) {
+        if (!tableName)
+            throw new Error('DatabaseNode.createTable: tableName is required');
+        return {
+            id: `TABLE:${tableName}`,
+            type: 'db:table',
+            name: tableName,
+        };
+    }
+    /**
+     * Check if a type belongs to the database domain.
+     */
+    static isDatabaseType(type) {
+        return type === 'db:connection' || type === 'db:query' || type === 'db:table';
+    }
+    /**
+     * Validate a database domain node.
+     */
+    static validate(node) {
+        const errors = [];
+        if (!DatabaseNode.isDatabaseType(node.type)) {
+            errors.push(`Expected db:* type, got ${node.type}`);
+        }
+        if (!node.id)
+            errors.push('Missing required field: id');
+        return errors;
+    }
+}
+//# sourceMappingURL=DatabaseNode.js.map

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

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

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

@@ -0,0 +1,47 @@
+/**
+ * ExpressMiddlewareNode - contract for express:middleware nodes
+ *
+ * Represents an Express.js middleware in a route chain or global mount.
+ * Created by ExpressRouteAnalyzer.
+ *
+ * ID format: express:middleware#${name}#${file}#${line}
+ */
+import type { BaseNodeRecord } from '@grafema/types';
+interface ExpressMiddlewareNodeRecord extends BaseNodeRecord {
+    type: 'express:middleware';
+    name: string;
+    file: string;
+    line: number;
+    column: number;
+}
+interface ExpressMiddlewareNodeOptions {
+    /** Associated endpoint ID (for route-specific middleware) */
+    endpointId?: string;
+    /** Order in middleware chain */
+    order?: number;
+    /** Mount path (for app.use() middleware) */
+    mountPath?: string;
+    /** Whether this is a global middleware (mounted on '/') */
+    isGlobal?: boolean;
+}
+export declare class ExpressMiddlewareNode {
+    static readonly TYPE: "express:middleware";
+    static readonly REQUIRED: readonly ["name", "file", "line", "column"];
+    static readonly OPTIONAL: readonly ["endpointId", "order", "mountPath", "isGlobal"];
+    /**
+     * Create express:middleware node
+     *
+     * @param name - Middleware name (e.g., "cors", "authMiddleware", "inline:42")
+     * @param file - File path where middleware is used
+     * @param line - Line number
+     * @param column - Column number
+     * @param options - Optional fields
+     */
+    static create(name: string, file: string, line: number, column: number, options?: ExpressMiddlewareNodeOptions): ExpressMiddlewareNodeRecord;
+    /**
+     * Validate express:middleware node structure
+     */
+    static validate(node: ExpressMiddlewareNodeRecord): string[];
+}
+export type { ExpressMiddlewareNodeRecord, ExpressMiddlewareNodeOptions };
+//# sourceMappingURL=ExpressMiddlewareNode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ExpressMiddlewareNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/ExpressMiddlewareNode.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,UAAU,2BAA4B,SAAQ,cAAc;IAC1D,IAAI,EAAE,oBAAoB,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,4BAA4B;IACpC,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,qBAAqB;IAChC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,oBAAoB,CAAU;IAErD,MAAM,CAAC,QAAQ,CAAC,QAAQ,8CAA+C;IACvE,MAAM,CAAC,QAAQ,CAAC,QAAQ,4DAA6D;IAErF;;;;;;;;OAQG;IACH,MAAM,CAAC,MAAM,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,4BAAiC,GACzC,2BAA2B;IA4B9B;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,2BAA2B,GAAG,MAAM,EAAE;CAa7D;AAED,YAAY,EAAE,2BAA2B,EAAE,4BAA4B,EAAE,CAAC"}

package/dist/core/nodes/ExpressMiddlewareNode.js

@@ -0,0 +1,63 @@
+/**
+ * ExpressMiddlewareNode - contract for express:middleware nodes
+ *
+ * Represents an Express.js middleware in a route chain or global mount.
+ * Created by ExpressRouteAnalyzer.
+ *
+ * ID format: express:middleware#${name}#${file}#${line}
+ */
+export class ExpressMiddlewareNode {
+    static TYPE = 'express:middleware';
+    static REQUIRED = ['name', 'file', 'line', 'column'];
+    static OPTIONAL = ['endpointId', 'order', 'mountPath', 'isGlobal'];
+    /**
+     * Create express:middleware node
+     *
+     * @param name - Middleware name (e.g., "cors", "authMiddleware", "inline:42")
+     * @param file - File path where middleware is used
+     * @param line - Line number
+     * @param column - Column number
+     * @param options - Optional fields
+     */
+    static create(name, file, line, column, options = {}) {
+        const id = `express:middleware#${name}#${file}#${line}`;
+        const node = {
+            id,
+            type: this.TYPE,
+            name,
+            file,
+            line,
+            column,
+        };
+        if (options.endpointId !== undefined) {
+            node.endpointId = options.endpointId;
+        }
+        if (options.order !== undefined) {
+            node.order = options.order;
+        }
+        if (options.mountPath !== undefined) {
+            node.mountPath = options.mountPath;
+        }
+        if (options.isGlobal !== undefined) {
+            node.isGlobal = options.isGlobal;
+        }
+        return node;
+    }
+    /**
+     * Validate express:middleware 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=ExpressMiddlewareNode.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ExpressMiddlewareNode.js","sourceRoot":"","sources":["../../../src/core/nodes/ExpressMiddlewareNode.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAuBH,MAAM,OAAO,qBAAqB;IAChC,MAAM,CAAU,IAAI,GAAG,oBAA6B,CAAC;IAErD,MAAM,CAAU,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAU,CAAC;IACvE,MAAM,CAAU,QAAQ,GAAG,CAAC,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,CAAU,CAAC;IAErF;;;;;;;;OAQG;IACH,MAAM,CAAC,MAAM,CACX,IAAY,EACZ,IAAY,EACZ,IAAY,EACZ,MAAc,EACd,UAAwC,EAAE;QAE1C,MAAM,EAAE,GAAG,sBAAsB,IAAI,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;QAExD,MAAM,IAAI,GAAgC;YACxC,EAAE;YACF,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI;YACJ,IAAI;YACJ,IAAI;YACJ,MAAM;SACP,CAAC;QAEF,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACpC,IAAgC,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACpE,CAAC;QACD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/B,IAAgC,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC1D,CAAC;QACD,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACnC,IAAgC,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QAClE,CAAC;QACD,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAClC,IAAgC,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QAChE,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAiC;QAC/C,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/ExpressMountNode.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 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}
+ */
+import type { BaseNodeRecord } from '@grafema/types';
+interface ExpressMountNodeRecord extends BaseNodeRecord {
+    type: 'express:mount';
+    file: string;
+    line: number;
+    column: number;
+}
+interface ExpressMountNodeOptions {
+    /** Target function name (e.g., "createRouter") */
+    targetFunction?: string | null;
+    /** Target variable name (e.g., "router") */
+    targetVariable?: string | null;
+    /** App/router variable name this is mounted on */
+    mountedOn?: string;
+}
+export declare class ExpressMountNode {
+    static readonly TYPE: "express:mount";
+    static readonly REQUIRED: readonly ["prefix", "file", "line", "column"];
+    static readonly OPTIONAL: readonly ["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: string, file: string, line: number, column: number, options?: ExpressMountNodeOptions): ExpressMountNodeRecord;
+    /**
+     * Validate express:mount node structure
+     */
+    static validate(node: ExpressMountNodeRecord): string[];
+}
+export type { ExpressMountNodeRecord, ExpressMountNodeOptions };
+//# sourceMappingURL=ExpressMountNode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ExpressMountNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/ExpressMountNode.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,UAAU,sBAAuB,SAAQ,cAAc;IACrD,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,uBAAuB;IAC/B,kDAAkD;IAClD,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,gBAAgB;IAC3B,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,eAAe,CAAU;IAEhD,MAAM,CAAC,QAAQ,CAAC,QAAQ,gDAAiD;IACzE,MAAM,CAAC,QAAQ,CAAC,QAAQ,6DAA8D;IAEtF;;;;;;;;OAQG;IACH,MAAM,CAAC,MAAM,CACX,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,uBAA4B,GACpC,sBAAsB;IA2BzB;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,sBAAsB,GAAG,MAAM,EAAE;CAaxD;AAED,YAAY,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,CAAC"}