npm - @theihtisham/devtools-with-cloud - Versions diffs - 1.0.0 - Mend

@theihtisham/devtools-with-cloud 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (150) hide show

package/.env.example +15 -0
package/LICENSE +21 -0
package/README.md +73 -0
package/docker-compose.yml +23 -0
package/jest.config.js +7 -0
package/next-env.d.ts +5 -0
package/next.config.mjs +22 -0
package/package.json +82 -0
package/postcss.config.js +6 -0
package/prisma/schema.prisma +105 -0
package/prisma/seed.ts +211 -0
package/src/app/(app)/ai/page.tsx +122 -0
package/src/app/(app)/collections/page.tsx +155 -0
package/src/app/(app)/environments/page.tsx +96 -0
package/src/app/(app)/history/page.tsx +107 -0
package/src/app/(app)/import/page.tsx +102 -0
package/src/app/(app)/layout.tsx +60 -0
package/src/app/(app)/settings/page.tsx +79 -0
package/src/app/(app)/workspace/page.tsx +284 -0
package/src/app/api/ai/discover/route.ts +17 -0
package/src/app/api/ai/explain/route.ts +29 -0
package/src/app/api/ai/generate-tests/route.ts +37 -0
package/src/app/api/ai/suggest/route.ts +29 -0
package/src/app/api/collections/[id]/route.ts +66 -0
package/src/app/api/collections/route.ts +48 -0
package/src/app/api/environments/route.ts +40 -0
package/src/app/api/export/openapi/route.ts +17 -0
package/src/app/api/export/postman/route.ts +18 -0
package/src/app/api/import/curl/route.ts +18 -0
package/src/app/api/import/har/route.ts +20 -0
package/src/app/api/import/openapi/route.ts +21 -0
package/src/app/api/import/postman/route.ts +21 -0
package/src/app/api/proxy/route.ts +35 -0
package/src/app/api/requests/[id]/execute/route.ts +85 -0
package/src/app/api/requests/[id]/history/route.ts +23 -0
package/src/app/api/requests/[id]/route.ts +66 -0
package/src/app/api/requests/route.ts +49 -0
package/src/app/api/workspaces/route.ts +38 -0
package/src/app/globals.css +99 -0
package/src/app/layout.tsx +24 -0
package/src/app/page.tsx +182 -0
package/src/components/ai/ai-panel.tsx +65 -0
package/src/components/ai/code-explainer.tsx +51 -0
package/src/components/ai/endpoint-discovery.tsx +62 -0
package/src/components/ai/test-generator.tsx +49 -0
package/src/components/collections/collection-actions.tsx +36 -0
package/src/components/collections/collection-tree.tsx +55 -0
package/src/components/collections/folder-creator.tsx +54 -0
package/src/components/landing/comparison.tsx +43 -0
package/src/components/landing/cta.tsx +16 -0
package/src/components/landing/features.tsx +24 -0
package/src/components/landing/hero.tsx +23 -0
package/src/components/response/body-viewer.tsx +33 -0
package/src/components/response/headers-viewer.tsx +23 -0
package/src/components/response/status-badge.tsx +25 -0
package/src/components/response/test-results.tsx +50 -0
package/src/components/response/timing-chart.tsx +39 -0
package/src/components/ui/badge.tsx +24 -0
package/src/components/ui/button.tsx +32 -0
package/src/components/ui/code-editor.tsx +51 -0
package/src/components/ui/dialog.tsx +56 -0
package/src/components/ui/dropdown.tsx +63 -0
package/src/components/ui/input.tsx +22 -0
package/src/components/ui/key-value-editor.tsx +75 -0
package/src/components/ui/select.tsx +24 -0
package/src/components/ui/tabs.tsx +85 -0
package/src/components/ui/textarea.tsx +22 -0
package/src/components/ui/toast.tsx +54 -0
package/src/components/workspace/request-panel.tsx +38 -0
package/src/components/workspace/response-panel.tsx +81 -0
package/src/components/workspace/sidebar.tsx +52 -0
package/src/components/workspace/split-pane.tsx +49 -0
package/src/components/workspace/tabs/auth-tab.tsx +94 -0
package/src/components/workspace/tabs/body-tab.tsx +41 -0
package/src/components/workspace/tabs/headers-tab.tsx +23 -0
package/src/components/workspace/tabs/params-tab.tsx +23 -0
package/src/components/workspace/tabs/pre-request-tab.tsx +26 -0
package/src/components/workspace/url-bar.tsx +53 -0
package/src/hooks/use-ai.ts +115 -0
package/src/hooks/use-collection.ts +71 -0
package/src/hooks/use-environment.ts +73 -0
package/src/hooks/use-request.ts +111 -0
package/src/lib/ai/endpoint-discovery.ts +158 -0
package/src/lib/ai/explainer.ts +127 -0
package/src/lib/ai/suggester.ts +164 -0
package/src/lib/ai/test-generator.ts +161 -0
package/src/lib/auth/api-key.ts +28 -0
package/src/lib/auth/aws-sig.ts +131 -0
package/src/lib/auth/basic.ts +17 -0
package/src/lib/auth/bearer.ts +15 -0
package/src/lib/auth/oauth2.ts +155 -0
package/src/lib/auth/types.ts +16 -0
package/src/lib/db/client.ts +15 -0
package/src/lib/env/manager.ts +32 -0
package/src/lib/env/resolver.ts +30 -0
package/src/lib/exporters/openapi.ts +193 -0
package/src/lib/exporters/postman.ts +140 -0
package/src/lib/graphql/builder.ts +249 -0
package/src/lib/graphql/formatter.ts +147 -0
package/src/lib/graphql/index.ts +43 -0
package/src/lib/graphql/introspection.ts +175 -0
package/src/lib/graphql/types.ts +99 -0
package/src/lib/graphql/validator.ts +216 -0
package/src/lib/http/client.ts +112 -0
package/src/lib/http/proxy.ts +83 -0
package/src/lib/http/request-builder.ts +214 -0
package/src/lib/http/response-parser.ts +106 -0
package/src/lib/http/timing.ts +63 -0
package/src/lib/importers/curl-parser.ts +346 -0
package/src/lib/importers/har-parser.ts +128 -0
package/src/lib/importers/openapi.ts +324 -0
package/src/lib/importers/postman.ts +312 -0
package/src/lib/test-runner/assertions.ts +163 -0
package/src/lib/test-runner/reporter.ts +90 -0
package/src/lib/test-runner/runner.ts +69 -0
package/src/lib/utils/api-response.ts +85 -0
package/src/lib/utils/cn.ts +6 -0
package/src/lib/utils/content-type.ts +123 -0
package/src/lib/utils/download.ts +53 -0
package/src/lib/utils/errors.ts +92 -0
package/src/lib/utils/format.ts +142 -0
package/src/lib/utils/syntax-highlight.ts +108 -0
package/src/lib/utils/validation.ts +231 -0
package/src/lib/websocket/client.ts +182 -0
package/src/lib/websocket/frames.ts +96 -0
package/src/lib/websocket/history.ts +121 -0
package/src/lib/websocket/index.ts +25 -0
package/src/lib/websocket/types.ts +57 -0
package/src/types/ai.ts +28 -0
package/src/types/collection.ts +24 -0
package/src/types/environment.ts +16 -0
package/src/types/request.ts +54 -0
package/src/types/response.ts +37 -0
package/tailwind.config.ts +82 -0
package/tests/lib/env/resolver.test.ts +108 -0
package/tests/lib/graphql/builder.test.ts +349 -0
package/tests/lib/graphql/formatter.test.ts +99 -0
package/tests/lib/http/request-builder.test.ts +160 -0
package/tests/lib/http/response-parser.test.ts +150 -0
package/tests/lib/http/timing.test.ts +188 -0
package/tests/lib/importers/curl-parser.test.ts +245 -0
package/tests/lib/test-runner/assertions.test.ts +342 -0
package/tests/lib/utils/cn.test.ts +46 -0
package/tests/lib/utils/content-type.test.ts +175 -0
package/tests/lib/utils/format.test.ts +188 -0
package/tests/lib/utils/validation.test.ts +237 -0
package/tests/lib/websocket/history.test.ts +186 -0
package/tsconfig.json +29 -0
package/tsconfig.tsbuildinfo +1 -0
package/vitest.config.ts +21 -0

