@lpenguin/notion-cli 1.0.0

package/dist/lib/csv.js

@@ -0,0 +1,262 @@
+/**
+ * CSV conversion utilities for Notion database rows.
+ *
+ * - Notion DB rows → CSV (export)
+ * - CSV → Notion DB row properties (import)
+ *
+ * Property type mapping:
+ *   title, rich_text    → string
+ *   number              → number
+ *   select              → string
+ *   multi_select        → semicolon-separated string
+ *   date                → ISO string (start / start|end for ranges)
+ *   checkbox            → "true" / "false"
+ *   url, email, phone   → string
+ *   formula             → computed string (read-only)
+ *   relation            → comma-separated page IDs
+ *   rollup              → computed string (read-only)
+ *   status              → string
+ *   people              → comma-separated user IDs
+ *   files               → comma-separated URLs
+ */
+import { stringify } from 'csv-stringify/sync';
+import { parse } from 'csv-parse/sync';
+import * as logger from '../utils/logger.js';
+/**
+ * Convert Notion database query results to CSV string.
+ */
+export function rowsToCsv(rows, propertyNames) {
+    const headers = ['_notion_id', ...propertyNames];
+    const records = rows.map((row) => {
+        const record = { _notion_id: row.id };
+        for (const prop of propertyNames) {
+            const value = row.properties[prop];
+            record[prop] = value !== undefined ? extractPropertyValue(value) : '';
+        }
+        return record;
+    });
+    return stringify(records, {
+        header: true,
+        columns: headers,
+    });
+}
+/**
+ * Parse CSV string into row objects for database import.
+ * Returns an array of { id?: string, properties: Record<string, string> }.
+ */
+export function csvToRows(csvContent) {
+    const records = parse(csvContent, {
+        columns: true,
+        skip_empty_lines: true,
+        trim: true,
+    });
+    return records.map((record) => {
+        const id = record['_notion_id'];
+        const properties = {};
+        for (const [key, value] of Object.entries(record)) {
+            if (key !== '_notion_id') {
+                properties[key] = value;
+            }
+        }
+        return {
+            id: id !== undefined && id !== '' ? id : undefined,
+            properties,
+        };
+    });
+}
+/**
+ * Build Notion property objects from CSV row values.
+ * Maps string values back to Notion property types.
+ */
+export function buildPropertyValue(type, value) {
+    if (value === '') {
+        return undefined;
+    }
+    switch (type) {
+        case 'title':
+            return {
+                title: [{ text: { content: value } }],
+            };
+        case 'rich_text':
+            return {
+                rich_text: [{ text: { content: value } }],
+            };
+        case 'number': {
+            const num = Number(value);
+            return Number.isNaN(num) ? undefined : { number: num };
+        }
+        case 'select':
+            return { select: { name: value } };
+        case 'multi_select':
+            return {
+                multi_select: value.split(';').map((v) => ({ name: v.trim() })),
+            };
+        case 'date': {
+            const parts = value.split('|');
+            const start = parts[0]?.trim();
+            const end = parts[1]?.trim();
+            if (start === undefined || start === '')
+                return undefined;
+            return {
+                date: {
+                    start,
+                    ...(end !== undefined && end !== '' ? { end } : {}),
+                },
+            };
+        }
+        case 'checkbox':
+            return { checkbox: value.toLowerCase() === 'true' };
+        case 'url':
+            return { url: value };
+        case 'email':
+            return { email: value };
+        case 'phone_number':
+            return { phone_number: value };
+        case 'relation':
+            return {
+                relation: value.split(',').map((id) => ({ id: id.trim() })),
+            };
+        case 'status':
+            return { status: { name: value } };
+        default:
+            logger.warn(`Unsupported property type for import: ${type}. Skipping.`);
+            return undefined;
+    }
+}
+/**
+ * Extract a human-readable string from a Notion property value.
+ */
+function extractPropertyValue(prop) {
+    const type = prop['type'];
+    if (type === undefined)
+        return JSON.stringify(prop);
+    switch (type) {
+        case 'title':
+            return extractRichText(prop['title']);
+        case 'rich_text':
+            return extractRichText(prop['rich_text']);
+        case 'number':
+            return prop['number'] !== null && prop['number'] !== undefined
+                ? String(prop['number'])
+                : '';
+        case 'select':
+            return extractName(prop['select']);
+        case 'multi_select':
+            return extractMultiSelect(prop['multi_select']);
+        case 'date':
+            return extractDate(prop['date']);
+        case 'checkbox':
+            return String(prop['checkbox'] ?? false);
+        case 'url':
+            return String(prop['url'] ?? '');
+        case 'email':
+            return String(prop['email'] ?? '');
+        case 'phone_number':
+            return String(prop['phone_number'] ?? '');
+        case 'formula':
+            return extractFormula(prop['formula']);
+        case 'relation':
+            return extractRelation(prop['relation']);
+        case 'rollup':
+            return extractRollup(prop['rollup']);
+        case 'status':
+            return extractName(prop['status']);
+        case 'people':
+            return extractPeople(prop['people']);
+        case 'files':
+            return extractFiles(prop['files']);
+        case 'created_time':
+            return String(prop['created_time'] ?? '');
+        case 'last_edited_time':
+            return String(prop['last_edited_time'] ?? '');
+        case 'created_by':
+            return extractName(prop['created_by']);
+        case 'last_edited_by':
+            return extractName(prop['last_edited_by']);
+        default:
+            return JSON.stringify(prop);
+    }
+}
+function extractRichText(val) {
+    if (!Array.isArray(val))
+        return '';
+    return val
+        .map((t) => t['plain_text'] ?? '')
+        .join('');
+}
+function extractName(val) {
+    if (val === null || val === undefined)
+        return '';
+    return val['name'] ?? '';
+}
+function extractMultiSelect(val) {
+    if (!Array.isArray(val))
+        return '';
+    return val
+        .map((s) => s['name'] ?? '')
+        .join(';');
+}
+function extractDate(val) {
+    if (val === null || val === undefined)
+        return '';
+    const d = val;
+    const start = d['start'] ?? '';
+    const end = d['end'];
+    return end !== undefined ? `${start}|${end}` : start;
+}
+function extractFormula(val) {
+    if (val === null || val === undefined)
+        return '';
+    const f = val;
+    const fType = f['type'];
+    if (fType !== undefined && f[fType] !== undefined) {
+        return String(f[fType]);
+    }
+    return '';
+}
+function extractRelation(val) {
+    if (!Array.isArray(val))
+        return '';
+    return val
+        .map((r) => r['id'] ?? '')
+        .join(',');
+}
+function extractRollup(val) {
+    if (val === null || val === undefined)
+        return '';
+    const r = val;
+    const rType = r['type'];
+    if (rType === 'array' && Array.isArray(r['array'])) {
+        return r['array'].map((item) => extractPropertyValue(item)).join(';');
+    }
+    if (rType !== undefined && r[rType] !== undefined) {
+        return String(r[rType]);
+    }
+    return '';
+}
+function extractPeople(val) {
+    if (!Array.isArray(val))
+        return '';
+    return val
+        .map((p) => p['id'] ?? '')
+        .join(',');
+}
+function extractFiles(val) {
+    if (!Array.isArray(val))
+        return '';
+    return val
+        .map((f) => {
+        const fType = f['type'];
+        if (fType === 'external') {
+            const external = f['external'];
+            return external?.['url'] ?? '';
+        }
+        if (fType === 'file') {
+            const file = f['file'];
+            return file?.['url'] ?? '';
+        }
+        return '';
+    })
+        .join(',');
+}
+//# sourceMappingURL=csv.js.map

