observability-toolkit 1.8.4 → 1.8.5

package/dist/test-helpers/fuzz-generators.js

@@ -0,0 +1,216 @@
+/**
+ * Fuzzing utilities for security testing
+ *
+ * Provides generators for random inputs to test input validation resilience.
+ */
+/**
+ * Generate a random Unicode string of specified length
+ * Includes various Unicode ranges for thorough testing
+ */
+export function generateRandomUnicodeString(length) {
+    const ranges = [
+        [0x0020, 0x007E], // Basic Latin
+        [0x00A0, 0x00FF], // Latin-1 Supplement
+        [0x0100, 0x017F], // Latin Extended-A
+        [0x0400, 0x04FF], // Cyrillic
+        [0x0600, 0x06FF], // Arabic
+        [0x4E00, 0x4FFF], // CJK Unified Ideographs (subset)
+        [0x1F300, 0x1F3FF], // Misc Symbols and Pictographs
+    ];
+    let result = '';
+    for (let i = 0; i < length; i++) {
+        const range = ranges[Math.floor(Math.random() * ranges.length)];
+        const codePoint = Math.floor(Math.random() * (range[1] - range[0] + 1)) + range[0];
+        result += String.fromCodePoint(codePoint);
+    }
+    return result;
+}
+/**
+ * Generate a random number in the specified range
+ */
+export function generateRandomNumber(min, max) {
+    return Math.random() * (max - min) + min;
+}
+/**
+ * Generate a random integer in the specified range
+ */
+export function generateRandomInteger(min, max) {
+    return Math.floor(generateRandomNumber(min, max + 1));
+}
+/**
+ * Generate a random date string (may be invalid)
+ */
+export function generateRandomDateString() {
+    const formats = [
+        // Valid-ish formats
+        () => `${generateRandomInteger(1900, 2100)}-${String(generateRandomInteger(1, 12)).padStart(2, '0')}-${String(generateRandomInteger(1, 31)).padStart(2, '0')}`,
+        // Invalid formats
+        () => `${generateRandomInteger(1, 9999)}/${generateRandomInteger(1, 12)}/${generateRandomInteger(1, 31)}`,
+        () => `${String(generateRandomInteger(1, 31)).padStart(2, '0')}-${String(generateRandomInteger(1, 12)).padStart(2, '0')}-${generateRandomInteger(1900, 2100)}`,
+        () => generateRandomUnicodeString(10),
+        () => `${generateRandomInteger(-1000, 10000)}-${generateRandomInteger(-5, 15)}-${generateRandomInteger(-5, 40)}`,
+        () => '',
+        () => 'NaN-NaN-NaN',
+        () => '0000-00-00',
+        () => '9999-99-99',
+    ];
+    return formats[Math.floor(Math.random() * formats.length)]();
+}
+/**
+ * Get common SQL injection payloads for testing
+ */
+export function getSqlInjectionPayloads() {
+    return [
+        "'; DROP TABLE traces; --",
+        "1' OR '1'='1",
+        "1; SELECT * FROM users",
+        "' UNION SELECT * FROM secrets --",
+        "1 AND 1=1",
+        "' OR 1=1 --",
+        "admin'--",
+        "1'1",
+        "1' AND '1'='1",
+        "'; EXEC xp_cmdshell('dir'); --",
+        "1; WAITFOR DELAY '00:00:05'",
+        "' OR ''='",
+        "1' OR '1'='1' /*",
+        "1' ORDER BY 1--",
+        "'||'",
+        "' HAVING 1=1 --",
+    ];
+}
+/**
+ * Get common path traversal payloads for testing
+ */
+export function getPathTraversalPayloads() {
+    return [
+        '../../../etc/passwd',
+        '..\\..\\..\\windows\\system32\\config\\sam',
+        '....//....//....//etc/passwd',
+        '..%2f..%2f..%2fetc%2fpasswd',
+        '..%252f..%252f..%252fetc%252fpasswd',
+        '%2e%2e%2f%2e%2e%2f%2e%2e%2fetc%2fpasswd',
+        '..%c0%af..%c0%af..%c0%afetc/passwd',
+        '/etc/passwd%00.txt',
+        '../../../etc/passwd\0',
+        '..\\..\\..\\etc\\passwd',
+        '....//....//etc/passwd',
+        '..;/..;/..;/etc/passwd',
+        '../.../.../.../etc/passwd',
+        '/....//....//etc/passwd',
+        '..%00/..%00/..%00/etc/passwd',
+    ];
+}
+/**
+ * Get common XSS payloads for testing
+ */
+export function getXssPayloads() {
+    return [
+        '<script>alert(1)</script>',
+        '"><script>alert(1)</script>',
+        "javascript:alert('XSS')",
+        '<img src=x onerror=alert(1)>',
+        '<svg onload=alert(1)>',
+        '\'"><img src=x onerror=alert(1)>',
+        '<body onload=alert(1)>',
+        '<iframe src="javascript:alert(1)">',
+        '{{constructor.constructor("alert(1)")()}}',
+        '${alert(1)}',
+        '<input onfocus=alert(1) autofocus>',
+        '<marquee onstart=alert(1)>',
+        '<details open ontoggle=alert(1)>',
+        '<audio src=x onerror=alert(1)>',
+    ];
+}
+/**
+ * Get special number edge cases for testing
+ */
+export function getSpecialNumbers() {
+    return [
+        0,
+        -0,
+        1,
+        -1,
+        Number.MAX_VALUE,
+        Number.MIN_VALUE,
+        Number.MAX_SAFE_INTEGER,
+        Number.MIN_SAFE_INTEGER,
+        Number.POSITIVE_INFINITY,
+        Number.NEGATIVE_INFINITY,
+        Number.NaN,
+        Number.EPSILON,
+        Math.PI,
+        Math.E,
+        0.1 + 0.2, // Floating point precision
+        2 ** 53, // Just beyond MAX_SAFE_INTEGER
+        -(2 ** 53), // Negative beyond MIN_SAFE_INTEGER
+        1e308, // Near MAX_VALUE
+        1e-308, // Near MIN_VALUE (denormalized)
+        0.0000001,
+        -0.0000001,
+        86400000, // 24 hours in ms (MAX_DURATION_MS)
+        86400001, // Just over MAX_DURATION_MS
+    ];
+}
+/**
+ * Generate control character strings for testing
+ */
+export function getControlCharacterStrings() {
+    return [
+        '\x00', // null
+        '\x01', // start of heading
+        '\x07', // bell
+        '\x08', // backspace
+        '\x09', // tab
+        '\x0A', // line feed
+        '\x0B', // vertical tab
+        '\x0C', // form feed
+        '\x0D', // carriage return
+        '\x1B', // escape
+        '\x7F', // delete
+        '\x00\x00\x00', // multiple nulls
+        'test\x00hidden', // null byte injection
+        'test\x0Anewline', // embedded newline
+        '\r\n\r\n', // CRLF injection
+    ];
+}
+/**
+ * Generate regex patterns that could cause ReDoS
+ */
+export function getRedosPatterns() {
+    return [
+        '(a+)+$',
+        '([a-zA-Z]+)*',
+        '(a|aa)+',
+        '(a|a?)+',
+        '(.*a){25}',
+        '([a-z]+)+\\s',
+        '^(a+)+b$',
+        '(x+x+)+y',
+        '(a+)+ab',
+        '([^\\s]+)+\\s',
+        '(\\w+)+@',
+        '([a-zA-Z0-9]+)+\\.',
+    ];
+}
+/**
+ * Run a function multiple times with random inputs
+ */
+export function fuzz(generator, fn, iterations = 100) {
+    let passed = 0;
+    let failed = 0;
+    const errors = [];
+    for (let i = 0; i < iterations; i++) {
+        const input = generator();
+        try {
+            fn(input);
+            passed++;
+        }
+        catch (error) {
+            failed++;
+            errors.push({ input, error });
+        }
+    }
+    return { passed, failed, errors };
+}
+//# sourceMappingURL=fuzz-generators.js.map

