@nast/notion2typst 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Martí Pardo
+
+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/README.md

@@ -0,0 +1,9 @@
+# Notion to Typst
+This package is simply a wrapper over the following packages:
+
+1. notion2nbt
+2. nbt2nast
+3. nast2typst
+4. nast-fetch-images
+
+It uses the other packages to provide a more direct conversion: given a notion pageId and notion token, you get the typst code and the images in the page.

package/dist/index-CJVMSA--.d.ts

@@ -0,0 +1,79 @@
+import { Notion2NBT, NotionBlock } from "@nast/notion2nbt";
+import { nbt2nast } from "@nast/nbt2nast";
+import { nast2typst } from "@nast/nast2typst";
+import { fetchImagesFromBlocks } from "@nast/nast-fetch-images";
+import { DownloadedImage, DownloadedImage as DownloadedImage$1, NASTNode, NASTRoot, NASTRoot as NASTRoot$1, NBTBlock } from "@nast/types";
+
+//#region src/index.d.ts
+
+/**
+ * Image data from the fetchImagesFromBlocks function
+ * @deprecated Use DownloadedImage from @nast/types instead
+ */
+type ImageData = DownloadedImage$1;
+/**
+ * Options for the notion2typst function
+ */
+interface Notion2TypstOptions {
+  /** Notion API token */
+  notionToken: string;
+  /** Notion page ID to convert */
+  pageId: string;
+  /** Whether to fetch images from the page (default: true) */
+  fetchImages?: boolean;
+  /** Whether to preserve block IDs in NAST (default: false) */
+  preserveBlockId?: boolean;
+  /** Whether to enable caching in Notion2NBT (default: false) */
+  enableCache?: boolean;
+}
+/**
+ * Result of the notion2typst conversion
+ */
+interface Notion2TypstResult {
+  /** The generated Typst code */
+  typstCode: string;
+  /** Downloaded images (if fetchImages was true) */
+  images: DownloadedImage$1[];
+  /** Image fetch statistics (if fetchImages was true) */
+  imageStats: {
+    /** Total number of image blocks found */
+    totalImages: number;
+    /** Number of successfully downloaded images */
+    downloaded: number;
+    /** Number of expired images */
+    expired: number;
+    /** Number of external images */
+    external: number;
+    /** Number of file images */
+    file: number;
+  };
+  /** The intermediate NAST representation */
+  nast: NASTRoot$1;
+}
+/**
+ * Main notion2typst function - converts a Notion page to Typst code
+ *
+ * This is a wrapper that combines:
+ * 1. notion2nbt - fetch page from Notion API
+ * 2. nbt2nast - convert Notion blocks to NAST
+ * 3. nast2typst - convert NAST to Typst code
+ * 4. fetchImagesFromBlocks - download images (optional)
+ *
+ * @param options - Configuration options
+ * @returns Typst code and downloaded images
+ *
+ * @example
+ * ```typescript
+ * const result = await notion2typst({
+ *   notionToken: 'your-token',
+ *   pageId: 'your-page-id',
+ *   fetchImages: true
+ * });
+ *
+ * console.log(result.typstCode);
+ * console.log(`Downloaded ${result.images.length} images`);
+ * ```
+ */
+declare function notion2typst(options: Notion2TypstOptions): Promise<Notion2TypstResult>;
+//#endregion
+export { type DownloadedImage, ImageData, type NASTNode, type NASTRoot, type NBTBlock, Notion2NBT, Notion2TypstOptions, Notion2TypstResult, type NotionBlock, fetchImagesFromBlocks, nast2typst, nbt2nast, notion2typst };

package/dist/index.js

@@ -0,0 +1,76 @@
+import { Notion2NBT } from "@nast/notion2nbt";
+import { nbt2nast } from "@nast/nbt2nast";
+import { nast2typst } from "@nast/nast2typst";
+import { fetchImagesFromBlocks } from "@nast/nast-fetch-images";
+
+//#region src/index.ts
+/**
+* Main notion2typst function - converts a Notion page to Typst code
+* 
+* This is a wrapper that combines:
+* 1. notion2nbt - fetch page from Notion API
+* 2. nbt2nast - convert Notion blocks to NAST
+* 3. nast2typst - convert NAST to Typst code
+* 4. fetchImagesFromBlocks - download images (optional)
+* 
+* @param options - Configuration options
+* @returns Typst code and downloaded images
+* 
+* @example
+* ```typescript
+* const result = await notion2typst({
+*   notionToken: 'your-token',
+*   pageId: 'your-page-id',
+*   fetchImages: true
+* });
+* 
+* console.log(result.typstCode);
+* console.log(`Downloaded ${result.images.length} images`);
+* ```
+*/
+async function notion2typst(options) {
+	const { notionToken, pageId, fetchImages = true, preserveBlockId = false, enableCache = false } = options;
+	console.log("Fetching page from Notion...");
+	const nbtPage = await new Notion2NBT({
+		auth: notionToken,
+		enableCache
+	}).getPageV2(pageId);
+	console.log("✓ Page fetched successfully");
+	console.log("Converting NBT to NAST...");
+	const nast = nbt2nast(nbtPage, { preserveBlockId });
+	console.log("✓ NBT converted to NAST");
+	console.log("Converting NAST to Typst...");
+	const typstCode = nast2typst(nast);
+	console.log("✓ NAST converted to Typst");
+	let images = [];
+	let imageStats = {
+		totalImages: 0,
+		downloaded: 0,
+		expired: 0,
+		external: 0,
+		file: 0
+	};
+	if (fetchImages) {
+		console.log("Fetching images...");
+		const imageResult = await fetchImagesFromBlocks(nast.children);
+		images = imageResult.images;
+		imageStats = {
+			totalImages: imageResult.imageCount,
+			downloaded: images.length,
+			expired: imageResult.expiredCount,
+			external: imageResult.imageExternalCount,
+			file: imageResult.imageFileCount
+		};
+		console.log(`✓ Downloaded ${images.length}/${imageResult.imageCount} images (${imageResult.expiredCount} expired)`);
+	}
+	console.log("Done!");
+	return {
+		typstCode,
+		images,
+		imageStats,
+		nast
+	};
+}
+
+//#endregion
+export { Notion2NBT, fetchImagesFromBlocks, nast2typst, nbt2nast, notion2typst };

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@nast/notion2typst",
+  "type": "module",
+  "version": "0.2.0",
+  "description": "A wrapper around nbt2nast and nast2typst to convert Notion content directly to Typst",
+  "keywords": [
+    "notion",
+    "ast",
+    "nast",
+    "typst"
+  ],
+  "author": "Mapaor <pardo.marti@gmail.com>",
+  "license": "MIT",
+  "homepage": "https://github.com/Mapaor/nast/tree/main/packages/notion2typst",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Mapaor/nast.git",
+    "directory": "packages/notion2typst"
+  },
+  "bugs": {
+    "url": "https://github.com/Mapaor/nast/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index-CJVMSA--.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@nast/nbt2nast": "0.4.0",
+    "@nast/nast-fetch-images": "0.2.0",
+    "@nast/nast2typst": "0.3.0",
+    "@nast/notion2nbt": "0.6.0",
+    "@nast/types": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "test": "vitest",
+    "typecheck": "tsc --noEmit",
+    "example": "node --env-file=.env.local --import tsx scripts/example.ts"
+  }
+}