package/dist/lib/csv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv.js","sourceRoot":"","sources":["../../src/lib/csv.ts"],"names":[],"mappings":"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"}

package/dist/lib/db-properties.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Shared helper to build Notion page properties from CSV values + database schema.
+ * Used by both `db insert` and `db update` commands.
+ */
+import type { GetDataSourceResponse } from '@notionhq/client';
+export type SchemaProperties = GetDataSourceResponse['properties'];
+/**
+ * Build Notion page properties from CSV values + schema.
+ */
+export declare function buildNotionProperties(csvProps: Record<string, string>, schema: SchemaProperties): Record<string, unknown>;
+//# sourceMappingURL=db-properties.d.ts.map

package/dist/lib/db-properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-properties.d.ts","sourceRoot":"","sources":["../../src/lib/db-properties.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAI9D,MAAM,MAAM,gBAAgB,GAAG,qBAAqB,CAAC,YAAY,CAAC,CAAC;AAEnE;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,MAAM,EAAE,gBAAgB,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBzB"}

package/dist/lib/db-properties.js

@@ -0,0 +1,25 @@
+/**
+ * Shared helper to build Notion page properties from CSV values + database schema.
+ * Used by both `db insert` and `db update` commands.
+ */
+import { buildPropertyValue } from './csv.js';
+import * as logger from '../utils/logger.js';
+/**
+ * Build Notion page properties from CSV values + schema.
+ */
+export function buildNotionProperties(csvProps, schema) {
+    const properties = {};
+    for (const [name, value] of Object.entries(csvProps)) {
+        const propSchema = schema[name];
+        if (propSchema === undefined) {
+            logger.warn(`Property "${name}" not found in database schema. Skipping.`);
+            continue;
+        }
+        const notionValue = buildPropertyValue(propSchema.type, value);
+        if (notionValue !== undefined) {
+            properties[name] = notionValue;
+        }
+    }
+    return properties;
+}
+//# sourceMappingURL=db-properties.js.map