package/tests/lib/utils/format.test.ts ADDED Viewed

@@ -0,0 +1,188 @@
+import { describe, it, expect } from 'vitest';
+import {
+  formatJson,
+  minifyJson,
+  validateJson,
+  formatXml,
+  formatHtml,
+  formatBytes,
+  formatDuration,
+} from '@/lib/utils/format';
+describe('formatJson', () => {
+  it('should format valid JSON with default indent of 2', () => {
+    expect(formatJson('{"a":1}')).toBe('{\n  "a": 1\n}');
+  });
+  it('should format with custom indent', () => {
+    expect(formatJson('{"a":1}', 4)).toBe('{\n    "a": 1\n}');
+  });
+  it('should return original string for invalid JSON', () => {
+    expect(formatJson('not json')).toBe('not json');
+  });
+  it('should format nested objects', () => {
+    const input = '{"a":{"b":2}}';
+    const result = formatJson(input);
+    expect(result).toContain('"a"');
+    expect(result).toContain('"b"');
+    expect(result).toContain('2');
+  });
+  it('should format arrays', () => {
+    expect(formatJson('[1,2,3]')).toBe('[\n  1,\n  2,\n  3\n]');
+  });
+});
+describe('minifyJson', () => {
+  it('should minify formatted JSON', () => {
+    expect(minifyJson('{\n  "a": 1\n}')).toBe('{"a":1}');
+  });
+  it('should return original string for invalid JSON', () => {
+    expect(minifyJson('{invalid}')).toBe('{invalid}');
+  });
+});
+describe('validateJson', () => {
+  it('should return valid:true with parsed data for valid JSON', () => {
+    const result = validateJson('{"key":"value"}');
+    expect(result).toEqual({ valid: true, data: { key: 'value' } });
+  });
+  it('should return valid:false with error message for invalid JSON', () => {
+    const result = validateJson('not json');
+    expect(result.valid).toBe(false);
+    if (!result.valid) {
+      expect(result.error).toBeTruthy();
+    }
+  });
+  it('should parse arrays', () => {
+    const result = validateJson('[1,2,3]');
+    expect(result).toEqual({ valid: true, data: [1, 2, 3] });
+  });
+  it('should parse primitives', () => {
+    expect(validateJson('42')).toEqual({ valid: true, data: 42 });
+    expect(validateJson('"hello"')).toEqual({ valid: true, data: 'hello' });
+    expect(validateJson('true')).toEqual({ valid: true, data: true });
+    expect(validateJson('null')).toEqual({ valid: true, data: null });
+  });
+});
+describe('formatXml', () => {
+  it('should format XML with proper indentation', () => {
+    const input = '<root><child>text</child></root>';
+    const result = formatXml(input);
+    expect(result).toContain('\n');
+    expect(result).toContain('  <child>');
+  });
+  it('should handle self-closing tags', () => {
+    const input = '<root><br/></root>';
+    const result = formatXml(input);
+    expect(result).toContain('<br/>');
+  });
+  it('should handle processing instructions', () => {
+    const input = '<?xml version="1.0"?><root><child/></root>';
+    const result = formatXml(input);
+    expect(result).toContain('<?xml');
+  });
+  it('should handle CDATA sections', () => {
+    const input = '<root><![CDATA[some text]]></root>';
+    const result = formatXml(input);
+    expect(result).toContain('CDATA');
+  });
+  it('should respect custom indent size', () => {
+    const input = '<root><child/></root>';
+    const result4 = formatXml(input, 4);
+    expect(result4).toContain('    ');
+  });
+});
+describe('formatHtml', () => {
+  it('should format HTML with proper indentation', () => {
+    const input = '<html><body><p>text</p></body></html>';
+    const result = formatHtml(input);
+    expect(result).toContain('\n');
+  });
+  it('should not increase indent for self-closing tags like <br>', () => {
+    const input = '<div><br><p>text</p></div>';
+    const result = formatHtml(input);
+    const lines = result.split('\n');
+    // br should be at the same level as the following p
+    const brLine = lines.find((l) => l.includes('<br>'));
+    const pLine = lines.find((l) => l.includes('<p>'));
+    expect(brLine).toBeDefined();
+    expect(pLine).toBeDefined();
+    // Both should be at the same indentation level (default indent = 2 spaces)
+    expect(brLine!.startsWith('  ')).toBe(true);
+    expect(pLine!.startsWith('  ')).toBe(true);
+  });
+  it('should handle self-closing syntax />', () => {
+    const input = '<div><img src="x.png"/></div>';
+    const result = formatHtml(input);
+    expect(result).toContain('<img');
+  });
+  it('should respect custom indent size', () => {
+    const input = '<div><p>hello</p></div>';
+    const result4 = formatHtml(input, 4);
+    expect(result4).toContain('    <p>');
+  });
+});
+describe('formatBytes', () => {
+  it('should format 0 bytes', () => {
+    expect(formatBytes(0)).toBe('0 B');
+  });
+  it('should format bytes', () => {
+    expect(formatBytes(100)).toBe('100 B');
+  });
+  it('should format kilobytes', () => {
+    expect(formatBytes(1024)).toBe('1.0 KB');
+  });
+  it('should format megabytes', () => {
+    expect(formatBytes(1024 * 1024)).toBe('1.0 MB');
+  });
+  it('should format gigabytes', () => {
+    expect(formatBytes(1024 * 1024 * 1024)).toBe('1.0 GB');
+  });
+  it('should format fractional kilobytes', () => {
+    expect(formatBytes(1536)).toBe('1.5 KB');
+  });
+});
+describe('formatDuration', () => {
+  it('should format microseconds', () => {
+    expect(formatDuration(0.5)).toBe('500us');
+  });
+  it('should format milliseconds', () => {
+    expect(formatDuration(150)).toBe('150ms');
+  });
+  it('should format seconds', () => {
+    expect(formatDuration(1500)).toBe('1.50s');
+  });
+  it('should format very small durations', () => {
+    expect(formatDuration(0.001)).toBe('1us');
+  });
+  it('should format exactly 1ms', () => {
+    expect(formatDuration(1)).toBe('1ms');
+  });
+});

