@nesso-how/formats 0.1.0-alpha.28 → 0.1.0-alpha.30

package/dist/index.d.ts

@@ -11,6 +11,13 @@ export interface NessoGraphFile {
     display?: Partial<GraphDisplaySettings>;
 }
 export declare function serializeGraph(file: NessoGraphFile): string;
+/**
+ * Parse and structurally validate a graph file. Files are user-editable (and
+ * importable from anywhere), so each element is checked before it can reach
+ * the store: a node without a valid id/position crashes the canvas and would
+ * then be re-persisted. Partial node data (e.g. hand-written files with only
+ * `text`) is normalized with fresh review fields.
+ */
 export declare function deserializeGraph(json: string): NessoGraphFile;
 /** Strip personal FSRS / review history for shareable graph export. Keeps text, elaboration, layout. */
 export declare function nodesForGraphShareExport(nodes: Node<ConceptNodeData>[]): Node<ConceptNodeData>[];

package/dist/index.js

@@ -2,15 +2,53 @@ import { defaultConceptReviewFields } from '@nesso-how/types';
 export function serializeGraph(file) {
     return JSON.stringify(file, null, 2);
 }
+function asRecord(value) {
+    return typeof value === 'object' && value !== null ? value : null;
+}
+/**
+ * Parse and structurally validate a graph file. Files are user-editable (and
+ * importable from anywhere), so each element is checked before it can reach
+ * the store: a node without a valid id/position crashes the canvas and would
+ * then be re-persisted. Partial node data (e.g. hand-written files with only
+ * `text`) is normalized with fresh review fields.
+ */
 export function deserializeGraph(json) {
     const data = JSON.parse(json);
-    if (typeof data !== 'object' ||
-        data === null ||
-        !Array.isArray(data.nodes) ||
-        !Array.isArray(data.edges)) {
+    const root = asRecord(data);
+    if (!root || !Array.isArray(root.nodes) || !Array.isArray(root.edges)) {
         throw new Error('Invalid Nesso graph file: missing nodes or edges array');
     }
-    return data;
+    const review = defaultConceptReviewFields();
+    const nodes = root.nodes.map((value, i) => {
+        const node = asRecord(value);
+        const pos = node ? asRecord(node.position) : null;
+        if (!node ||
+            typeof node.id !== 'string' ||
+            node.id === '' ||
+            !pos ||
+            typeof pos.x !== 'number' ||
+            !Number.isFinite(pos.x) ||
+            typeof pos.y !== 'number' ||
+            !Number.isFinite(pos.y)) {
+            throw new Error(`Invalid Nesso graph file: node ${i} is missing a valid id or position`);
+        }
+        const d = asRecord(node.data) ?? {};
+        return {
+            ...node,
+            data: { ...review, ...d, text: typeof d.text === 'string' ? d.text : '' },
+        };
+    });
+    const edges = root.edges.map((value, i) => {
+        const edge = asRecord(value);
+        if (!edge ||
+            typeof edge.id !== 'string' ||
+            typeof edge.source !== 'string' ||
+            typeof edge.target !== 'string') {
+            throw new Error(`Invalid Nesso graph file: edge ${i} is missing id, source or target`);
+        }
+        return edge;
+    });
+    return { ...root, nodes, edges };
 }
 /** Strip personal FSRS / review history for shareable graph export. Keeps text, elaboration, layout. */
 export function nodesForGraphShareExport(nodes) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nesso-how/formats",
-  "version": "0.1.0-alpha.28",
+  "version": "0.1.0-alpha.30",
   "description": "Nesso graph serialization formats — JSON serialize/deserialize",
   "license": "MIT",
   "repository": {
@@ -22,7 +22,7 @@
     }
   },
   "dependencies": {
-    "@nesso-how/types": "0.1.0-alpha.28"
+    "@nesso-how/types": "0.1.0-alpha.30"
   },
   "peerDependencies": {
     "@xyflow/react": "^12.6.4"