package/dist/lib/db-properties.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-properties.js","sourceRoot":"","sources":["../../src/lib/db-properties.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAC;AAI7C;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAgC,EAChC,MAAwB;IAExB,MAAM,UAAU,GAA4B,EAAE,CAAC;IAE/C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,aAAa,IAAI,2CAA2C,CAAC,CAAC;YAC1E,SAAS;QACX,CAAC;QAED,MAAM,WAAW,GAAG,kBAAkB,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC/D,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,UAAU,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC;QACjC,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/lib/errors.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Custom error classes with structured error codes.
+ * All errors sanitize sensitive information (tokens, secrets).
+ */
+import { type ExitCodeValue } from './types.js';
+/** Base CLI error with structured code and exit code. */
+export declare class CliError extends Error {
+    readonly code: string;
+    readonly exitCode: ExitCodeValue;
+    readonly details?: unknown;
+    constructor(message: string, code: string, exitCode: ExitCodeValue, details?: unknown);
+}
+export declare class AuthError extends CliError {
+    constructor(message?: string);
+}
+export declare class ValidationError extends CliError {
+    constructor(message: string, details?: unknown);
+}
+export declare class NotFoundError extends CliError {
+    constructor(resource: string, id: string);
+}
+export declare class RateLimitError extends CliError {
+    readonly retryAfterMs: number;
+    constructor(retryAfterMs: number);
+}
+export declare class PatchConflictError extends CliError {
+    constructor(message?: string);
+}
+/**
+ * Convert any thrown value into a structured CliError.
+ * Handles Notion API errors, Zod validation errors, and unknown throws.
+ */
+export declare function toCliError(err: unknown): CliError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/lib/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAY,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAE1D,yDAAyD;AACzD,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEf,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,OAAO;CAOtF;AAED,qBAAa,SAAU,SAAQ,QAAQ;gBACzB,OAAO,SAA4D;CAIhF;AAED,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI/C;AAED,qBAAa,aAAc,SAAQ,QAAQ;gBAC7B,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM;CAIzC;AAED,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;gBAElB,YAAY,EAAE,MAAM;CASjC;AAED,qBAAa,kBAAmB,SAAQ,QAAQ;gBAClC,OAAO,SAAuE;CAI3F;AAcD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,QAAQ,CA+BjD"}

