@deepnote/convert 2.3.1 → 3.0.0

package/dist/bin.cjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-const require_src = require('./src-DfBtDvXJ.cjs');
+const require_src = require('./src-BR6PqlNA.cjs');
 let cleye = require("cleye");
 cleye = require_src.__toESM(cleye);
 let node_fs_promises = require("node:fs/promises");
@@ -90,7 +90,7 @@ async function convert(options) {
 			format: "percent",
 			...directoryOptions
 		});
-		throw new Error("No supported notebook files found in the specified directory (.ipynb, .qmd, .py)");
+		throw new require_src.UnsupportedFormatError("No supported notebook files found in the specified directory (.ipynb, .qmd, .py)");
 	}
 	const ext = (0, node_path.extname)(absolutePath).toLowerCase();
 	const fileOptions = {
@@ -105,10 +105,10 @@ async function convert(options) {
 		const content = await node_fs_promises.default.readFile(absolutePath, "utf-8");
 		if (require_src.isMarimoContent(content)) return convertMarimoToDeepnote(fileOptions);
 		if (require_src.isPercentContent(content)) return convertPercentToDeepnote(fileOptions);
-		throw new Error("Unsupported Python file format. File must be a percent format (# %% markers) or Marimo notebook (@app.cell decorators).");
+		throw new require_src.UnsupportedFormatError("Unsupported Python file format. File must be a percent format (# %% markers) or Marimo notebook (@app.cell decorators).", { filename: absolutePath });
 	}
 	if (ext === ".deepnote") return convertDeepnoteToFormat(absolutePath, outputFormat, customOutputPath, cwd);
-	throw new Error("Unsupported file type. Please provide a .ipynb, .qmd, .py (percent/marimo), or .deepnote file.");
+	throw new require_src.UnsupportedFormatError("Unsupported file type. Please provide a .ipynb, .qmd, .py (percent/marimo), or .deepnote file.", { filename: absolutePath });
 }
 async function convertDirectory(options) {
 	const { dirPath, files, format, resolveProjectName, resolveOutputPath, singleFile } = options;

package/dist/bin.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { G as convertDeepnoteFileToPercentFiles, I as readAndConvertIpynbFiles, R as isMarimoContent, S as mergeSnapshotIntoSource, T as loadLatestSnapshot, V as convertDeepnoteFileToQuartoFiles, Y as convertDeepnoteFileToMarimoFiles, d as readAndConvertPercentFiles, et as convertDeepnoteFileToJupyterFiles, g as readAndConvertMarimoFiles, o as readAndConvertQuartoFiles, t as writeDeepnoteFile, z as isPercentContent } from "./src-D0_X_RDD.js";
+import { G as convertDeepnoteFileToPercentFiles, I as readAndConvertIpynbFiles, R as isMarimoContent, S as mergeSnapshotIntoSource, T as loadLatestSnapshot, V as convertDeepnoteFileToQuartoFiles, Y as convertDeepnoteFileToMarimoFiles, d as readAndConvertPercentFiles, g as readAndConvertMarimoFiles, it as convertDeepnoteFileToJupyterFiles, o as readAndConvertQuartoFiles, t as writeDeepnoteFile, tt as UnsupportedFormatError, z as isPercentContent } from "./src-BN4Mwc-V.js";
 import { cli } from "cleye";
 import fs from "node:fs/promises";
 import { basename, dirname, extname, resolve } from "node:path";
@@ -83,7 +83,7 @@ async function convert(options) {
 			format: "percent",
 			...directoryOptions
 		});