package/dist/test-helpers/fuzz-generators.js.map

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

package/dist/test-helpers/index.d.ts

@@ -7,4 +7,5 @@ export { type ToolDefinition, validateToolDefinition, validateHandlerExport, } f
 export { validateBackendSchema, validateLimitSchema, validateDateRangeSchema, } from './schema-validators.js';
 export { SIGNOZ_ENV_VARS, type EnvSnapshot, type HomeEnvScope, captureEnv, restoreEnv, clearSigNozEnv, setSigNozEnv, createEnvScope, setHomeEnv, restoreHomeEnv, } from './env-utils.js';
 export { TEST_TIMESTAMP_BASE, TEST_TIMESTAMP, TEST_TIMESTAMP_ISO, TEST_DURATION, TEST_DURATION_MS, type MockSpan, type MockLog, type MockMetric, type MockLLMEvent, type MockEvaluation, resetBuilderCounters, createMockSpan, createMockSpans, createMockLog, createMockLogs, createMockMetric, createMockMetrics, createMockLLMEvent, createMockLLMEvents, createMockEvaluation, createMockEvaluations, createHttpSpan, createDbSpan, createErrorLog, createCorrelatedLog, createHistogramMetric, createLLMEventWithTokens, createScoredEvaluation, createLabeledEvaluation, } from './test-data-builders.js';
