observability-toolkit 1.8.2 → 1.8.5

package/dist/test-helpers/race-condition-helpers.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Test helpers for race condition and TOCTOU testing
+ *
+ * Provides utilities for simulating and testing race conditions in file system operations.
+ */
+/**
+ * Options for race condition simulation
+ */
+export interface RaceConditionOptions {
+    /** Delay in milliseconds between operations */
+    delayMs?: number;
+    /** Number of iterations for the race */
+    iterations?: number;
+}
+/**
+ * Create a temporary directory structure for symlink testing
+ */
+export declare function createSymlinkTestDir(baseDir: string, name: string): {
+    symlinkPath: string;
+    targetPath: string;
+    cleanup: () => void;
+};
+/**
+ * Create a circular symlink chain for testing
+ */
+export declare function createCircularSymlinks(baseDir: string, prefix: string): {
+    paths: string[];
+    cleanup: () => void;
+};
+/**
+ * Create a broken symlink (pointing to non-existent target)
+ */
+export declare function createBrokenSymlink(baseDir: string, name: string): {
+    symlinkPath: string;
+    cleanup: () => void;
+};
+/**
+ * Create a symlink chain (symlink -> symlink -> directory)
+ */
+export declare function createSymlinkChain(baseDir: string, prefix: string, depth?: number): {
+    startPath: string;
+    endPath: string;
+    cleanup: () => void;
+};
+/**
+ * Create a symlink pointing outside allowed directories
+ */
+export declare function createEscapeSymlink(baseDir: string, name: string, escapePath?: string): {
+    symlinkPath: string;
+    cleanup: () => void;
+};
+/**
+ * Simulate a symlink swap attack (TOCTOU)
+ * Returns a function that swaps the symlink target when called
+ */
+export declare function createSymlinkSwapper(symlinkPath: string, target1: string, target2: string): {
+    swap: () => void;
+    getCurrentTarget: () => string;
+    cleanup: () => void;
+};
+/**
+ * Create a mock file system operation that can be intercepted
+ */
+export interface MockableFsOperation<T> {
+    original: T;
+    mock: T | null;
+    intercept: (mockFn: T) => void;
+    restore: () => void;
+    call: (...args: unknown[]) => unknown;
+}
+/**
+ * Simulate rapid file system changes for race condition testing
+ */
+export declare function simulateRapidChanges(createFn: () => void, deleteFn: () => void, iterations?: number, delayMs?: number): Promise<void>;
+/**
+ * Create a directory with a specific file for testing
+ */
+export declare function createTestDirectory(baseDir: string, name: string, files?: Array<{
+    name: string;
+    content: string;
+}>): {
+    path: string;
+    cleanup: () => void;
+};
+//# sourceMappingURL=race-condition-helpers.d.ts.map

package/dist/test-helpers/race-condition-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"race-condition-helpers.d.ts","sourceRoot":"","sources":["../../src/test-helpers/race-condition-helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAmClE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CA+B1C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAuB9C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAAU,GAChB;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CA4C7D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAe,GAC1B;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAqB9C;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd;IAAE,IAAI,EAAE,MAAM,IAAI,CAAC;IAAC,gBAAgB,EAAE,MAAM,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAgD3E;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,QAAQ,EAAE,CAAC,CAAC;IACZ,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACf,SAAS,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,CAAC;IAC/B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;CACvC;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,IAAI,EACpB,QAAQ,EAAE,MAAM,IAAI,EACpB,UAAU,GAAE,MAAW,EACvB,OAAO,GAAE,MAAU,GAClB,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GAC/C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAgCvC"}

package/dist/test-helpers/race-condition-helpers.js

