@n24q02m/better-notion-mcp 1.0.0

package/build/src/tools/composite/pages.js

@@ -0,0 +1,316 @@
+/**
+ * Pages Mega Tool
+ * All page operations in one unified interface
+ */
+import { NotionMCPError, withErrorHandling } from '../helpers/errors.js';
+import { blocksToMarkdown, markdownToBlocks } from '../helpers/markdown.js';
+import { autoPaginate } from '../helpers/pagination.js';
+import { convertToNotionProperties } from '../helpers/properties.js';
+import * as RichText from '../helpers/richtext.js';
+/**
+ * Unified pages tool - handles all page operations
+ */
+export async function pages(notion, input) {
+    return withErrorHandling(async () => {
+        switch (input.action) {
+            case 'create':
+                return await createPage(notion, input);
+            case 'get':
+                return await getPage(notion, input);
+            case 'update':
+                return await updatePage(notion, input);
+            case 'archive':
+            case 'restore':
+                return await archivePage(notion, input);
+            case 'duplicate':
+                return await duplicatePage(notion, input);
+            default:
+                throw new NotionMCPError(`Unknown action: ${input.action}`, 'VALIDATION_ERROR', 'Supported actions: create, get, update, archive, restore, move, duplicate');
+        }
+    })();
+}
+/**
+ * Create page with title and content
+ * Maps to: POST /v1/pages + PATCH /v1/blocks/{id}/children
+ */
+async function createPage(notion, input) {
+    if (!input.title) {
+        throw new NotionMCPError('title is required for create action', 'VALIDATION_ERROR', 'Provide page title');
+    }
+    if (!input.parent_id) {
+        throw new NotionMCPError('parent_id is required for page creation', 'VALIDATION_ERROR', 'Integration tokens cannot create workspace-level pages. Provide parent_id (database or page ID).');
+    }
+    const normalizedId = input.parent_id.replace(/-/g, '');
+    // Auto-detect parent type
+    let parent;
+    if (input.properties && Object.keys(input.properties).length > 0) {
+        parent = { type: 'database_id', database_id: normalizedId };
+    }
+    else {
+        parent = { type: 'page_id', page_id: normalizedId };
+    }
+    // Prepare properties
+    let properties = {};
+    if (parent.database_id) {
+        properties = convertToNotionProperties(input.properties || {});
+        if (!properties.title && !properties.Name && !properties.Title) {
+            properties.Name = { title: [RichText.text(input.title)] };
+        }
+    }
+    else {
+        properties = { title: { title: [RichText.text(input.title)] } };
+    }
+    const pageData = { parent, properties };
+    if (input.icon)
+        pageData.icon = { type: 'emoji', emoji: input.icon };
+    if (input.cover)
+        pageData.cover = { type: 'external', external: { url: input.cover } };
+    const page = await notion.pages.create(pageData);
+    // Add content if provided
+    if (input.content) {
+        const blocks = markdownToBlocks(input.content);
+        if (blocks.length > 0) {
+            await notion.blocks.children.append({
+                block_id: page.id,
+                children: blocks
+            });
+        }
+    }
+    return {
+        action: 'create',
+        page_id: page.id,
+        url: page.url,
+        created: true
+    };
+}
+/**
+ * Get page with full content as markdown
+ * Maps to: GET /v1/pages/{id} + GET /v1/blocks/{id}/children
+ */
+async function getPage(notion, input) {
+    if (!input.page_id) {
+        throw new NotionMCPError('page_id is required for get action', 'VALIDATION_ERROR', 'Provide page_id');
+    }
+    const page = await notion.pages.retrieve({ page_id: input.page_id });
+    // Get all blocks with auto-pagination
+    const blocks = await autoPaginate((cursor) => notion.blocks.children.list({
+        block_id: input.page_id,
+        start_cursor: cursor,
+        page_size: 100
+    }));
+    const markdown = blocksToMarkdown(blocks);
+    // Extract properties
+    const properties = {};
+    for (const [key, prop] of Object.entries(page.properties)) {
+        const p = prop;
+        if (p.type === 'title' && p.title) {
+            properties[key] = p.title.map((t) => t.plain_text).join('');
+        }
+        else if (p.type === 'rich_text' && p.rich_text) {
+            properties[key] = p.rich_text.map((t) => t.plain_text).join('');
+        }
+        else if (p.type === 'select' && p.select) {
+            properties[key] = p.select.name;
+        }
+        else if (p.type === 'multi_select' && p.multi_select) {
+            properties[key] = p.multi_select.map((s) => s.name);
+        }
+        else if (p.type === 'number') {
+            properties[key] = p.number;
+        }
+        else if (p.type === 'checkbox') {
+            properties[key] = p.checkbox;
+        }
+        else if (p.type === 'url') {
+            properties[key] = p.url;
+        }
+        else if (p.type === 'email') {
+            properties[key] = p.email;
+        }
+        else if (p.type === 'phone_number') {
+            properties[key] = p.phone_number;
+        }
+        else if (p.type === 'date' && p.date) {
+            properties[key] = p.date.start + (p.date.end ? ` to ${p.date.end}` : '');
+        }
+    }
+    return {
+        action: 'get',
+        page_id: page.id,
+        url: page.url,
+        created_time: page.created_time,
+        last_edited_time: page.last_edited_time,
+        archived: page.archived,
+        properties,
+        content: markdown,
+        block_count: blocks.length
+    };
+}
+/**
+ * Update page content/properties
+ * Maps to: PATCH /v1/pages/{id} + PATCH /v1/blocks/{id}/children
+ */
+async function updatePage(notion, input) {
+    if (!input.page_id) {
+        throw new NotionMCPError('page_id is required for update action', 'VALIDATION_ERROR', 'Provide page_id');
+    }
+    const updates = {};
+    // Update metadata
+    if (input.icon)
+        updates.icon = { type: 'emoji', emoji: input.icon };
+    if (input.cover)
+        updates.cover = { type: 'external', external: { url: input.cover } };
+    if (input.archived !== undefined)
+        updates.archived = input.archived;
+    // Update properties
+    if (input.properties || input.title) {
+        updates.properties = {};
+        if (input.title) {
+            updates.properties.title = { title: [RichText.text(input.title)] };
+        }
+        if (input.properties) {
+            const converted = convertToNotionProperties(input.properties);
+            updates.properties = { ...updates.properties, ...converted };
+        }
+    }
+    // Update page if we have metadata/property changes
+    if (Object.keys(updates).length > 0) {
+        await notion.pages.update({
+            page_id: input.page_id,
+            ...updates
+        });
+    }
+    // Handle content updates
+    if (input.content || input.append_content || input.prepend_content) {
+        if (input.content) {
+            // Replace all content
+            const existingBlocks = await autoPaginate((cursor) => notion.blocks.children.list({
+                block_id: input.page_id,
+                start_cursor: cursor,
+                page_size: 100
+            }));
+            for (const block of existingBlocks) {
+                await notion.blocks.delete({ block_id: block.id });
+            }
+            const newBlocks = markdownToBlocks(input.content);
+            if (newBlocks.length > 0) {
+                await notion.blocks.children.append({
+                    block_id: input.page_id,
+                    children: newBlocks
+                });
+            }
+        }
+        else if (input.append_content) {
+            const blocks = markdownToBlocks(input.append_content);
+            if (blocks.length > 0) {
+                await notion.blocks.children.append({
+                    block_id: input.page_id,
+                    children: blocks
+                });
+            }
+        }
+        else if (input.prepend_content) {
+            const existingBlocks = await autoPaginate((cursor) => notion.blocks.children.list({
+                block_id: input.page_id,
+                start_cursor: cursor,
+                page_size: 1
+            }));
+            const newBlocks = markdownToBlocks(input.prepend_content);
+            if (newBlocks.length > 0) {
+                const firstBlockId = existingBlocks[0]?.id;
+                if (firstBlockId) {
+                    await notion.blocks.children.append({
+                        block_id: input.page_id,
+                        children: newBlocks,
+                        after: undefined
+                    });
+                }
+                else {
+                    await notion.blocks.children.append({
+                        block_id: input.page_id,
+                        children: newBlocks
+                    });
+                }
+            }
+        }
+    }
+    return {
+        action: 'update',
+        page_id: input.page_id,
+        updated: true
+    };
+}
+/**
+ * Archive or restore page
+ * Maps to: PATCH /v1/pages/{id}
+ */
+async function archivePage(notion, input) {
+    const pageIds = input.page_ids || (input.page_id ? [input.page_id] : []);
+    if (pageIds.length === 0) {
+        throw new NotionMCPError('page_id or page_ids required', 'VALIDATION_ERROR', 'Provide at least one page ID');
+    }
+    const archived = input.action === 'archive';
+    const results = [];
+    for (const pageId of pageIds) {
+        await notion.pages.update({
+            page_id: pageId,
+            archived
+        });
+        results.push({ page_id: pageId, archived });
+    }
+    return {
+        action: input.action,
+        processed: results.length,
+        results
+    };
+}
+/**
+ * Move page to new parent
+ * Maps to: PATCH /v1/pages/{id}
+ */
+/**
+ * Duplicate page
+ * Maps to: GET /v1/pages/{id} + POST /v1/pages + GET/PATCH /v1/blocks
+ */
+async function duplicatePage(notion, input) {
+    const pageIds = input.page_ids || (input.page_id ? [input.page_id] : []);
+    if (pageIds.length === 0) {
+        throw new NotionMCPError('page_id or page_ids required', 'VALIDATION_ERROR', 'Provide at least one page ID');
+    }
+    const results = [];
+    for (const pageId of pageIds) {
+        // Get original page
+        const originalPage = await notion.pages.retrieve({ page_id: pageId });
+        // Get original content
+        const originalBlocks = await autoPaginate((cursor) => notion.blocks.children.list({
+            block_id: pageId,
+            start_cursor: cursor,
+            page_size: 100
+        }));
+        // Create duplicate
+        const duplicatePage = await notion.pages.create({
+            parent: originalPage.parent,
+            properties: originalPage.properties,
+            icon: originalPage.icon,
+            cover: originalPage.cover
+        });
+        // Copy content
+        if (originalBlocks.length > 0) {
+            await notion.blocks.children.append({
+                block_id: duplicatePage.id,
+                children: originalBlocks
+            });
+        }
+        results.push({
+            original_id: pageId,
+            duplicate_id: duplicatePage.id,
+            url: duplicatePage.url
+        });
+    }
+    return {
+        action: 'duplicate',
+        processed: results.length,
+        results
+    };
+}
+//# sourceMappingURL=pages.js.map