-		throw new Error("No supported notebook files found in the specified directory (.ipynb, .qmd, .py)");
+		throw new UnsupportedFormatError("No supported notebook files found in the specified directory (.ipynb, .qmd, .py)");
 	}
 	const ext = extname(absolutePath).toLowerCase();
 	const fileOptions = {
@@ -98,10 +98,10 @@ async function convert(options) {
 		const content = await fs.readFile(absolutePath, "utf-8");
 		if (isMarimoContent(content)) return convertMarimoToDeepnote(fileOptions);
 		if (isPercentContent(content)) return convertPercentToDeepnote(fileOptions);
-		throw new Error("Unsupported Python file format. File must be a percent format (# %% markers) or Marimo notebook (@app.cell decorators).");
+		throw new UnsupportedFormatError("Unsupported Python file format. File must be a percent format (# %% markers) or Marimo notebook (@app.cell decorators).", { filename: absolutePath });
 	}
 	if (ext === ".deepnote") return convertDeepnoteToFormat(absolutePath, outputFormat, customOutputPath, cwd);
-	throw new Error("Unsupported file type. Please provide a .ipynb, .qmd, .py (percent/marimo), or .deepnote file.");
+	throw new UnsupportedFormatError("Unsupported file type. Please provide a .ipynb, .qmd, .py (percent/marimo), or .deepnote file.", { filename: absolutePath });
 }
 async function convertDirectory(options) {
 	const { dirPath, files, format, resolveProjectName, resolveOutputPath, singleFile } = options;

package/dist/index.cjs

@@ -1,5 +1,9 @@
-const require_src = require('./src-DfBtDvXJ.cjs');
+const require_src = require('./src-BR6PqlNA.cjs');
 
+exports.FileReadError = require_src.FileReadError;
+exports.FileWriteError = require_src.FileWriteError;
+exports.JsonParseError = require_src.JsonParseError;
+exports.UnsupportedFormatError = require_src.UnsupportedFormatError;
 exports.addContentHashes = require_src.addContentHashes;
 exports.computeContentHash = require_src.computeContentHash;
 exports.computeSnapshotHash = require_src.computeSnapshotHash;

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { DeepnoteBlock, DeepnoteFile, DeepnoteSnapshot, Environment, Execution } from "@deepnote/blocks";
+import { DeepnoteBlock, DeepnoteError, DeepnoteFile, DeepnoteSnapshot, Environment, Execution, ParseError } from "@deepnote/blocks";
 
 //#region src/types/jupyter.d.ts
 
@@ -445,6 +445,39 @@ declare function serializeQuartoFormat(document: QuartoDocument): string;
  */
 declare function convertDeepnoteFileToQuartoFiles(deepnoteFilePath: string, options: ConvertDeepnoteFileToQuartoOptions): Promise<void>;
 //#endregion
+//#region src/errors.d.ts
+/**
+ * Thrown when a file cannot be read from disk.
+ */
+declare class FileReadError extends DeepnoteError {
+  filePath: string;
+  constructor(message: string, options: ErrorOptions & {
+    filePath: string;
+  });
+}
+/**
+ * Thrown when a file cannot be written to disk.
+ */
+declare class FileWriteError extends DeepnoteError {
+  filePath: string;
+  constructor(message: string, options: ErrorOptions & {
+    filePath: string;
+  });
+}
+/**
+ * Thrown when JSON parsing fails.
+ */
+declare class JsonParseError extends ParseError {}
+/**
+ * Thrown when a file format is not supported.
+ */
+declare class UnsupportedFormatError extends DeepnoteError {
+  filename?: string;
+  constructor(message: string, options?: ErrorOptions & {
+    filename?: string;
+  });
+}
+//#endregion
 //#region src/format-detection.d.ts
 type NotebookFormat = 'jupyter' | 'deepnote' | 'marimo' | 'percent' | 'quarto';
 /**
@@ -961,4 +994,4 @@ interface WriteDeepnoteFileResult {
  */
 declare function writeDeepnoteFile(options: WriteDeepnoteFileOptions): Promise<WriteDeepnoteFileResult>;
 //#endregion
-export { type BlockOutput, type ConvertBlocksToJupyterOptions, type ConvertDeepnoteFileToMarimoOptions, type ConvertDeepnoteFileToPercentOptions, type ConvertDeepnoteFileToQuartoOptions, type ConvertIpynbFilesToDeepnoteFileOptions, type ConvertJupyterNotebookOptions, type ConvertMarimoAppOptions, type ConvertMarimoAppsToDeepnoteOptions, type ConvertMarimoFilesToDeepnoteFileOptions, type ConvertPercentFilesToDeepnoteFileOptions, type ConvertPercentNotebookOptions, type ConvertQuartoDocumentOptions, type ConvertQuartoFilesToDeepnoteFileOptions, type JupyterCell, type JupyterNotebook, type JupyterNotebookInput, type MarimoApp, type MarimoAppInput, type MarimoCell, type MergeOptions, type NotebookFormat, type PercentCell, type PercentNotebook, type PercentNotebookInput, type QuartoCell, type QuartoCellOptions, type QuartoDocument, type QuartoDocumentInput, type QuartoFrontmatter, type ReadAndConvertIpynbFilesOptions, type ReadAndConvertMarimoFilesOptions, type ReadAndConvertPercentFilesOptions, type ReadAndConvertQuartoFilesOptions, type SnapshotInfo, type SnapshotOptions, type SplitResult, type WriteDeepnoteFileOptions, type WriteDeepnoteFileResult, addContentHashes, computeContentHash, computeSnapshotHash, convertBlockToJupyterCell, convertBlocksToJupyterNotebook, convertBlocksToMarimoApp, convertBlocksToPercentNotebook, convertBlocksToQuartoDocument, convertDeepnoteFileToJupyterFiles, convertDeepnoteFileToMarimoFiles, convertDeepnoteFileToPercentFiles, convertDeepnoteFileToQuartoFiles, convertDeepnoteToJupyterNotebooks, convertDeepnoteToMarimoApps, convertDeepnoteToPercentNotebooks, convertDeepnoteToQuartoDocuments, convertIpynbFilesToDeepnoteFile, convertJupyterNotebookToBlocks, convertJupyterNotebooksToDeepnote, convertMarimoAppToBlocks, convertMarimoAppsToDeepnote, convertMarimoFilesToDeepnoteFile, convertPercentFilesToDeepnoteFile, convertPercentNotebookToBlocks, convertPercentNotebooksToDeepnote, convertQuartoDocumentToBlocks, convertQuartoDocumentsToDeepnote, convertQuartoFilesToDeepnoteFile, countBlocksWithOutputs, detectFormat, findSnapshotsForProject, generateSnapshotFilename, getSnapshotDir, hasOutputs, loadLatestSnapshot, loadSnapshotFile, mergeSnapshotIntoSource, parseMarimoFormat, parsePercentFormat, parseQuartoFormat, parseSnapshotFilename, parseSourceFilePath, readAndConvertIpynbFiles, readAndConvertMarimoFiles, readAndConvertPercentFiles, readAndConvertQuartoFiles, serializeMarimoFormat, serializePercentFormat, serializeQuartoFormat, slugifyProjectName, snapshotExists, splitDeepnoteFile, writeDeepnoteFile };
+export { type BlockOutput, type ConvertBlocksToJupyterOptions, type ConvertDeepnoteFileToMarimoOptions, type ConvertDeepnoteFileToPercentOptions, type ConvertDeepnoteFileToQuartoOptions, type ConvertIpynbFilesToDeepnoteFileOptions, type ConvertJupyterNotebookOptions, type ConvertMarimoAppOptions, type ConvertMarimoAppsToDeepnoteOptions, type ConvertMarimoFilesToDeepnoteFileOptions, type ConvertPercentFilesToDeepnoteFileOptions, type ConvertPercentNotebookOptions, type ConvertQuartoDocumentOptions, type ConvertQuartoFilesToDeepnoteFileOptions, FileReadError, FileWriteError, JsonParseError, type JupyterCell, type JupyterNotebook, type JupyterNotebookInput, type MarimoApp, type MarimoAppInput, type MarimoCell, type MergeOptions, type NotebookFormat, type PercentCell, type PercentNotebook, type PercentNotebookInput, type QuartoCell, type QuartoCellOptions, type QuartoDocument, type QuartoDocumentInput, type QuartoFrontmatter, type ReadAndConvertIpynbFilesOptions, type ReadAndConvertMarimoFilesOptions, type ReadAndConvertPercentFilesOptions, type ReadAndConvertQuartoFilesOptions, type SnapshotInfo, type SnapshotOptions, type SplitResult, UnsupportedFormatError, type WriteDeepnoteFileOptions, type WriteDeepnoteFileResult, addContentHashes, computeContentHash, computeSnapshotHash, convertBlockToJupyterCell, convertBlocksToJupyterNotebook, convertBlocksToMarimoApp, convertBlocksToPercentNotebook, convertBlocksToQuartoDocument, convertDeepnoteFileToJupyterFiles, convertDeepnoteFileToMarimoFiles, convertDeepnoteFileToPercentFiles, convertDeepnoteFileToQuartoFiles, convertDeepnoteToJupyterNotebooks, convertDeepnoteToMarimoApps, convertDeepnoteToPercentNotebooks, convertDeepnoteToQuartoDocuments, convertIpynbFilesToDeepnoteFile, convertJupyterNotebookToBlocks, convertJupyterNotebooksToDeepnote, convertMarimoAppToBlocks, convertMarimoAppsToDeepnote, convertMarimoFilesToDeepnoteFile, convertPercentFilesToDeepnoteFile, convertPercentNotebookToBlocks, convertPercentNotebooksToDeepnote, convertQuartoDocumentToBlocks, convertQuartoDocumentsToDeepnote, convertQuartoFilesToDeepnoteFile, countBlocksWithOutputs, detectFormat, findSnapshotsForProject, generateSnapshotFilename, getSnapshotDir, hasOutputs, loadLatestSnapshot, loadSnapshotFile, mergeSnapshotIntoSource, parseMarimoFormat, parsePercentFormat, parseQuartoFormat, parseSnapshotFilename, parseSourceFilePath, readAndConvertIpynbFiles, readAndConvertMarimoFiles, readAndConvertPercentFiles, readAndConvertQuartoFiles, serializeMarimoFormat, serializePercentFormat, serializeQuartoFormat, slugifyProjectName, snapshotExists, splitDeepnoteFile, writeDeepnoteFile };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { DeepnoteBlock, DeepnoteFile, DeepnoteSnapshot, Environment, Execution } from "@deepnote/blocks";
+import { DeepnoteBlock, DeepnoteError, DeepnoteFile, DeepnoteSnapshot, Environment, Execution, ParseError } from "@deepnote/blocks";
 
 //#region src/types/jupyter.d.ts
 
@@ -445,6 +445,39 @@ declare function serializeQuartoFormat(document: QuartoDocument): string;
  */
 declare function convertDeepnoteFileToQuartoFiles(deepnoteFilePath: string, options: ConvertDeepnoteFileToQuartoOptions): Promise<void>;
 //#endregion
+//#region src/errors.d.ts
+/**
+ * Thrown when a file cannot be read from disk.
+ */
+declare class FileReadError extends DeepnoteError {
+  filePath: string;
+  constructor(message: string, options: ErrorOptions & {
+    filePath: string;
+  });
+}
+/**
+ * Thrown when a file cannot be written to disk.
+ */
+declare class FileWriteError extends DeepnoteError {
+  filePath: string;
+  constructor(message: string, options: ErrorOptions & {
+    filePath: string;
+  });
+}
+/**
+ * Thrown when JSON parsing fails.
+ */
+declare class JsonParseError extends ParseError {}
+/**
+ * Thrown when a file format is not supported.
+ */
+declare class UnsupportedFormatError extends DeepnoteError {
+  filename?: string;
+  constructor(message: string, options?: ErrorOptions & {
+    filename?: string;
+  });
+}
+//#endregion
 //#region src/format-detection.d.ts
 type NotebookFormat = 'jupyter' | 'deepnote' | 'marimo' | 'percent' | 'quarto';
 /**
@@ -961,4 +994,4 @@ interface WriteDeepnoteFileResult {
  */
 declare function writeDeepnoteFile(options: WriteDeepnoteFileOptions): Promise<WriteDeepnoteFileResult>;
 //#endregion
-export { type BlockOutput, type ConvertBlocksToJupyterOptions, type ConvertDeepnoteFileToMarimoOptions, type ConvertDeepnoteFileToPercentOptions, type ConvertDeepnoteFileToQuartoOptions, type ConvertIpynbFilesToDeepnoteFileOptions, type ConvertJupyterNotebookOptions, type ConvertMarimoAppOptions, type ConvertMarimoAppsToDeepnoteOptions, type ConvertMarimoFilesToDeepnoteFileOptions, type ConvertPercentFilesToDeepnoteFileOptions, type ConvertPercentNotebookOptions, type ConvertQuartoDocumentOptions, type ConvertQuartoFilesToDeepnoteFileOptions, type JupyterCell, type JupyterNotebook, type JupyterNotebookInput, type MarimoApp, type MarimoAppInput, type MarimoCell, type MergeOptions, type NotebookFormat, type PercentCell, type PercentNotebook, type PercentNotebookInput, type QuartoCell, type QuartoCellOptions, type QuartoDocument, type QuartoDocumentInput, type QuartoFrontmatter, type ReadAndConvertIpynbFilesOptions, type ReadAndConvertMarimoFilesOptions, type ReadAndConvertPercentFilesOptions, type ReadAndConvertQuartoFilesOptions, type SnapshotInfo, type SnapshotOptions, type SplitResult, type WriteDeepnoteFileOptions, type WriteDeepnoteFileResult, addContentHashes, computeContentHash, computeSnapshotHash, convertBlockToJupyterCell, convertBlocksToJupyterNotebook, convertBlocksToMarimoApp, convertBlocksToPercentNotebook, convertBlocksToQuartoDocument, convertDeepnoteFileToJupyterFiles, convertDeepnoteFileToMarimoFiles, convertDeepnoteFileToPercentFiles, convertDeepnoteFileToQuartoFiles, convertDeepnoteToJupyterNotebooks, convertDeepnoteToMarimoApps, convertDeepnoteToPercentNotebooks, convertDeepnoteToQuartoDocuments, convertIpynbFilesToDeepnoteFile, convertJupyterNotebookToBlocks, convertJupyterNotebooksToDeepnote, convertMarimoAppToBlocks, convertMarimoAppsToDeepnote, convertMarimoFilesToDeepnoteFile, convertPercentFilesToDeepnoteFile, convertPercentNotebookToBlocks, convertPercentNotebooksToDeepnote, convertQuartoDocumentToBlocks, convertQuartoDocumentsToDeepnote, convertQuartoFilesToDeepnoteFile, countBlocksWithOutputs, detectFormat, findSnapshotsForProject, generateSnapshotFilename, getSnapshotDir, hasOutputs, loadLatestSnapshot, loadSnapshotFile, mergeSnapshotIntoSource, parseMarimoFormat, parsePercentFormat, parseQuartoFormat, parseSnapshotFilename, parseSourceFilePath, readAndConvertIpynbFiles, readAndConvertMarimoFiles, readAndConvertPercentFiles, readAndConvertQuartoFiles, serializeMarimoFormat, serializePercentFormat, serializeQuartoFormat, slugifyProjectName, snapshotExists, splitDeepnoteFile, writeDeepnoteFile };
+export { type BlockOutput, type ConvertBlocksToJupyterOptions, type ConvertDeepnoteFileToMarimoOptions, type ConvertDeepnoteFileToPercentOptions, type ConvertDeepnoteFileToQuartoOptions, type ConvertIpynbFilesToDeepnoteFileOptions, type ConvertJupyterNotebookOptions, type ConvertMarimoAppOptions, type ConvertMarimoAppsToDeepnoteOptions, type ConvertMarimoFilesToDeepnoteFileOptions, type ConvertPercentFilesToDeepnoteFileOptions, type ConvertPercentNotebookOptions, type ConvertQuartoDocumentOptions, type ConvertQuartoFilesToDeepnoteFileOptions, FileReadError, FileWriteError, JsonParseError, type JupyterCell, type JupyterNotebook, type JupyterNotebookInput, type MarimoApp, type MarimoAppInput, type MarimoCell, type MergeOptions, type NotebookFormat, type PercentCell, type PercentNotebook, type PercentNotebookInput, type QuartoCell, type QuartoCellOptions, type QuartoDocument, type QuartoDocumentInput, type QuartoFrontmatter, type ReadAndConvertIpynbFilesOptions, type ReadAndConvertMarimoFilesOptions, type ReadAndConvertPercentFilesOptions, type ReadAndConvertQuartoFilesOptions, type SnapshotInfo, type SnapshotOptions, type SplitResult, UnsupportedFormatError, type WriteDeepnoteFileOptions, type WriteDeepnoteFileResult, addContentHashes, computeContentHash, computeSnapshotHash, convertBlockToJupyterCell, convertBlocksToJupyterNotebook, convertBlocksToMarimoApp, convertBlocksToPercentNotebook, convertBlocksToQuartoDocument, convertDeepnoteFileToJupyterFiles, convertDeepnoteFileToMarimoFiles, convertDeepnoteFileToPercentFiles, convertDeepnoteFileToQuartoFiles, convertDeepnoteToJupyterNotebooks, convertDeepnoteToMarimoApps, convertDeepnoteToPercentNotebooks, convertDeepnoteToQuartoDocuments, convertIpynbFilesToDeepnoteFile, convertJupyterNotebookToBlocks, convertJupyterNotebooksToDeepnote, convertMarimoAppToBlocks, convertMarimoAppsToDeepnote, convertMarimoFilesToDeepnoteFile, convertPercentFilesToDeepnoteFile, convertPercentNotebookToBlocks, convertPercentNotebooksToDeepnote, convertQuartoDocumentToBlocks, convertQuartoDocumentsToDeepnote, convertQuartoFilesToDeepnoteFile, countBlocksWithOutputs, detectFormat, findSnapshotsForProject, generateSnapshotFilename, getSnapshotDir, hasOutputs, loadLatestSnapshot, loadSnapshotFile, mergeSnapshotIntoSource, parseMarimoFormat, parsePercentFormat, parseQuartoFormat, parseSnapshotFilename, parseSourceFilePath, readAndConvertIpynbFiles, readAndConvertMarimoFiles, readAndConvertPercentFiles, readAndConvertQuartoFiles, serializeMarimoFormat, serializePercentFormat, serializeQuartoFormat, slugifyProjectName, snapshotExists, splitDeepnoteFile, writeDeepnoteFile };

package/dist/index.js

@@ -1,3 +1,3 @@
-import { $ as convertBlocksToJupyterNotebook, A as addContentHashes, B as convertBlocksToQuartoDocument, C as findSnapshotsForProject, D as parseSnapshotFilename, E as loadSnapshotFile, F as convertJupyterNotebooksToDeepnote, G as convertDeepnoteFileToPercentFiles, H as convertDeepnoteToQuartoDocuments, I as readAndConvertIpynbFiles, J as convertBlocksToMarimoApp, K as convertDeepnoteToPercentNotebooks, L as detectFormat, M as computeSnapshotHash, N as convertIpynbFilesToDeepnoteFile, O as parseSourceFilePath, P as convertJupyterNotebookToBlocks, Q as convertBlockToJupyterCell, S as mergeSnapshotIntoSource, T as loadLatestSnapshot, U as serializeQuartoFormat, V as convertDeepnoteFileToQuartoFiles, W as convertBlocksToPercentNotebook, X as convertDeepnoteToMarimoApps, Y as convertDeepnoteFileToMarimoFiles, Z as serializeMarimoFormat, _ as generateSnapshotFilename, a as parseQuartoFormat, b as splitDeepnoteFile, c as convertPercentNotebookToBlocks, d as readAndConvertPercentFiles, et as convertDeepnoteFileToJupyterFiles, f as convertMarimoAppToBlocks, g as readAndConvertMarimoFiles, h as parseMarimoFormat, i as convertQuartoFilesToDeepnoteFile, j as computeContentHash, k as snapshotExists, l as convertPercentNotebooksToDeepnote, m as convertMarimoFilesToDeepnoteFile, n as convertQuartoDocumentToBlocks, o as readAndConvertQuartoFiles, p as convertMarimoAppsToDeepnote, q as serializePercentFormat, r as convertQuartoDocumentsToDeepnote, s as convertPercentFilesToDeepnoteFile, t as writeDeepnoteFile, tt as convertDeepnoteToJupyterNotebooks, u as parsePercentFormat, v as hasOutputs, w as getSnapshotDir, x as countBlocksWithOutputs, y as slugifyProjectName } from "./src-D0_X_RDD.js";
+import { $ as FileWriteError, A as addContentHashes, B as convertBlocksToQuartoDocument, C as findSnapshotsForProject, D as parseSnapshotFilename, E as loadSnapshotFile, F as convertJupyterNotebooksToDeepnote, G as convertDeepnoteFileToPercentFiles, H as convertDeepnoteToQuartoDocuments, I as readAndConvertIpynbFiles, J as convertBlocksToMarimoApp, K as convertDeepnoteToPercentNotebooks, L as detectFormat, M as computeSnapshotHash, N as convertIpynbFilesToDeepnoteFile, O as parseSourceFilePath, P as convertJupyterNotebookToBlocks, Q as FileReadError, S as mergeSnapshotIntoSource, T as loadLatestSnapshot, U as serializeQuartoFormat, V as convertDeepnoteFileToQuartoFiles, W as convertBlocksToPercentNotebook, X as convertDeepnoteToMarimoApps, Y as convertDeepnoteFileToMarimoFiles, Z as serializeMarimoFormat, _ as generateSnapshotFilename, a as parseQuartoFormat, at as convertDeepnoteToJupyterNotebooks, b as splitDeepnoteFile, c as convertPercentNotebookToBlocks, d as readAndConvertPercentFiles, et as JsonParseError, f as convertMarimoAppToBlocks, g as readAndConvertMarimoFiles, h as parseMarimoFormat, i as convertQuartoFilesToDeepnoteFile, it as convertDeepnoteFileToJupyterFiles, j as computeContentHash, k as snapshotExists, l as convertPercentNotebooksToDeepnote, m as convertMarimoFilesToDeepnoteFile, n as convertQuartoDocumentToBlocks, nt as convertBlockToJupyterCell, o as readAndConvertQuartoFiles, p as convertMarimoAppsToDeepnote, q as serializePercentFormat, r as convertQuartoDocumentsToDeepnote, rt as convertBlocksToJupyterNotebook, s as convertPercentFilesToDeepnoteFile, t as writeDeepnoteFile, tt as UnsupportedFormatError, u as parsePercentFormat, v as hasOutputs, w as getSnapshotDir, x as countBlocksWithOutputs, y as slugifyProjectName } from "./src-BN4Mwc-V.js";
 
-export { addContentHashes, computeContentHash, computeSnapshotHash, convertBlockToJupyterCell, convertBlocksToJupyterNotebook, convertBlocksToMarimoApp, convertBlocksToPercentNotebook, convertBlocksToQuartoDocument, convertDeepnoteFileToJupyterFiles, convertDeepnoteFileToMarimoFiles, convertDeepnoteFileToPercentFiles, convertDeepnoteFileToQuartoFiles, convertDeepnoteToJupyterNotebooks, convertDeepnoteToMarimoApps, convertDeepnoteToPercentNotebooks, convertDeepnoteToQuartoDocuments, convertIpynbFilesToDeepnoteFile, convertJupyterNotebookToBlocks, convertJupyterNotebooksToDeepnote, convertMarimoAppToBlocks, convertMarimoAppsToDeepnote, convertMarimoFilesToDeepnoteFile, convertPercentFilesToDeepnoteFile, convertPercentNotebookToBlocks, convertPercentNotebooksToDeepnote, convertQuartoDocumentToBlocks, convertQuartoDocumentsToDeepnote, convertQuartoFilesToDeepnoteFile, countBlocksWithOutputs, detectFormat, findSnapshotsForProject, generateSnapshotFilename, getSnapshotDir, hasOutputs, loadLatestSnapshot, loadSnapshotFile, mergeSnapshotIntoSource, parseMarimoFormat, parsePercentFormat, parseQuartoFormat, parseSnapshotFilename, parseSourceFilePath, readAndConvertIpynbFiles, readAndConvertMarimoFiles, readAndConvertPercentFiles, readAndConvertQuartoFiles, serializeMarimoFormat, serializePercentFormat, serializeQuartoFormat, slugifyProjectName, snapshotExists, splitDeepnoteFile, writeDeepnoteFile };
+export { FileReadError, FileWriteError, JsonParseError, UnsupportedFormatError, addContentHashes, computeContentHash, computeSnapshotHash, convertBlockToJupyterCell, convertBlocksToJupyterNotebook, convertBlocksToMarimoApp, convertBlocksToPercentNotebook, convertBlocksToQuartoDocument, convertDeepnoteFileToJupyterFiles, convertDeepnoteFileToMarimoFiles, convertDeepnoteFileToPercentFiles, convertDeepnoteFileToQuartoFiles, convertDeepnoteToJupyterNotebooks, convertDeepnoteToMarimoApps, convertDeepnoteToPercentNotebooks, convertDeepnoteToQuartoDocuments, convertIpynbFilesToDeepnoteFile, convertJupyterNotebookToBlocks, convertJupyterNotebooksToDeepnote, convertMarimoAppToBlocks, convertMarimoAppsToDeepnote, convertMarimoFilesToDeepnoteFile, convertPercentFilesToDeepnoteFile, convertPercentNotebookToBlocks, convertPercentNotebooksToDeepnote, convertQuartoDocumentToBlocks, convertQuartoDocumentsToDeepnote, convertQuartoFilesToDeepnoteFile, countBlocksWithOutputs, detectFormat, findSnapshotsForProject, generateSnapshotFilename, getSnapshotDir, hasOutputs, loadLatestSnapshot, loadSnapshotFile, mergeSnapshotIntoSource, parseMarimoFormat, parsePercentFormat, parseQuartoFormat, parseSnapshotFilename, parseSourceFilePath, readAndConvertIpynbFiles, readAndConvertMarimoFiles, readAndConvertPercentFiles, readAndConvertQuartoFiles, serializeMarimoFormat, serializePercentFormat, serializeQuartoFormat, slugifyProjectName, snapshotExists, splitDeepnoteFile, writeDeepnoteFile };

package/dist/{src-D0_X_RDD.js → src-BN4Mwc-V.js}

@@ -1,6 +1,6 @@
 import fs from "node:fs/promises";
 import { basename, dirname, extname, join, resolve } from "node:path";
-import { createMarkdown, createPythonCode, deepnoteBlockSchema, deepnoteSnapshotSchema, deserializeDeepnoteFile, environmentSchema, executionSchema, isExecutableBlockType } from "@deepnote/blocks";
+import { DeepnoteError, InvalidValueError, ParseError, createMarkdown, createPythonCode, deepnoteBlockSchema, deepnoteSnapshotSchema, deserializeDeepnoteFile, environmentSchema, executionSchema, isExecutableBlockType } from "@deepnote/blocks";
 import { parse, stringify } from "yaml";
 import { createHash, randomUUID } from "node:crypto";
 
@@ -16,7 +16,7 @@ function createSortingKey(index) {
 	const maxLength = 6;
 	const chars = "0123456789abcdefghijklmnopqrstuvwxyz";
 	const base = 36;
-	if (index < 0) throw new Error("Index must be non-negative");
+	if (index < 0) throw new InvalidValueError("Index must be non-negative", { value: index });
 	let result = "";
 	let num = index + 1;
 	let iterations = 0;
@@ -26,7 +26,7 @@ function createSortingKey(index) {
 		num = Math.floor(num / base);
 		iterations++;
 	}
-	if (num > 0) throw new Error(`Index ${index} exceeds maximum key length of ${maxLength}`);
+	if (num > 0) throw new InvalidValueError(`Index ${index} exceeds maximum key length of ${maxLength}`, { value: index });
 	return result;
 }
 /**
@@ -222,6 +222,43 @@ function convertNotebookToJupyter(deepnoteFile, notebook) {
 	});
 }
 
+//#endregion
+//#region src/errors.ts
+/**
+* Thrown when a file cannot be read from disk.
+*/
+var FileReadError = class extends DeepnoteError {
+	filePath;
+	constructor(message, options) {
+		super(message, options);
+		this.filePath = options.filePath;
+	}
+};
+/**
+* Thrown when a file cannot be written to disk.
+*/
+var FileWriteError = class extends DeepnoteError {
+	filePath;
+	constructor(message, options) {
+		super(message, options);
+		this.filePath = options.filePath;
+	}
+};
+/**
+* Thrown when JSON parsing fails.
+*/
+var JsonParseError = class extends ParseError {};
+/**
+* Thrown when a file format is not supported.
+*/
+var UnsupportedFormatError = class extends DeepnoteError {
+	filename;
+	constructor(message, options) {
+		super(message, options);
+		this.filename = options?.filename;
+	}
+};
+
 //#endregion
 //#region src/deepnote-to-marimo.ts
 /** Current Marimo version for generated files */
@@ -336,8 +373,10 @@ async function convertDeepnoteFileToMarimoFiles(deepnoteFilePath, options) {
 			const content = serializeMarimoFormat(app);
 			await fs.writeFile(filePath, content, "utf-8");
 		} catch (err) {
-			const errorMessage = err instanceof Error ? err.message : String(err);
-			throw new Error(`Failed to write ${filename}: ${errorMessage}`, { cause: err });
+			throw new FileWriteError(`Failed to write ${filename}: ${err instanceof Error ? err.message : String(err)}`, {
+				cause: err,
+				filePath
+			});
 		}
 	}
 }
