@ontologie/mock-server 0.1.0-preview.1

package/README.md

@@ -0,0 +1,74 @@
+# @dataforge/mock-server
+
+In-process mock server for local SDK development. Exposes `createMockServer()` returning a `createFetch()` function compatible with the global `fetch` API.
+
+## Status — V1.0 (post-Phase-5)
+
+| Surface | Status | Notes |
+|---------|--------|-------|
+| Read paths (`ObjectSet.fetchPage`, manifest, types, link-types, graph traverse/neighbors/paths) | ✅ Supported | Returns deterministic fixtures matching staging shapes |
+| Action describe (`GET /api/v1/actions/:key/describe`) | ✅ Supported | Returns stub action descriptor |
+| Calendar / Audit / Forms / Scenarios / Decision-compares (read+write) | ✅ Supported | In-memory state, deterministic round-trips |
+| **V1 REST instance CRUD** (`POST /api/v1/object-types/:apiName/instances`, `PUT/DELETE /api/v1/instances/:id`, `/instances/batch`) | ✅ **Supported (Phase 5)** | In-memory store, version increment on update, soft delete |
+| **ActionBuilder** (`POST /api/v1/actions/:key/dry-run` and `/invoke`) | ✅ **Supported (Phase 5)** | Returns `PlanArtifactV1` + `ActionResult` stubs |
+| Legacy CQRS writes (`POST /api/commands/execute`, `/api/commands/batch`) | ⚠️ Returns 501 `MOCK_LEGACY_CQRS_DEPRECATED` | Defensive guard for legacy callers — current SDK uses REST routes above |
+
+## Usage
+
+```ts
+import { createMockServer } from '@dataforge/mock-server';
+import { createClient } from '@dataforge/sdk-client';
+
+const mock = createMockServer();
+globalThis.fetch = mock.createFetch();
+
+const client = createClient({
+  baseUrl: 'http://mock.dataforge.local',
+  apiKey: 'mock-key',
+  workspaceId: 'mock-ws',
+});
+
+// Reads — fully supported:
+const types = await client.ontology.types.list();
+const result = await client.ontology.Employee.where(e => e.salary.gt(50000)).fetchPage();
+
+// Writes — fully supported (Phase 5):
+const employee = await client.ontology.Employee.create({ name: 'Alice', salary: 60000 });
+const updated = await client.ontology.Employee.update(employee.data.id, { salary: 70000 });
+await client.ontology.Employee.delete(employee.data.id);
+
+// Batch operations:
+const batch = await client.ontology.Employee.batchCreate([
+  { name: 'Bob' },
+  { name: 'Charlie' },
+]);
+
+// Actions:
+const plan = await client.actions.on('Contract').action('approve').target('con-1').dryRun();
+const result2 = await client.actions.on('Contract').action('approve').applyPlan(plan.planId);
+```
+
+## Phase 5 implementation details (closes #1076)
+
+Phase 5 of epic [#1077](https://github.com/growthsystemes/dataforge/issues/1077) wires real handlers for V1 REST routes that the SDK uses post-Phase-4 (PR #1099). Pre-Phase-5 these returned 501. Now :
+
+| Route | Behavior |
+|-------|----------|
+| `POST /api/v1/object-types/:apiName/instances` | Stores in `MockServer.objects` Map, returns `{success, data: {id, object_type_id, data, version: 1, status: 'active', ...}}` |
+| `POST /api/v1/object-types/:apiName/instances/batch` | Iterates `body.updates[]`, dispatches by op `type`, returns `{succeeded, failed, results[]}` |
+| `PUT /api/v1/instances/:id` | Cross-type lookup, version increment, returns updated instance. 404 if not found |
+| `DELETE /api/v1/instances/:id` | Cross-type lookup, removes from store, returns `{success, data: {id, status: 'deleted'}}`. 404 if not found |
+| `POST /api/v1/actions/:key/dry-run` | Returns minimal `PlanArtifactV1` stub with `canApply: true`, signature placeholders |
+| `POST /api/v1/actions/:key/invoke` | Returns `ActionResult` stub with `runId`, `actionKey`, empty `editedRefs` + `blockedSideEffects` |
+
+## Legacy CQRS writes (501 mitigation)
+
+`POST /api/commands/execute` and `/api/commands/batch` now return `MOCK_LEGACY_CQRS_DEPRECATED` 501 with a message explaining that the SDK uses REST routes post-Phase-4. This is a defensive guard for legacy callers. Current SDK code does not hit these paths.
+
+## Cross-references
+
+- Epic : [#1077 Track G-bis](https://github.com/growthsystemes/dataforge/issues/1077)
+- Audit : [`docs/quality/COMMAND-PRIMITIVE-AUDIT-2026-05-01.md`](https://github.com/growthsystemes/dataforge/blob/staging/docs/quality/COMMAND-PRIMITIVE-AUDIT-2026-05-01.md)
+- Phase 4 (root cause fix) : [#1099](https://github.com/growthsystemes/dataforge/pull/1099)
+- Issue : [#1076](https://github.com/growthsystemes/dataforge/issues/1076) — closed by this PR
+- Parity test : [`src/server.parity.test.ts`](src/server.parity.test.ts) — 23 tests covering reads + writes + actions + legacy 501 guard

package/dist/fixtures.d.ts

@@ -0,0 +1,267 @@
+/**
+ * Default test fixtures for the mock server.
+ *
+ * Ontology data mirrors the shared sample-ontology seed (5 types, ~30 props, 8 links).
+ * SOT: sdk/sample-ontology/seed.ts — keep in sync.
+ *
+ * Covers M1-M7 SDK features: ontology objects, dashboard, calendar,
+ * audit, forms, scenarios, and decision-compare.
+ */
+export interface MockObject {
+    $primaryKey: string;
+    $objectType: string;
+    $version: number;
+    [key: string]: unknown;
+}
+export interface MockEdge {
+    sourceKey: string;
+    targetKey: string;
+    linkType: string;
+}
+export declare const defaultFixtures: {
+    objectTypes: {
+        apiName: string;
+        displayName: string;
+        description: string;
+        properties: {
+            apiName: string;
+            displayName: string;
+            dataType: string;
+            required: boolean;
+        }[];
+    }[];
+    linkTypes: ({
+        apiName: string;
+        displayName: string;
+        sourceTypeApiName: string;
+        targetTypeApiName: string;
+        cardinality: "1:N";
+        relationshipType: string;
+        inverseName: string;
+        properties: never[];
+    } | {
+        apiName: string;
+        displayName: string;
+        sourceTypeApiName: string;
+        targetTypeApiName: string;
+        cardinality: "N:1";
+        relationshipType: string;
+        inverseName: string;
+        properties: never[];
+    } | {
+        apiName: string;
+        displayName: string;
+        sourceTypeApiName: string;
+        targetTypeApiName: string;
+        cardinality: "N:N";
+        relationshipType: string;
+        inverseName: string;
+        properties: never[];
+    })[];
+    objects: Map<string, MockObject[]>;
+    edges: MockEdge[];
+    dashboardKpis: {
+        name: string;
+        value: number;
+        category: string;
+    }[];
+    dashboardStats: {
+        totalNodes: number;
+        totalEdges: number;
+        activeWorkflows: number;
+        agentConversations24h: number;
+        kpis: {
+            name: string;
+            value: number;
+            unit: string;
+        }[];
+    };
+    dashboardTimeseries: {
+        data: {
+            timestamp: string;
+            value: number;
+        }[];
+    };
+    calendarEvents: ({
+        id: string;
+        calendarId: string;
+        title: string;
+        startTime: string;
+        endTime: string;
+        allDay: boolean;
+        recurrence: null;
+        createdAt: string;
+    } | {
+        id: string;
+        calendarId: string;
+        title: string;
+        startTime: string;
+        endTime: string;
+        allDay: boolean;
+        recurrence: string;
+        createdAt: string;
+    })[];
+    auditEvents: ({
+        id: string;
+        eventType: string;
+        actor: {
+            type: string;
+            id: string;
+            name: string;
+        };
+        entityType: string;
+        entityId: string;
+        changes: {
+            field: string;
+            from: null;
+            to: string;
+        }[];
+        timestamp: string;
+        workspaceId: string;
+    } | {
+        id: string;
+        eventType: string;
+        actor: {
+            type: string;
+            id: string;
+            name: string;
+        };
+        entityType: string;
+        entityId: string;
+        changes: {
+            field: string;
+            from: string;
+            to: string;
+        }[];
+        timestamp: string;
+        workspaceId: string;
+    })[];
+    forms: ({
+        id: string;
+        name: string;
+        description: string;
+        status: string;
+        fields: ({
+            id: string;
+            type: string;
+            label: string;
+            required: boolean;
+            options?: undefined;
+        } | {
+            id: string;
+            type: string;
+            label: string;
+            required: boolean;
+            options: string[];
+        })[];
+        submitCount: number;
+        createdAt: string;
+        updatedAt: string;
+    } | {
+        id: string;
+        name: string;
+        description: string;
+        status: string;
+        fields: ({
+            id: string;
+            type: string;
+            label: string;
+            required: boolean;
+            validation?: undefined;
+        } | {
+            id: string;
+            type: string;
+            label: string;
+            required: boolean;
+            validation: {
+                min: number;
+                max: number;
+            };
+        })[];
+        submitCount: number;
+        createdAt: string;
+        updatedAt: string;
+    })[];
+    formSubmissions: {
+        id: string;
+        formId: string;
+        data: {
+            'Full Name': string;
+            Email: string;
+            Department: string;
+        };
+        submittedAt: string;
+    }[];
+    scenarios: ({
+        id: string;
+        name: string;
+        description: string;
+        status: string;
+        baseVersion: number;
+        results: {
+            affectedInstances: number;
+            totalDelta: number;
+        };
+        createdBy: string;
+        createdAt: string;
+        updatedAt: string;
+    } | {
+        id: string;
+        name: string;
+        description: string;
+        status: string;
+        baseVersion: number;
+        results: {
+            affectedInstances?: undefined;
+            totalDelta?: undefined;
+        };
+        createdBy: string;
+        createdAt: string;
+        updatedAt: string;
+    })[];
+    decisionCompareEstimate: {
+        estimatedTokens: number;
+        estimatedCost: number;
+        proofLevel: string;
+        estimatedDurationMs: number;
+        dimensions: {
+            name: string;
+            weight: number;
+        }[];
+    };
+    decisionCompareSubmit: {
+        runId: string;
+        status: string;
+        createdAt: string;
+    };
+    decisionCompareReport: {
+        runId: string;
+        version: number;
+        verdict: string;
+        confidence: number;
+        summary: string;
+        dimensions: {
+            name: string;
+            optionA: number;
+            optionB: number;
+            winner: string;
+        }[];
+        sealedAt: string;
+        integrityHash: string;
+    };
+    decisionCompareEvidence: {
+        runId: string;
+        claims: {
+            id: string;
+            text: string;
+            supported: boolean;
+            sources: {
+                type: string;
+                reference: string;
+                confidence: number;
+            }[];
+        }[];
+        integrityHash: string;
+    };
+};
+//# sourceMappingURL=fixtures.d.ts.map

package/dist/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../src/fixtures.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAsJD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2N3B,CAAC"}