package/build/src/tools/composite/pages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages.js","sourceRoot":"","sources":["../../../../src/tools/composite/pages.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AACxE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAA;AACpE,OAAO,KAAK,QAAQ,MAAM,wBAAwB,CAAA;AAuBlD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,MAAc,EACd,KAAiB;IAEjB,OAAO,iBAAiB,CAAC,KAAK,IAAI,EAAE;QAClC,QAAQ,KAAK,CAAC,MAAM,EAAE,CAAC;YACrB,KAAK,QAAQ;gBACX,OAAO,MAAM,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;YAExC,KAAK,KAAK;gBACR,OAAO,MAAM,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;YAErC,KAAK,QAAQ;gBACX,OAAO,MAAM,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;YAExC,KAAK,SAAS,CAAC;YACf,KAAK,SAAS;gBACZ,OAAO,MAAM,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;YAEzC,KAAK,WAAW;gBACd,OAAO,MAAM,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;YAE3C;gBACE,MAAM,IAAI,cAAc,CACtB,mBAAmB,KAAK,CAAC,MAAM,EAAE,EACjC,kBAAkB,EAClB,2EAA2E,CAC5E,CAAA;QACL,CAAC;IACH,CAAC,CAAC,EAAE,CAAA;AACN,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,UAAU,CAAC,MAAc,EAAE,KAAiB;IACzD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,IAAI,cAAc,CAAC,qCAAqC,EAAE,kBAAkB,EAAE,oBAAoB,CAAC,CAAA;IAC3G,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QACrB,MAAM,IAAI,cAAc,CACtB,yCAAyC,EACzC,kBAAkB,EAClB,kGAAkG,CACnG,CAAA;IACH,CAAC;IAED,MAAM,YAAY,GAAG,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IAEtD,0BAA0B;IAC1B,IAAI,MAAW,CAAA;IACf,IAAI,KAAK,CAAC,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjE,MAAM,GAAG,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,CAAA;IAC7D,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,CAAA;IACrD,CAAC;IAED,qBAAqB;IACrB,IAAI,UAAU,GAAQ,EAAE,CAAA;IACxB,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,UAAU,GAAG,yBAAyB,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,CAAA;QAC9D,IAAI,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;YAC/D,UAAU,CAAC,IAAI,GAAG,EAAE,KAAK,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAA;QAC3D,CAAC;IACH,CAAC;SAAM,CAAC;QACN,UAAU,GAAG,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAA;IACjE,CAAC;IAED,MAAM,QAAQ,GAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,CAAA;IAC5C,IAAI,KAAK,CAAC,IAAI;QAAE,QAAQ,CAAC,IAAI,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,CAAA;IACpE,IAAI,KAAK,CAAC,KAAK;QAAE,QAAQ,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,KAAK,EAAE,EAAE,CAAA;IAEtF,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IAEhD,0BAA0B;IAC1B,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAC9C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAClC,QAAQ,EAAE,IAAI,CAAC,EAAE;gBACjB,QAAQ,EAAE,MAAa;aACxB,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED,OAAO;QACL,MAAM,EAAE,QAAQ;QAChB,OAAO,EAAE,IAAI,CAAC,EAAE;QAChB,GAAG,EAAG,IAAY,CAAC,GAAG;QACtB,OAAO,EAAE,IAAI;KACd,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,OAAO,CAAC,MAAc,EAAE,KAAiB;IACtD,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,IAAI,cAAc,CAAC,oCAAoC,EAAE,kBAAkB,EAAE,iBAAiB,CAAC,CAAA;IACvG,CAAC;IAED,MAAM,IAAI,GAAQ,MAAM,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;IAEzE,sCAAsC;IACtC,MAAM,MAAM,GAAG,MAAM,YAAY,CAC/B,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QACtC,QAAQ,EAAE,KAAK,CAAC,OAAQ;QACxB,YAAY,EAAE,MAAM;QACpB,SAAS,EAAE,GAAG;KACf,CAAC,CACH,CAAA;IAED,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAa,CAAC,CAAA;IAEhD,qBAAqB;IACrB,MAAM,UAAU,GAAQ,EAAE,CAAA;IAC1B,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1D,MAAM,CAAC,GAAG,IAAW,CAAA;QACrB,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;YAClC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAClE,CAAC;aAAM,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;YACjD,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACtE,CAAC;aAAM,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;YAC3C,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAA;QACjC,CAAC;aAAM,IAAI,CAAC,CAAC,IAAI,KAAK,cAAc,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC;YACvD,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QAC1D,CAAC;aAAM,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC/B,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAA;QAC5B,CAAC;aAAM,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACjC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAA;QAC9B,CAAC;aAAM,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YAC5B,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAA;QACzB,CAAC;aAAM,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC9B,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,CAAA;QAC3B,CAAC;aAAM,IAAI,CAAC,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YACrC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,YAAY,CAAA;QAClC,CAAC;aAAM,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YACvC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;QAC1E,CAAC;IACH,CAAC;IAED,OAAO;QACL,MAAM,EAAE,KAAK;QACb,OAAO,EAAE,IAAI,CAAC,EAAE;QAChB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,UAAU;QACV,OAAO,EAAE,QAAQ;QACjB,WAAW,EAAE,MAAM,CAAC,MAAM;KAC3B,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,UAAU,CAAC,MAAc,EAAE,KAAiB;IACzD,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,IAAI,cAAc,CAAC,uCAAuC,EAAE,kBAAkB,EAAE,iBAAiB,CAAC,CAAA;IAC1G,CAAC;IAED,MAAM,OAAO,GAAQ,EAAE,CAAA;IAEvB,kBAAkB;IAClB,IAAI,KAAK,CAAC,IAAI;QAAE,OAAO,CAAC,IAAI,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,CAAA;IACnE,IAAI,KAAK,CAAC,KAAK;QAAE,OAAO,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,KAAK,EAAE,EAAE,CAAA;IACrF,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAA;IAEnE,oBAAoB;IACpB,IAAI,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QACpC,OAAO,CAAC,UAAU,GAAG,EAAE,CAAA;QAEvB,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,KAAK,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAA;QACpE,CAAC;QAED,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,SAAS,GAAG,yBAAyB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;YAC7D,OAAO,CAAC,UAAU,GAAG,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,GAAG,SAAS,EAAE,CAAA;QAC9D,CAAC;IACH,CAAC;IAED,mDAAmD;IACnD,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,MAAM,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;YACxB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,GAAG,OAAO;SACX,CAAC,CAAA;IACJ,CAAC;IAED,yBAAyB;IACzB,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,cAAc,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;QACnE,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClB,sBAAsB;YACtB,MAAM,cAAc,GAAG,MAAM,YAAY,CACvC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;gBACtC,QAAQ,EAAE,KAAK,CAAC,OAAQ;gBACxB,YAAY,EAAE,MAAM;gBACpB,SAAS,EAAE,GAAG;aACf,CAAC,CACH,CAAA;YAED,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;gBACnC,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAA;YACpD,CAAC;YAED,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;YACjD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,MAAM,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;oBAClC,QAAQ,EAAE,KAAK,CAAC,OAAO;oBACvB,QAAQ,EAAE,SAAgB;iBAC3B,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;YAChC,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,cAAc,CAAC,CAAA;YACrD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtB,MAAM,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;oBAClC,QAAQ,EAAE,KAAK,CAAC,OAAO;oBACvB,QAAQ,EAAE,MAAa;iBACxB,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;YACjC,MAAM,cAAc,GAAG,MAAM,YAAY,CACvC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;gBACtC,QAAQ,EAAE,KAAK,CAAC,OAAQ;gBACxB,YAAY,EAAE,MAAM;gBACpB,SAAS,EAAE,CAAC;aACb,CAAC,CACH,CAAA;YAED,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAA;YACzD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,MAAM,YAAY,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE,CAAA;gBAC1C,IAAI,YAAY,EAAE,CAAC;oBACjB,MAAM,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;wBAClC,QAAQ,EAAE,KAAK,CAAC,OAAO;wBACvB,QAAQ,EAAE,SAAgB;wBAC1B,KAAK,EAAE,SAAS;qBACjB,CAAC,CAAA;gBACJ,CAAC;qBAAM,CAAC;oBACN,MAAM,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;wBAClC,QAAQ,EAAE,KAAK,CAAC,OAAO;wBACvB,QAAQ,EAAE,SAAgB;qBAC3B,CAAC,CAAA;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,MAAM,EAAE,QAAQ;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,OAAO,EAAE,IAAI;KACd,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,WAAW,CAAC,MAAc,EAAE,KAAiB;IAC1D,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IAExE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,cAAc,CAAC,8BAA8B,EAAE,kBAAkB,EAAE,8BAA8B,CAAC,CAAA;IAC9G,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,KAAK,SAAS,CAAA;IAC3C,MAAM,OAAO,GAAG,EAAE,CAAA;IAElB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;YACxB,OAAO,EAAE,MAAM;YACf,QAAQ;SACT,CAAC,CAAA;QACF,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAA;IAC7C,CAAC;IAED,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,SAAS,EAAE,OAAO,CAAC,MAAM;QACzB,OAAO;KACR,CAAA;AACH,CAAC;AAED;;;GAGG;AACH;;;GAGG;AACH,KAAK,UAAU,aAAa,CAAC,MAAc,EAAE,KAAiB;IAC5D,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IAExE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,cAAc,CAAC,8BAA8B,EAAE,kBAAkB,EAAE,8BAA8B,CAAC,CAAA;IAC9G,CAAC;IAED,MAAM,OAAO,GAAG,EAAE,CAAA;IAElB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,oBAAoB;QACpB,MAAM,YAAY,GAAQ,MAAM,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;QAE1E,uBAAuB;QACvB,MAAM,cAAc,GAAG,MAAM,YAAY,CACvC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;YACtC,QAAQ,EAAE,MAAM;YAChB,YAAY,EAAE,MAAM;YACpB,SAAS,EAAE,GAAG;SACf,CAAC,CACH,CAAA;QAED,mBAAmB;QACnB,MAAM,aAAa,GAAQ,MAAM,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;YACnD,MAAM,EAAE,YAAY,CAAC,MAAM;YAC3B,UAAU,EAAE,YAAY,CAAC,UAAU;YACnC,IAAI,EAAE,YAAY,CAAC,IAAI;YACvB,KAAK,EAAE,YAAY,CAAC,KAAK;SAC1B,CAAC,CAAA;QAEF,eAAe;QACf,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAClC,QAAQ,EAAE,aAAa,CAAC,EAAE;gBAC1B,QAAQ,EAAE,cAAqB;aAChC,CAAC,CAAA;QACJ,CAAC;QAED,OAAO,CAAC,IAAI,CAAC;YACX,WAAW,EAAE,MAAM;YACnB,YAAY,EAAE,aAAa,CAAC,EAAE;YAC9B,GAAG,EAAE,aAAa,CAAC,GAAG;SACvB,CAAC,CAAA;IACJ,CAAC;IAED,OAAO;QACL,MAAM,EAAE,WAAW;QACnB,SAAS,EAAE,OAAO,CAAC,MAAM;QACzB,OAAO;KACR,CAAA;AACH,CAAC"}