@@ -0,0 +1,279 @@
+/**
+ * Test helpers for race condition and TOCTOU testing
+ *
+ * Provides utilities for simulating and testing race conditions in file system operations.
+ */
+import { mkdirSync, rmdirSync, symlinkSync, unlinkSync, writeFileSync, existsSync } from 'fs';
+import { join } from 'path';
+/**
+ * Create a temporary directory structure for symlink testing
+ */
+export function createSymlinkTestDir(baseDir, name) {
+    const targetPath = join(baseDir, `${name}-target`);
+    const symlinkPath = join(baseDir, `${name}-link`);
+    // Create target directory
+    if (!existsSync(targetPath)) {
+        mkdirSync(targetPath, { recursive: true });
+    }
+    // Create symlink
+    if (existsSync(symlinkPath)) {
+        try {
+            unlinkSync(symlinkPath);
+        }
+        catch {
+            // Ignore if already removed
+        }
+    }
+    symlinkSync(targetPath, symlinkPath);
+    return {
+        symlinkPath,
+        targetPath,
+        cleanup: () => {
+            try {
+                unlinkSync(symlinkPath);
+            }
+            catch {
+                // Ignore
+            }
+            try {
+                rmdirSync(targetPath);
+            }
+            catch {
+                // Ignore
+            }
+        },
+    };
+}
+/**
+ * Create a circular symlink chain for testing
+ */
+export function createCircularSymlinks(baseDir, prefix) {
+    const link1 = join(baseDir, `${prefix}-circular-1`);
+    const link2 = join(baseDir, `${prefix}-circular-2`);
+    const link3 = join(baseDir, `${prefix}-circular-3`);
+    // Clean up any existing links
+    for (const p of [link1, link2, link3]) {
+        try {
+            unlinkSync(p);
+        }
+        catch {
+            // Ignore
+        }
+    }
+    // Create circular chain: link1 -> link2 -> link3 -> link1
+    symlinkSync(link2, link1);
+    symlinkSync(link3, link2);
+    symlinkSync(link1, link3);
+    return {
+        paths: [link1, link2, link3],
+        cleanup: () => {
+            for (const p of [link1, link2, link3]) {
+                try {
+                    unlinkSync(p);
+                }
+                catch {
+                    // Ignore
+                }
+            }
+        },
+    };
+}
+/**
+ * Create a broken symlink (pointing to non-existent target)
+ */
+export function createBrokenSymlink(baseDir, name) {
+    const symlinkPath = join(baseDir, `${name}-broken`);
+    const nonExistentTarget = join(baseDir, 'nonexistent-target-' + Date.now());
+    // Clean up any existing link
+    try {
+        unlinkSync(symlinkPath);
+    }
+    catch {
+        // Ignore
+    }
+    symlinkSync(nonExistentTarget, symlinkPath);
+    return {
+        symlinkPath,
+        cleanup: () => {
+            try {
+                unlinkSync(symlinkPath);
+            }
+            catch {
+                // Ignore
+            }
+        },
+    };
+}
+/**
+ * Create a symlink chain (symlink -> symlink -> directory)
+ */
+export function createSymlinkChain(baseDir, prefix, depth = 3) {
+    const paths = [];
+    const endPath = join(baseDir, `${prefix}-chain-target`);
+    // Create target directory
+    if (!existsSync(endPath)) {
+        mkdirSync(endPath, { recursive: true });
+    }
+    paths.push(endPath);
+    // Create symlink chain
+    let currentTarget = endPath;
+    for (let i = depth - 1; i >= 0; i--) {
+        const linkPath = join(baseDir, `${prefix}-chain-${i}`);
+        try {
+            unlinkSync(linkPath);
+        }
+        catch {
+            // Ignore
+        }
+        symlinkSync(currentTarget, linkPath);
+        paths.push(linkPath);
+        currentTarget = linkPath;
+    }
+    const startPath = currentTarget;
+    return {
+        startPath,
+        endPath,
+        cleanup: () => {
+            for (const p of paths) {
+                try {
+                    unlinkSync(p);
+                }
+                catch {
+                    // Ignore symlink errors
+                }
+                try {
+                    rmdirSync(p);
+                }
+                catch {
+                    // Ignore directory errors
+                }
+            }
+        },
+    };
+}
+/**
+ * Create a symlink pointing outside allowed directories
+ */
+export function createEscapeSymlink(baseDir, name, escapePath = '/tmp') {
+    const symlinkPath = join(baseDir, `${name}-escape`);
+    try {
+        unlinkSync(symlinkPath);
+    }
+    catch {
+        // Ignore
+    }
+    symlinkSync(escapePath, symlinkPath);
+    return {
+        symlinkPath,
+        cleanup: () => {
+            try {
+                unlinkSync(symlinkPath);
+            }
+            catch {
+                // Ignore
+            }
+        },
+    };
+}
+/**
+ * Simulate a symlink swap attack (TOCTOU)
+ * Returns a function that swaps the symlink target when called
+ */
+export function createSymlinkSwapper(symlinkPath, target1, target2) {
+    let currentTarget = target1;
+    // Ensure targets exist
+    if (!existsSync(target1)) {
+        mkdirSync(target1, { recursive: true });
+    }
+    if (!existsSync(target2)) {
+        mkdirSync(target2, { recursive: true });
+    }
+    // Create initial symlink
+    try {
+        unlinkSync(symlinkPath);
+    }
+    catch {
+        // Ignore
+    }
+    symlinkSync(target1, symlinkPath);
+    return {
+        swap: () => {
+            currentTarget = currentTarget === target1 ? target2 : target1;
+            try {
+                unlinkSync(symlinkPath);
+            }
+            catch {
+                // Ignore
+            }
+            symlinkSync(currentTarget, symlinkPath);
+        },
+        getCurrentTarget: () => currentTarget,
+        cleanup: () => {
+            try {
+                unlinkSync(symlinkPath);
+            }
+            catch {
+                // Ignore
+            }
+            try {
+                rmdirSync(target1);
+            }
+            catch {
+                // Ignore
+            }
+            try {
+                rmdirSync(target2);
+            }
+            catch {
+                // Ignore
+            }
+        },
+    };
+}
+/**
+ * Simulate rapid file system changes for race condition testing
+ */
+export async function simulateRapidChanges(createFn, deleteFn, iterations = 10, delayMs = 1) {
+    for (let i = 0; i < iterations; i++) {
+        createFn();
+        await new Promise(resolve => setTimeout(resolve, delayMs));
+        deleteFn();
+        await new Promise(resolve => setTimeout(resolve, delayMs));
+    }
+}
+/**
+ * Create a directory with a specific file for testing
+ */
+export function createTestDirectory(baseDir, name, files) {
+    const dirPath = join(baseDir, name);
+    if (!existsSync(dirPath)) {
+        mkdirSync(dirPath, { recursive: true });
+    }
+    if (files) {
+        for (const file of files) {
+            writeFileSync(join(dirPath, file.name), file.content);
+        }
+    }
+    return {
+        path: dirPath,
+        cleanup: () => {
+            if (files) {
+                for (const file of files) {
+                    try {
+                        unlinkSync(join(dirPath, file.name));
+                    }
+                    catch {
+                        // Ignore
+                    }
+                }
+            }
+            try {
+                rmdirSync(dirPath);
+            }
+            catch {
+                // Ignore
+            }
+        },
+    };
+}
+//# sourceMappingURL=race-condition-helpers.js.map

