comfyui-node 1.4.2 → 1.4.4

package/dist/pool/profiling/JobProfiler.js

@@ -0,0 +1,225 @@
+/**
+ * Job Profiler - Automatic per-node execution profiling for WorkflowPool
+ * =======================================================================
+ *
+ * Captures detailed execution metrics for workflow jobs automatically:
+ * - Per-node execution timing
+ * - Progress tracking for nodes that emit progress events
+ * - Execution order and dependencies
+ * - Node types and metadata
+ *
+ * Usage:
+ * ```ts
+ * const pool = new WorkflowPool(clients, { enableProfiling: true });
+ * const jobId = await pool.enqueue(workflow);
+ *
+ * pool.on('job:completed', (event) => {
+ *   console.log(event.detail.job.profileStats);
+ * });
+ * ```
+ */
+/**
+ * JobProfiler tracks execution metrics for a single workflow job.
+ */
+export class JobProfiler {
+    queuedAt;
+    startedAt;
+    completedAt;
+    promptId;
+    nodeProfiles = new Map();
+    lastExecutingNode = null;
+    constructor(queuedAt, workflowJson) {
+        this.queuedAt = queuedAt;
+        // Initialize node profiles from workflow structure
+        if (workflowJson) {
+            for (const [nodeId, nodeData] of Object.entries(workflowJson)) {
+                const node = nodeData;
+                if (node && typeof node === 'object' && node.class_type) {
+                    this.nodeProfiles.set(nodeId, {
+                        nodeId,
+                        type: node.class_type,
+                        title: node._meta?.title,
+                        cached: false,
+                        status: 'pending'
+                    });
+                }
+            }
+        }
+    }
+    /**
+     * Record execution start event
+     */
+    onExecutionStart(promptId) {
+        this.promptId = promptId;
+        if (!this.startedAt) {
+            this.startedAt = Date.now();
+        }
+    }
+    /**
+     * Record cached nodes
+     */
+    onCachedNodes(nodeIds) {
+        const now = Date.now();
+        for (const nodeId of nodeIds) {
+            let profile = this.nodeProfiles.get(nodeId);
+            if (!profile) {
+                profile = {
+                    nodeId,
+                    cached: true,
+                    status: 'cached'
+                };
+                this.nodeProfiles.set(nodeId, profile);
+            }
+            profile.cached = true;
+            profile.status = 'cached';
+            profile.startedAt = now;
+            profile.completedAt = now;
+            profile.duration = 0;
+        }
+    }
+    /**
+     * Record node execution start
+     */
+    onNodeExecuting(nodeId) {
+        // Complete previous node if any
+        if (this.lastExecutingNode && this.lastExecutingNode !== nodeId) {
+            this.completeNode(this.lastExecutingNode);
+        }
+        // Start tracking new node
+        let profile = this.nodeProfiles.get(nodeId);
+        if (!profile) {
+            profile = {
+                nodeId,
+                cached: false,
+                status: 'executing'
+            };
+            this.nodeProfiles.set(nodeId, profile);
+        }
+        if (!profile.startedAt) {
+            profile.startedAt = Date.now();
+            profile.status = 'executing';
+        }
+        this.lastExecutingNode = nodeId;
+    }
+    /**
+     * Record node completion (when next node starts or execution ends)
+     */
+    completeNode(nodeId) {
+        const profile = this.nodeProfiles.get(nodeId);
+        if (profile && !profile.completedAt && profile.startedAt) {
+            profile.completedAt = Date.now();
+            profile.duration = profile.completedAt - profile.startedAt;
+            profile.status = 'completed';
+        }
+    }
+    /**
+     * Record execution end (node: null event)
+     */
+    onExecutionComplete() {
+        // Complete last executing node
+        if (this.lastExecutingNode) {
+            this.completeNode(this.lastExecutingNode);
+            this.lastExecutingNode = null;
+        }
+        // Mark any nodes still in "executing" state as completed
+        for (const profile of Array.from(this.nodeProfiles.values())) {
+            if (profile.status === 'executing' && !profile.completedAt && profile.startedAt) {
+                profile.completedAt = Date.now();
+                profile.duration = profile.completedAt - profile.startedAt;
+                profile.status = 'completed';
+            }
+        }
+        this.completedAt = Date.now();
+    }
+    /**
+     * Record progress event for a node
+     */
+    onProgress(progress) {
+        if (!progress.node)
+            return;
+        const nodeId = String(progress.node);
+        let profile = this.nodeProfiles.get(nodeId);
+        if (!profile) {
+            profile = {
+                nodeId,
+                cached: false,
+                status: 'executing',
+                progressEvents: []
+            };
+            this.nodeProfiles.set(nodeId, profile);
+        }
+        if (!profile.progressEvents) {
+            profile.progressEvents = [];
+        }
+        profile.progressEvents.push({
+            timestamp: Date.now(),
+            value: progress.value,
+            max: progress.max
+        });
+    }
+    /**
+     * Record node execution error
+     */
+    onNodeError(nodeId, error) {
+        let profile = this.nodeProfiles.get(nodeId);
+        if (!profile) {
+            profile = {
+                nodeId,
+                cached: false,
+                status: 'failed'
+            };
+            this.nodeProfiles.set(nodeId, profile);
+        }
+        profile.status = 'failed';
+        profile.error = error;
+        profile.completedAt = Date.now();
+        if (profile.startedAt) {
+            profile.duration = profile.completedAt - profile.startedAt;
+        }
+    }
+    /**
+     * Generate final profile statistics
+     */
+    getStats() {
+        const now = Date.now();
+        const completedAt = this.completedAt || now;
+        const startedAt = this.startedAt || this.queuedAt;
+        const nodes = Array.from(this.nodeProfiles.values());
+        // Calculate summary statistics
+        const executedNodes = nodes.filter(n => n.status === 'completed').length;
+        const cachedNodes = nodes.filter(n => n.cached).length;
+        const failedNodes = nodes.filter(n => n.status === 'failed').length;
+        const slowestNodes = nodes
+            .filter(n => n.duration && n.duration > 0)
+            .sort((a, b) => (b.duration || 0) - (a.duration || 0))
+            .slice(0, 5)
+            .map(n => ({
+            nodeId: n.nodeId,
+            type: n.type,
+            title: n.title,
+            duration: n.duration
+        }));
+        const progressNodes = nodes
+            .filter(n => n.progressEvents && n.progressEvents.length > 0)
+            .map(n => n.nodeId);
+        return {
+            promptId: this.promptId,
+            totalDuration: completedAt - this.queuedAt,
+            queueTime: startedAt - this.queuedAt,
+            executionTime: completedAt - startedAt,
+            queuedAt: this.queuedAt,
+            startedAt: this.startedAt,
+            completedAt,
+            nodes,
+            summary: {
+                totalNodes: nodes.length,
+                executedNodes,
+                cachedNodes,
+                failedNodes,
+                slowestNodes,
+                progressNodes
+            }
+        };
+    }
+}
+//# sourceMappingURL=JobProfiler.js.map