package/build/src/tools/composite/search.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Search Composite Tool
+ * Smart context-aware search across workspace
+ */
+import { Client } from '@notionhq/client';
+export interface SearchSmartInput {
+    query: string;
+    filter?: {
+        object?: 'page' | 'database';
+        property?: string;
+        value?: any;
+    };
+    sort?: {
+        direction: 'ascending' | 'descending';
+        timestamp: 'last_edited_time' | 'created_time';
+    };
+    limit?: number;
+}
+/**
+ * Smart search with context-aware ranking
+ */
+export declare function searchSmart(notion: Client, input: SearchSmartInput): Promise<any>;
+//# sourceMappingURL=search.d.ts.map

package/build/src/tools/composite/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../../src/tools/composite/search.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAIzC,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE;QACP,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,CAAA;QAC5B,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,KAAK,CAAC,EAAE,GAAG,CAAA;KACZ,CAAA;IACD,IAAI,CAAC,EAAE;QACL,SAAS,EAAE,WAAW,GAAG,YAAY,CAAA;QACrC,SAAS,EAAE,kBAAkB,GAAG,cAAc,CAAA;KAC/C,CAAA;IACD,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,GAAG,CAAC,CAmDd"}

package/build/src/tools/composite/search.js

@@ -0,0 +1,94 @@
+/**
+ * Search Composite Tool
+ * Smart context-aware search across workspace
+ */
+import { withErrorHandling } from '../helpers/errors.js';
+import * as RichText from '../helpers/richtext.js';
+/**
+ * Smart search with context-aware ranking
+ */
+export async function searchSmart(notion, input) {
+    return withErrorHandling(async () => {
+        const searchParams = {
+            query: input.query,
+            page_size: Math.min(input.limit || 100, 100)
+        };
+        if (input.filter) {
+            searchParams.filter = input.filter;
+        }
+        if (input.sort) {
+            searchParams.sort = input.sort;
+        }
+        const response = await notion.search(searchParams);
+        const results = response.results.map((item) => {
+            if (item.object === 'page') {
+                return {
+                    type: 'page',
+                    id: item.id,
+                    url: item.url,
+                    title: extractTitle(item),
+                    created_time: item.created_time,
+                    last_edited_time: item.last_edited_time,
+                    archived: item.archived,
+                    parent: formatParent(item.parent)
+                };
+            }
+            else if (item.object === 'database') {
+                return {
+                    type: 'database',
+                    id: item.id,
+                    url: item.url,
+                    title: extractDatabaseTitle(item),
+                    created_time: item.created_time,
+                    last_edited_time: item.last_edited_time,
+                    archived: item.archived,
+                    description: item.description
+                };
+            }
+            return item;
+        });
+        return {
+            query: input.query,
+            total_results: results.length,
+            has_more: response.has_more,
+            results
+        };
+    })();
+}
+/**
+ * Extract title from page
+ */
+function extractTitle(page) {
+    if (!page.properties)
+        return 'Untitled';
+    const titleProp = Object.values(page.properties).find((prop) => prop.type === 'title');
+    if (titleProp && titleProp.title && titleProp.title.length > 0) {
+        return RichText.extractPlainText(titleProp.title);
+    }
+    return 'Untitled';
+}
+/**
+ * Extract database title
+ */
+function extractDatabaseTitle(database) {
+    if (database.title && database.title.length > 0) {
+        return RichText.extractPlainText(database.title);
+    }
+    return 'Untitled Database';
+}
+/**
+ * Format parent information
+ */
+function formatParent(parent) {
+    if (parent.type === 'workspace') {
+        return { type: 'workspace' };
+    }
+    else if (parent.type === 'page_id') {
+        return { type: 'page', id: parent.page_id };
+    }
+    else if (parent.type === 'database_id') {
+        return { type: 'database', id: parent.database_id };
+    }
+    return parent;
+}
+//# sourceMappingURL=search.js.map