@@ -697,12 +736,12 @@ function detectFormat(filename, content) {
 	if (lowercaseFilename.endsWith(".deepnote")) return "deepnote";
 	if (lowercaseFilename.endsWith(".qmd")) return "quarto";
 	if (lowercaseFilename.endsWith(".py")) {
-		if (!content) throw new Error("Content is required to detect format for .py files");
+		if (!content) throw new UnsupportedFormatError("Content is required to detect format for .py files", { filename });
 		if (isMarimoContent(content)) return "marimo";
 		if (isPercentContent(content)) return "percent";
-		throw new Error("Unsupported Python file format. File must be percent format (# %%) or Marimo (@app.cell).");
+		throw new UnsupportedFormatError("Unsupported Python file format. File must be percent format (# %%) or Marimo (@app.cell).", { filename });
 	}
-	throw new Error(`Unsupported file format: ${filename}`);
+	throw new UnsupportedFormatError(`Unsupported file format: ${filename}`, { filename });
 }
 
 //#endregion
@@ -819,14 +858,18 @@ async function parseIpynbFile(filePath) {
 	try {
 		ipynbJson = await fs.readFile(filePath, "utf-8");
 	} catch (error) {
-		const message = error instanceof Error ? error.message : String(error);
-		throw new Error(`Failed to read ${filePath}: ${message}`);
+		throw new FileReadError(`Failed to read ${filePath}: ${error instanceof Error ? error.message : String(error)}`, {
+			cause: error,
+			filePath
+		});
 	}
 	try {
 		return JSON.parse(ipynbJson);
 	} catch (error) {
-		const message = error instanceof Error ? error.message : String(error);
-		throw new Error(`Failed to parse ${filePath}: invalid JSON - ${message}`);
+		throw new JsonParseError(`Failed to parse ${filePath}: invalid JSON - ${error instanceof Error ? error.message : String(error)}`, {
+			cause: error,
+			filePath
+		});
 	}
 }
 function convertCellToBlock$3(cell, index, idGenerator) {
@@ -1577,10 +1620,13 @@ async function readAndConvertMarimoFiles(inputFilePaths, options) {
 	} catch (err) {
 		const errorMessage = err instanceof Error ? err.message : String(err);
 		const errorStack = err instanceof Error ? err.stack : void 0;
-		throw new Error(`Failed to read or parse file ${basename(filePath)}: ${errorMessage}`, { cause: errorStack ? {
-			originalError: err,
-			stack: errorStack
-		} : err });
+		throw new FileReadError(`Failed to read or parse file ${basename(filePath)}: ${errorMessage}`, {
+			cause: errorStack ? {
+				originalError: err,
+				stack: errorStack
+			} : err,
+			filePath
+		});
 	}
 	return convertMarimoAppsToDeepnoteFile(apps, { projectName: options.projectName });
 }