package/tests/lib/utils/validation.test.ts ADDED Viewed

@@ -0,0 +1,237 @@
+import { describe, it, expect } from 'vitest';
+import {
+  HttpMethodSchema,
+  KeyValueSchema,
+  BodyTypeSchema,
+  AuthConfigSchema,
+  CreateRequestSchema,
+  UpdateRequestSchema,
+  CreateCollectionSchema,
+  CreateWorkspaceSchema,
+  ExecuteRequestSchema,
+  EnvironmentVariableSchema,
+  ImportCurlSchema,
+} from '@/lib/utils/validation';
+describe('HttpMethodSchema', () => {
+  it('should accept valid HTTP methods', () => {
+    const methods = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS', 'TRACE', 'CONNECT'];
+    for (const method of methods) {
+      expect(HttpMethodSchema.parse(method)).toBe(method);
+    }
+  });
+  it('should reject invalid HTTP methods', () => {
+    expect(() => HttpMethodSchema.parse('INVALID')).toThrow();
+  });
+});
+describe('KeyValueSchema', () => {
+  it('should accept valid key-value pair', () => {
+    const result = KeyValueSchema.parse({ key: 'Content-Type', value: 'application/json' });
+    expect(result).toEqual({ key: 'Content-Type', value: 'application/json', enabled: true });
+  });
+  it('should default enabled to true', () => {
+    const result = KeyValueSchema.parse({ key: 'foo', value: 'bar' });
+    expect(result.enabled).toBe(true);
+  });
+  it('should reject empty key', () => {
+    expect(() => KeyValueSchema.parse({ key: '', value: 'bar' })).toThrow();
+  });
+  it('should accept optional description', () => {
+    const result = KeyValueSchema.parse({ key: 'foo', value: 'bar', description: 'test' });
+    expect(result.description).toBe('test');
+  });
+});
+describe('BodyTypeSchema', () => {
+  it('should accept valid body types', () => {
+    const types = ['none', 'json', 'form', 'urlencoded', 'raw', 'graphql', 'binary'];
+    for (const t of types) {
+      expect(BodyTypeSchema.parse(t)).toBe(t);
+    }
+  });
+  it('should reject invalid body types', () => {
+    expect(() => BodyTypeSchema.parse('invalid')).toThrow();
+  });
+});
+describe('AuthConfigSchema', () => {
+  it('should accept none auth', () => {
+    const result = AuthConfigSchema.parse({ type: 'none' });
+    expect(result.type).toBe('none');
+  });
+  it('should accept basic auth', () => {
+    const result = AuthConfigSchema.parse({ type: 'basic', username: 'user', password: 'pass' });
+    expect(result.type).toBe('basic');
+    if (result.type === 'basic') {
+      expect(result.username).toBe('user');
+      expect(result.password).toBe('pass');
+    }
+  });
+  it('should accept bearer auth', () => {
+    const result = AuthConfigSchema.parse({ type: 'bearer', token: 'my-token' });
+    expect(result.type).toBe('bearer');
+    if (result.type === 'bearer') {
+      expect(result.token).toBe('my-token');
+      expect(result.prefix).toBe('Bearer');
+    }
+  });
+  it('should accept apikey auth', () => {
+    const result = AuthConfigSchema.parse({
+      type: 'apikey',
+      key: 'X-API-Key',
+      value: 'secret',
+      addTo: 'header',
+    });
+    expect(result.type).toBe('apikey');
+  });
+  it('should reject invalid auth type', () => {
+    expect(() => AuthConfigSchema.parse({ type: 'invalid' })).toThrow();
+  });
+});
+describe('CreateRequestSchema', () => {
+  const validRequest = {
+    name: 'Test Request',
+    collectionId: 'col-1',
+    url: 'https://api.example.com',
+  };
+  it('should accept valid request with defaults', () => {
+    const result = CreateRequestSchema.parse(validRequest);
+    expect(result.method).toBe('GET');
+    expect(result.headers).toEqual([]);
+    expect(result.params).toEqual([]);
+    expect(result.bodyType).toBe('none');
+    expect(result.sortOrder).toBe(0);
+  });
+  it('should reject request without name', () => {
+    expect(() => CreateRequestSchema.parse({ collectionId: 'col-1', url: 'https://example.com' })).toThrow();
+  });
+  it('should reject request with empty name', () => {
+    expect(() => CreateRequestSchema.parse({ name: '', collectionId: 'col-1', url: 'https://example.com' })).toThrow();
+  });
+  it('should reject request without URL', () => {
+    expect(() => CreateRequestSchema.parse({ name: 'Test', collectionId: 'col-1' })).toThrow();
+  });
+  it('should reject request name over 200 chars', () => {
+    expect(() => CreateRequestSchema.parse({
+      name: 'x'.repeat(201),
+      collectionId: 'col-1',
+      url: 'https://example.com',
+    })).toThrow();
+  });
+});
+describe('UpdateRequestSchema', () => {
+  it('should accept partial updates with id', () => {
+    const result = UpdateRequestSchema.parse({ id: 'req-1', name: 'Updated' });
+    expect(result.id).toBe('req-1');
+    expect(result.name).toBe('Updated');
+  });
+  it('should require id', () => {
+    expect(() => UpdateRequestSchema.parse({ name: 'Updated' })).toThrow();
+  });
+});
+describe('CreateCollectionSchema', () => {
+  it('should accept valid collection', () => {
+    const result = CreateCollectionSchema.parse({
+      name: 'My Collection',
+      workspaceId: 'ws-1',
+    });
+    expect(result.name).toBe('My Collection');
+    expect(result.variables).toEqual({});
+    expect(result.sortOrder).toBe(0);
+  });
+  it('should reject collection without workspaceId', () => {
+    expect(() => CreateCollectionSchema.parse({ name: 'Test' })).toThrow();
+  });
+});
+describe('CreateWorkspaceSchema', () => {
+  it('should accept valid workspace', () => {
+    const result = CreateWorkspaceSchema.parse({ name: 'Workspace 1' });
+    expect(result.name).toBe('Workspace 1');
+    expect(result.userId).toBe('demo-user');
+  });
+});
+describe('ExecuteRequestSchema', () => {
+  it('should accept valid execute request', () => {
+    const result = ExecuteRequestSchema.parse({
+      method: 'GET',
+      url: 'https://api.example.com',
+    });
+    expect(result.timeout).toBe(30000);
+    expect(result.followRedirects).toBe(true);
+    expect(result.maxRedirects).toBe(5);
+    expect(result.verifySSL).toBe(true);
+  });
+  it('should apply default timeout', () => {
+    const result = ExecuteRequestSchema.parse({
+      method: 'POST',
+      url: 'https://api.example.com',
+    });
+    expect(result.timeout).toBe(30000);
+  });
+  it('should reject timeout over 300000', () => {
+    expect(() => ExecuteRequestSchema.parse({
+      method: 'GET',
+      url: 'https://example.com',
+      timeout: 400000,
+    })).toThrow();
+  });
+  it('should reject timeout of 0', () => {
+    expect(() => ExecuteRequestSchema.parse({
+      method: 'GET',
+      url: 'https://example.com',
+      timeout: 0,
+    })).toThrow();
+  });
+});
+describe('EnvironmentVariableSchema', () => {
+  it('should accept valid environment variable', () => {
+    const result = EnvironmentVariableSchema.parse({ key: 'API_KEY', value: 'secret' });
+    expect(result.type).toBe('string');
+    expect(result.enabled).toBe(true);
+  });
+  it('should accept secret type', () => {
+    const result = EnvironmentVariableSchema.parse({ key: 'TOKEN', value: 'abc', type: 'secret' });
+    expect(result.type).toBe('secret');
+  });
+});
+describe('ImportCurlSchema', () => {
+  it('should accept valid cURL import', () => {
+    const result = ImportCurlSchema.parse({
+      command: 'curl https://example.com',
+      collectionId: 'col-1',
+    });
+    expect(result.command).toBe('curl https://example.com');
+  });
+  it('should reject empty command', () => {
+    expect(() => ImportCurlSchema.parse({ command: '', collectionId: 'col-1' })).toThrow();
+  });
+});