package/dist/pool/profiling/JobProfiler.js.map

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

package/dist/pool/queue/QueueAdapter.d.ts

@@ -1,31 +1,31 @@
-import type { WorkflowJobPayload } from "../types/job.js";
-export interface QueueStats {
-    waiting: number;
-    inFlight: number;
-    delayed: number;
-    failed: number;
-}
-export interface QueueReservation {
-    /** Unique reservation identifier (often equals the jobId for in-memory implementation). */
-    reservationId: string;
-    payload: WorkflowJobPayload;
-    attempt: number;
-    /** Optional timestamp when the item becomes visible again (for delayed retries). */
-    availableAt?: number;
-}
-export interface QueueAdapter {
-    enqueue(payload: WorkflowJobPayload, opts?: {
-        priority?: number;
-        delayMs?: number;
-    }): Promise<void>;
-    reserve(): Promise<QueueReservation | null>;
-    commit(reservationId: string): Promise<void>;
-    retry(reservationId: string, opts?: {
-        delayMs?: number;
-    }): Promise<void>;
-    discard(reservationId: string, reason?: unknown): Promise<void>;
-    remove(jobId: string): Promise<boolean>;
-    stats(): Promise<QueueStats>;
-    shutdown(): Promise<void>;
-}
+import type { WorkflowJobPayload } from "../types/job.js";
+export interface QueueStats {
+    waiting: number;
+    inFlight: number;
+    delayed: number;
+    failed: number;
+}
+export interface QueueReservation {
+    /** Unique reservation identifier (often equals the jobId for in-memory implementation). */
+    reservationId: string;
+    payload: WorkflowJobPayload;
+    attempt: number;
+    /** Optional timestamp when the item becomes visible again (for delayed retries). */
+    availableAt?: number;
+}
+export interface QueueAdapter {
+    enqueue(payload: WorkflowJobPayload, opts?: {
+        priority?: number;
+        delayMs?: number;
+    }): Promise<void>;
+    reserve(): Promise<QueueReservation | null>;
+    commit(reservationId: string): Promise<void>;
+    retry(reservationId: string, opts?: {
+        delayMs?: number;
+    }): Promise<void>;
+    discard(reservationId: string, reason?: unknown): Promise<void>;
+    remove(jobId: string): Promise<boolean>;
+    stats(): Promise<QueueStats>;
+    shutdown(): Promise<void>;
+}
 //# sourceMappingURL=QueueAdapter.d.ts.map

