@mcp-monorepo/notion-query 1.1.0 → 1.3.0

package/dist/lib/parser.d.ts

@@ -0,0 +1,13 @@
+import { type DataSourceObjectResponse, type PageObjectResponse, type PartialDataSourceObjectResponse, type PartialPageObjectResponse } from '@notionhq/client';
+type SimplifiedPropertyValue = string | number | boolean | string[] | (string | number | boolean)[] | undefined;
+type SimplifiedPage = Record<string, SimplifiedPropertyValue>;
+type NotionPage = PageObjectResponse | PartialPageObjectResponse | PartialDataSourceObjectResponse | DataSourceObjectResponse;
+/**
+ * Takes an array of Notion page objects from the API and converts them into
+ * a simplified, flat array of key-value objects.
+ * @param pages The array of page objects from the Notion API response.
+ * @returns An array of simplified page objects.
+ */
+export declare const simplifyNotionPages: (pages: NotionPage[]) => SimplifiedPage[];
+export {};
+//# sourceMappingURL=parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/lib/parser.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,+BAA+B,EACpC,KAAK,yBAAyB,EAC/B,MAAM,kBAAkB,CAAA;AAEzB,KAAK,uBAAuB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EAAE,GAAG,SAAS,CAAA;AAG/G,KAAK,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAA;AAU7D,KAAK,UAAU,GACX,kBAAkB,GAClB,yBAAyB,GACzB,+BAA+B,GAC/B,wBAAwB,CAAA;AAsD5B;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,OAAO,UAAU,EAAE,KAAG,cAAc,EA8BvE,CAAA"}

package/dist/lib/parser.js

@@ -0,0 +1,88 @@
+// notion-query/lib/parser.ts
+/**
+ * Simplifies a single Notion property object into a more readable, simple value.
+ * @param prop The Notion property object.
+ * @returns A simplified value (string, number, boolean, array, etc.) or undefined.
+ */
+const simplifyPropertyValue = (prop) => {
+    switch (prop.type) {
+        case 'title':
+            return prop.title.map((t) => t.plain_text).join('');
+        case 'rich_text':
+            return prop.rich_text.map((t) => t.plain_text).join('');
+        case 'number':
+            return prop.number;
+        case 'checkbox':
+            return prop.checkbox;
+        case 'select':
+            return prop.select?.name;
+        case 'multi_select':
+            return prop.multi_select.map((s) => s.name);
+        case 'status':
+            return prop.status?.name;
+        case 'date': {
+            const date = prop.date;
+            if (!date)
+                return undefined;
+            return date.end ? `${date.start} to ${date.end}` : date.start;
+        }
+        case 'people':
+            return prop.people.map((p) => p.name ?? p.id);
+        case 'relation':
+            return prop.relation.map((r) => r.id);
+        case 'formula': {
+            const formula = prop.formula;
+            return formula[formula.type];
+        }
+        case 'rollup': {
+            const rollup = prop.rollup;
+            if (rollup.type === 'array' && rollup.array) {
+                return rollup.array.flatMap((item) => simplifyPropertyValue(item)).filter((p) => p !== undefined);
+            }
+            return rollup[rollup.type];
+        }
+        case 'url':
+            return prop.url;
+        case 'email':
+            return prop.email;
+        case 'phone_number':
+            return prop.phone_number;
+        default:
+            return undefined;
+    }
+};
+/**
+ * Takes an array of Notion page objects from the API and converts them into
+ * a simplified, flat array of key-value objects.
+ * @param pages The array of page objects from the Notion API response.
+ * @returns An array of simplified page objects.
+ */
+export const simplifyNotionPages = (pages) => {
+    return pages.map((page) => {
+        const simplifiedPage = {};
+        if ('icon' in page) {
+            if (page.icon?.type === 'emoji') {
+                simplifiedPage.icon = page.icon.emoji;
+            }
+            else if (page.icon?.type === 'external') {
+                simplifiedPage.icon = page.icon.external.url;
+            }
+        }
+        if ('cover' in page) {
+            if (page.cover?.type === 'external') {
+                simplifiedPage.cover = page.cover.external.url;
+            }
+            else if (page.cover?.type === 'file') {
+                simplifiedPage.cover = page.cover.file.url;
+            }
+        }
+        simplifiedPage.url = 'url' in page ? page.url : undefined;
+        if ('properties' in page && page.properties) {
+            for (const [propName, propValue] of Object.entries(page.properties)) {
+                simplifiedPage[propName] = simplifyPropertyValue(propValue);
+            }
+        }
+        return simplifiedPage;
+    });
+};
+//# sourceMappingURL=parser.js.map