package/tests/lib/websocket/history.test.ts ADDED Viewed

@@ -0,0 +1,186 @@
+import { describe, it, expect } from 'vitest';
+import { MessageHistory } from '@/lib/websocket/history';
+import type { WSMessage } from '@/lib/websocket/types';
+function createMessage(direction: 'sent' | 'received', data: string, ts?: number): WSMessage {
+  return {
+    id: `msg_${Math.random().toString(36).slice(2, 8)}`,
+    direction,
+    data,
+    type: 'text',
+    timestamp: ts ?? Date.now(),
+    size: new TextEncoder().encode(data).length,
+  };
+}
+describe('MessageHistory', () => {
+  it('should add and retrieve messages', () => {
+    const history = new MessageHistory();
+    const msg = createMessage('sent', 'hello');
+    history.add(msg);
+    const all = history.getHistory();
+    expect(all).toHaveLength(1);
+    expect(all[0]?.data).toBe('hello');
+  });
+  it('should track multiple messages in order', () => {
+    const history = new MessageHistory();
+    history.add(createMessage('sent', 'first'));
+    history.add(createMessage('received', 'second'));
+    history.add(createMessage('sent', 'third'));
+    const all = history.getHistory();
+    expect(all).toHaveLength(3);
+    expect(all[0]?.data).toBe('first');
+    expect(all[1]?.data).toBe('second');
+    expect(all[2]?.data).toBe('third');
+  });
+  it('should filter by direction', () => {
+    const history = new MessageHistory();
+    history.add(createMessage('sent', 'out1'));
+    history.add(createMessage('received', 'in1'));
+    history.add(createMessage('sent', 'out2'));
+    history.add(createMessage('received', 'in2'));
+    const sent = history.getByDirection('sent');
+    const received = history.getByDirection('received');
+    expect(sent).toHaveLength(2);
+    expect(received).toHaveLength(2);
+    expect(sent.every((m) => m.direction === 'sent')).toBe(true);
+    expect(received.every((m) => m.direction === 'received')).toBe(true);
+  });
+  it('should search messages by content', () => {
+    const history = new MessageHistory();
+    history.add(createMessage('sent', '{"type":"greeting","msg":"hello"}'));
+    history.add(createMessage('received', '{"type":"response","msg":"world"}'));
+    history.add(createMessage('sent', '{"type":"ping"}'));
+    const results = history.search('greeting');
+    expect(results).toHaveLength(1);
+    expect(results[0]?.data).toContain('greeting');
+  });
+  it('should perform case-insensitive search', () => {
+    const history = new MessageHistory();
+    history.add(createMessage('sent', 'HELLO WORLD'));
+    const results = history.search('hello');
+    expect(results).toHaveLength(1);
+  });
+  it('should filter messages by time range', () => {
+    const history = new MessageHistory();
+    const now = Date.now();
+    history.add(createMessage('sent', 'old', now - 5000));
+    history.add(createMessage('sent', 'mid', now - 2000));
+    history.add(createMessage('sent', 'new', now));
+    const results = history.getByTimeRange(now - 3000, now);
+    expect(results).toHaveLength(2);
+    expect(results[0]?.data).toBe('mid');
+    expect(results[1]?.data).toBe('new');
+  });
+  it('should get recent N messages', () => {
+    const history = new MessageHistory();
+    for (let i = 0; i < 10; i++) {
+      history.add(createMessage('sent', `msg_${i}`));
+    }
+    const recent = history.getRecent(3);
+    expect(recent).toHaveLength(3);
+    expect(recent[0]?.data).toBe('msg_7');
+    expect(recent[2]?.data).toBe('msg_9');
+  });
+  it('should clear all messages', () => {
+    const history = new MessageHistory();
+    history.add(createMessage('sent', 'a'));
+    history.add(createMessage('sent', 'b'));
+    expect(history.count).toBe(2);
+    history.clear();
+    expect(history.count).toBe(0);
+    expect(history.getHistory()).toHaveLength(0);
+  });
+  it('should export as JSON', () => {
+    const history = new MessageHistory();
+    history.add(createMessage('sent', 'test'));
+    const exported = history.export();
+    const parsed = JSON.parse(exported);
+    expect(Array.isArray(parsed)).toBe(true);
+    expect(parsed).toHaveLength(1);
+    expect(parsed[0]?.data).toBe('test');
+  });
+  it('should import from JSON', () => {
+    const history = new MessageHistory();
+    const msg = createMessage('received', 'imported');
+    history.import(JSON.stringify([msg]));
+    expect(history.count).toBe(1);
+    expect(history.getHistory()[0]?.data).toBe('imported');
+  });
+  it('should reject invalid JSON on import', () => {
+    const history = new MessageHistory();
+    expect(() => history.import('not-json')).toThrow('Invalid JSON');
+  });
+  it('should evict oldest messages when exceeding maxSize', () => {
+    const history = new MessageHistory(3);
+    history.add(createMessage('sent', 'first'));
+    history.add(createMessage('sent', 'second'));
+    history.add(createMessage('sent', 'third'));
+    history.add(createMessage('sent', 'fourth'));
+    expect(history.count).toBe(3);
+    const all = history.getHistory();
+    expect(all[0]?.data).toBe('second');
+    expect(all[2]?.data).toBe('fourth');
+  });
+  it('should calculate total bytes', () => {
+    const history = new MessageHistory();
+    history.add(createMessage('sent', 'hello')); // 5 bytes
+    history.add(createMessage('sent', 'world')); // 5 bytes
+    expect(history.totalBytes).toBe(10);
+  });
+  it('should toArray return copies not references', () => {
+    const history = new MessageHistory();
+    history.add(createMessage('sent', 'original'));
+    const arr = history.toArray();
+    arr[0]!.data = 'modified';
+    // Original should be unchanged
+    expect(history.getHistory()[0]?.data).toBe('original');
+  });
+  it('should search by message type', () => {
+    const history = new MessageHistory();
+    const jsonMsg = createMessage('sent', 'json msg');
+    jsonMsg.type = 'json';
+    const textMsg = createMessage('received', 'text msg');
+    textMsg.type = 'text';
+    history.add(jsonMsg);
+    history.add(textMsg);
+    const jsonResults = history.searchByType('json');
+    expect(jsonResults).toHaveLength(1);
+    expect(jsonResults[0]?.type).toBe('json');
+  });
+});

package/tsconfig.json ADDED Viewed

@@ -0,0 +1,29 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [
+      { "name": "next" }
+    ],
+    "paths": {
+      "@/*": ["./src/*"]
+    },
+    "forceConsistentCasingInFileNames": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+    "noPropertyAccessFromIndexSignature": true
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}