@nesso-how/formats 0.1.0-alpha.19 → 0.1.0-alpha.21

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Omar Desogus
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -1,6 +1,10 @@
 import type { Node, Edge } from '@xyflow/react';
 import type { ConceptNodeData, GraphDisplaySettings } from '@nesso-how/types';
 export interface NessoGraphFile {
+    /** Internal graph id (desktop sync); omitted in manual exports. */
+    id?: string;
+    /** Last save time (Unix ms); desktop sync metadata. */
+    updatedAt?: number;
     name: string;
     nodes: Node<ConceptNodeData>[];
     edges: Edge[];
@@ -8,3 +12,7 @@ export interface NessoGraphFile {
 }
 export declare function serializeGraph(file: NessoGraphFile): string;
 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>[];
+/** Reset review fields on import so shared files never restore someone else's scheduling. */
+export declare function nodesFromGraphShareImport(nodes: Node<ConceptNodeData>[]): Node<ConceptNodeData>[];

package/dist/index.js

@@ -1,3 +1,4 @@
+import { defaultConceptReviewFields } from '@nesso-how/types';
 export function serializeGraph(file) {
     return JSON.stringify(file, null, 2);
 }
@@ -11,3 +12,22 @@ export function deserializeGraph(json) {
     }
     return data;
 }
+/** Strip personal FSRS / review history for shareable graph export. Keeps text, elaboration, layout. */
+export function nodesForGraphShareExport(nodes) {
+    const review = defaultConceptReviewFields();
+    return nodes.map(node => {
+        const { text, elaboration } = node.data ?? { text: '' };
+        return {
+            ...node,
+            data: {
+                text: text ?? '',
+                ...(elaboration ? { elaboration } : {}),
+                ...review,
+            },
+        };
+    });
+}
+/** Reset review fields on import so shared files never restore someone else's scheduling. */
+export function nodesFromGraphShareImport(nodes) {
+    return nodesForGraphShareExport(nodes);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nesso-how/formats",
-  "version": "0.1.0-alpha.19",
+  "version": "0.1.0-alpha.21",
   "description": "Nesso graph serialization formats — JSON serialize/deserialize",
   "license": "MIT",
   "type": "module",
@@ -13,16 +13,15 @@
       "import": "./dist/index.js"
     }
   },
-  "scripts": {
-    "build": "tsc",
-    "prepublishOnly": "pnpm build",
-    "dev": "tsc --watch"
-  },
   "dependencies": {
-    "@nesso-how/types": "workspace:*",
-    "@xyflow/react": "^12.6.4"
+    "@xyflow/react": "^12.6.4",
+    "@nesso-how/types": "0.1.0-alpha.21"
   },
   "devDependencies": {
     "typescript": "~5.8.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
   }
-}
+}

package/src/index.ts

@@ -1,8 +1,13 @@
 // SPDX-License-Identifier: MIT
 import type { Node, Edge } from '@xyflow/react'
 import type { ConceptNodeData, GraphDisplaySettings } from '@nesso-how/types'
+import { defaultConceptReviewFields } from '@nesso-how/types'
 
 export interface NessoGraphFile {
+  /** Internal graph id (desktop sync); omitted in manual exports. */
+  id?: string
+  /** Last save time (Unix ms); desktop sync metadata. */
+  updatedAt?: number
   name: string
   nodes: Node<ConceptNodeData>[]
   edges: Edge[]
@@ -25,3 +30,28 @@ export function deserializeGraph(json: string): NessoGraphFile {
   }
   return data as NessoGraphFile
 }
+
+/** Strip personal FSRS / review history for shareable graph export. Keeps text, elaboration, layout. */
+export function nodesForGraphShareExport(
+  nodes: Node<ConceptNodeData>[],
+): Node<ConceptNodeData>[] {
+  const review = defaultConceptReviewFields()
+  return nodes.map(node => {
+    const { text, elaboration } = node.data ?? { text: '' }
+    return {
+      ...node,
+      data: {
+        text: text ?? '',
+        ...(elaboration ? { elaboration } : {}),
+        ...review,
+      },
+    }
+  })
+}
+
+/** Reset review fields on import so shared files never restore someone else's scheduling. */
+export function nodesFromGraphShareImport(
+  nodes: Node<ConceptNodeData>[],
+): Node<ConceptNodeData>[] {
+  return nodesForGraphShareExport(nodes)
+}