package/dist/lib/errors.js

@@ -0,0 +1,86 @@
+/**
+ * Custom error classes with structured error codes.
+ * All errors sanitize sensitive information (tokens, secrets).
+ */
+import { ExitCode } from './types.js';
+/** Base CLI error with structured code and exit code. */
+export class CliError extends Error {
+    code;
+    exitCode;
+    details;
+    constructor(message, code, exitCode, details) {
+        super(sanitizeMessage(message));
+        this.name = 'CliError';
+        this.code = code;
+        this.exitCode = exitCode;
+        this.details = details;
+    }
+}
+export class AuthError extends CliError {
+    constructor(message = 'Authentication failed. Set NOTION_TOKEN or use --token.') {
+        super(message, 'AUTH_ERROR', ExitCode.AUTH_ERROR);
+        this.name = 'AuthError';
+    }
+}
+export class ValidationError extends CliError {
+    constructor(message, details) {
+        super(message, 'VALIDATION_ERROR', ExitCode.VALIDATION_ERROR, details);
+        this.name = 'ValidationError';
+    }
+}
+export class NotFoundError extends CliError {
+    constructor(resource, id) {
+        super(`${resource} not found: ${id}`, 'NOT_FOUND', ExitCode.NOT_FOUND);
+        this.name = 'NotFoundError';
+    }
+}
+export class RateLimitError extends CliError {
+    retryAfterMs;
+    constructor(retryAfterMs) {
+        super(`Rate limited by Notion API. Retry after ${Math.ceil(retryAfterMs / 1000)}s.`, 'RATE_LIMITED', ExitCode.RATE_LIMITED);
+        this.name = 'RateLimitError';
+        this.retryAfterMs = retryAfterMs;
+    }
+}
+export class PatchConflictError extends CliError {
+    constructor(message = 'Patch cannot be applied: page content has changed since last read.') {
+        super(message, 'PATCH_CONFLICT', ExitCode.GENERAL_ERROR);
+        this.name = 'PatchConflictError';
+    }
+}
+/**
+ * Strip any token-like strings from error messages.
+ * Matches patterns: ntn_*, secret_*, Bearer *, and long hex strings.
+ */
+function sanitizeMessage(message) {
+    return message
+        .replace(/\b(ntn_[A-Za-z0-9_-]+)\b/g, '[REDACTED]')
+        .replace(/\b(secret_[A-Za-z0-9_-]+)\b/g, '[REDACTED]')
+        .replace(/Bearer\s+[A-Za-z0-9_-]+/g, 'Bearer [REDACTED]')
+        .replace(/\b[a-f0-9]{40,}\b/gi, '[REDACTED]');
+}
+/**
+ * Convert any thrown value into a structured CliError.
+ * Handles Notion API errors, Zod validation errors, and unknown throws.
+ */
+export function toCliError(err) {
+    if (err instanceof CliError) {
+        return err;
+    }
+    if (err instanceof Error) {
+        // Notion API error shape
+        const notionErr = err;
+        if (notionErr.status === 401 || notionErr.code === 'unauthorized') {
+            return new AuthError();
+        }
+        if (notionErr.status === 404 || notionErr.code === 'object_not_found') {
+            return new NotFoundError('Resource', 'unknown');
+        }
+        if (notionErr.status === 429) {
+            return new RateLimitError(1000);
+        }
+        return new CliError(err.message, 'GENERAL_ERROR', ExitCode.GENERAL_ERROR);
+    }
+    return new CliError(String(err), 'GENERAL_ERROR', ExitCode.GENERAL_ERROR);
+}
+//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"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"}