package/dist/test-helpers/race-condition-helpers.js.map

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

package/dist/test-helpers/schema-validators.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Shared test utilities for validating Zod schemas
+ */
+import type { z } from 'zod';
+/**
+ * Generate standard backend selection schema tests
+ * @param schema - Zod schema with backend field
+ * @param schemaName - Name for test descriptions
+ */
+export declare function validateBackendSchema(schema: z.ZodType<{
+    backend?: string;
+}>, schemaName: string): void;
+/**
+ * Generate standard limit parameter validation tests
+ * @param schema - Zod schema with limit field
+ * @param schemaName - Name for test descriptions
+ * @param defaultLimit - Expected default limit value
+ * @param maxLimit - Maximum allowed limit (optional, defaults to 1000)
+ */
+export declare function validateLimitSchema(schema: z.ZodType<{
+    limit?: number;
+}>, schemaName: string, defaultLimit: number, maxLimit?: number): void;
+/**
+ * Generate standard date range validation tests
+ * @param schema - Zod schema with startDate/endDate fields
+ * @param schemaName - Name for test descriptions
+ */
+export declare function validateDateRangeSchema(schema: z.ZodType<{
+    startDate?: string;
+    endDate?: string;
+}>, schemaName: string): void;
+//# sourceMappingURL=schema-validators.d.ts.map

package/dist/test-helpers/schema-validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validators.d.ts","sourceRoot":"","sources":["../../src/test-helpers/schema-validators.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EACvC,UAAU,EAAE,MAAM,GACjB,IAAI,CAuCN;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EACrC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,QAAQ,SAAO,GACd,IAAI,CAwCN;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EAC3D,UAAU,EAAE,MAAM,GACjB,IAAI,CA8BN"}

package/dist/test-helpers/schema-validators.js