package/dist/lib/parser.js.map

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

package/dist/lib/property-parser.d.ts

@@ -0,0 +1,23 @@
+import { type CreatePageParameters, type UpdatePageParameters } from '@notionhq/client';
+import { type DataSourceObjectResponse } from '@notionhq/client/build/src/api-endpoints.js';
+type DataSourceSchema = DataSourceObjectResponse['properties'];
+type NotionProperties = CreatePageParameters['properties'];
+type NotionUpdateProperties = UpdatePageParameters['properties'];
+/**
+ * Parses a flat properties object from the 'create-pages' tool input
+ * into the format required by the Notion API.
+ * @param properties - A flat key-value map of properties from the tool input.
+ * @param dataSourceSchema - The schema of the parent data source.
+ * @returns A Notion `CreatePageParameters['properties']` object.
+ */
+export declare function parsePropertiesForCreate(properties: Record<string, string | number | boolean | null>, dataSourceSchema?: DataSourceSchema): NotionProperties;
+/**
+ * Parses a flat properties object with special keys (e.g., 'date:deadline:start')
+ * from the 'update-page' tool input into the format required by the Notion API.
+ * @param properties - A flat key-value map with special-cased keys from the tool input [1].
+ * @param schema - The schema of the data source the page belongs to.
+ * @returns A Notion `NotionUpdateProperties` object.
+ */
+export declare function parsePropertiesForUpdate(properties: Record<string, string | number | boolean | null>, schema: DataSourceSchema): NotionUpdateProperties;
+export {};
+//# sourceMappingURL=property-parser.d.ts.map

package/dist/lib/property-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-parser.d.ts","sourceRoot":"","sources":["../../src/lib/property-parser.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,oBAAoB,EAAE,KAAK,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AACvF,OAAO,EAAE,KAAK,wBAAwB,EAAE,MAAM,6CAA6C,CAAA;AAE3F,KAAK,gBAAgB,GAAG,wBAAwB,CAAC,YAAY,CAAC,CAAA;AAC9D,KAAK,gBAAgB,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAA;AAC1D,KAAK,sBAAsB,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAA;AAEhE;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,EAC5D,gBAAgB,CAAC,EAAE,gBAAgB,GAClC,gBAAgB,CA2FlB;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,EAC5D,MAAM,EAAE,gBAAgB,GACvB,sBAAsB,CAoHxB"}

package/dist/lib/property-parser.js

