observability-toolkit 1.8.2 → 1.8.5

package/dist/lib/shared-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-schemas.js","sourceRoot":"","sources":["../../src/lib/shared-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IAC/D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;CAC5D,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC;CAChE,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC;CACjE,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;CACjG,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;CACjE,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;CAC5D,CAAC;AAGF;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,GAAG,aAAa;IAChB,GAAG,aAAa;IAChB,GAAG,eAAe;IAClB,GAAG,gBAAgB;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;CACrH,CAAC"}

package/dist/lib/shared-schemas.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for shared Zod schemas
+ */
+export {};
+//# sourceMappingURL=shared-schemas.test.d.ts.map

package/dist/lib/shared-schemas.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-schemas.test.d.ts","sourceRoot":"","sources":["../../src/lib/shared-schemas.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/lib/shared-schemas.test.js

@@ -0,0 +1,106 @@
+/**
+ * Tests for shared Zod schemas
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert';
+import { z } from 'zod';
+import { traceIdSchema, sessionSchema, dateRangeSchema, paginationSchema, backendSchema, } from './shared-schemas.js';
+describe('shared-schemas', () => {
+    describe('traceIdSchema', () => {
+        const schema = z.object(traceIdSchema);
+        it('should accept valid traceId', () => {
+            const result = schema.safeParse({ traceId: 'abc123' });
+            assert.strictEqual(result.success, true);
+        });
+        it('should accept traceId at max length (64)', () => {
+            const result = schema.safeParse({ traceId: 'a'.repeat(64) });
+            assert.strictEqual(result.success, true);
+        });
+        it('should reject traceId exceeding 64 characters', () => {
+            const result = schema.safeParse({ traceId: 'a'.repeat(65) });
+            assert.strictEqual(result.success, false);
+        });
+        it('should accept undefined traceId', () => {
+            const result = schema.safeParse({});
+            assert.strictEqual(result.success, true);
+        });
+    });
+    describe('sessionSchema', () => {
+        const schema = z.object(sessionSchema);
+        it('should accept valid sessionId', () => {
+            const result = schema.safeParse({ sessionId: 'session-123' });
+            assert.strictEqual(result.success, true);
+        });
+        it('should accept sessionId at max length (128)', () => {
+            const result = schema.safeParse({ sessionId: 'a'.repeat(128) });
+            assert.strictEqual(result.success, true);
+        });
+        it('should reject sessionId exceeding 128 characters', () => {
+            const result = schema.safeParse({ sessionId: 'a'.repeat(129) });
+            assert.strictEqual(result.success, false);
+        });
+        it('should accept undefined sessionId', () => {
+            const result = schema.safeParse({});
+            assert.strictEqual(result.success, true);
+        });
+    });
+    describe('dateRangeSchema', () => {
+        const schema = z.object(dateRangeSchema);
+        it('should accept valid date range', () => {
+            const result = schema.safeParse({
+                startDate: '2026-01-01',
+                endDate: '2026-01-31',
+            });
+            assert.strictEqual(result.success, true);
+        });
+        it('should accept partial date range', () => {
+            const result = schema.safeParse({ startDate: '2026-01-01' });
+            assert.strictEqual(result.success, true);
+        });
+        it('should accept empty object', () => {
+            const result = schema.safeParse({});
+            assert.strictEqual(result.success, true);
+        });
+    });
+    describe('paginationSchema', () => {
+        const schema = z.object(paginationSchema);
+        it('should default limit to 50', () => {
+            const result = schema.safeParse({});
+            assert.strictEqual(result.success, true);
+            if (result.success) {
+                assert.strictEqual(result.data.limit, 50);
+            }
+        });
+        it('should accept valid limit', () => {
+            const result = schema.safeParse({ limit: 100 });
+            assert.strictEqual(result.success, true);
+        });
+        it('should reject limit exceeding 1000', () => {
+            const result = schema.safeParse({ limit: 1001 });
+            assert.strictEqual(result.success, false);
+        });
+    });
+    describe('backendSchema', () => {
+        const schema = z.object(backendSchema);
+        it('should default backend to auto', () => {
+            const result = schema.safeParse({});
+            assert.strictEqual(result.success, true);
+            if (result.success) {
+                assert.strictEqual(result.data.backend, 'auto');
+            }
+        });
+        it('should accept local backend', () => {
+            const result = schema.safeParse({ backend: 'local' });
+            assert.strictEqual(result.success, true);
+        });
+        it('should accept signoz backend', () => {
+            const result = schema.safeParse({ backend: 'signoz' });
+            assert.strictEqual(result.success, true);
+        });
+        it('should reject invalid backend', () => {
+            const result = schema.safeParse({ backend: 'invalid' });
+            assert.strictEqual(result.success, false);
+        });
+    });
+});
+//# sourceMappingURL=shared-schemas.test.js.map

package/dist/lib/shared-schemas.test.js.map

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

package/dist/lib/toon-encoder.d.ts

@@ -0,0 +1,26 @@
+/**
+ * TOON (Token-Oriented Object Notation) encoding utilities
+ * Provides 40-60% token reduction for uniform array responses
+ */
+export type ResponseFormat = 'json' | 'toon';
+/** Maximum elements to encode in toToon (prevents process freezing on large arrays) */
+export declare const MAX_TOON_ELEMENTS = 10000;
+/**
+ * Encode data to TOON format
+ * @param data - Data to encode (typically an array of objects)
+ * @param maxElements - Maximum elements to encode (default: 10000)
+ * @returns TOON-encoded string
+ * @throws Error if data exceeds maxElements (prevents process freezing)
+ *
+ * Security: Logs encoding failures for debugging instead of silently falling back
+ */
+export declare function toToon<T>(data: T[], maxElements?: number): string;
+/**
+ * Check if TOON format is beneficial for the given data
+ * TOON works best with uniform arrays of objects
+ * @param data - Data to check
+ * @param maxElements - Maximum elements to consider (default: MAX_TOON_ELEMENTS)
+ * @returns true if TOON would be beneficial
+ */
+export declare function isToonBeneficial(data: unknown[], maxElements?: number): boolean;
+//# sourceMappingURL=toon-encoder.d.ts.map