package/dist/pool/queue/adapters/memory.d.ts

@@ -1,21 +1,21 @@
-import { QueueAdapter, QueueReservation, QueueStats } from "../QueueAdapter.js";
-import type { WorkflowJobPayload } from "../../types/job.js";
-export declare class MemoryQueueAdapter implements QueueAdapter {
-    private waiting;
-    private inFlight;
-    private failed;
-    enqueue(payload: WorkflowJobPayload, opts?: {
-        priority?: number;
-        delayMs?: number;
-    }): Promise<void>;
-    reserve(): Promise<QueueReservation | null>;
-    commit(reservationId: string): Promise<void>;
-    retry(reservationId: string, opts?: {
-        delayMs?: number;
-    }): Promise<void>;
-    discard(reservationId: string, reason?: unknown): Promise<void>;
-    remove(jobId: string): Promise<boolean>;
-    stats(): Promise<QueueStats>;
-    shutdown(): Promise<void>;
-}
+import { QueueAdapter, QueueReservation, QueueStats } from "../QueueAdapter.js";
+import type { WorkflowJobPayload } from "../../types/job.js";
+export declare class MemoryQueueAdapter implements QueueAdapter {
+    private waiting;
+    private inFlight;
+    private failed;
+    enqueue(payload: WorkflowJobPayload, opts?: {
+        priority?: number;
+        delayMs?: number;
+    }): Promise<void>;
+    reserve(): Promise<QueueReservation | null>;
+    commit(reservationId: string): Promise<void>;
+    retry(reservationId: string, opts?: {
+        delayMs?: number;
+    }): Promise<void>;
+    discard(reservationId: string, reason?: unknown): Promise<void>;
+    remove(jobId: string): Promise<boolean>;
+    stats(): Promise<QueueStats>;
+    shutdown(): Promise<void>;
+}
 //# sourceMappingURL=memory.d.ts.map

package/dist/pool/types/job.d.ts

@@ -1,4 +1,5 @@
 import type { Workflow, WorkflowResult } from "../../workflow.js";