@@ -0,0 +1,200 @@
+import { logger } from '@mcp-monorepo/shared';
+/**
+ * Parses a flat properties object from the 'create-pages' tool input
+ * into the format required by the Notion API.
+ * @param properties - A flat key-value map of properties from the tool input.
+ * @param dataSourceSchema - The schema of the parent data source.
+ * @returns A Notion `CreatePageParameters['properties']` object.
+ */
+export function parsePropertiesForCreate(properties, dataSourceSchema) {
+    const notionProperties = {};
+    // Find the name of the 'title' property from the schema, if it exists [11].
+    const titleSchemaKey = dataSourceSchema
+        ? Object.keys(dataSourceSchema).find((key) => dataSourceSchema[key]?.type === 'title')
+        : 'title';
+    for (const [key, value] of Object.entries(properties)) {
+        // eslint-disable-next-line no-restricted-syntax -- User input
+        if (value === null || value === undefined)
+            continue;
+        // For convenience, allow 'title' as a key and map it to the actual title property name [1].
+        if (key.toLowerCase() === 'title' && titleSchemaKey) {
+            notionProperties[titleSchemaKey] = {
+                title: [{ text: { content: String(value) } }],
+            };
+            continue;
+        }
+        // If no schema is available (e.g., for a workspace page), only the 'title' is valid [9].
+        if (!dataSourceSchema) {
+            if (key.toLowerCase() === 'title') {
+                notionProperties[key] = { title: [{ text: { content: String(value) } }] };
+            }
+            else {
+                logger.warn(`Skipping property "${key}"; only 'title' is allowed for pages not in a database.`);
+            }
+            continue;
+        }
+        const schema = dataSourceSchema[key];
+        if (!schema) {
+            logger.warn(`Skipping property "${key}" as it was not found in the data source schema.`);
+            continue;
+        }
+        // Format the property based on its type from the schema [11].
+        switch (schema.type) {
+            case 'title':
+                notionProperties[key] = { title: [{ text: { content: String(value) } }] };
+                break;
+            case 'rich_text':
+                notionProperties[key] = { rich_text: [{ text: { content: String(value) } }] };
+                break;
+            case 'number':
+                notionProperties[key] = { number: Number(value) };
+                break;
+            case 'select':
+                notionProperties[key] = { select: { name: String(value) } };
+                break;
+            case 'status':
+                notionProperties[key] = { status: { name: String(value) } };
+                break;
+            case 'multi_select':
+                notionProperties[key] = {
+                    multi_select: String(value)
+                        .split(',')
+                        .map((name) => ({ name: name.trim() })),
+                };
+                break;
+            case 'date':
+                notionProperties[key] = { date: { start: String(value) } };
+                break;
+            case 'checkbox': {
+                const lowerValue = String(value).toLowerCase();
+                const boolValue = lowerValue === 'true' || lowerValue === 'yes' || value === 1 || value === true;
+                notionProperties[key] = { checkbox: boolValue };
+                break;
+            }
+            case 'url':
+                notionProperties[key] = { url: String(value) };
+                break;
+            case 'email':
+                notionProperties[key] = { email: String(value) };
+                break;
+            case 'phone_number':
+                notionProperties[key] = { phone_number: String(value) };
+                break;
+            // Advanced types like relation, people, and files are complex and would require
+            // more specific input formats than string/number, often needing IDs.
+            // They are omitted here but can be extended if the tool input is enhanced.
+            case 'relation':
+            case 'people':
+            case 'files':
+            default:
+                logger.warn(`Unsupported property type "${schema.type}" for key "${key}" during creation.`);
+                break;
+        }
+    }
+    return notionProperties;
+}
+/**
+ * Parses a flat properties object with special keys (e.g., 'date:deadline:start')
+ * from the 'update-page' tool input into the format required by the Notion API.
+ * @param properties - A flat key-value map with special-cased keys from the tool input [1].
+ * @param schema - The schema of the data source the page belongs to.
+ * @returns A Notion `NotionUpdateProperties` object.
+ */
+export function parsePropertiesForUpdate(properties, schema) {
+    const notionProperties = {};
+    const groupedComplexProps = {};
+    // 1. Group complex, colon-separated properties like 'date' and 'place' [1].
+    for (const [key, value] of Object.entries(properties)) {
+        const parts = key.split(':');
+        if (parts.length > 1 && (parts[0] === 'date' || parts[0] === 'place')) {
+            const [type, propName, ...rest] = parts;
+            const part = rest.join(':'); // Join the rest in case property name has a colon
+            if (!groupedComplexProps[propName]) {
+                groupedComplexProps[propName] = { type: type, data: {} };
+            }
+            // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+            // @ts-ignore
+            groupedComplexProps[propName].data[part] = value;
+        }
+    }
+    // 2. Process grouped complex properties
+    for (const [name, { type, data }] of Object.entries(groupedComplexProps)) {
+        if (type === 'date') {
+            const dateObj = { start: data.start };
+            if (data.end)
+                dateObj.end = data.end;
+            // eslint-disable-next-line
+            notionProperties[name] = { date: data.start === null ? null : dateObj };
+        }
+        else if (type === 'place') {
+            // For a place to be valid, latitude and longitude are required [11].
+            if (typeof data.latitude === 'number' && typeof data.longitude === 'number') {
+                const placeObj = {
+                    lat: data.latitude,
+                    lon: data.longitude,
+                };
+                if (data.name)
+                    placeObj.name = String(data.name);
+                if (data.address)
+                    placeObj.address = String(data.address);
+                if (data.google_place_id)
+                    placeObj.google_place_id = String(data.google_place_id);
+                notionProperties[name] = { place: placeObj };
+            }
+            else {
+                logger.warn(`Skipping place property "${name}" due to missing or invalid latitude/longitude.`);
+            }
+        }
+    }
+    // 3. Process simple and standard properties
+    for (const [name, value] of Object.entries(properties)) {
+        if (name.includes(':'))
+            continue; // Skip keys already processed in the grouping step.
+        const propSchema = schema[name];
+        const propType = propSchema?.type ?? (name.toLowerCase() === 'title' ? 'title' : undefined);
+        if (!propType) {
+            logger.warn(`Could not determine type for property "${name}". Skipping update.`);
+            continue;
+        }
+        /* eslint-disable no-restricted-syntax */
+        switch (propType) {
+            case 'title':
+                notionProperties[name] = { title: [{ text: { content: String(value) } }] };
+                break;
+            case 'rich_text':
+                notionProperties[name] = { rich_text: [{ text: { content: String(value ?? '') } }] };
+                break;
+            case 'number':
+                notionProperties[name] = { number: value === null ? null : Number(value) };
+                break;
+            case 'select':
+                notionProperties[name] = { select: value === null ? null : { name: String(value) } };
+                break;
+            case 'status':
+                notionProperties[name] = { status: value === null ? null : { name: String(value) } };
+                break;
+            case 'checkbox': {
+                const boolValue = String(value).toLowerCase() === '__yes__' || String(value).toLowerCase() === 'true';
+                notionProperties[name] = { checkbox: boolValue };
+                break;
+            }
+            case 'url':
+                notionProperties[name] = { url: value === null ? null : String(value) };
+                break;
+            case 'email':
+                notionProperties[name] = { email: value === null ? null : String(value) };
+                break;
+            case 'phone_number':
+                notionProperties[name] = { phone_number: value === null ? null : String(value) };
+                break;
+            default:
+                if (!Object.keys(groupedComplexProps).includes(name)) {
+                    logger.warn(`Updates for property type "${propType}" are not supported. Skipping "${name}".`);
+                }
+                break;
+        }
+        /* eslint-enable no-restricted-syntax */
+    }
+    return notionProperties;
+}
+//# sourceMappingURL=property-parser.js.map