@@ -1600,10 +1646,13 @@ async function convertMarimoFilesToDeepnoteFile(inputFilePaths, options) {
 	} catch (err) {
 		const errorMessage = err instanceof Error ? err.message : String(err);
 		const errorStack = err instanceof Error ? err.stack : void 0;
-		throw new Error(`Failed to read or parse file ${basename(filePath)}: ${errorMessage}`, { cause: errorStack ? {
-			originalError: err,
-			stack: errorStack
-		} : err });
+		throw new FileReadError(`Failed to read or parse file ${basename(filePath)}: ${errorMessage}`, {
+			cause: errorStack ? {
+				originalError: err,
+				stack: errorStack
+			} : err,
+			filePath
+		});
 	}
 	const yamlContent = stringify(convertMarimoAppsToDeepnoteFile(apps, { projectName: options.projectName }));
 	const parentDir = dirname(options.outputPath);
@@ -2115,4 +2164,4 @@ async function writeDeepnoteFile(options) {
 }
 
 //#endregion
-export { convertBlocksToJupyterNotebook as $, addContentHashes as A, convertBlocksToQuartoDocument as B, findSnapshotsForProject as C, parseSnapshotFilename as D, loadSnapshotFile as E, convertJupyterNotebooksToDeepnote as F, convertDeepnoteFileToPercentFiles as G, convertDeepnoteToQuartoDocuments as H, readAndConvertIpynbFiles as I, convertBlocksToMarimoApp as J, convertDeepnoteToPercentNotebooks as K, detectFormat as L, computeSnapshotHash as M, convertIpynbFilesToDeepnoteFile as N, parseSourceFilePath as O, convertJupyterNotebookToBlocks as P, convertBlockToJupyterCell as Q, isMarimoContent as R, mergeSnapshotIntoSource as S, loadLatestSnapshot as T, serializeQuartoFormat as U, convertDeepnoteFileToQuartoFiles as V, convertBlocksToPercentNotebook as W, convertDeepnoteToMarimoApps as X, convertDeepnoteFileToMarimoFiles as Y, serializeMarimoFormat as Z, generateSnapshotFilename as _, parseQuartoFormat as a, splitDeepnoteFile as b, convertPercentNotebookToBlocks as c, readAndConvertPercentFiles as d, convertDeepnoteFileToJupyterFiles as et, convertMarimoAppToBlocks as f, readAndConvertMarimoFiles as g, parseMarimoFormat as h, convertQuartoFilesToDeepnoteFile as i, computeContentHash as j, snapshotExists as k, convertPercentNotebooksToDeepnote as l, convertMarimoFilesToDeepnoteFile as m, convertQuartoDocumentToBlocks as n, readAndConvertQuartoFiles as o, convertMarimoAppsToDeepnote as p, serializePercentFormat as q, convertQuartoDocumentsToDeepnote as r, convertPercentFilesToDeepnoteFile as s, writeDeepnoteFile as t, convertDeepnoteToJupyterNotebooks as tt, parsePercentFormat as u, hasOutputs as v, getSnapshotDir as w, countBlocksWithOutputs as x, slugifyProjectName as y, isPercentContent as z };
+export { FileWriteError as $, addContentHashes as A, convertBlocksToQuartoDocument as B, findSnapshotsForProject as C, parseSnapshotFilename as D, loadSnapshotFile as E, convertJupyterNotebooksToDeepnote as F, convertDeepnoteFileToPercentFiles as G, convertDeepnoteToQuartoDocuments as H, readAndConvertIpynbFiles as I, convertBlocksToMarimoApp as J, convertDeepnoteToPercentNotebooks as K, detectFormat as L, computeSnapshotHash as M, convertIpynbFilesToDeepnoteFile as N, parseSourceFilePath as O, convertJupyterNotebookToBlocks as P, FileReadError as Q, isMarimoContent as R, mergeSnapshotIntoSource as S, loadLatestSnapshot as T, serializeQuartoFormat as U, convertDeepnoteFileToQuartoFiles as V, convertBlocksToPercentNotebook as W, convertDeepnoteToMarimoApps as X, convertDeepnoteFileToMarimoFiles as Y, serializeMarimoFormat as Z, generateSnapshotFilename as _, parseQuartoFormat as a, convertDeepnoteToJupyterNotebooks as at, splitDeepnoteFile as b, convertPercentNotebookToBlocks as c, readAndConvertPercentFiles as d, JsonParseError as et, convertMarimoAppToBlocks as f, readAndConvertMarimoFiles as g, parseMarimoFormat as h, convertQuartoFilesToDeepnoteFile as i, convertDeepnoteFileToJupyterFiles as it, computeContentHash as j, snapshotExists as k, convertPercentNotebooksToDeepnote as l, convertMarimoFilesToDeepnoteFile as m, convertQuartoDocumentToBlocks as n, convertBlockToJupyterCell as nt, readAndConvertQuartoFiles as o, convertMarimoAppsToDeepnote as p, serializePercentFormat as q, convertQuartoDocumentsToDeepnote as r, convertBlocksToJupyterNotebook as rt, convertPercentFilesToDeepnoteFile as s, writeDeepnoteFile as t, UnsupportedFormatError as tt, parsePercentFormat as u, hasOutputs as v, getSnapshotDir as w, countBlocksWithOutputs as x, slugifyProjectName as y, isPercentContent as z };