+export { type MemFsInstance, createMemFs, writeJsonlMem, writeFileMem, readFileMem, readJsonlMem, readJsonlMemWithStats, streamJsonlMem, existsMem, mkdirMem, readdirMem, listFilesMem, listFilesInRangeMem, getTestDateMem, getSharedMemFs, resetSharedMemFs, removeSharedMemFs, cleanupAllSharedMemFs, } from './memfs-utils.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/test-helpers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/test-helpers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,aAAa,EACb,aAAa,EACb,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,cAAc,EACd,mBAAmB,EACnB,WAAW,EAEX,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,EAExB,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,eAAe,EAEpB,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,uBAAuB,EAEvB,KAAK,aAAa,EAClB,iBAAiB,EACjB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,KAAK,cAAc,EACnB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,UAAU,EACV,UAAU,EACV,cAAc,EACd,YAAY,EACZ,cAAc,EACd,UAAU,EACV,cAAc,GACf,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAEL,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAEhB,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,cAAc,EAEnB,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EAErB,cAAc,EACd,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/test-helpers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,aAAa,EACb,aAAa,EACb,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,cAAc,EACd,mBAAmB,EACnB,WAAW,EAEX,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,EAExB,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,eAAe,EAEpB,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,uBAAuB,EAEvB,KAAK,aAAa,EAClB,iBAAiB,EACjB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,KAAK,cAAc,EACnB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,UAAU,EACV,UAAU,EACV,cAAc,EACd,YAAY,EACZ,cAAc,EACd,UAAU,EACV,cAAc,GACf,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAEL,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAEhB,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,cAAc,EAEnB,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EAErB,cAAc,EACd,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,KAAK,aAAa,EAClB,WAAW,EACX,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,qBAAqB,EACrB,cAAc,EACd,SAAS,EACT,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC"}

package/dist/test-helpers/index.js

@@ -25,4 +25,6 @@ TEST_TIMESTAMP_BASE, TEST_TIMESTAMP, TEST_TIMESTAMP_ISO, TEST_DURATION, TEST_DUR
 resetBuilderCounters, createMockSpan, createMockSpans, createMockLog, createMockLogs, createMockMetric, createMockMetrics, createMockLLMEvent, createMockLLMEvents, createMockEvaluation, createMockEvaluations, 
 // Specialized builders
 createHttpSpan, createDbSpan, createErrorLog, createCorrelatedLog, createHistogramMetric, createLLMEventWithTokens, createScoredEvaluation, createLabeledEvaluation, } from './test-data-builders.js';
+// In-memory file system utilities (memfs)
+export { createMemFs, writeJsonlMem, writeFileMem, readFileMem, readJsonlMem, readJsonlMemWithStats, streamJsonlMem, existsMem, mkdirMem, readdirMem, listFilesMem, listFilesInRangeMem, getTestDateMem, getSharedMemFs, resetSharedMemFs, removeSharedMemFs, cleanupAllSharedMemFs, } from './memfs-utils.js';
 //# sourceMappingURL=index.js.map