package/dist/lib/property-parser.js.map

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

package/dist/lib/response-formatter.d.ts

@@ -0,0 +1,16 @@
+import { type BlockObjectResponse, type DatabaseObjectResponse, type DataSourceObjectResponse, type PageObjectResponse } from '@notionhq/client/build/src/api-endpoints.js';
+/**
+ * Formats a Notion Page object and its content into a single Markdown string [5].
+ * @param page - The fetched Page object from the Notion API.
+ * @param blocks - The content blocks of the page.
+ * @returns A promise that resolves to a comprehensive Markdown string representing the page.
+ */
+export declare function formatPageToMarkdown(page: PageObjectResponse, blocks: BlockObjectResponse[]): Promise<string>;
+/**
+ * Formats a Notion Database object and its data sources into a Markdown string that describes its schemas [10].
+ * @param database - The fetched Database object from the Notion API.
+ * @param data_sources - An array of fetched Data Source objects belonging to the database.
+ * @returns A promise that resolves to a Markdown string representing the database and its data source schemas.
+ */
+export declare function formatDatabaseToMarkdown(database: DatabaseObjectResponse, data_sources: DataSourceObjectResponse[]): Promise<string>;
+//# sourceMappingURL=response-formatter.d.ts.map

package/dist/lib/response-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-formatter.d.ts","sourceRoot":"","sources":["../../src/lib/response-formatter.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACxB,MAAM,6CAA6C,CAAA;AAoGpD;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBnH;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,sBAAsB,EAChC,YAAY,EAAE,wBAAwB,EAAE,GACvC,OAAO,CAAC,MAAM,CAAC,CA8CjB"}

package/dist/lib/response-formatter.js