package/dist/{src-DfBtDvXJ.cjs → src-BR6PqlNA.cjs}

@@ -44,7 +44,7 @@ function createSortingKey(index) {
 	const maxLength = 6;
 	const chars = "0123456789abcdefghijklmnopqrstuvwxyz";
 	const base = 36;
-	if (index < 0) throw new Error("Index must be non-negative");
+	if (index < 0) throw new __deepnote_blocks.InvalidValueError("Index must be non-negative", { value: index });
 	let result = "";
 	let num = index + 1;
 	let iterations = 0;
@@ -54,7 +54,7 @@ function createSortingKey(index) {
 		num = Math.floor(num / base);
 		iterations++;
 	}
-	if (num > 0) throw new Error(`Index ${index} exceeds maximum key length of ${maxLength}`);
+	if (num > 0) throw new __deepnote_blocks.InvalidValueError(`Index ${index} exceeds maximum key length of ${maxLength}`, { value: index });
 	return result;
 }
 /**
@@ -250,6 +250,43 @@ function convertNotebookToJupyter(deepnoteFile, notebook) {
 	});
 }
 
+//#endregion
+//#region src/errors.ts
+/**
+* Thrown when a file cannot be read from disk.
+*/
+var FileReadError = class extends __deepnote_blocks.DeepnoteError {
+	filePath;
+	constructor(message, options) {
+		super(message, options);
+		this.filePath = options.filePath;
+	}
+};
+/**
+* Thrown when a file cannot be written to disk.
+*/
+var FileWriteError = class extends __deepnote_blocks.DeepnoteError {
+	filePath;
+	constructor(message, options) {
+		super(message, options);
+		this.filePath = options.filePath;
+	}
+};
+/**
+* Thrown when JSON parsing fails.
+*/
+var JsonParseError = class extends __deepnote_blocks.ParseError {};
+/**
+* Thrown when a file format is not supported.
+*/
+var UnsupportedFormatError = class extends __deepnote_blocks.DeepnoteError {
+	filename;
+	constructor(message, options) {
+		super(message, options);
+		this.filename = options?.filename;
+	}
+};
+
 //#endregion
 //#region src/deepnote-to-marimo.ts
 /** Current Marimo version for generated files */