package/dist/test-helpers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/test-helpers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,iBAAiB;AACjB,OAAO,EACL,aAAa,EACb,aAAa,EACb,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,cAAc,EACd,mBAAmB,EACnB,WAAW;AACX,gDAAgD;AAChD,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB;AACxB,4BAA4B;AAC5B,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC;AAEzB,gBAAgB;AAChB,OAAO;AAKL,wCAAwC;AACxC,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,uBAAuB,EAGvB,iBAAiB,EACjB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAE5B,kBAAkB;AAClB,OAAO,EAEL,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAE9B,oBAAoB;AACpB,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAEhC,wBAAwB;AACxB,OAAO,EACL,eAAe,EAGf,UAAU,EACV,UAAU,EACV,cAAc,EACd,YAAY,EACZ,cAAc,EACd,UAAU,EACV,cAAc,GACf,MAAM,gBAAgB,CAAC;AAExB,qBAAqB;AACrB,OAAO;AACL,YAAY;AACZ,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,gBAAgB;AAOhB,gBAAgB;AAChB,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB;AACrB,uBAAuB;AACvB,cAAc,EACd,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/test-helpers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,iBAAiB;AACjB,OAAO,EACL,aAAa,EACb,aAAa,EACb,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,cAAc,EACd,mBAAmB,EACnB,WAAW;AACX,gDAAgD;AAChD,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB;AACxB,4BAA4B;AAC5B,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC;AAEzB,gBAAgB;AAChB,OAAO;AAKL,wCAAwC;AACxC,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,uBAAuB,EAGvB,iBAAiB,EACjB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAE5B,kBAAkB;AAClB,OAAO,EAEL,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAE9B,oBAAoB;AACpB,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAEhC,wBAAwB;AACxB,OAAO,EACL,eAAe,EAGf,UAAU,EACV,UAAU,EACV,cAAc,EACd,YAAY,EACZ,cAAc,EACd,UAAU,EACV,cAAc,GACf,MAAM,gBAAgB,CAAC;AAExB,qBAAqB;AACrB,OAAO;AACL,YAAY;AACZ,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,gBAAgB;AAOhB,gBAAgB;AAChB,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB;AACrB,uBAAuB;AACvB,cAAc,EACd,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AAEjC,0CAA0C;AAC1C,OAAO,EAEL,WAAW,EACX,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,qBAAqB,EACrB,cAAc,EACd,SAAS,EACT,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC"}

package/dist/test-helpers/memfs-utils.d.ts