@@ -0,0 +1,173 @@
+import { notionToMarkdown } from './markdown-converter.js';
+/**
+ * Formats a single Notion page property into a readable string based on its type [2].
+ * @param name - The name of the property.
+ * @param prop - The property value object from the Notion API.
+ * @returns A formatted string representing the property's value.
+ */
+function formatPageProperty(name, prop) {
+    let value = 'Unsupported type';
+    switch (prop.type) {
+        case 'title':
+            value = prop.title.map((t) => t.plain_text).join('');
+            break;
+        case 'rich_text':
+            value = prop.rich_text.map((t) => t.plain_text).join('');
+            break;
+        case 'number':
+            value = prop.number;
+            break;
+        case 'select':
+            value = prop.select?.name;
+            break;
+        case 'multi_select':
+            value = prop.multi_select.map((s) => s.name).join(', ');
+            break;
+        case 'status':
+            value = prop.status?.name;
+            break;
+        case 'date':
+            if (prop.date) {
+                value = prop.date.end ? `${prop.date.start} -> ${prop.date.end}` : prop.date.start;
+            }
+            else {
+                value = undefined;
+            }
+            break;
+        case 'people':
+            value = prop.people.map((p) => ('name' in p ? p.name : p.id)).join(', ');
+            break;
+        case 'files':
+            value = prop.files.map((f) => f.name).join(', ');
+            break;
+        case 'checkbox':
+            value = prop.checkbox ? 'Yes' : 'No';
+            break;
+        case 'url':
+            value = prop.url;
+            break;
+        case 'email':
+            value = prop.email;
+            break;
+        case 'phone_number':
+            value = prop.phone_number;
+            break;
+        case 'formula': {
+            const { formula } = prop;
+            if (formula.type === 'string')
+                value = formula.string;
+            if (formula.type === 'number')
+                value = formula.number;
+            if (formula.type === 'boolean')
+                value = formula.boolean ? 'Yes' : 'No';
+            if (formula.type === 'date')
+                value = formula.date?.start;
+            break;
+        }
+        case 'relation':
+            value = `${prop.relation.length} relation(s)`;
+            break;
+        case 'created_time':
+            value = new Date(prop.created_time).toLocaleString();
+            break;
+        case 'last_edited_time':
+            value = new Date(prop.last_edited_time).toLocaleString();
+            break;
+        case 'created_by':
+            value = 'id' in prop.created_by ? prop.created_by.id : '';
+            break;
+        case 'last_edited_by':
+            value = 'id' in prop.last_edited_by ? prop.last_edited_by.id : '';
+            break;
+        case 'rollup': {
+            const rollup = prop.rollup;
+            if (rollup.type === 'number')
+                value = rollup.number;
+            else if (rollup.type === 'date')
+                value = rollup.date?.start;
+            else if (rollup.type === 'array')
+                value = `${rollup.array.length} items`;
+            else
+                value = `Unsupported rollup type`;
+            break;
+        }
+        case 'unique_id':
+            value = prop.unique_id.prefix ? `${prop.unique_id.prefix}-${prop.unique_id.number}` : `${prop.unique_id.number}`;
+            break;
+    }
+    // eslint-disable-next-line no-restricted-syntax
+    return `- **${name}**: ${value ?? 'null'}`;
+}
+/**
+ * Formats a Notion Page object and its content into a single Markdown string [5].
+ * @param page - The fetched Page object from the Notion API.
+ * @param blocks - The content blocks of the page.
+ * @returns A promise that resolves to a comprehensive Markdown string representing the page.
+ */
+export async function formatPageToMarkdown(page, blocks) {
+    const contentMarkdown = await notionToMarkdown(blocks);
+    const propertiesMarkdown = Object.entries(page.properties)
+        .map(([name, prop]) => formatPageProperty(name, prop))
+        .join('\n');
+    const icon = page.icon?.type === 'emoji' ? `${page.icon.emoji} ` : '';
+    return `
+# ${icon}Page: ${page.url}
+
+## Properties
+${propertiesMarkdown}
+
+## Content
+---
+${contentMarkdown}
+  `.trim();
+}
+/**
+ * Formats a Notion Database object and its data sources into a Markdown string that describes its schemas [10].
+ * @param database - The fetched Database object from the Notion API.
+ * @param data_sources - An array of fetched Data Source objects belonging to the database.
+ * @returns A promise that resolves to a Markdown string representing the database and its data source schemas.
+ */
+export async function formatDatabaseToMarkdown(database, data_sources) {
+    const title = database.title.map((t) => t.plain_text).join('');
+    const icon = database.icon?.type === 'emoji' ? `${database.icon.emoji} ` : '';
+    const dataSourcesMarkdown = data_sources
+        .map((ds) => {
+        const dsTitle = ds.title.map((t) => t.plain_text).join('');
+        const propertiesMarkdown = Object.entries(ds.properties)
+            .map(([name, prop]) => {
+            let details = `(type: \`${prop.type}\`, id: \`${prop.id}\`)`;
+            let options = [];
+            // For select, multi_select, and status, list the available options [13].
+            if (prop.type === 'select') {
+                options = prop.select.options;
+            }
+            else if (prop.type === 'multi_select') {
+                options = prop.multi_select.options;
+            }
+            else if (prop.type === 'status') {
+                options = prop.status.options;
+            }
+            if (options.length > 0) {
+                const optionsString = options.map((o) => o.name).join(', ');
+                details += `\n    - Options: ${optionsString}`;
+            }
+            return `  - **${name}** ${details}`;
+        })
+            .join('\n');
+        return `
+### Data Source: ${dsTitle}
+> To query this data source, use its URL: collection://${ds.id}
+
+**Schema / Properties:**
+${propertiesMarkdown}
+      `.trim();
+    })
+        .join('\n\n');
+    return `
+# ${icon}Database: ${title}
+> To query pages from this database, use one of the data source URLs below.
+
+${dataSourcesMarkdown}
+  `.trim();
+}
+//# sourceMappingURL=response-formatter.js.map