package/build/src/tools/composite/search.js.map

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

package/build/src/tools/composite/users.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Users Mega Tool
+ * All user operations in one unified interface
+ */
+import { Client } from '@notionhq/client';
+export interface UsersInput {
+    action: 'list' | 'get' | 'me' | 'from_workspace';
+    user_id?: string;
+}
+/**
+ * Unified users tool
+ * Maps to: GET /v1/users and GET /v1/users/{id} and GET /v1/users/me
+ */
+export declare function users(notion: Client, input: UsersInput): Promise<any>;
+//# sourceMappingURL=users.d.ts.map

package/build/src/tools/composite/users.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../../../src/tools/composite/users.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAIzC,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,gBAAgB,CAAA;IAChD,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;GAGG;AACH,wBAAsB,KAAK,CACzB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,GAAG,CAAC,CAmGd"}

package/build/src/tools/composite/users.js

@@ -0,0 +1,93 @@
+/**
+ * Users Mega Tool
+ * All user operations in one unified interface
+ */
+import { NotionMCPError, withErrorHandling } from '../helpers/errors.js';
+import { autoPaginate } from '../helpers/pagination.js';
+/**
+ * Unified users tool
+ * Maps to: GET /v1/users and GET /v1/users/{id} and GET /v1/users/me
+ */
+export async function users(notion, input) {
+    return withErrorHandling(async () => {
+        switch (input.action) {
+            case 'list': {
+                const usersList = await autoPaginate((cursor) => notion.users.list({
+                    start_cursor: cursor,
+                    page_size: 100
+                }));
+                return {
+                    action: 'list',
+                    total: usersList.length,
+                    users: usersList.map((user) => ({
+                        id: user.id,
+                        type: user.type,
+                        name: user.name || 'Unknown',
+                        avatar_url: user.avatar_url,
+                        email: user.type === 'person' ? user.person?.email : undefined
+                    }))
+                };
+            }
+            case 'get': {
+                if (!input.user_id) {
+                    throw new NotionMCPError('user_id required for get action', 'VALIDATION_ERROR', 'Provide user_id');
+                }
+                const user = await notion.users.retrieve({ user_id: input.user_id });
+                return {
+                    action: 'get',
+                    id: user.id,
+                    type: user.type,
+                    name: user.name || 'Unknown',
+                    avatar_url: user.avatar_url,
+                    email: user.type === 'person' ? user.person?.email : undefined
+                };
+            }
+            case 'me': {
+                const botUser = await notion.users.retrieve({ user_id: 'me' });
+                return {
+                    action: 'me',
+                    id: botUser.id,
+                    type: botUser.type,
+                    name: botUser.name || 'Bot',
+                    bot: botUser.bot
+                };
+            }
+            case 'from_workspace': {
+                // Alternative method: Search pages and extract user info from metadata
+                // This bypasses the permission issue with direct users.list() call
+                const searchResults = await notion.search({
+                    filter: { property: 'object', value: 'page' },
+                    page_size: 100
+                });
+                const usersMap = new Map();
+                for (const page of searchResults.results) {
+                    // Extract users from created_by and last_edited_by
+                    if (page.created_by) {
+                        usersMap.set(page.created_by.id, {
+                            id: page.created_by.id,
+                            type: page.created_by.object,
+                            source: 'page_metadata'
+                        });
+                    }
+                    if (page.last_edited_by) {
+                        usersMap.set(page.last_edited_by.id, {
+                            id: page.last_edited_by.id,
+                            type: page.last_edited_by.object,
+                            source: 'page_metadata'
+                        });
+                    }
+                }
+                const users = Array.from(usersMap.values());
+                return {
+                    action: 'from_workspace',
+                    total: users.length,
+                    users,
+                    note: 'Users extracted from accessible pages. Use "me" action for bot info, or share more pages for more users.'
+                };
+            }
+            default:
+                throw new NotionMCPError(`Unknown action: ${input.action}`, 'VALIDATION_ERROR', 'Supported actions: list, get, me, from_workspace');
+        }
+    })();
+}
+//# sourceMappingURL=users.js.map

