@wener/common 2.0.2 → 2.0.5

package/lib/drain3/TemplateMiner.js

@@ -0,0 +1,204 @@
+import { Drain } from "./Drain.js";
+/**
+ * High-level API for log template mining with persistence support.
+ *
+ * TemplateMiner wraps the Drain algorithm and provides convenience methods
+ * for extracting parameters and managing persistence.
+ */ export class TemplateMiner {
+    drain;
+    persistence;
+    constructor(drain, persistence) {
+        this.drain = drain;
+        this.persistence = persistence;
+    }
+    /**
+     * Adds a log message and returns the update type, cluster, template, and cluster count.
+     *
+     * @param content The log message content
+     * @returns Object containing updateType, cluster, templateMined, and clusterCount
+     */ async addLogMessage(content) {
+        const { cluster, updateType } = this.drain.addLogMessage(content);
+        const templateMined = cluster.getTemplate();
+        const clusterCount = this.drain.getClusters().length;
+        if (updateType !== "none") {
+            await this.saveState();
+        }
+        return {
+            updateType,
+            cluster,
+            templateMined,
+            clusterCount
+        };
+    }
+    /**
+     * Matches a log message against an already existing cluster.
+     *
+     * @param content Log message to match
+     * @param strategy Search strategy
+     * @returns Matched cluster or null
+     */ match(content, strategy = "never") {
+        return this.drain.match(content, strategy);
+    }
+    /**
+     * Extracts parameters from a log message according to a provided template.
+     *
+     * @param logTemplate Template generated by AddLogMessage
+     * @param logMessage The log message to extract parameters from
+     * @returns Array of extracted parameters, or null if template doesn't match
+     */ extractParameters(logTemplate, logMessage) {
+        // Apply delimiters
+        let processedMessage = logMessage;
+        for (const delimiter of this.drain.extraDelimiters) {
+            // Escape delimiter for regex if it contains special characters
+            const escapedDelimiter = delimiter.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+            processedMessage = processedMessage.replace(new RegExp(escapedDelimiter, "g"), " ");
+        }
+        const { templateRegex, paramGroupNameToMaskName } = this.getTemplateParameterExtractionRegex(logTemplate);
+        // Create regex from template
+        const regex = new RegExp(templateRegex);
+        // Match the log message against the template
+        const match = processedMessage.match(regex);
+        // Template doesn't match
+        if (match === null) {
+            return null;
+        }
+        // Extract named captures
+        const extractedParameters = [];
+        // Get all named groups from the match
+        if (match.groups) {
+            for (const [groupName, value] of Object.entries(match.groups)) {
+                if (value !== undefined) {
+                    const maskName = paramGroupNameToMaskName.get(groupName);
+                    if (maskName !== undefined) {
+                        extractedParameters.push({
+                            value,
+                            maskName
+                        });
+                    }
+                }
+            }
+        }
+        // Also check by index if groups are not available (fallback)
+        // The regex exec method provides better named group support
+        const execResult = regex.exec(processedMessage);
+        if (execResult !== null && execResult.groups === undefined) {
+            // Fallback: extract by order (less reliable but works)
+            const indices = Array.from({
+                length: execResult.length - 1
+            }, (_, i) => i + 1);
+            let paramIndex = 0;
+            for (const index of indices) {
+                const value = execResult[index];
+                if (value !== undefined) {
+                    // Find corresponding mask name by order
+                    // This is a fallback - ideally we should use named groups
+                    const maskName = paramGroupNameToMaskName.get(`p_${paramIndex}`);
+                    if (maskName !== undefined) {
+                        extractedParameters.push({
+                            value,
+                            maskName
+                        });
+                    }
+                    paramIndex++;
+                }
+            }
+        }
+        return extractedParameters.length > 0 ? extractedParameters : null;
+    }
+    /**
+     * Gets the template parameter extraction regex and mapping.
+     *
+     * @param logTemplate The log template
+     * @returns Tuple of [templateRegex, paramGroupNameToMaskName]
+     */ getTemplateParameterExtractionRegex(logTemplate) {
+        const paramGroupNameToMaskName = new Map();
+        let paramNameCounter = 0;
+        const getNextParamName = () => {
+            const paramGroupName = `p_${paramNameCounter}`;
+            paramNameCounter++;
+            return paramGroupName;
+        };
+        // Create a named group with the respective patterns for the given mask-name
+        const createCaptureRegex = (maskName) => {
+            const allowedPatterns = [];
+            if (maskName === "*") {
+                allowedPatterns.push(".+?");
+            }
+            // Give each capture group a unique name to avoid conflict
+            const paramGroupName = getNextParamName();
+            paramGroupNameToMaskName.set(paramGroupName, maskName);
+            const joinedPatterns = allowedPatterns.join("|");
+            const captureRegex = `(?<${paramGroupName}>${joinedPatterns})`;
+            return captureRegex;
+        };
+        // For every mask in the template, replace it with a named group
+        const maskNames = new Set();
+        // The drain catch-all mask
+        maskNames.add("*");
+        // Escape the template for regex
+        let templateRegex = this.escapeRegex(logTemplate);
+        // Replace each mask name with a proper regex that captures it
+        for (const maskName of maskNames) {
+            const searchStr = `<${this.escapeRegex(maskName)}>`;
+            // Replace one-by-one to get a new param group name for each replacement
+            while (true) {
+                const repStr = createCaptureRegex(maskName);
+                const templateRegexNew = templateRegex.replace(searchStr, repStr);
+                // Break when all replaces for this mask are done
+                if (templateRegexNew === templateRegex) {
+                    break;
+                }
+                templateRegex = templateRegexNew;
+            }
+        }
+        // Match also messages with multiple spaces or other whitespace chars between tokens
+        templateRegex = templateRegex.replace(/\\ /g, "\\s+");
+        templateRegex = `^${templateRegex}$`;
+        return {
+            templateRegex,
+            paramGroupNameToMaskName
+        };
+    }
+    /**
+     * Escapes special regex characters in a string.
+     */ escapeRegex(str) {
+        return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    }
+    /**
+     * Loads the Drain state from persistence.
+     *
+     * @throws Error if loading fails
+     */ async loadState() {
+        const state = await this.persistence.load();
+        if (state === null || typeof state === "string" && state.length === 0) {
+            throw new Error("saved state not found");
+        }
+        try {
+            const stateStr = typeof state === "string" ? state : new TextDecoder().decode(state);
+            const data = JSON.parse(stateStr);
+            this.drain = Drain.fromJSON(data);
+        }
+        catch (error) {
+            throw new Error(`failed to unmarshal state: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Saves the Drain state to persistence.
+     *
+     * @throws Error if saving fails
+     */ async saveState() {
+        try {
+            const state = JSON.stringify(this.drain.toJSON());
+            await this.persistence.save(state);
+        }
+        catch (error) {
+            throw new Error(`failed to save state: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Gets the underlying Drain instance.
+     */ getDrain() {
+        return this.drain;
+    }
+}
+//# sourceMappingURL=TemplateMiner.js.map

package/lib/drain3/TemplateMiner.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/drain3/TemplateMiner.ts"],"sourcesContent":["import { Drain } from './Drain';\nimport type { LogCluster } from './LogCluster';\nimport type { PersistenceHandler } from './persistence/PersistenceHandler';\nimport type { ClusterUpdateType, ExtractedParameter, SearchStrategy } from './types';\n\n/**\n * High-level API for log template mining with persistence support.\n *\n * TemplateMiner wraps the Drain algorithm and provides convenience methods\n * for extracting parameters and managing persistence.\n */\nexport class TemplateMiner {\n\tconstructor(\n\t\tprivate drain: Drain,\n\t\tprivate readonly persistence: PersistenceHandler,\n\t) {}\n\n\t/**\n\t * Adds a log message and returns the update type, cluster, template, and cluster count.\n\t *\n\t * @param content The log message content\n\t * @returns Object containing updateType, cluster, templateMined, and clusterCount\n\t */\n\tasync addLogMessage(content: string): Promise<{\n\t\tupdateType: ClusterUpdateType;\n\t\tcluster: LogCluster;\n\t\ttemplateMined: string;\n\t\tclusterCount: number;\n\t}> {\n\t\tconst { cluster, updateType } = this.drain.addLogMessage(content);\n\n\t\tconst templateMined = cluster.getTemplate();\n\t\tconst clusterCount = this.drain.getClusters().length;\n\n\t\tif (updateType !== 'none') {\n\t\t\tawait this.saveState();\n\t\t}\n\n\t\treturn {\n\t\t\tupdateType,\n\t\t\tcluster,\n\t\t\ttemplateMined,\n\t\t\tclusterCount,\n\t\t};\n\t}\n\n\t/**\n\t * Matches a log message against an already existing cluster.\n\t *\n\t * @param content Log message to match\n\t * @param strategy Search strategy\n\t * @returns Matched cluster or null\n\t */\n\tmatch(content: string, strategy: SearchStrategy = 'never'): LogCluster | null {\n\t\treturn this.drain.match(content, strategy);\n\t}\n\n\t/**\n\t * Extracts parameters from a log message according to a provided template.\n\t *\n\t * @param logTemplate Template generated by AddLogMessage\n\t * @param logMessage The log message to extract parameters from\n\t * @returns Array of extracted parameters, or null if template doesn't match\n\t */\n\textractParameters(logTemplate: string, logMessage: string): ExtractedParameter[] | null {\n\t\t// Apply delimiters\n\t\tlet processedMessage = logMessage;\n\t\tfor (const delimiter of this.drain.extraDelimiters) {\n\t\t\t// Escape delimiter for regex if it contains special characters\n\t\t\tconst escapedDelimiter = delimiter.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n\t\t\tprocessedMessage = processedMessage.replace(new RegExp(escapedDelimiter, 'g'), ' ');\n\t\t}\n\n\t\tconst { templateRegex, paramGroupNameToMaskName } = this.getTemplateParameterExtractionRegex(logTemplate);\n\n\t\t// Create regex from template\n\t\tconst regex = new RegExp(templateRegex);\n\n\t\t// Match the log message against the template\n\t\tconst match = processedMessage.match(regex);\n\n\t\t// Template doesn't match\n\t\tif (match === null) {\n\t\t\treturn null;\n\t\t}\n\n\t\t// Extract named captures\n\t\tconst extractedParameters: ExtractedParameter[] = [];\n\n\t\t// Get all named groups from the match\n\t\tif (match.groups) {\n\t\t\tfor (const [groupName, value] of Object.entries(match.groups)) {\n\t\t\t\tif (value !== undefined) {\n\t\t\t\t\tconst maskName = paramGroupNameToMaskName.get(groupName);\n\t\t\t\t\tif (maskName !== undefined) {\n\t\t\t\t\t\textractedParameters.push({\n\t\t\t\t\t\t\tvalue,\n\t\t\t\t\t\t\tmaskName,\n\t\t\t\t\t\t});\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// Also check by index if groups are not available (fallback)\n\t\t// The regex exec method provides better named group support\n\t\tconst execResult = regex.exec(processedMessage);\n\t\tif (execResult !== null && execResult.groups === undefined) {\n\t\t\t// Fallback: extract by order (less reliable but works)\n\t\t\tconst indices = Array.from({ length: execResult.length - 1 }, (_, i) => i + 1);\n\t\t\tlet paramIndex = 0;\n\t\t\tfor (const index of indices) {\n\t\t\t\tconst value = execResult[index];\n\t\t\t\tif (value !== undefined) {\n\t\t\t\t\t// Find corresponding mask name by order\n\t\t\t\t\t// This is a fallback - ideally we should use named groups\n\t\t\t\t\tconst maskName = paramGroupNameToMaskName.get(`p_${paramIndex}`);\n\t\t\t\t\tif (maskName !== undefined) {\n\t\t\t\t\t\textractedParameters.push({\n\t\t\t\t\t\t\tvalue,\n\t\t\t\t\t\t\tmaskName,\n\t\t\t\t\t\t});\n\t\t\t\t\t}\n\t\t\t\t\tparamIndex++;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn extractedParameters.length > 0 ? extractedParameters : null;\n\t}\n\n\t/**\n\t * Gets the template parameter extraction regex and mapping.\n\t *\n\t * @param logTemplate The log template\n\t * @returns Tuple of [templateRegex, paramGroupNameToMaskName]\n\t */\n\tprivate getTemplateParameterExtractionRegex(logTemplate: string): {\n\t\ttemplateRegex: string;\n\t\tparamGroupNameToMaskName: Map<string, string>;\n\t} {\n\t\tconst paramGroupNameToMaskName = new Map<string, string>();\n\t\tlet paramNameCounter = 0;\n\n\t\tconst getNextParamName = (): string => {\n\t\t\tconst paramGroupName = `p_${paramNameCounter}`;\n\t\t\tparamNameCounter++;\n\t\t\treturn paramGroupName;\n\t\t};\n\n\t\t// Create a named group with the respective patterns for the given mask-name\n\t\tconst createCaptureRegex = (maskName: string): string => {\n\t\t\tconst allowedPatterns: string[] = [];\n\n\t\t\tif (maskName === '*') {\n\t\t\t\tallowedPatterns.push('.+?');\n\t\t\t}\n\n\t\t\t// Give each capture group a unique name to avoid conflict\n\t\t\tconst paramGroupName = getNextParamName();\n\t\t\tparamGroupNameToMaskName.set(paramGroupName, maskName);\n\t\t\tconst joinedPatterns = allowedPatterns.join('|');\n\t\t\tconst captureRegex = `(?<${paramGroupName}>${joinedPatterns})`;\n\n\t\t\treturn captureRegex;\n\t\t};\n\n\t\t// For every mask in the template, replace it with a named group\n\t\tconst maskNames = new Set<string>();\n\t\t// The drain catch-all mask\n\t\tmaskNames.add('*');\n\n\t\t// Escape the template for regex\n\t\tlet templateRegex = this.escapeRegex(logTemplate);\n\n\t\t// Replace each mask name with a proper regex that captures it\n\t\tfor (const maskName of maskNames) {\n\t\t\tconst searchStr = `<${this.escapeRegex(maskName)}>`;\n\n\t\t\t// Replace one-by-one to get a new param group name for each replacement\n\t\t\twhile (true) {\n\t\t\t\tconst repStr = createCaptureRegex(maskName);\n\t\t\t\tconst templateRegexNew = templateRegex.replace(searchStr, repStr);\n\t\t\t\t// Break when all replaces for this mask are done\n\t\t\t\tif (templateRegexNew === templateRegex) {\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t\ttemplateRegex = templateRegexNew;\n\t\t\t}\n\t\t}\n\n\t\t// Match also messages with multiple spaces or other whitespace chars between tokens\n\t\ttemplateRegex = templateRegex.replace(/\\\\ /g, '\\\\s+');\n\t\ttemplateRegex = `^${templateRegex}$`;\n\n\t\treturn { templateRegex, paramGroupNameToMaskName };\n\t}\n\n\t/**\n\t * Escapes special regex characters in a string.\n\t */\n\tprivate escapeRegex(str: string): string {\n\t\treturn str.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n\t}\n\n\t/**\n\t * Loads the Drain state from persistence.\n\t *\n\t * @throws Error if loading fails\n\t */\n\tasync loadState(): Promise<void> {\n\t\tconst state = await this.persistence.load();\n\t\tif (state === null || (typeof state === 'string' && state.length === 0)) {\n\t\t\tthrow new Error('saved state not found');\n\t\t}\n\n\t\ttry {\n\t\t\tconst stateStr = typeof state === 'string' ? state : new TextDecoder().decode(state);\n\t\t\tconst data = JSON.parse(stateStr);\n\t\t\tthis.drain = Drain.fromJSON(data);\n\t\t} catch (error) {\n\t\t\tthrow new Error(`failed to unmarshal state: ${error instanceof Error ? error.message : String(error)}`);\n\t\t}\n\t}\n\n\t/**\n\t * Saves the Drain state to persistence.\n\t *\n\t * @throws Error if saving fails\n\t */\n\tasync saveState(): Promise<void> {\n\t\ttry {\n\t\t\tconst state = JSON.stringify(this.drain.toJSON());\n\t\t\tawait this.persistence.save(state);\n\t\t} catch (error) {\n\t\t\tthrow new Error(`failed to save state: ${error instanceof Error ? error.message : String(error)}`);\n\t\t}\n\t}\n\n\t/**\n\t * Gets the underlying Drain instance.\n\t */\n\tgetDrain(): Drain {\n\t\treturn this.drain;\n\t}\n}\n"],"names":["Drain","TemplateMiner","drain","persistence","addLogMessage","content","cluster","updateType","templateMined","getTemplate","clusterCount","getClusters","length","saveState","match","strategy","extractParameters","logTemplate","logMessage","processedMessage","delimiter","extraDelimiters","escapedDelimiter","replace","RegExp","templateRegex","paramGroupNameToMaskName","getTemplateParameterExtractionRegex","regex","extractedParameters","groups","groupName","value","Object","entries","undefined","maskName","get","push","execResult","exec","indices","Array","from","_","i","paramIndex","index","Map","paramNameCounter","getNextParamName","paramGroupName","createCaptureRegex","allowedPatterns","set","joinedPatterns","join","captureRegex","maskNames","Set","add","escapeRegex","searchStr","repStr","templateRegexNew","str","loadState","state","load","Error","stateStr","TextDecoder","decode","data","JSON","parse","fromJSON","error","message","String","stringify","toJSON","save","getDrain"],"mappings":"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"}

package/lib/drain3/index.js

@@ -0,0 +1,31 @@
+/**
+ * Drain3 - A TypeScript implementation of the Drain log clustering algorithm.
+ *
+ * Drain is an online log parsing algorithm that groups log messages into clusters
+ * based on their structural similarity, extracting templates by parameterizing
+ * variable parts of the logs.
+ *
+ * @example
+ * ```typescript
+ * import { Drain, TemplateMiner, MemoryPersistence } from '@wener/common/drain3';
+ *
+ * // Basic usage
+ * const drain = new Drain({
+ *   logClusterDepth: 4,
+ *   simTh: 0.4,
+ *   maxClusters: 1000
+ * });
+ *
+ * const result = drain.addLogMessage('[INFO] User 123 logged in');
+ * console.log(result.cluster.getTemplate()); // [INFO] User <*> logged in
+ *
+ * // Advanced usage with persistence
+ * const miner = new TemplateMiner(drain, new MemoryPersistence());
+ * await miner.addLogMessage('[INFO] User 123 logged in');
+ * ```
+ */ export { Drain } from "./Drain.js";
+export { LogCluster } from "./LogCluster.js";
+export { Node } from "./Node.js";
+export { TemplateMiner } from "./TemplateMiner.js";
+export { MemoryPersistence } from "./persistence/MemoryPersistence.js";
+//# sourceMappingURL=index.js.map

package/lib/drain3/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/drain3/index.ts"],"sourcesContent":["/**\n * Drain3 - A TypeScript implementation of the Drain log clustering algorithm.\n *\n * Drain is an online log parsing algorithm that groups log messages into clusters\n * based on their structural similarity, extracting templates by parameterizing\n * variable parts of the logs.\n *\n * @example\n * ```typescript\n * import { Drain, TemplateMiner, MemoryPersistence } from '@wener/common/drain3';\n *\n * // Basic usage\n * const drain = new Drain({\n *   logClusterDepth: 4,\n *   simTh: 0.4,\n *   maxClusters: 1000\n * });\n *\n * const result = drain.addLogMessage('[INFO] User 123 logged in');\n * console.log(result.cluster.getTemplate()); // [INFO] User <*> logged in\n *\n * // Advanced usage with persistence\n * const miner = new TemplateMiner(drain, new MemoryPersistence());\n * await miner.addLogMessage('[INFO] User 123 logged in');\n * ```\n */\n\nexport { Drain } from './Drain';\nexport { LogCluster } from './LogCluster';\nexport { Node } from './Node';\nexport { TemplateMiner } from './TemplateMiner';\n\nexport type { ClusterUpdateType, DrainOptions, ExtractedParameter, SearchStrategy } from './types';\n\nexport type { PersistenceHandler } from './persistence/PersistenceHandler';\nexport { MemoryPersistence } from './persistence/MemoryPersistence';\n"],"names":["Drain","LogCluster","Node","TemplateMiner","MemoryPersistence"],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;CAyBC,GAED,SAASA,KAAK,QAAQ,UAAU;AAChC,SAASC,UAAU,QAAQ,eAAe;AAC1C,SAASC,IAAI,QAAQ,SAAS;AAC9B,SAASC,aAAa,QAAQ,kBAAkB;AAKhD,SAASC,iBAAiB,QAAQ,kCAAkC"}

package/lib/drain3/persistence/FilePersistence.js

@@ -0,0 +1,24 @@
+import { readFile, writeFile } from "node:fs/promises";
+/**
+ * File-based persistence handler that saves and loads state from the filesystem.
+ */ export class FilePersistence {
+    filePath;
+    constructor(filePath){
+        this.filePath = filePath;
+    }
+    async save(state) {
+        await writeFile(this.filePath, state, 'utf8');
+    }
+    async load() {
+        try {
+            return await readFile(this.filePath, 'utf8');
+        } catch (error) {
+            if (error?.code === 'ENOENT') {
+                return null;
+            }
+            throw error;
+        }
+    }
+}
+
+//# sourceMappingURL=FilePersistence.js.map

package/lib/drain3/persistence/FilePersistence.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/drain3/persistence/FilePersistence.ts"],"sourcesContent":["import { readFile, writeFile } from 'node:fs/promises';\nimport type { PersistenceHandler } from './PersistenceHandler';\n\n/**\n * File-based persistence handler that saves and loads state from the filesystem.\n */\nexport class FilePersistence implements PersistenceHandler {\n\tconstructor(private readonly filePath: string) {}\n\n\tasync save(state: Uint8Array | string): Promise<void> {\n\t\tawait writeFile(this.filePath, state, 'utf8');\n\t}\n\n\tasync load(): Promise<string | null> {\n\t\ttry {\n\t\t\treturn await readFile(this.filePath, 'utf8');\n\t\t} catch (error) {\n\t\t\tif ((error as { code?: string })?.code === 'ENOENT') {\n\t\t\t\treturn null;\n\t\t\t}\n\t\t\tthrow error;\n\t\t}\n\t}\n}\n"],"names":["readFile","writeFile","FilePersistence","filePath","save","state","load","error","code"],"mappings":"AAAA,SAASA,QAAQ,EAAEC,SAAS,QAAQ,mBAAmB;AAGvD;;CAEC,GACD,OAAO,MAAMC;;IACZ,YAAY,AAAiBC,QAAgB,CAAE;aAAlBA,WAAAA;IAAmB;IAEhD,MAAMC,KAAKC,KAA0B,EAAiB;QACrD,MAAMJ,UAAU,IAAI,CAACE,QAAQ,EAAEE,OAAO;IACvC;IAEA,MAAMC,OAA+B;QACpC,IAAI;YACH,OAAO,MAAMN,SAAS,IAAI,CAACG,QAAQ,EAAE;QACtC,EAAE,OAAOI,OAAO;YACf,IAAI,AAACA,OAA6BC,SAAS,UAAU;gBACpD,OAAO;YACR;YACA,MAAMD;QACP;IACD;AACD"}

package/lib/drain3/persistence/MemoryPersistence.js

@@ -0,0 +1,18 @@
+/**
+ * In-memory persistence handler that stores state in memory.
+ * Useful for testing or when persistence is not needed.
+ */ export class MemoryPersistence {
+    state = null;
+    /**
+	 * Saves the state to memory.
+	 */ async save(state) {
+        this.state = state;
+    }
+    /**
+	 * Loads the state from memory.
+	 */ async load() {
+        return this.state;
+    }
+}
+
+//# sourceMappingURL=MemoryPersistence.js.map

package/lib/drain3/persistence/MemoryPersistence.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/drain3/persistence/MemoryPersistence.ts"],"sourcesContent":["import type { PersistenceHandler } from './PersistenceHandler';\n\n/**\n * In-memory persistence handler that stores state in memory.\n * Useful for testing or when persistence is not needed.\n */\nexport class MemoryPersistence implements PersistenceHandler {\n\tprivate state: Uint8Array | string | null = null;\n\n\t/**\n\t * Saves the state to memory.\n\t */\n\tasync save(state: Uint8Array | string): Promise<void> {\n\t\tthis.state = state;\n\t}\n\n\t/**\n\t * Loads the state from memory.\n\t */\n\tasync load(): Promise<Uint8Array | string | null> {\n\t\treturn this.state;\n\t}\n}\n"],"names":["MemoryPersistence","state","save","load"],"mappings":"AAEA;;;CAGC,GACD,OAAO,MAAMA;IACJC,QAAoC,KAAK;IAEjD;;EAEC,GACD,MAAMC,KAAKD,KAA0B,EAAiB;QACrD,IAAI,CAACA,KAAK,GAAGA;IACd;IAEA;;EAEC,GACD,MAAME,OAA4C;QACjD,OAAO,IAAI,CAACF,KAAK;IAClB;AACD"}

package/lib/drain3/persistence/PersistenceHandler.js

@@ -0,0 +1,5 @@
+/**
+ * Interface for persistence handlers that can save and load Drain state.
+ */ export { };
+
+//# sourceMappingURL=PersistenceHandler.js.map

package/lib/drain3/persistence/PersistenceHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/drain3/persistence/PersistenceHandler.ts"],"sourcesContent":["/**\n * Interface for persistence handlers that can save and load Drain state.\n */\nexport interface PersistenceHandler {\n\t/**\n\t * Saves the Drain state.\n\t *\n\t * @param state Serialized state data\n\t * @returns Promise that resolves when save is complete\n\t */\n\tsave(state: Uint8Array | string): Promise<void>;\n\n\t/**\n\t * Loads the Drain state.\n\t *\n\t * @returns Promise that resolves with the loaded state, or null if no state exists\n\t */\n\tload(): Promise<Uint8Array | string | null>;\n}\n"],"names":[],"mappings":"AAAA;;CAEC,GACD,WAeC"}

package/lib/drain3/types.js

@@ -0,0 +1,7 @@
+/**
+ * Cluster update type indicating what happened when a log message was processed.
+ */ /**
+ * Extracted parameter from a log message based on a template.
+ */ export { };
+
+//# sourceMappingURL=types.js.map

package/lib/drain3/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/drain3/types.ts"],"sourcesContent":["/**\n * Cluster update type indicating what happened when a log message was processed.\n */\nexport type ClusterUpdateType = 'none' | 'created' | 'templateChanged';\n\n/**\n * Search strategy for matching log messages against existing clusters.\n *\n * - 'never': Fastest, always performs tree search [O(log(n))] but might produce false negatives\n * - 'fallback': Performs linear search [O(n)] only if tree search found no match, should not have false negatives\n * - 'always': Slowest, always evaluates all clusters and selects the best match with least wildcard parameters\n */\nexport type SearchStrategy = 'never' | 'fallback' | 'always';\n\n/**\n * Configuration options for Drain algorithm.\n */\nexport interface DrainOptions {\n\t/**\n\t * Depth of the prefix tree for log clustering. Must be at least 3.\n\t * @default 4\n\t */\n\tlogClusterDepth?: number;\n\n\t/**\n\t * Similarity threshold (0.0 to 1.0) for matching log messages to clusters.\n\t * @default 0.4\n\t */\n\tsimTh?: number;\n\n\t/**\n\t * Maximum number of children nodes in the prefix tree.\n\t * @default 100\n\t */\n\tmaxChildren?: number;\n\n\t/**\n\t * Maximum number of clusters to maintain in LRU cache.\n\t * @default 1000\n\t */\n\tmaxClusters?: number;\n\n\t/**\n\t * Additional delimiters to replace with spaces during tokenization.\n\t * @default []\n\t */\n\textraDelimiters?: string[];\n\n\t/**\n\t * String used to represent parameterized tokens in templates.\n\t * @default \"<*>\"\n\t */\n\tparamStr?: string;\n\n\t/**\n\t * Whether to automatically parameterize tokens containing numbers.\n\t * @default true\n\t */\n\tparametrizeNumericTokens?: boolean;\n}\n\n/**\n * Extracted parameter from a log message based on a template.\n */\nexport interface ExtractedParameter {\n\t/**\n\t * The extracted parameter value.\n\t */\n\tvalue: string;\n\n\t/**\n\t * The mask name (e.g., \"*\") that matched this parameter.\n\t */\n\tmaskName: string;\n}\n"],"names":[],"mappings":"AAAA;;CAEC,GA2DD;;CAEC,GACD,WAUC"}

package/lib/emittery/emitter.js

@@ -0,0 +1,10 @@
+import Emittery from "emittery";
+export function createEmitter(name) {
+    return new Emittery({
+        debug: {
+            name
+        }
+    });
+}
+
+//# sourceMappingURL=emitter.js.map

package/lib/emittery/emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/emittery/emitter.ts"],"sourcesContent":["import Emittery, { type EventName } from 'emittery';\n\nexport function createEmitter<EventData = Record<EventName, any>>(name: string) {\n\treturn new Emittery<EventData>({\n\t\tdebug: {\n\t\t\tname,\n\t\t},\n\t});\n}\n"],"names":["Emittery","createEmitter","name","debug"],"mappings":"AAAA,OAAOA,cAAkC,WAAW;AAEpD,OAAO,SAASC,cAAkDC,IAAY;IAC7E,OAAO,IAAIF,SAAoB;QAC9BG,OAAO;YACND;QACD;IACD;AACD"}

package/lib/emittery/index.js

@@ -0,0 +1,2 @@
+export { createEmitter } from "./emitter.js";
+//# sourceMappingURL=index.js.map

package/lib/emittery/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/emittery/index.ts"],"sourcesContent":["export { createEmitter } from './emitter';\n"],"names":["createEmitter"],"mappings":"AAAA,SAASA,aAAa,QAAQ,YAAY"}

package/lib/foundation/schema/SexType.js

@@ -1,14 +1,16 @@
-import { z } from 'zod/v4';
+import { z } from "zod/v4";
 // Sex 指的是生理性别/生物性别，通常由出生时的生物特征决定
-export var SexType = Object.freeze({
+export const SexType = Object.freeze({
     __proto__: null,
     Male: 'Male',
     Female: 'Female'
 });
-export var SexTypeSchema = z.union([
+export const SexTypeSchema = z.union([
     //
     z.literal(SexType.Male).describe('男'),
     z.literal(SexType.Female).describe('女')
 ]).describe('性别').meta({
     title: 'SexType'
 });
+
+//# sourceMappingURL=SexType.js.map

package/lib/foundation/schema/SexType.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/foundation/schema/SexType.ts"],"sourcesContent":["import { z } from 'zod/v4';\nimport type { EnumValues } from '../../resource/schema';\n\n// Sex 指的是生理性别/生物性别，通常由出生时的生物特征决定\nexport const SexType = Object.freeze({\n\t__proto__: null,\n\tMale: 'Male',\n\tFemale: 'Female',\n});\nexport type SexType = EnumValues<typeof SexType>;\n\nexport const SexTypeSchema = z\n\t.union([\n\t\t//\n\t\tz.literal(SexType.Male).describe('男'),\n\t\tz.literal(SexType.Female).describe('女'),\n\t])\n\t.describe('性别')\n\t.meta({\n\t\ttitle: 'SexType',\n\t});\n"],"names":["z","SexType","Object","freeze","__proto__","Male","Female","SexTypeSchema","union","literal","describe","meta","title"],"mappings":"AAAA,SAASA,CAAC,QAAQ,SAAS;AAG3B,iCAAiC;AACjC,OAAO,MAAMC,UAAUC,OAAOC,MAAM,CAAC;IACpCC,WAAW;IACXC,MAAM;IACNC,QAAQ;AACT,GAAG;AAGH,OAAO,MAAMC,gBAAgBP,EAC3BQ,KAAK,CAAC;IACN,EAAE;IACFR,EAAES,OAAO,CAACR,QAAQI,IAAI,EAAEK,QAAQ,CAAC;IACjCV,EAAES,OAAO,CAACR,QAAQK,MAAM,EAAEI,QAAQ,CAAC;CACnC,EACAA,QAAQ,CAAC,MACTC,IAAI,CAAC;IACLC,OAAO;AACR,GAAG"}

package/lib/foundation/schema/index.js

@@ -1 +1,2 @@
 export { SexType, SexTypeSchema } from "./SexType.js";
+//# sourceMappingURL=index.js.map

package/lib/foundation/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/foundation/schema/index.ts"],"sourcesContent":["export { SexType, SexTypeSchema } from './SexType';\n"],"names":["SexType","SexTypeSchema"],"mappings":"AAAA,SAASA,OAAO,EAAEC,aAAa,QAAQ,YAAY"}

package/lib/foundation/schema/parseSexType.js

@@ -16,3 +16,4 @@ export function parseSexType(s) {
     }
     return undefined;
 }
+//# sourceMappingURL=parseSexType.js.map

package/lib/foundation/schema/parseSexType.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/foundation/schema/parseSexType.ts"],"sourcesContent":["import { SexType } from './SexType';\n\nexport function parseSexType(s: string | null | undefined): undefined | SexType {\n\tif (!s) return undefined;\n\n\tswitch (s.toLowerCase()) {\n\t\tcase '♂':\n\t\tcase '男':\n\t\tcase 'male':\n\t\tcase 'man':\n\t\t\treturn SexType.Male;\n\t\tcase '♀':\n\t\tcase '女':\n\t\tcase 'female':\n\t\tcase 'woman':\n\t\t\treturn SexType.Female;\n\t}\n\treturn undefined;\n}\n"],"names":["SexType","parseSexType","s","undefined","toLowerCase","Male","Female"],"mappings":"AAAA,SAASA,OAAO,QAAQ,YAAY;AAEpC,OAAO,SAASC,aAAaC,CAA4B;IACxD,IAAI,CAACA,GAAG,OAAOC;IAEf,OAAQD,EAAEE,WAAW;QACpB,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;YACJ,OAAOJ,QAAQK,IAAI;QACpB,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;YACJ,OAAOL,QAAQM,MAAM;IACvB;IACA,OAAOH;AACR"}

package/lib/foundation/schema/types.js

@@ -1,5 +1,7 @@
-import z from 'zod/v4';
-export var CoordinatesSchema = z.object({
+import z from "zod/v4";
+export const CoordinatesSchema = z.object({
     latitude: z.number().min(-90).max(90).describe('纬度'),
     longitude: z.number().min(-180).max(180).describe('经度')
 }).describe('坐标信息');
+
+//# sourceMappingURL=types.js.map

package/lib/foundation/schema/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/foundation/schema/types.ts"],"sourcesContent":["import z from 'zod/v4';\n\nexport const CoordinatesSchema = z\n\t.object({\n\t\tlatitude: z.number().min(-90).max(90).describe('纬度'),\n\t\tlongitude: z.number().min(-180).max(180).describe('经度'),\n\t})\n\t.describe('坐标信息');\n"],"names":["z","CoordinatesSchema","object","latitude","number","min","max","describe","longitude"],"mappings":"AAAA,OAAOA,OAAO,SAAS;AAEvB,OAAO,MAAMC,oBAAoBD,EAC/BE,MAAM,CAAC;IACPC,UAAUH,EAAEI,MAAM,GAAGC,GAAG,CAAC,CAAC,IAAIC,GAAG,CAAC,IAAIC,QAAQ,CAAC;IAC/CC,WAAWR,EAAEI,MAAM,GAAGC,GAAG,CAAC,CAAC,KAAKC,GAAG,CAAC,KAAKC,QAAQ,CAAC;AACnD,GACCA,QAAQ,CAAC,QAAQ"}

package/lib/fs/FileSystemError.js

@@ -0,0 +1,23 @@
+export const FileSystemErrorCode = {
+    ENOENT: 'ENOENT',
+    ENOTDIR: 'ENOTDIR',
+    EEXIST: 'EEXIST',
+    EISDIR: 'EISDIR',
+    ENOTEMPTY: 'ENOTEMPTY',
+    EACCES: 'EACCES',
+    EPERM: 'EPERM',
+    EINVAL: 'EINVAL'
+};
+export class FileSystemError extends Error {
+    code;
+    constructor(message, code){
+        super(message), this.code = code;
+        this.name = 'FileSystemError';
+        // Maintains proper stack trace for where our error was thrown (only available on V8)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, FileSystemError);
+        }
+    }
+}
+
+//# sourceMappingURL=FileSystemError.js.map

package/lib/fs/FileSystemError.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/fs/FileSystemError.ts"],"sourcesContent":["export const FileSystemErrorCode = {\n\tENOENT: 'ENOENT',\n\tENOTDIR: 'ENOTDIR',\n\tEEXIST: 'EEXIST',\n\tEISDIR: 'EISDIR',\n\tENOTEMPTY: 'ENOTEMPTY',\n\tEACCES: 'EACCES',\n\tEPERM: 'EPERM',\n\tEINVAL: 'EINVAL',\n} as const;\n\nexport type FileSystemErrorCode = (typeof FileSystemErrorCode)[keyof typeof FileSystemErrorCode];\n\nexport class FileSystemError extends Error {\n\tconstructor(\n\t\tmessage: string,\n\t\tpublic readonly code: FileSystemErrorCode | string,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = 'FileSystemError';\n\t\t// Maintains proper stack trace for where our error was thrown (only available on V8)\n\t\tif (Error.captureStackTrace) {\n\t\t\tError.captureStackTrace(this, FileSystemError);\n\t\t}\n\t}\n}\n"],"names":["FileSystemErrorCode","ENOENT","ENOTDIR","EEXIST","EISDIR","ENOTEMPTY","EACCES","EPERM","EINVAL","FileSystemError","Error","message","code","name","captureStackTrace"],"mappings":"AAAA,OAAO,MAAMA,sBAAsB;IAClCC,QAAQ;IACRC,SAAS;IACTC,QAAQ;IACRC,QAAQ;IACRC,WAAW;IACXC,QAAQ;IACRC,OAAO;IACPC,QAAQ;AACT,EAAW;AAIX,OAAO,MAAMC,wBAAwBC;;IACpC,YACCC,OAAe,EACf,AAAgBC,IAAkC,CACjD;QACD,KAAK,CAACD,eAFUC,OAAAA;QAGhB,IAAI,CAACC,IAAI,GAAG;QACZ,qFAAqF;QACrF,IAAIH,MAAMI,iBAAiB,EAAE;YAC5BJ,MAAMI,iBAAiB,CAAC,IAAI,EAAEL;QAC/B;IACD;AACD"}

package/lib/fs/IFileSystem.d.js

@@ -0,0 +1,3 @@
+export { };
+
+//# sourceMappingURL=IFileSystem.d.js.map

package/lib/fs/IFileSystem.d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/fs/IFileSystem.d.ts"],"sourcesContent":["import type { FileKind, FileUrlOptions } from './types';\n\n// Base operation options\ntype OperationOptions = {\n\tsignal?: AbortSignal;\n};\n\n// Directory operations\nexport type ReaddirOptions = OperationOptions & {\n\tglob?: string;\n\trecursive?: boolean;\n\tdepth?: number;\n\tkind?: FileKind;\n\thidden?: boolean;\n};\nexport type MkdirOptions = OperationOptions & {\n\trecursive?: boolean;\n};\n// File operations\nexport type ReadFileOptions = OperationOptions & {\n\tencoding?: 'text' | 'binary';\n\tonDownloadProgress?: (e: { loaded: number; total: number }) => void;\n};\nexport type WriteFileOptions = OperationOptions & {\n\toverwrite?: boolean;\n\tonUploadProgress?: (e: { loaded: number; total: number }) => void;\n};\nexport type RenameOptions = OperationOptions & {\n\toverwrite?: boolean;\n};\nexport type RmOptions = OperationOptions & {\n\trecursive?: boolean;\n\tforce?: boolean;\n};\nexport type CopyOptions = OperationOptions & {\n\toverwrite?: boolean;\n\tshallow?: boolean;\n};\nexport type CreateReadStreamOptions = OperationOptions & {\n\trange?: { start: number; end?: number };\n\tsignal?: AbortSignal;\n};\nexport type CreateWriteStreamOptions = OperationOptions & {\n\toverwrite?: boolean;\n};\nexport type StatOptions = OperationOptions & {};\n\ntype WritableData = string | ArrayBuffer | ArrayBufferView<ArrayBufferLike> | ReadableStream;\n\n/**\n * Universal file system interface (browser & server compatible)\n */\nexport type IFileSystem = {\n\treaddir(dir: string, options?: ReaddirOptions): Promise<IFileStat[]>;\n\tstat(entry: string, options?: StatOptions): Promise<IFileStat>;\n\tmkdir(path: string, options?: MkdirOptions): Promise<void>;\n\treadFile(path: string, options?: ReadFileOptions & { encoding: 'text' }): Promise<string>;\n\treadFile(path: string, options?: ReadFileOptions): Promise<Uint8Array>;\n\twriteFile(path: string, data: WritableData, options?: WriteFileOptions): Promise<void>;\n\trm(path: string, options?: RmOptions): Promise<void>;\n\trename(oldPath: string, newPath: string, options?: RenameOptions): Promise<void>;\n\texists(path: string): Promise<boolean>;\n\tcopy(src: string, dest: string, options?: CopyOptions): Promise<void>;\n\n\tgetUrl?(path: IFileStat | string, options?: FileUrlOptions): string | undefined;\n\n\tcreateReadableStream?(path: string, options?: CreateReadStreamOptions): ReadableStream;\n\tcreateWritableStream?(path: string, options?: CreateWriteStreamOptions): WritableStream;\n};\n\n/**\n * Server/Node.js specific file system interface with stream support\n */\nexport type IServerFileSystem = IFileSystem & {\n\tcreateReadStream(path: string, options?: CreateReadStreamOptions): import('node:stream').Readable;\n\tcreateWriteStream(path: string, options?: CreateWriteStreamOptions): import('node:stream').Writable;\n\twriteFile(\n\t\tpath: string,\n\t\tdata: WritableData | Buffer | import('node:stream').Readable,\n\t\toptions?: WriteFileOptions,\n\t): Promise<void>;\n};\n\nexport type IFileStat = {\n\t/**\n\t * parent path\n\t */\n\tdirectory: string;\n\t/**\n\t * full path\n\t */\n\tpath: string;\n\t/**\n\t * basename\n\t */\n\tname: string;\n\tkind: 'directory' | 'file';\n\tmtime: number;\n\tmeta: Record<string, any>;\n\tsize: number;\n};\n"],"names":[],"mappings":"AAmFA,WAiBE"}