@@ -0,0 +1,181 @@
+/**
+ * In-memory file system utilities for tests
+ *
+ * Uses memfs to provide a virtual file system that avoids disk I/O.
+ * Tests can use createMemFs() to get an isolated fs instance and directory.
+ *
+ * @example
+ * ```ts
+ * import { createMemFs, writeJsonlMem } from '../test-helpers/memfs-utils.js';
+ *
+ * describe('MyTest', () => {
+ *   let mfs: MemFsInstance;
+ *
+ *   beforeEach(() => {
+ *     mfs = createMemFs();
+ *   });
+ *
+ *   it('should work', async () => {
+ *     writeJsonlMem(mfs, 'traces-2026-01-31.jsonl', [{ traceId: 't1' }]);
+ *     // mfs.dir contains the path prefix to use
+ *     const backend = new LocalJsonlBackend(mfs.dir, { fs: mfs.fs });
+ *   });
+ * });
+ * ```
+ */
+import { Volume, type IFs } from 'memfs';
+/** Memfs instance with isolated volume */
+export interface MemFsInstance {
+    /** The memfs filesystem interface (compatible with node:fs) */
+    fs: IFs;
+    /** The underlying volume (for advanced operations) */
+    vol: InstanceType<typeof Volume>;
+    /** The base directory path (e.g., '/test-data') */
+    dir: string;
+    /** Reset the volume (clear all files) */
+    reset: () => void;
+}
+/**
+ * Create a new in-memory file system instance
+ *
+ * Each call creates an isolated volume with its own directory.
+ * The returned fs object is compatible with node:fs operations.
+ *
+ * @param prefix - Optional prefix for the directory name
+ * @returns MemFsInstance with fs, vol, dir, and reset function
+ */
+export declare function createMemFs(prefix?: string): MemFsInstance;
+/**
+ * Write JSONL data to an in-memory file
+ *
+ * @param mfs - MemFsInstance from createMemFs()
+ * @param filename - Filename (not full path) to write
+ * @param data - Array of objects to write as JSONL
+ */
+export declare function writeJsonlMem(mfs: MemFsInstance, filename: string, data: unknown[]): void;
+/**
+ * Write raw content to an in-memory file
+ *
+ * @param mfs - MemFsInstance from createMemFs()
+ * @param filename - Filename (not full path) to write
+ * @param content - Content to write (string or Buffer)
+ */
+export declare function writeFileMem(mfs: MemFsInstance, filename: string, content: string | Buffer): void;
+/**
+ * Read file content from in-memory file system
+ *
+ * @param mfs - MemFsInstance from createMemFs()
+ * @param filename - Filename (not full path) to read
+ * @returns File content as string
+ */
+export declare function readFileMem(mfs: MemFsInstance, filename: string): string;
+/**
+ * Check if a file exists in the in-memory file system
+ *
+ * @param mfs - MemFsInstance from createMemFs()
+ * @param filename - Filename (not full path) to check
+ * @returns true if file exists
+ */
+export declare function existsMem(mfs: MemFsInstance, filename: string): boolean;
+/**
+ * Create a subdirectory in the in-memory file system
+ *
+ * @param mfs - MemFsInstance from createMemFs()
+ * @param dirname - Directory name to create (relative to mfs.dir)
+ */
+export declare function mkdirMem(mfs: MemFsInstance, dirname: string): void;
+/**
+ * List files in a directory in the in-memory file system
+ *
+ * @param mfs - MemFsInstance from createMemFs()
+ * @param dirname - Optional subdirectory (defaults to mfs.dir)
+ * @returns Array of filenames
+ */
+export declare function readdirMem(mfs: MemFsInstance, dirname?: string): string[];
+/**
+ * Get today's date in YYYY-MM-DD format
+ * @returns Today's date string
+ */
+export declare function getTestDateMem(): string;
+/**
+ * Get or create a shared memfs instance for a test suite
+ *
+ * Use this when multiple tests in a suite can share the same in-memory fs.
+ * Call resetSharedMemFs() in beforeEach to clear files between tests.
+ *
+ * @param suiteId - Unique identifier for the test suite
+ * @returns Shared MemFsInstance
+ */
+export declare function getSharedMemFs(suiteId: string): MemFsInstance;
+/**
+ * Reset (clear) a shared memfs instance
+ *
+ * Call this in beforeEach to ensure clean state between tests.
+ *
+ * @param suiteId - Unique identifier for the test suite
+ */
+export declare function resetSharedMemFs(suiteId: string): void;
+/**
+ * Remove a shared memfs instance
+ *
+ * Call this in after() to clean up suite-level resources.
+ *
+ * @param suiteId - Unique identifier for the test suite
+ */
+export declare function removeSharedMemFs(suiteId: string): void;
+/**
+ * Clean up all shared memfs instances
+ *
+ * Useful for global test teardown.
+ */
+export declare function cleanupAllSharedMemFs(): void;
+/**
+ * Read JSONL content from in-memory file and parse to objects
+ *
+ * @param mfs - MemFsInstance from createMemFs()
+ * @param filename - Filename (not full path) to read
+ * @returns Array of parsed objects (skips invalid lines)
+ */
+export declare function readJsonlMem<T = unknown>(mfs: MemFsInstance, filename: string): T[];
+/**
+ * Read JSONL content with stats (mirrors readJsonlSyncWithStats)
+ *
+ * @param mfs - MemFsInstance from createMemFs()
+ * @param filename - Filename (not full path) to read
+ * @returns Object with data array and stats
+ */
+export declare function readJsonlMemWithStats<T = unknown>(mfs: MemFsInstance, filename: string): {
+    data: T[];
+    stats: {
+        totalLines: number;
+        skippedLines: number;
+        emptyLines: number;
+    };
+};
+/**
+ * Async generator for streaming JSONL from memfs (mirrors streamJsonl)
+ *
+ * @param mfs - MemFsInstance from createMemFs()
+ * @param filename - Filename (not full path) to read
+ * @yields Parsed objects from each line
+ */
+export declare function streamJsonlMem<T = unknown>(mfs: MemFsInstance, filename: string): AsyncGenerator<T, void, unknown>;
+/**
+ * List files matching a pattern prefix in the memfs directory
+ *
+ * @param mfs - MemFsInstance from createMemFs()
+ * @param prefix - Filename prefix to match (e.g., 'traces-')
+ * @returns Array of matching filenames
+ */
+export declare function listFilesMem(mfs: MemFsInstance, prefix: string): string[];
+/**
+ * List files matching a date range pattern
+ *
+ * @param mfs - MemFsInstance from createMemFs()
+ * @param type - Telemetry type prefix (e.g., 'traces', 'logs')
+ * @param startDate - Optional start date (YYYY-MM-DD)
+ * @param endDate - Optional end date (YYYY-MM-DD)
+ * @returns Array of matching full paths
+ */
+export declare function listFilesInRangeMem(mfs: MemFsInstance, type: string, startDate?: string, endDate?: string): string[];
+//# sourceMappingURL=memfs-utils.d.ts.map

package/dist/test-helpers/memfs-utils.d.ts.map

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