package/dist/lib/response-formatter.js.map

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

package/dist/lib/sync-state-manager.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Defines the structure for metadata associated with a single synchronized page.
+ * 'undefined' for lastEdited indicates the page has been discovered but not yet processed.
+ */
+export type SyncedPageInfo = {
+    lastEdited: string | undefined;
+    title: string | undefined;
+    url: string | undefined;
+};
+/**
+ * Defines the structure of the entire synchronization state file.
+ */
+export type SyncState = {
+    pages: Record<string, SyncedPageInfo>;
+};
+/**
+ * Loads the synchronization state from the file system.
+ * If the state file does not exist, it returns a default initial state.
+ * @returns A promise that resolves to the loaded or initial SyncState.
+ */
+export declare function loadSyncState(): Promise<SyncState>;
+/**
+ * Saves the provided synchronization state to the file system.
+ * This function is critical for maintaining progress across restarts.
+ * @param state - The SyncState object to save.
+ * @returns A promise that resolves when the file has been written.
+ */
+export declare function saveSyncState(state: SyncState): Promise<void>;
+//# sourceMappingURL=sync-state-manager.d.ts.map

package/dist/lib/sync-state-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-state-manager.d.ts","sourceRoot":"","sources":["../../src/lib/sync-state-manager.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CACxB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;CACtC,CAAA;AAED;;;;GAIG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,SAAS,CAAC,CAiBxD;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CASnE"}

package/dist/lib/sync-state-manager.js

@@ -0,0 +1,45 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { logger } from '@mcp-monorepo/shared';
+import { SYNC_STATE_PATH } from './config.js';
+/**
+ * Loads the synchronization state from the file system.
+ * If the state file does not exist, it returns a default initial state.
+ * @returns A promise that resolves to the loaded or initial SyncState.
+ */
+export async function loadSyncState() {
+    try {
+        const fileContent = await readFile(SYNC_STATE_PATH, 'utf-8');
+        // A simple validation to ensure the loaded data has the expected structure.
+        const parsed = JSON.parse(fileContent);
+        if (typeof parsed === 'object' && parsed && 'pages' in parsed) {
+            return parsed;
+        }
+        throw new Error('Loaded sync state has an invalid structure.');
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+            logger.info('Sync state file not found. Creating a new one.');
+            return { pages: {} };
+        }
+        logger.error('Failed to load or parse sync state file. Starting with a fresh state.', error);
+        return { pages: {} };
+    }
+}
+/**
+ * Saves the provided synchronization state to the file system.
+ * This function is critical for maintaining progress across restarts.
+ * @param state - The SyncState object to save.
+ * @returns A promise that resolves when the file has been written.
+ */
+export async function saveSyncState(state) {
+    try {
+        const jsonString = JSON.stringify(state, undefined, 2);
+        await writeFile(SYNC_STATE_PATH, jsonString, 'utf-8');
+    }
+    catch (error) {
+        logger.error('CRITICAL: Failed to save sync state file. Progress may be lost.', error);
+        // Re-throwing the error allows the calling function to handle the failure.
+        throw error;
+    }
+}
+//# sourceMappingURL=sync-state-manager.js.map

package/dist/lib/sync-state-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-state-manager.js","sourceRoot":"","sources":["../../src/lib/sync-state-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAEtD,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAE7C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAmB7C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC,CAAA;QAC5D,4EAA4E;QAC5E,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAY,CAAA;QACjD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;YAC9D,OAAO,MAAmB,CAAA;QAC5B,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;IAChE,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAI,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACzE,MAAM,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAA;YAC7D,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;QACtB,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,uEAAuE,EAAE,KAAK,CAAC,CAAA;QAC5F,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;IACtB,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAgB;IAClD,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,CAAA;QACtD,MAAM,SAAS,CAAC,eAAe,EAAE,UAAU,EAAE,OAAO,CAAC,CAAA;IACvD,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,CAAC,KAAK,CAAC,iEAAiE,EAAE,KAAK,CAAC,CAAA;QACtF,2EAA2E;QAC3E,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC"}