@@ -364,8 +401,10 @@ async function convertDeepnoteFileToMarimoFiles(deepnoteFilePath, options) {
 			const content = serializeMarimoFormat(app);
 			await node_fs_promises.default.writeFile(filePath, content, "utf-8");
 		} catch (err) {
-			const errorMessage = err instanceof Error ? err.message : String(err);
-			throw new Error(`Failed to write ${filename}: ${errorMessage}`, { cause: err });
+			throw new FileWriteError(`Failed to write ${filename}: ${err instanceof Error ? err.message : String(err)}`, {
+				cause: err,
+				filePath
+			});
 		}
 	}
 }
@@ -725,12 +764,12 @@ function detectFormat(filename, content) {
 	if (lowercaseFilename.endsWith(".deepnote")) return "deepnote";
 	if (lowercaseFilename.endsWith(".qmd")) return "quarto";
 	if (lowercaseFilename.endsWith(".py")) {
-		if (!content) throw new Error("Content is required to detect format for .py files");
+		if (!content) throw new UnsupportedFormatError("Content is required to detect format for .py files", { filename });
 		if (isMarimoContent(content)) return "marimo";
 		if (isPercentContent(content)) return "percent";
-		throw new Error("Unsupported Python file format. File must be percent format (# %%) or Marimo (@app.cell).");
+		throw new UnsupportedFormatError("Unsupported Python file format. File must be percent format (# %%) or Marimo (@app.cell).", { filename });
 	}
-	throw new Error(`Unsupported file format: ${filename}`);
+	throw new UnsupportedFormatError(`Unsupported file format: ${filename}`, { filename });
 }
 
 //#endregion
