@jnss95/ical-mcp 1.0.0

package/build/calendar/loader.js

@@ -0,0 +1,179 @@
+/**
+ * Calendar loader - handles loading iCal data from various sources
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { Calendar } from './calendar.js';
+/**
+ * Load a calendar from a file path
+ */
+export async function loadFromFile(filePath) {
+    const absolutePath = path.resolve(filePath);
+    // Check if file exists
+    try {
+        await fs.access(absolutePath, fs.constants.R_OK);
+    }
+    catch {
+        throw new Error(`Cannot access file: ${absolutePath}`);
+    }
+    const source = {
+        type: 'file',
+        source: absolutePath,
+        writable: await isFileWritable(absolutePath),
+    };
+    const calendar = new Calendar(source);
+    const content = await fs.readFile(absolutePath, 'utf-8');
+    calendar.loadFromString(content);
+    return calendar;
+}
+/**
+ * Load a calendar from an HTTP/HTTPS URL
+ */
+export async function loadFromUrl(url) {
+    // Validate URL
+    let parsedUrl;
+    try {
+        parsedUrl = new URL(url);
+    }
+    catch {
+        throw new Error(`Invalid URL: ${url}`);
+    }
+    if (!['http:', 'https:'].includes(parsedUrl.protocol)) {
+        throw new Error(`Unsupported protocol: ${parsedUrl.protocol}. Only http and https are supported.`);
+    }
+    const source = {
+        type: 'http',
+        source: url,
+        writable: false, // HTTP sources are always read-only
+    };
+    const calendar = new Calendar(source);
+    const response = await fetch(url, {
+        headers: {
+            'Accept': 'text/calendar, application/calendar+xml, */*',
+            'User-Agent': 'iCal-MCP-Server/1.0',
+        },
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to fetch calendar: ${response.status} ${response.statusText}`);
+    }
+    const content = await response.text();
+    if (!content.includes('BEGIN:VCALENDAR')) {
+        throw new Error('Invalid iCal data: missing VCALENDAR component');
+    }
+    calendar.loadFromString(content);
+    return calendar;
+}
+/**
+ * Load a calendar from a raw iCal string
+ */
+export function loadFromString(icalString, writable = true) {
+    if (!icalString.includes('BEGIN:VCALENDAR')) {
+        throw new Error('Invalid iCal data: missing VCALENDAR component');
+    }
+    const source = {
+        type: 'string',
+        source: 'memory',
+        writable,
+    };
+    const calendar = new Calendar(source);
+    calendar.loadFromString(icalString);
+    return calendar;
+}
+/**
+ * Load a calendar from either a file path or URL
+ */
+export async function loadCalendar(pathOrUrl) {
+    // Check if it's a URL
+    if (pathOrUrl.startsWith('http://') || pathOrUrl.startsWith('https://')) {
+        return loadFromUrl(pathOrUrl);
+    }
+    // Check if it's a file URL
+    if (pathOrUrl.startsWith('file://')) {
+        const filePath = pathOrUrl.replace(/^file:\/\//, '');
+        return loadFromFile(filePath);
+    }
+    // Assume it's a file path
+    return loadFromFile(pathOrUrl);
+}
+/**
+ * Save a calendar back to its source
+ */
+export async function saveCalendar(calendar) {
+    const source = calendar.getSource();
+    if (!source.writable) {
+        throw new Error('Calendar source is read-only');
+    }
+    if (source.type === 'file') {
+        const content = calendar.toString();
+        await fs.writeFile(source.source, content, 'utf-8');
+    }
+    else if (source.type === 'http') {
+        throw new Error('Cannot save to HTTP source');
+    }
+    else if (source.type === 'string') {
+        // In-memory calendar, nothing to persist
+        throw new Error('Cannot save in-memory calendar');
+    }
+}
+/**
+ * Create a new empty calendar file
+ */
+export async function createCalendarFile(filePath, options) {
+    const absolutePath = path.resolve(filePath);
+    // Check if file already exists
+    try {
+        await fs.access(absolutePath);
+        throw new Error(`File already exists: ${absolutePath}`);
+    }
+    catch (error) {
+        // File doesn't exist, which is what we want
+        if (error.code !== 'ENOENT') {
+            throw error;
+        }
+    }
+    const source = {
+        type: 'file',
+        source: absolutePath,
+        writable: true,
+    };
+    const calendar = new Calendar(source);
+    // Set optional properties
+    const icalString = buildEmptyCalendar(options?.name, options?.timezone);
+    calendar.loadFromString(icalString);
+    // Save to file
+    await fs.writeFile(absolutePath, calendar.toString(), 'utf-8');
+    return calendar;
+}
+/**
+ * Check if a file is writable
+ */
+async function isFileWritable(filePath) {
+    try {
+        await fs.access(filePath, fs.constants.W_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Build an empty iCal calendar string
+ */
+function buildEmptyCalendar(name, timezone) {
+    const lines = [
+        'BEGIN:VCALENDAR',
+        'VERSION:2.0',
+        'PRODID:-//iCal MCP Server//EN',
+        'CALSCALE:GREGORIAN',
+        'METHOD:PUBLISH',
+    ];
+    if (name) {
+        lines.push(`X-WR-CALNAME:${name}`);
+    }
+    if (timezone) {
+        lines.push(`X-WR-TIMEZONE:${timezone}`);
+    }
+    lines.push('END:VCALENDAR');
+    return lines.join('\r\n');
+}
+//# sourceMappingURL=loader.js.map

package/build/calendar/loader.js.map

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

package/build/index.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * iCal MCP Server - Main entry point
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { Calendar } from './calendar/index.js';
+declare const calendars: Map<string, Calendar>;
+/**
+ * Create and configure the MCP server
+ */
+export declare function createServer(): McpServer;
+export { calendars };
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,EAAE,QAAQ,EAAkD,MAAM,qBAAqB,CAAC;AAI/F,QAAA,MAAM,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAa,CAAC;AAEnD;;GAEG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAUxC;AA6yBD,OAAO,EAAE,SAAS,EAAE,CAAC"}