@mmapp/react-compiler 0.1.0-alpha.1

package/src/__tests__/source-envelope.test.ts

@@ -0,0 +1,284 @@
+/**
+ * Source Envelope Tests — validates file manifest and envelope creation.
+ */
+
+import { describe, it, expect } from 'vitest';
+import { detectFileRole } from '../envelope/fs-tree';
+import {
+  createSourceEnvelope,
+  computeEnvelopeId,
+  envelopesEqual,
+  diffEnvelopes,
+} from '../envelope/source-envelope';
+import type { FsTree } from '../envelope/fs-tree';
+import type { IRWorkflowDefinition } from '@mindmatrix/player-core';
+
+// =============================================================================
+// File Role Detection
+// =============================================================================
+
+describe('File Role Detection', () => {
+  it('should detect workflow files', () => {
+    expect(detectFileRole('counter.workflow.tsx')).toBe('view-entry');
+    expect(detectFileRole('chat/message.workflow.ts')).toBe('view-entry');
+  });
+
+  it('should detect model files', () => {
+    expect(detectFileRole('models/channel.ts')).toBe('model');
+    expect(detectFileRole('src/models/message.tsx')).toBe('model');
+  });
+
+  it('should detect server action files', () => {
+    expect(detectFileRole('actions.server.ts')).toBe('server-action');
+    expect(detectFileRole('chat/notify.server.tsx')).toBe('server-action');
+  });
+
+  it('should detect layout files', () => {
+    expect(detectFileRole('app/layout.tsx')).toBe('layout');
+    expect(detectFileRole('app/chat/layout.tsx')).toBe('layout');
+  });
+
+  it('should detect page files', () => {
+    expect(detectFileRole('app/page.tsx')).toBe('page');
+    expect(detectFileRole('app/chat/page.tsx')).toBe('page');
+  });
+
+  it('should detect config files', () => {
+    expect(detectFileRole('mm.config.ts')).toBe('config');
+    expect(detectFileRole('blueprint.config.ts')).toBe('config');
+  });
+
+  it('should detect test files', () => {
+    expect(detectFileRole('counter.test.ts')).toBe('test');
+    expect(detectFileRole('__tests__/foo.ts')).toBe('test');
+    expect(detectFileRole('counter.spec.tsx')).toBe('test');
+  });
+
+  it('should detect component files', () => {
+    expect(detectFileRole('components/Button.tsx')).toBe('component');
+    expect(detectFileRole('Header.jsx')).toBe('component');
+  });
+
+  it('should detect asset files', () => {
+    expect(detectFileRole('logo.png')).toBe('asset');
+    expect(detectFileRole('styles.css')).toBe('asset');
+    expect(detectFileRole('font.woff2')).toBe('asset');
+  });
+
+  it('should return unknown for unrecognized files', () => {
+    expect(detectFileRole('readme.md')).toBe('unknown');
+    expect(detectFileRole('data.json')).toBe('unknown');
+  });
+});
+
+// =============================================================================
+// Source Envelope
+// =============================================================================
+
+function createMockDefinition(slug: string, version: string): IRWorkflowDefinition {
+  return {
+    slug,
+    name: slug,
+    version,
+    category: 'workflow',
+    fields: [{ name: 'status', type: 'text', default_value: '' }],
+    states: [{ name: 'draft', type: 'START', on_enter: [], during: [], on_exit: [] }],
+    transitions: [{ name: 'submit', from: 'draft', to: 'active', actions: [], conditions: [] }],
+    roles: [],
+    tags: [],
+  };
+}
+
+function createMockFsTree(): FsTree {
+  return {
+    version: 1,
+    root: '/project',
+    generatedAt: new Date().toISOString(),
+    entries: [
+      { path: 'counter.workflow.tsx', role: 'view-entry', hash: 'abc123', size: 1000, mtime: new Date().toISOString() },
+      { path: 'models/channel.ts', role: 'model', hash: 'def456', size: 2000, mtime: new Date().toISOString() },
+    ],
+    summary: {
+      totalFiles: 2,
+      byRole: { 'view-entry': 1, model: 1 } as any,
+      totalSize: 3000,
+    },
+  };
+}
+
+describe('Source Envelope', () => {
+  it('should create an envelope', () => {
+    const definitions = [createMockDefinition('counter', '1.0.0')];
+    const fsTree = createMockFsTree();
+
+    const envelope = createSourceEnvelope({
+      blueprintSlug: 'mm-chat',
+      blueprintVersion: '1.0.0',
+      definitions,
+      fsTree,
+    });
+
+    expect(envelope.version).toBe(1);
+    expect(envelope.blueprintSlug).toBe('mm-chat');
+    expect(envelope.blueprintVersion).toBe('1.0.0');
+    expect(envelope.envelopeId).toBeDefined();
+    expect(envelope.envelopeId.length).toBe(32);
+    expect(envelope.definitions).toHaveLength(1);
+    expect(envelope.fsTree.entries).toHaveLength(2);
+  });
+
+  it('should compute correct metadata', () => {
+    const definitions = [
+      createMockDefinition('counter', '1.0.0'),
+      createMockDefinition('chat', '1.0.0'),
+    ];
+    const fsTree = createMockFsTree();
+
+    const envelope = createSourceEnvelope({
+      blueprintSlug: 'mm-chat',
+      blueprintVersion: '1.0.0',
+      definitions,
+      fsTree,
+    });
+
+    expect(envelope.metadata.definitionCount).toBe(2);
+    expect(envelope.metadata.totalFields).toBe(2);
+    expect(envelope.metadata.totalStates).toBe(2);
+    expect(envelope.metadata.totalTransitions).toBe(2);
+    expect(envelope.metadata.hasErrors).toBe(false);
+  });
+
+  it('should produce deterministic envelope IDs', () => {
+    const definitions = [createMockDefinition('counter', '1.0.0')];
+    const fsTree = createMockFsTree();
+
+    const e1 = createSourceEnvelope({
+      blueprintSlug: 'test',
+      blueprintVersion: '1.0.0',
+      definitions,
+      fsTree,
+    });
+
+    const e2 = createSourceEnvelope({
+      blueprintSlug: 'test',
+      blueprintVersion: '1.0.0',
+      definitions,
+      fsTree,
+    });
+
+    expect(e1.envelopeId).toBe(e2.envelopeId);
+  });
+
+  it('should detect equal envelopes', () => {
+    const definitions = [createMockDefinition('counter', '1.0.0')];
+    const fsTree = createMockFsTree();
+
+    const e1 = createSourceEnvelope({
+      blueprintSlug: 'test',
+      blueprintVersion: '1.0.0',
+      definitions,
+      fsTree,
+    });
+
+    const e2 = createSourceEnvelope({
+      blueprintSlug: 'test',
+      blueprintVersion: '1.0.0',
+      definitions,
+      fsTree,
+    });
+
+    expect(envelopesEqual(e1, e2)).toBe(true);
+  });
+
+  it('should detect different envelopes', () => {
+    const fsTree = createMockFsTree();
+
+    const e1 = createSourceEnvelope({
+      blueprintSlug: 'test',
+      blueprintVersion: '1.0.0',
+      definitions: [createMockDefinition('counter', '1.0.0')],
+      fsTree,
+    });
+
+    const e2 = createSourceEnvelope({
+      blueprintSlug: 'test',
+      blueprintVersion: '1.0.0',
+      definitions: [createMockDefinition('counter', '2.0.0')],
+      fsTree,
+    });
+
+    expect(envelopesEqual(e1, e2)).toBe(false);
+  });
+});
+
+describe('Envelope Diff', () => {
+  it('should detect added definitions', () => {
+    const fsTree = createMockFsTree();
+
+    const before = createSourceEnvelope({
+      blueprintSlug: 'test',
+      blueprintVersion: '1.0.0',
+      definitions: [createMockDefinition('counter', '1.0.0')],
+      fsTree,
+    });
+
+    const after = createSourceEnvelope({
+      blueprintSlug: 'test',
+      blueprintVersion: '1.0.0',
+      definitions: [
+        createMockDefinition('counter', '1.0.0'),
+        createMockDefinition('chat', '1.0.0'),
+      ],
+      fsTree,
+    });
+
+    const diff = diffEnvelopes(before, after);
+    expect(diff.added).toContain('chat');
+    expect(diff.unchanged).toContain('counter');
+  });
+
+  it('should detect removed definitions', () => {
+    const fsTree = createMockFsTree();
+
+    const before = createSourceEnvelope({
+      blueprintSlug: 'test',
+      blueprintVersion: '1.0.0',
+      definitions: [
+        createMockDefinition('counter', '1.0.0'),
+        createMockDefinition('chat', '1.0.0'),
+      ],
+      fsTree,
+    });
+
+    const after = createSourceEnvelope({
+      blueprintSlug: 'test',
+      blueprintVersion: '1.0.0',
+      definitions: [createMockDefinition('counter', '1.0.0')],
+      fsTree,
+    });
+
+    const diff = diffEnvelopes(before, after);
+    expect(diff.removed).toContain('chat');
+  });
+
+  it('should detect modified definitions', () => {
+    const fsTree = createMockFsTree();
+
+    const before = createSourceEnvelope({
+      blueprintSlug: 'test',
+      blueprintVersion: '1.0.0',
+      definitions: [createMockDefinition('counter', '1.0.0')],
+      fsTree,
+    });
+
+    const after = createSourceEnvelope({
+      blueprintSlug: 'test',
+      blueprintVersion: '1.0.0',
+      definitions: [createMockDefinition('counter', '2.0.0')],
+      fsTree,
+    });
+
+    const diff = diffEnvelopes(before, after);
+    expect(diff.modified).toContain('counter');
+  });
+});