+import type { JobProfileStats } from "../profiling/JobProfiler.js";
 export type JobId = string;
 export type WorkflowInput = Workflow | object | string | {
     toJSON(): object;
@@ -52,5 +53,7 @@ export interface JobRecord extends WorkflowJobPayload {
     result?: WorkflowResult | Record<string, unknown>;
     startedAt?: number;
     completedAt?: number;
+    /** Execution profiling stats (only present when profiling enabled) */
+    profileStats?: JobProfileStats;
 }
 //# sourceMappingURL=job.d.ts.map

package/dist/pool/types/job.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"job.d.ts","sourceRoot":"","sources":["../../../src/pool/types/job.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAElE,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC;AAE3B,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG;IAAE,MAAM,IAAI,MAAM,CAAA;CAAE,CAAC;AAE9E,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,yCAAyC;IACzC,WAAW,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACvC;AAED,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,SAAS,GACT,WAAW,GACX,QAAQ,GACR,WAAW,CAAC;AAEhB,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,kBAAkB,EAAE,aAAa,GAAG,cAAc,CAAC,CAAC,GACzE,IAAI,CAAC,kBAAkB,EAAE,aAAa,GAAG,cAAc,GAAG,OAAO,GAAG,aAAa,CAAC,CAAC;IACrF,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,wFAAwF;IACxF,YAAY,CAAC,EAAE;QACb,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QACzB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACxC,CAAC;CACH;AAED,MAAM,WAAW,SAAU,SAAQ,kBAAkB;IACnD,WAAW,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACtC,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}
+{"version":3,"file":"job.d.ts","sourceRoot":"","sources":["../../../src/pool/types/job.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC;AAE3B,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG;IAAE,MAAM,IAAI,MAAM,CAAA;CAAE,CAAC;AAE9E,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,yCAAyC;IACzC,WAAW,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACvC;AAED,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,SAAS,GACT,WAAW,GACX,QAAQ,GACR,WAAW,CAAC;AAEhB,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,kBAAkB,EAAE,aAAa,GAAG,cAAc,CAAC,CAAC,GACzE,IAAI,CAAC,kBAAkB,EAAE,aAAa,GAAG,cAAc,GAAG,OAAO,GAAG,aAAa,CAAC,CAAC;IACrF,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,wFAAwF;IACxF,YAAY,CAAC,EAAE;QACb,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QACzB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACxC,CAAC;CACH;AAED,MAAM,WAAW,SAAU,SAAQ,kBAAkB;IACnD,WAAW,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACtC,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,YAAY,CAAC,EAAE,eAAe,CAAC;CAChC"}

package/dist/pool/utils/hash.d.ts

@@ -1,5 +1,17 @@
 /**
- * Deterministically hash a workflow payload so failover heuristics can group related jobs.
+ * Deterministically hash a workflow JSON structure (node graph, connections, node types).
+ * This hash is computed on workflow initialization and can be used by failover strategies
+ * to group related jobs and track client compatibility.
+ *
+ * The hash is based on the STRUCTURE of the workflow (nodes, connections, class types),
+ * NOT on parameter values. This ensures that running the same workflow with different
+ * prompts, seeds, or dimensions produces the same hash.
+ *
+ * If you modify the workflow structure AFTER initialization (e.g., changing a checkpoint),
+ * call workflow.updateHash() to recalculate the hash.
+ *
+ * @param workflow - The workflow JSON object
+ * @returns SHA256 hash of the normalized workflow structure
  */
 export declare function hashWorkflow(workflow: object): string;
 //# sourceMappingURL=hash.d.ts.map

package/dist/pool/utils/hash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../../src/pool/utils/hash.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAarD"}
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../../src/pool/utils/hash.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAcrD"}

package/dist/pool/utils/hash.js

@@ -1,9 +1,22 @@
 import { createHash } from "node:crypto";
 /**
- * Deterministically hash a workflow payload so failover heuristics can group related jobs.
+ * Deterministically hash a workflow JSON structure (node graph, connections, node types).
+ * This hash is computed on workflow initialization and can be used by failover strategies
+ * to group related jobs and track client compatibility.
+ *
+ * The hash is based on the STRUCTURE of the workflow (nodes, connections, class types),
+ * NOT on parameter values. This ensures that running the same workflow with different
+ * prompts, seeds, or dimensions produces the same hash.
+ *
+ * If you modify the workflow structure AFTER initialization (e.g., changing a checkpoint),
+ * call workflow.updateHash() to recalculate the hash.
+ *
+ * @param workflow - The workflow JSON object
+ * @returns SHA256 hash of the normalized workflow structure
  */
 export function hashWorkflow(workflow) {
     const json = JSON.stringify(workflow, (_key, value) => {
+        // Sort object keys for deterministic ordering
         if (value && typeof value === "object" && !Array.isArray(value)) {
             return Object.keys(value)
                 .sort()

package/dist/pool/utils/hash.js.map

@@ -1 +1 @@
-{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../../src/pool/utils/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACpD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;iBACtB,IAAI,EAAE;iBACN,MAAM,CAA0B,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;gBAC5C,GAAG,CAAC,GAAG,CAAC,GAAI,KAAiC,CAAC,GAAG,CAAC,CAAC;gBACnD,OAAO,GAAG,CAAC;YACb,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;IACH,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC"}
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../../src/pool/utils/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACpD,8CAA8C;QAC9C,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;iBACtB,IAAI,EAAE;iBACN,MAAM,CAA0B,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;gBAC5C,GAAG,CAAC,GAAG,CAAC,GAAI,KAAiC,CAAC,GAAG,CAAC,CAAC;gBACnD,OAAO,GAAG,CAAC;YACb,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;IACH,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC"}