package/dist/lib/file-upload.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Utilities for uploading files to Notion.
+ *
+ * Handles file:// URLs by uploading them to Notion's file storage
+ * and returning the file upload ID for use in blocks.
+ */
+import { type Client } from '@notionhq/client';
+/**
+ * Upload a local file to Notion.
+ *
+ * @param client - Notion client
+ * @param filePath - Local file path (without file:// prefix)
+ * @returns The file upload ID to use in blocks
+ */
+export declare function uploadFileToNotion(client: Client, filePath: string): Promise<string>;
+/**
+ * Check if a URL is a file:// URL.
+ */
+export declare function isFileUrl(url: string): boolean;
+/**
+ * Convert file:// URL to local file path.
+ * Handles both Unix and Windows paths.
+ */
+export declare function fileUrlToPath(url: string): string;
+//# sourceMappingURL=file-upload.d.ts.map

package/dist/lib/file-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-upload.d.ts","sourceRoot":"","sources":["../../src/lib/file-upload.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAO/C;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CA0CjB;AAwBD;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAiBjD"}

package/dist/lib/file-upload.js

@@ -0,0 +1,90 @@
+/**
+ * Utilities for uploading files to Notion.
+ *
+ * Handles file:// URLs by uploading them to Notion's file storage
+ * and returning the file upload ID for use in blocks.
+ */
+import {} from '@notionhq/client';
+import { readFileSync } from 'node:fs';
+import { basename } from 'node:path';
+import {} from '@notionhq/client/build/src/api-endpoints.js';
+import * as logger from '../utils/logger.js';
+import { withRateLimit } from './rate-limit.js';
+/**
+ * Upload a local file to Notion.
+ *
+ * @param client - Notion client
+ * @param filePath - Local file path (without file:// prefix)
+ * @returns The file upload ID to use in blocks
+ */
+export async function uploadFileToNotion(client, filePath) {
+    logger.debug(`Uploading file to Notion: ${filePath}`);
+    // Read file content
+    const fileContent = readFileSync(filePath);
+    const filename = basename(filePath);
+    // Determine content type based on file extension
+    const contentType = getContentType(filename);
+    // Create file upload
+    const uploadResponse = await withRateLimit(() => client.fileUploads.create({
+        mode: 'single_part',
+        filename,
+        content_type: contentType,
+    }), 'fileUploads.create');
+    logger.debug(`Created file upload with ID: ${uploadResponse.id}`);
+    // Send file content
+    // Convert Buffer to Blob
+    const blob = new Blob([fileContent], { type: contentType });
+    await withRateLimit(() => client.fileUploads.send({
+        file_upload_id: uploadResponse.id,
+        file: {
+            data: blob,
+            filename,
+        },
+    }), 'fileUploads.send');
+    logger.debug(`File uploaded successfully: ${uploadResponse.id}`);
+    return uploadResponse.id;
+}
+/**
+ * Determine MIME type from filename extension.
+ */
+function getContentType(filename) {
+    const ext = filename.toLowerCase().split('.').pop();
+    const mimeTypes = {
+        jpg: 'image/jpeg',
+        jpeg: 'image/jpeg',
+        png: 'image/png',
+        gif: 'image/gif',
+        webp: 'image/webp',
+        svg: 'image/svg+xml',
+        bmp: 'image/bmp',
+        ico: 'image/x-icon',
+        tiff: 'image/tiff',
+        tif: 'image/tiff',
+    };
+    return mimeTypes[ext ?? ''] ?? 'application/octet-stream';
+}
+/**
+ * Check if a URL is a file:// URL.
+ */
+export function isFileUrl(url) {
+    return url.startsWith('file://');
+}
+/**
+ * Convert file:// URL to local file path.
+ * Handles both Unix and Windows paths.
+ */
+export function fileUrlToPath(url) {
+    if (!isFileUrl(url)) {
+        return url;
+    }
+    // Remove file:// prefix
+    let path = url.slice(7);
+    // Handle Windows paths (file:///C:/path)
+    if (/^\/[A-Za-z]:/.test(path)) {
+        path = path.slice(1);
+    }
+    // Decode URL encoding
+    path = decodeURIComponent(path);
+    return path;
+}
+//# sourceMappingURL=file-upload.js.map