package/dist/lib/toon-encoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toon-encoder.d.ts","sourceRoot":"","sources":["../../src/lib/toon-encoder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,CAAC;AAE7C,uFAAuF;AACvF,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AAEvC;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,WAAW,GAAE,MAA0B,GAAG,MAAM,CAkBpF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,GAAE,MAA0B,GAAG,OAAO,CAkBlG"}

package/dist/lib/toon-encoder.js

@@ -0,0 +1,61 @@
+/**
+ * TOON (Token-Oriented Object Notation) encoding utilities
+ * Provides 40-60% token reduction for uniform array responses
+ */
+import { encode as toonEncode } from '@toon-format/toon';
+/** Maximum elements to encode in toToon (prevents process freezing on large arrays) */
+export const MAX_TOON_ELEMENTS = 10000;
+/**
+ * Encode data to TOON format
+ * @param data - Data to encode (typically an array of objects)
+ * @param maxElements - Maximum elements to encode (default: 10000)
+ * @returns TOON-encoded string
+ * @throws Error if data exceeds maxElements (prevents process freezing)
+ *
+ * Security: Logs encoding failures for debugging instead of silently falling back
+ */
+export function toToon(data, maxElements = MAX_TOON_ELEMENTS) {
+    if (Array.isArray(data) && data.length > 0) {
+        // M4: Prevent process freezing on million-element arrays
+        if (data.length > maxElements) {
+            throw new Error(`TOON encoding limit exceeded: ${data.length} elements > ${maxElements} max`);
+        }
+        try {
+            return toonEncode(data);
+        }
+        catch (error) {
+            // Log warning for debugging - silent fallback makes issues hard to diagnose
+            console.warn('[TOON] Encoding failed, falling back to JSON:', error instanceof Error ? error.message : String(error));
+            return JSON.stringify(data);
+        }
+    }
+    return JSON.stringify(data);
+}
+/**
+ * Check if TOON format is beneficial for the given data
+ * TOON works best with uniform arrays of objects
+ * @param data - Data to check
+ * @param maxElements - Maximum elements to consider (default: MAX_TOON_ELEMENTS)
+ * @returns true if TOON would be beneficial
+ */
+export function isToonBeneficial(data, maxElements = MAX_TOON_ELEMENTS) {
+    // M4: Early exit for oversized arrays to avoid expensive key comparisons
+    if (!Array.isArray(data) || data.length < 2 || data.length > maxElements)
+        return false;
+    // Check if all items are objects with same keys
+    const firstItem = data[0];
+    if (typeof firstItem !== 'object' || firstItem === null)
+        return false;
+    // M8: Cache first keys string to avoid repeated Object.keys() calls
+    const firstKeys = Object.keys(firstItem).sort().join(',');
+    // Use for loop with early exit instead of .every() for better performance
+    for (let i = 1; i < data.length; i++) {
+        const item = data[i];
+        if (typeof item !== 'object' || item === null)
+            return false;
+        if (Object.keys(item).sort().join(',') !== firstKeys)
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=toon-encoder.js.map

package/dist/lib/toon-encoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toon-encoder.js","sourceRoot":"","sources":["../../src/lib/toon-encoder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIzD,uFAAuF;AACvF,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,CAAC;AAEvC;;;;;;;;GAQG;AACH,MAAM,UAAU,MAAM,CAAI,IAAS,EAAE,cAAsB,iBAAiB;IAC1E,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3C,yDAAyD;QACzD,IAAI,IAAI,CAAC,MAAM,GAAG,WAAW,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,iCAAiC,IAAI,CAAC,MAAM,eAAe,WAAW,MAAM,CAAC,CAAC;QAChG,CAAC;QACD,IAAI,CAAC;YACH,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,4EAA4E;YAC5E,OAAO,CAAC,IAAI,CACV,+CAA+C,EAC/C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;YACF,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAe,EAAE,cAAsB,iBAAiB;IACvF,yEAAyE;IACzE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,WAAW;QAAE,OAAO,KAAK,CAAC;IAEvF,gDAAgD;IAChD,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1B,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAEtE,oEAAoE;IACpE,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAE1D,0EAA0E;IAC1E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAC5D,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;IACrE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/lib/toon-encoder.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for TOON encoder utilities
+ */
+export {};
+//# sourceMappingURL=toon-encoder.test.d.ts.map

package/dist/lib/toon-encoder.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toon-encoder.test.d.ts","sourceRoot":"","sources":["../../src/lib/toon-encoder.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/lib/toon-encoder.test.js

@@ -0,0 +1,85 @@
+/**
+ * Tests for TOON encoder utilities
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert';
+import { toToon, isToonBeneficial, MAX_TOON_ELEMENTS } from './toon-encoder.js';
+describe('toToon', () => {
+    it('should encode array of objects', () => {
+        const data = [
+            { name: 'Alice', age: 30 },
+            { name: 'Bob', age: 25 },
+        ];
+        const result = toToon(data);
+        // TOON format should be different from JSON
+        assert.ok(typeof result === 'string');
+    });
+    it('should throw for arrays exceeding MAX_TOON_ELEMENTS', () => {
+        const data = new Array(MAX_TOON_ELEMENTS + 1).fill({ id: 1 });
+        assert.throws(() => toToon(data), /TOON encoding limit exceeded/);
+    });
+    it('should allow arrays at exactly MAX_TOON_ELEMENTS', () => {
+        const data = new Array(MAX_TOON_ELEMENTS).fill({ id: 1 });
+        // Should not throw
+        const result = toToon(data);
+        assert.ok(typeof result === 'string');
+    });
+    it('should fall back to JSON for empty arrays', () => {
+        const result = toToon([]);
+        assert.strictEqual(result, '[]');
+    });
+});
+describe('isToonBeneficial', () => {
+    it('should return false for arrays with less than 2 items', () => {
+        assert.strictEqual(isToonBeneficial([]), false);
+        assert.strictEqual(isToonBeneficial([{ a: 1 }]), false);
+    });
+    it('should return true for uniform arrays of objects', () => {
+        const data = [
+            { name: 'Alice', age: 30 },
+            { name: 'Bob', age: 25 },
+        ];
+        assert.strictEqual(isToonBeneficial(data), true);
+    });
+    it('should return false for non-uniform arrays', () => {
+        const data = [
+            { name: 'Alice', age: 30 },
+            { name: 'Bob' }, // missing 'age'
+        ];
+        assert.strictEqual(isToonBeneficial(data), false);
+    });
+    it('should return false for arrays with non-objects', () => {
+        assert.strictEqual(isToonBeneficial([1, 2, 3]), false);
+        assert.strictEqual(isToonBeneficial(['a', 'b']), false);
+    });
+    describe('M4: early exit for oversized arrays', () => {
+        it('should return false for arrays exceeding maxElements', () => {
+            const data = new Array(MAX_TOON_ELEMENTS + 1).fill({ id: 1, name: 'test' });
+            assert.strictEqual(isToonBeneficial(data), false);
+        });
+        it('should accept custom maxElements parameter', () => {
+            const data = [
+                { id: 1, name: 'test' },
+                { id: 2, name: 'test' },
+                { id: 3, name: 'test' },
+            ];
+            // Should return false when maxElements is 2
+            assert.strictEqual(isToonBeneficial(data, 2), false);
+            // Should return true when maxElements is 3 or more
+            assert.strictEqual(isToonBeneficial(data, 3), true);
+        });
+        it('should not perform expensive key comparisons on oversized arrays', () => {
+            // Create a large array where key comparison would be slow
+            const data = new Array(MAX_TOON_ELEMENTS + 100).fill(null).map((_, i) => ({
+                [`key_${i}`]: i, // Each object has a unique key - would fail uniformity check
+            }));
+            const start = performance.now();
+            const result = isToonBeneficial(data);
+            const elapsed = performance.now() - start;
+            assert.strictEqual(result, false);
+            // Should return almost instantly (< 10ms) due to early exit
+            assert.ok(elapsed < 10, `Should exit early, took ${elapsed.toFixed(2)}ms`);
+        });
+    });
+});
+//# sourceMappingURL=toon-encoder.test.js.map

package/dist/lib/toon-encoder.test.js.map

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

package/dist/server.d.ts

@@ -7,53 +7,5 @@
  *
  * Install: claude mcp add observability-toolkit -- npx -y @alyshia/observability-toolkit
  */
-/**
- * Sliding window counter rate limiter with O(1) operations and bounded memory.
- * Uses fixed-size bucket array to track request counts per time slice.
- *
- * Memory usage: O(bucketCount) - fixed regardless of request volume
- * Time complexity: O(bucketCount) for sum, but bucketCount is constant (60)
- *
- * @exported for testing
- */
-export declare class RateLimiter {
-    private buckets;
-    private bucketTimestamps;
-    private readonly bucketMs;
-    private readonly windowMs;
-    private readonly maxRequests;
-    private readonly bucketCount;
-    constructor(windowMs?: number, maxRequests?: number, bucketCount?: number);
-    /**
-     * Get the bucket index for a given timestamp.
-     * Uses modulo to create circular buffer behavior.
-     */
-    private getBucketIndex;
-    /**
-     * Clear expired buckets and return the current valid count.
-     * A bucket is expired if its timestamp is older than windowMs ago.
-     */
-    private cleanAndCount;
-    /**
-     * Check if a request is allowed and record it if so.
-     * O(bucketCount) time complexity where bucketCount is constant.
-     */
-    isAllowed(): boolean;
-    /**
-     * Get the number of remaining allowed requests in the current window.
-     */
-    getRemainingRequests(): number;
-    /**
-     * Get the current memory footprint (for testing).
-     * Returns the fixed size of internal arrays.
-     */
-    getMemoryFootprint(): {
-        bucketCount: number;
-        arraySize: number;
-    };
-    /**
-     * Reset the rate limiter state (for testing).
-     */
-    reset(): void;
-}
+export { RateLimiter, ServerInitError } from './lib/server-utils.js';
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AA8BH;;;;;;;;GAQG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAW;IAC1B,OAAO,CAAC,gBAAgB,CAAW;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAGnC,QAAQ,GAAE,MAA4B,EACtC,WAAW,GAAE,MAA+B,EAC5C,WAAW,GAAE,MAA+B;IAY9C;;;OAGG;IACH,OAAO,CAAC,cAAc;IAItB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAiBrB;;;OAGG;IACH,SAAS,IAAI,OAAO;IAuBpB;;OAEG;IACH,oBAAoB,IAAI,MAAM;IAM9B;;;OAGG;IACH,kBAAkB,IAAI;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAOhE;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AA8BH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}