@@ -847,14 +886,18 @@ async function parseIpynbFile(filePath) {
 	try {
 		ipynbJson = await node_fs_promises.default.readFile(filePath, "utf-8");
 	} catch (error) {
-		const message = error instanceof Error ? error.message : String(error);
-		throw new Error(`Failed to read ${filePath}: ${message}`);
+		throw new FileReadError(`Failed to read ${filePath}: ${error instanceof Error ? error.message : String(error)}`, {
+			cause: error,
+			filePath
+		});
 	}
 	try {
 		return JSON.parse(ipynbJson);
 	} catch (error) {
-		const message = error instanceof Error ? error.message : String(error);
-		throw new Error(`Failed to parse ${filePath}: invalid JSON - ${message}`);
+		throw new JsonParseError(`Failed to parse ${filePath}: invalid JSON - ${error instanceof Error ? error.message : String(error)}`, {
+			cause: error,
+			filePath
+		});
 	}
 }
 function convertCellToBlock$3(cell, index, idGenerator) {
@@ -1605,10 +1648,13 @@ async function readAndConvertMarimoFiles(inputFilePaths, options) {
 	} catch (err) {
 		const errorMessage = err instanceof Error ? err.message : String(err);
 		const errorStack = err instanceof Error ? err.stack : void 0;
-		throw new Error(`Failed to read or parse file ${(0, node_path.basename)(filePath)}: ${errorMessage}`, { cause: errorStack ? {
-			originalError: err,
-			stack: errorStack
-		} : err });
+		throw new FileReadError(`Failed to read or parse file ${(0, node_path.basename)(filePath)}: ${errorMessage}`, {
+			cause: errorStack ? {
+				originalError: err,
+				stack: errorStack
+			} : err,
+			filePath
+		});
 	}
 	return convertMarimoAppsToDeepnoteFile(apps, { projectName: options.projectName });
 }