package/dist/lib/file-upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-upload.js","sourceRoot":"","sources":["../../src/lib/file-upload.ts"],"names":[],"mappings":"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"}

package/dist/lib/markdown.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Markdown conversion wrappers.
+ *
+ * - Markdown → Notion blocks: @tryfabric/martian
+ * - Notion → Markdown: notion-to-md (with unified converter)
+ *
+ * This module provides a clean interface over both libraries.
+ *
+ * IMPORTANT: All Notion→Markdown conversion uses `mdBlocksToMarkdown()`
+ * to ensure consistent output between `page read` and `page patch`.
+ */
+import { type MdBlock } from 'notion-to-md/build/types/index.js';
+import { type Client } from '@notionhq/client';
+import { type BlockObjectRequest } from '@notionhq/client/build/src/api-endpoints.js';
+import { type BlockLineMapResult } from './types.js';
+export type { MdBlock } from 'notion-to-md/build/types/index.js';
+/**
+ * Convert a Markdown string to an array of Notion block objects.
+ * Uses @tryfabric/martian for the conversion.
+ */
+export declare function markdownToNotionBlocks(markdown: string): BlockObjectRequest[];
+/**
+ * Process blocks and upload any file:// images to Notion.
+ * Returns modified blocks with uploaded file IDs.
+ */
+export declare function processImageUploads(client: Client, blocks: BlockObjectRequest[]): Promise<BlockObjectRequest[]>;
+/**
+ * Unified MdBlock to Markdown converter.
+ *
+ * Converts MdBlocks to markdown while tracking which lines each block contributes.
+ * This is the SINGLE source of truth for Notion→Markdown conversion.
+ *
+ * Used by both `page read` and `page patch` to ensure consistent line numbers.
+ *
+ * @param blocks - Array of MdBlocks from notion-to-md
+ * @returns The markdown string and a mapping of blocks to line ranges
+ */
+export declare function mdBlocksToMarkdown(blocks: readonly MdBlock[]): BlockLineMapResult;
+/**
+ * Fetch a Notion page's content as MdBlocks (preserving block IDs).
+ * Used for surgical patching where we need to track block → line mappings.
+ */
+export declare function fetchPageMdBlocks(client: Client, pageId: string): Promise<MdBlock[]>;
+/**
+ * Fetch a Notion page's content and convert to Markdown.
+ * Uses the unified mdBlocksToMarkdown converter.
+ */
+export declare function notionPageToMarkdown(client: Client, pageId: string): Promise<string>;
+/**
+ * Clean raw Markdown output:
+ * - Trim leading/trailing whitespace
+ * - Collapse 3+ consecutive newlines into exactly 2
+ */
+export declare function cleanMarkdownOutput(raw: string): string;
+/**
+ * Recursively rewrite child_page blocks to paragraph so that
+ * toMarkdownString includes them in the output.
+ */
+export declare function fixChildPageBlocks(mdBlocks: MdBlock[]): void;
+/**
+ * Convert Markdown to numbered-line format for patch operations.
+ * Each line is prefixed with its 1-based line number.
+ *
+ * Example output:
+ *   1: # Hello World
+ *   2:
+ *   3: Some content here.
+ */
+export declare function addLineNumbers(markdown: string): string;
+/**
+ * Remove line numbers from numbered-line format.
+ * Strips the "N: " prefix from each line.
+ */
+export declare function stripLineNumbers(numbered: string): string;
+/**
+ * Extract the title (first H1) from Markdown content.
+ */
+export declare function extractTitle(markdown: string): string;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/lib/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/lib/markdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,KAAK,kBAAkB,EAA6D,MAAM,6CAA6C,CAAC;AACjJ,OAAO,EAAyB,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAM5E,YAAY,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AA6FjE;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAO7E;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,kBAAkB,EAAE,GAC3B,OAAO,CAAC,kBAAkB,EAAE,CAAC,CA8C/B;AAGD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,kBAAkB,CA8BjF;AAwDD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,EAAE,CAAC,CAuCpB;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAS5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMvD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKzD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGrD"}