package/build/src/tools/composite/users.js.map

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

package/build/src/tools/composite/workspace.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Workspace Mega Tool
+ * Workspace exploration and info
+ */
+import { Client } from '@notionhq/client';
+export interface WorkspaceInput {
+    action: 'info' | 'search';
+    query?: string;
+    filter?: {
+        object?: 'page' | 'data_source';
+        property?: string;
+        value?: any;
+    };
+    sort?: {
+        direction?: 'ascending' | 'descending';
+        timestamp?: 'last_edited_time' | 'created_time';
+    };
+    limit?: number;
+}
+/**
+ * Unified workspace tool
+ * Maps to: GET /v1/users/me and POST /v1/search
+ */
+export declare function workspace(notion: Client, input: WorkspaceInput): Promise<any>;
+//# sourceMappingURL=workspace.d.ts.map

package/build/src/tools/composite/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../../src/tools/composite/workspace.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAIzC,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAA;IAGzB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE;QACP,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa,CAAA;QAC/B,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,KAAK,CAAC,EAAE,GAAG,CAAA;KACZ,CAAA;IACD,IAAI,CAAC,EAAE;QACL,SAAS,CAAC,EAAE,WAAW,GAAG,YAAY,CAAA;QACtC,SAAS,CAAC,EAAE,kBAAkB,GAAG,cAAc,CAAA;KAChD,CAAA;IACD,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,GAAG,CAAC,CA2Ed"}