@@ -1628,10 +1674,13 @@ async function convertMarimoFilesToDeepnoteFile(inputFilePaths, options) {
 	} catch (err) {
 		const errorMessage = err instanceof Error ? err.message : String(err);
 		const errorStack = err instanceof Error ? err.stack : void 0;
-		throw new Error(`Failed to read or parse file ${(0, node_path.basename)(filePath)}: ${errorMessage}`, { cause: errorStack ? {
-			originalError: err,
-			stack: errorStack
-		} : err });
+		throw new FileReadError(`Failed to read or parse file ${(0, node_path.basename)(filePath)}: ${errorMessage}`, {
+			cause: errorStack ? {
+				originalError: err,
+				stack: errorStack
+			} : err,
+			filePath
+		});
 	}
 	const yamlContent = (0, yaml.stringify)(convertMarimoAppsToDeepnoteFile(apps, { projectName: options.projectName }));
 	const parentDir = (0, node_path.dirname)(options.outputPath);
@@ -2143,6 +2192,30 @@ async function writeDeepnoteFile(options) {
 }
 
 //#endregion
+Object.defineProperty(exports, 'FileReadError', {
+  enumerable: true,
+  get: function () {
+    return FileReadError;
+  }
+});
+Object.defineProperty(exports, 'FileWriteError', {
+  enumerable: true,
+  get: function () {
+    return FileWriteError;
+  }
+});
+Object.defineProperty(exports, 'JsonParseError', {
+  enumerable: true,
+  get: function () {
+    return JsonParseError;
+  }
+});
+Object.defineProperty(exports, 'UnsupportedFormatError', {
+  enumerable: true,
+  get: function () {
+    return UnsupportedFormatError;
+  }
+});
 Object.defineProperty(exports, '__toESM', {
   enumerable: true,
   get: function () {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deepnote/convert",
-  "version": "2.3.1",
+  "version": "3.0.0",
   "description": "",
   "keywords": [],
   "repository": {
@@ -34,7 +34,7 @@
     "cleye": "^2.0.0",
     "ora": "^9.0.0",
     "yaml": "^2.8.1",
-    "@deepnote/blocks": "3.2.1"
+    "@deepnote/blocks": "4.0.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",