@@ -0,0 +1,125 @@
+/**
+ * Shared test utilities for validating Zod schemas
+ */
+import { describe, it } from 'node:test';
+import * as assert from 'node:assert';
+/**
+ * Generate standard backend selection schema tests
+ * @param schema - Zod schema with backend field
+ * @param schemaName - Name for test descriptions
+ */
+export function validateBackendSchema(schema, schemaName) {
+    describe(`${schemaName} backend validation`, () => {
+        it('should validate input with backend=local', () => {
+            const result = schema.safeParse({ backend: 'local' });
+            assert.strictEqual(result.success, true);
+            if (result.success) {
+                assert.strictEqual(result.data.backend, 'local');
+            }
+        });
+        it('should validate input with backend=signoz', () => {
+            const result = schema.safeParse({ backend: 'signoz' });
+            assert.strictEqual(result.success, true);
+            if (result.success) {
+                assert.strictEqual(result.data.backend, 'signoz');
+            }
+        });
+        it('should validate input with backend=auto', () => {
+            const result = schema.safeParse({ backend: 'auto' });
+            assert.strictEqual(result.success, true);
+            if (result.success) {
+                assert.strictEqual(result.data.backend, 'auto');
+            }
+        });
+        it('should default backend to auto when not provided', () => {
+            const result = schema.safeParse({});
+            assert.strictEqual(result.success, true);
+            if (result.success) {
+                assert.strictEqual(result.data.backend, 'auto');
+            }
+        });
+        it('should reject invalid backend values', () => {
+            const result = schema.safeParse({ backend: 'invalid' });
+            assert.strictEqual(result.success, false);
+        });
+    });
+}
+/**
+ * Generate standard limit parameter validation tests
+ * @param schema - Zod schema with limit field
+ * @param schemaName - Name for test descriptions
+ * @param defaultLimit - Expected default limit value
+ * @param maxLimit - Maximum allowed limit (optional, defaults to 1000)
+ */
+export function validateLimitSchema(schema, schemaName, defaultLimit, maxLimit = 1000) {
+    describe(`${schemaName} limit validation`, () => {
+        it(`should use ${defaultLimit} as default limit`, () => {
+            const result = schema.safeParse({});
+            assert.strictEqual(result.success, true);
+            if (result.success) {
+                assert.strictEqual(result.data.limit, defaultLimit);
+            }
+        });
+        it('should accept custom limit value', () => {
+            const customLimit = Math.floor(defaultLimit / 2) || 25;
+            const result = schema.safeParse({ limit: customLimit });
+            assert.strictEqual(result.success, true);
+            if (result.success) {
+                assert.strictEqual(result.data.limit, customLimit);
+            }
+        });
+        it('should accept limit of 1', () => {
+            const result = schema.safeParse({ limit: 1 });
+            assert.strictEqual(result.success, true);
+            if (result.success) {
+                assert.strictEqual(result.data.limit, 1);
+            }
+        });
+        it(`should accept max limit value of ${maxLimit}`, () => {
+            const result = schema.safeParse({ limit: maxLimit });
+            assert.strictEqual(result.success, true);
+            if (result.success) {
+                assert.strictEqual(result.data.limit, maxLimit);
+            }
+        });
+        it('should reject non-numeric limit', () => {
+            const result = schema.safeParse({ limit: 'fifty' });
+            assert.strictEqual(result.success, false);
+        });
+    });
+}
+/**
+ * Generate standard date range validation tests
+ * @param schema - Zod schema with startDate/endDate fields
+ * @param schemaName - Name for test descriptions
+ */
+export function validateDateRangeSchema(schema, schemaName) {
+    describe(`${schemaName} date range validation`, () => {
+        it('should accept startDate only', () => {
+            const result = schema.safeParse({ startDate: '2026-01-01' });
+            assert.strictEqual(result.success, true);
+            if (result.success) {
+                assert.strictEqual(result.data.startDate, '2026-01-01');
+            }
+        });
+        it('should accept endDate only', () => {
+            const result = schema.safeParse({ endDate: '2026-01-31' });
+            assert.strictEqual(result.success, true);
+            if (result.success) {
+                assert.strictEqual(result.data.endDate, '2026-01-31');
+            }
+        });
+        it('should accept both startDate and endDate', () => {
+            const result = schema.safeParse({
+                startDate: '2026-01-01',
+                endDate: '2026-01-31',
+            });
+            assert.strictEqual(result.success, true);
+            if (result.success) {
+                assert.strictEqual(result.data.startDate, '2026-01-01');
+                assert.strictEqual(result.data.endDate, '2026-01-31');
+            }
+        });
+    });
+}
+//# sourceMappingURL=schema-validators.js.map

package/dist/test-helpers/schema-validators.js.map

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