vikunja-mcp-ng 0.4.0

package/dist/config/types.d.ts.map

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

package/dist/config/types.js

@@ -0,0 +1,189 @@
+"use strict";
+/**
+ * Configuration Types and Schemas
+ * Centralized configuration management for the Vikunja MCP server
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigurationError = exports.ApplicationConfigSchema = exports.TemplatesConfigSchema = exports.ModulesConfigSchema = exports.DANGEROUS_MODULE_KEYS = exports.ModuleToggleSchema = exports.FeatureFlagsConfigSchema = exports.RateLimitConfigSchema = exports.LoggingConfigSchema = exports.AuthConfigSchema = exports.Environment = void 0;
+exports.isModuleEnabled = isModuleEnabled;
+const zod_1 = require("zod");
+// Environment type for configuration profiles
+var Environment;
+(function (Environment) {
+    Environment["DEVELOPMENT"] = "development";
+    Environment["TEST"] = "test";
+    Environment["PRODUCTION"] = "production";
+})(Environment || (exports.Environment = Environment = {}));
+// Authentication Configuration Schema
+exports.AuthConfigSchema = zod_1.z.object({
+    vikunjaUrl: zod_1.z.string().url().optional(),
+    vikunjaToken: zod_1.z.string().optional(),
+    mcpMode: zod_1.z.string().optional(),
+});
+// Logging Configuration Schema
+exports.LoggingConfigSchema = zod_1.z.object({
+    level: zod_1.z.enum(['error', 'warn', 'info', 'debug']).default('info'),
+    debug: zod_1.z.boolean().default(false),
+    environment: zod_1.z.nativeEnum(Environment).default(Environment.DEVELOPMENT),
+});
+// Individual rate limit settings schema
+const RateLimitSettingsSchema = zod_1.z.object({
+    requestsPerMinute: zod_1.z.number().int().positive().default(60),
+    requestsPerHour: zod_1.z.number().int().positive().default(1000),
+    maxRequestSize: zod_1.z.number().int().positive().default(1048576), // 1MB
+    maxResponseSize: zod_1.z.number().int().positive().default(10485760), // 10MB
+    executionTimeout: zod_1.z.number().int().positive().default(30000), // 30 seconds
+});
+// Rate Limiting Configuration Schema
+exports.RateLimitConfigSchema = zod_1.z.object({
+    // Global enable/disable switch for rate limiting
+    enabled: zod_1.z.boolean().default(true),
+    // Default tool limits
+    default: RateLimitSettingsSchema.default({
+        requestsPerMinute: 60,
+        requestsPerHour: 1000,
+        maxRequestSize: 1048576,
+        maxResponseSize: 10485760,
+        executionTimeout: 30000,
+    }),
+    // Expensive tool limits
+    expensive: RateLimitSettingsSchema.default({
+        requestsPerMinute: 10,
+        requestsPerHour: 100,
+        maxRequestSize: 2097152,
+        maxResponseSize: 52428800,
+        executionTimeout: 120000,
+    }),
+    // Bulk operation limits
+    bulk: RateLimitSettingsSchema.default({
+        requestsPerMinute: 5,
+        requestsPerHour: 50,
+        maxRequestSize: 5242880,
+        maxResponseSize: 104857600,
+        executionTimeout: 300000,
+    }),
+    // Export operation limits
+    export: RateLimitSettingsSchema.default({
+        requestsPerMinute: 2,
+        requestsPerHour: 10,
+        maxRequestSize: 1048576,
+        maxResponseSize: 1073741824,
+        executionTimeout: 600000,
+    }),
+});
+// Feature Flags Configuration Schema
+exports.FeatureFlagsConfigSchema = zod_1.z.object({
+    enableServerSideFiltering: zod_1.z.boolean().default(true),
+    enableAdvancedMetrics: zod_1.z.boolean().default(false),
+    enableExperimentalFeatures: zod_1.z.boolean().default(false),
+});
+// Module Enable/Disable Configuration Schema
+//
+// A module value is a plain boolean today ({"tasks": false}), but the object
+// form ({"tasks": {"enabled": true, "delete": false}}) is accepted now so that
+// per-subcommand granularity can be introduced later without a breaking change.
+// The `.catchall(z.boolean())` allows arbitrary future subcommand keys through
+// validation; only `enabled` is interpreted today (see `isModuleEnabled`).
+exports.ModuleToggleSchema = zod_1.z.union([
+    zod_1.z.boolean(),
+    zod_1.z.object({ enabled: zod_1.z.boolean() }).catchall(zod_1.z.boolean()),
+]);
+/**
+ * Resolve a module toggle (boolean shorthand or object form) to its
+ * effective enabled/disabled state.
+ */
+function isModuleEnabled(toggle) {
+    return typeof toggle === 'boolean' ? toggle : toggle.enabled;
+}
+// Modules deliberately excluded from ordinary defaults because they are
+// dangerous/destructive in nature. These have no registered tools yet, but
+// the config keys are reserved now so future admin/user-deletion/token-
+// management tools plug into the same deny-by-default gating from day one.
+exports.DANGEROUS_MODULE_KEYS = [
+    'admin',
+    'userDeletion',
+    'tokenManagement',
+    'caldavTokens',
+];
+exports.ModulesConfigSchema = zod_1.z.object({
+    // Ordinary modules — default ON.
+    tasks: exports.ModuleToggleSchema.default(true),
+    projects: exports.ModuleToggleSchema.default(true),
+    labels: exports.ModuleToggleSchema.default(true),
+    teams: exports.ModuleToggleSchema.default(true),
+    users: exports.ModuleToggleSchema.default(true),
+    webhooks: exports.ModuleToggleSchema.default(true),
+    filters: exports.ModuleToggleSchema.default(true),
+    templates: exports.ModuleToggleSchema.default(true),
+    export: exports.ModuleToggleSchema.default(true),
+    batchImport: exports.ModuleToggleSchema.default(true),
+    notifications: exports.ModuleToggleSchema.default(true),
+    subscriptions: exports.ModuleToggleSchema.default(true),
+    reactions: exports.ModuleToggleSchema.default(true),
+    // Dangerous modules — deny-by-default. No tools implement these yet; the
+    // keys are reserved so future work composes with this gating system.
+    admin: exports.ModuleToggleSchema.default(false),
+    userDeletion: exports.ModuleToggleSchema.default(false),
+    tokenManagement: exports.ModuleToggleSchema.default(false),
+    // Gates `vikunja_caldav_tokens` (CalDAV token list/create/delete for the
+    // connected account). Deny-by-default — credential-adjacent, and a
+    // created token's secret value is only ever shown once (see
+    // src/tools/caldav-tokens.ts). Unlike `tokenManagement`, the underlying
+    // `/user/settings/token/caldav*` endpoints are JWT-only per the vendored
+    // OpenAPI spec (`security: [{JWTKeyAuth: []}]`), so registration composes
+    // with the same JWT-only gate as `users`/`export`/`admin` — see
+    // src/tools/index.ts.
+    caldavTokens: exports.ModuleToggleSchema.default(false),
+    // Opt-in cosmetic module — deny-by-default for the OPPOSITE reason the
+    // dangerous keys above are: not dangerous, just low-value for a task-
+    // management assistant (project backgrounds are decorative, not
+    // functional). Gates three `vikunja_projects` subcommands
+    // (`remove-background`/`set-unsplash-background`/`search-unsplash`, see
+    // `src/tools/projects/backgrounds.ts`) rather than a whole standalone
+    // tool — see that module's doc comment and
+    // `registerProjectsTool`/`resolveBackgroundsEnabled` in
+    // `src/tools/projects/index.ts` for how a single tool's subcommand *enum*
+    // (not just its dispatch) is built conditionally so the disabled
+    // subcommands are genuinely absent from the schema, matching every other
+    // module's "invisible, not merely rejected" contract. See
+    // docs/ENDPOINT-TAIL-RETRIAGE.md item G7.
+    backgrounds: exports.ModuleToggleSchema.default(false),
+});
+// Templates Configuration Schema
+//
+// Templates are in-memory-only (session-scoped, lost on restart) unless
+// `persistPath` is set, in which case the vikunja_templates tool write-
+// throughs to that file on every mutation and reloads from it at startup.
+// See docs/CONFIGURATION.md for the env var / Docker volume story.
+exports.TemplatesConfigSchema = zod_1.z.object({
+    persistPath: zod_1.z.string().optional(),
+});
+// Complete Application Configuration Schema
+exports.ApplicationConfigSchema = zod_1.z.object({
+    environment: zod_1.z.nativeEnum(Environment).default(Environment.DEVELOPMENT),
+    auth: exports.AuthConfigSchema.default({}),
+    logging: exports.LoggingConfigSchema.default({}),
+    rateLimiting: exports.RateLimitConfigSchema.default({}),
+    featureFlags: exports.FeatureFlagsConfigSchema.default({}),
+    modules: exports.ModulesConfigSchema.default({}),
+    // Global read-only safety mode. When true, every write/destructive
+    // subcommand across every tool is rejected at dispatch (see
+    // src/utils/read-only.ts) — read subcommands continue to work normally.
+    // Config file key: `readOnly`. Env override: `VIKUNJA_MCP_READ_ONLY`
+    // (env always wins over the config file, per standard layering).
+    readOnly: zod_1.z.boolean().default(false),
+    templates: exports.TemplatesConfigSchema.default({}),
+});
+// Configuration Validation Error
+class ConfigurationError extends Error {
+    field;
+    value;
+    constructor(field, message, value) {
+        super(`Configuration error in ${field}: ${message}`);
+        this.field = field;
+        this.value = value;
+        this.name = 'ConfigurationError';
+    }
+}
+exports.ConfigurationError = ConfigurationError;
+//# sourceMappingURL=types.js.map

package/dist/config/types.js.map

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

package/dist/formatters/BatchImportResponseFormatter.d.ts

@@ -0,0 +1,89 @@
+/**
+ * BatchImportResponseFormatter - Handles formatting of batch import results
+ *
+ * This module is responsible for formatting the response text for batch import operations,
+ * including success/failure summaries, warnings, errors, and authentication issues.
+ *
+ * Refactored from src/tools/batch-import.ts to improve separation of concerns and testability.
+ */
+export interface ImportResult {
+    success: number;
+    failed: number;
+    errors: Array<{
+        index: number;
+        title: string;
+        error: string;
+    }>;
+    createdTasks: Array<{
+        id: number;
+        title: string;
+    }>;
+    warnings?: Array<{
+        taskId: number;
+        title: string;
+        warning: string;
+    }>;
+}
+export interface FormatterOptions {
+    userFetchFailedDueToAuth: boolean;
+    hasAssignees: boolean;
+}
+/**
+ * Formats batch import results into a user-friendly text response
+ */
+export declare class BatchImportResponseFormatter {
+    /**
+     * Format the complete batch import result
+     *
+     * @param result - The import result to format
+     * @param userFetchFailedDueToAuth - Whether user fetching failed due to authentication
+     * @param hasAssignees - Whether any tasks have assignees
+     * @returns Formatted response text
+     */
+    formatResult(result: ImportResult, userFetchFailedDueToAuth?: boolean, hasAssignees?: boolean): string;
+    /**
+     * Format the success/failure summary section
+     *
+     * @param result - The import result
+     * @returns Summary text
+     */
+    private formatSummary;
+    /**
+     * Format authentication warning if users couldn't be fetched
+     *
+     * @param userFetchFailedDueToAuth - Whether user fetching failed due to authentication
+     * @param hasAssignees - Whether any tasks have assignees
+     * @returns Authentication warning text or empty string
+     */
+    private formatAuthWarning;
+    /**
+     * Format the created tasks section
+     *
+     * @param result - The import result
+     * @returns Created tasks text or empty string
+     */
+    private formatCreatedTasks;
+    /**
+     * Format the warnings section
+     *
+     * @param result - The import result
+     * @returns Warnings text or empty string
+     */
+    private formatWarnings;
+    /**
+     * Format the errors section
+     *
+     * @param result - The import result
+     * @returns Errors text or empty string
+     */
+    private formatErrors;
+    /**
+     * Format result using options object for convenience
+     *
+     * @param result - The import result
+     * @param options - Formatting options
+     * @returns Formatted response text
+     */
+    formatResultWithOptions(result: ImportResult, options: FormatterOptions): string;
+}
+//# sourceMappingURL=BatchImportResponseFormatter.d.ts.map

package/dist/formatters/BatchImportResponseFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BatchImportResponseFormatter.d.ts","sourceRoot":"","sources":["../../src/formatters/BatchImportResponseFormatter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,KAAK,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;IACH,YAAY,EAAE,KAAK,CAAC;QAClB,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,gBAAgB;IAC/B,wBAAwB,EAAE,OAAO,CAAC;IAClC,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,qBAAa,4BAA4B;IACvC;;;;;;;OAOG;IACH,YAAY,CACV,MAAM,EAAE,YAAY,EACpB,wBAAwB,GAAE,OAAe,EACzC,YAAY,GAAE,OAAe,GAC5B,MAAM;IAqBT;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAOrB;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IASzB;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAW1B;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAWtB;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAWpB;;;;;;OAMG;IACH,uBAAuB,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,gBAAgB,GAAG,MAAM;CAGjF"}

package/dist/formatters/BatchImportResponseFormatter.js

@@ -0,0 +1,125 @@
+"use strict";
+/**
+ * BatchImportResponseFormatter - Handles formatting of batch import results
+ *
+ * This module is responsible for formatting the response text for batch import operations,
+ * including success/failure summaries, warnings, errors, and authentication issues.
+ *
+ * Refactored from src/tools/batch-import.ts to improve separation of concerns and testability.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BatchImportResponseFormatter = void 0;
+/**
+ * Formats batch import results into a user-friendly text response
+ */
+class BatchImportResponseFormatter {
+    /**
+     * Format the complete batch import result
+     *
+     * @param result - The import result to format
+     * @param userFetchFailedDueToAuth - Whether user fetching failed due to authentication
+     * @param hasAssignees - Whether any tasks have assignees
+     * @returns Formatted response text
+     */
+    formatResult(result, userFetchFailedDueToAuth = false, hasAssignees = false) {
+        let responseText = '';
+        // Add success/failure summary
+        responseText += this.formatSummary(result);
+        // Add authentication warning if applicable
+        responseText += this.formatAuthWarning(userFetchFailedDueToAuth, hasAssignees);
+        // Add created tasks list
+        responseText += this.formatCreatedTasks(result);
+        // Add warnings if any
+        responseText += this.formatWarnings(result);
+        // Add errors if any
+        responseText += this.formatErrors(result);
+        return responseText;
+    }
+    /**
+     * Format the success/failure summary section
+     *
+     * @param result - The import result
+     * @returns Summary text
+     */
+    formatSummary(result) {
+        let summary = `Import completed:\n`;
+        summary += `- Successfully imported: ${result.success} tasks\n`;
+        summary += `- Failed: ${result.failed} tasks\n`;
+        return summary;
+    }
+    /**
+     * Format authentication warning if users couldn't be fetched
+     *
+     * @param userFetchFailedDueToAuth - Whether user fetching failed due to authentication
+     * @param hasAssignees - Whether any tasks have assignees
+     * @returns Authentication warning text or empty string
+     */
+    formatAuthWarning(userFetchFailedDueToAuth, hasAssignees) {
+        if (userFetchFailedDueToAuth && hasAssignees) {
+            let warning = `\n⚠️  Warning: Could not fetch users due to Vikunja API authentication issue.\n`;
+            warning += `   Assignees were skipped for all tasks.\n`;
+            return warning;
+        }
+        return '';
+    }
+    /**
+     * Format the created tasks section
+     *
+     * @param result - The import result
+     * @returns Created tasks text or empty string
+     */
+    formatCreatedTasks(result) {
+        if (result.createdTasks.length > 0) {
+            let createdTasks = `\nCreated tasks:\n`;
+            result.createdTasks.forEach((task) => {
+                createdTasks += `- #${task.id}: ${task.title}\n`;
+            });
+            return createdTasks;
+        }
+        return '';
+    }
+    /**
+     * Format the warnings section
+     *
+     * @param result - The import result
+     * @returns Warnings text or empty string
+     */
+    formatWarnings(result) {
+        if (result.warnings && result.warnings.length > 0) {
+            let warnings = `\n⚠️  Warnings:\n`;
+            result.warnings.forEach((warning) => {
+                warnings += `- Task #${warning.taskId} (${warning.title}): ${warning.warning}\n`;
+            });
+            return warnings;
+        }
+        return '';
+    }
+    /**
+     * Format the errors section
+     *
+     * @param result - The import result
+     * @returns Errors text or empty string
+     */
+    formatErrors(result) {
+        if (result.errors.length > 0) {
+            let errors = `\nErrors:\n`;
+            result.errors.forEach((error) => {
+                errors += `- Row ${error.index + 1} (${error.title}): ${error.error}\n`;
+            });
+            return errors;
+        }
+        return '';
+    }
+    /**
+     * Format result using options object for convenience
+     *
+     * @param result - The import result
+     * @param options - Formatting options
+     * @returns Formatted response text
+     */
+    formatResultWithOptions(result, options) {
+        return this.formatResult(result, options.userFetchFailedDueToAuth, options.hasAssignees);
+    }
+}
+exports.BatchImportResponseFormatter = BatchImportResponseFormatter;
+//# sourceMappingURL=BatchImportResponseFormatter.js.map

package/dist/formatters/BatchImportResponseFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BatchImportResponseFormatter.js","sourceRoot":"","sources":["../../src/formatters/BatchImportResponseFormatter.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AA0BH;;GAEG;AACH,MAAa,4BAA4B;IACvC;;;;;;;OAOG;IACH,YAAY,CACV,MAAoB,EACpB,2BAAoC,KAAK,EACzC,eAAwB,KAAK;QAE7B,IAAI,YAAY,GAAG,EAAE,CAAC;QAEtB,8BAA8B;QAC9B,YAAY,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAE3C,2CAA2C;QAC3C,YAAY,IAAI,IAAI,CAAC,iBAAiB,CAAC,wBAAwB,EAAE,YAAY,CAAC,CAAC;QAE/E,yBAAyB;QACzB,YAAY,IAAI,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAEhD,sBAAsB;QACtB,YAAY,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAE5C,oBAAoB;QACpB,YAAY,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAE1C,OAAO,YAAY,CAAC;IACtB,CAAC;IAED;;;;;OAKG;IACK,aAAa,CAAC,MAAoB;QACxC,IAAI,OAAO,GAAG,qBAAqB,CAAC;QACpC,OAAO,IAAI,4BAA4B,MAAM,CAAC,OAAO,UAAU,CAAC;QAChE,OAAO,IAAI,aAAa,MAAM,CAAC,MAAM,UAAU,CAAC;QAChD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;;OAMG;IACK,iBAAiB,CAAC,wBAAiC,EAAE,YAAqB;QAChF,IAAI,wBAAwB,IAAI,YAAY,EAAE,CAAC;YAC7C,IAAI,OAAO,GAAG,iFAAiF,CAAC;YAChG,OAAO,IAAI,4CAA4C,CAAC;YACxD,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;;OAKG;IACK,kBAAkB,CAAC,MAAoB;QAC7C,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,IAAI,YAAY,GAAG,oBAAoB,CAAC;YACxC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;gBACnC,YAAY,IAAI,MAAM,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,KAAK,IAAI,CAAC;YACnD,CAAC,CAAC,CAAC;YACH,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;;OAKG;IACK,cAAc,CAAC,MAAoB;QACzC,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClD,IAAI,QAAQ,GAAG,mBAAmB,CAAC;YACnC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;gBAClC,QAAQ,IAAI,WAAW,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,KAAK,MAAM,OAAO,CAAC,OAAO,IAAI,CAAC;YACnF,CAAC,CAAC,CAAC;YACH,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;;OAKG;IACK,YAAY,CAAC,MAAoB;QACvC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,IAAI,MAAM,GAAG,aAAa,CAAC;YAC3B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;gBAC9B,MAAM,IAAI,SAAS,KAAK,CAAC,KAAK,GAAG,CAAC,KAAK,KAAK,CAAC,KAAK,MAAM,KAAK,CAAC,KAAK,IAAI,CAAC;YAC1E,CAAC,CAAC,CAAC;YACH,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;;;OAMG;IACH,uBAAuB,CAAC,MAAoB,EAAE,OAAyB;QACrE,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,wBAAwB,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC3F,CAAC;CACF;AA5HD,oEA4HC"}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+/**
+ * Vikunja MCP Server
+ * Main entry point for the Model Context Protocol server
+ */
+export declare const factoryInitializationPromise: Promise<void>;
+export { MCPError, ErrorCode } from './types/errors';
+export type { TaskResponseData, FilterExpression, Task } from './types';
+export type { ParseResult } from './types/filters';
+export type { AorpBuilderConfig, AorpFactoryResult } from './types';
+export { logger } from './utils/logger';
+export { isAuthenticationError } from './utils/auth-error-handler';
+export { withRetry, RETRY_CONFIG } from './utils/retry';
+export { transformApiError, handleFetchError, handleStatusCodeError } from './utils/error-handler';
+export { parseFilterString } from './utils/filters';
+export { validateTaskCountLimit } from './utils/memory';
+export { createStandardResponse, createAorpErrorResponse as createErrorResponse } from './utils/response-factory';
+export type { SimpleResponse } from './utils/simple-response';
+export { getAuthManagerFromContext, clearGlobalClientFactory } from './client';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;GAGG;AAsCH,eAAO,MAAM,4BAA4B,eAiBrC,CAAC;AAuDL,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACrD,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AACxE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAGpE,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnG,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,IAAI,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAGlH,YAAY,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAG9D,OAAO,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,130 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Vikunja MCP Server
+ * Main entry point for the Model Context Protocol server
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearGlobalClientFactory = exports.getAuthManagerFromContext = exports.createErrorResponse = exports.createStandardResponse = exports.validateTaskCountLimit = exports.parseFilterString = exports.handleStatusCodeError = exports.handleFetchError = exports.transformApiError = exports.RETRY_CONFIG = exports.withRetry = exports.isAuthenticationError = exports.logger = exports.ErrorCode = exports.MCPError = exports.factoryInitializationPromise = void 0;
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const dotenv_1 = __importDefault(require("dotenv"));
+const AuthManager_1 = require("./auth/AuthManager");
+const tools_1 = require("./tools");
+const logger_1 = require("./utils/logger");
+const security_1 = require("./utils/security");
+const client_1 = require("./client");
+const secrets_1 = require("./config/secrets");
+dotenv_1.default.config({ quiet: true });
+const server = new mcp_js_1.McpServer({
+    name: 'vikunja-mcp-ng',
+    version: '0.3.0',
+});
+const authManager = new AuthManager_1.AuthManager();
+let clientFactory = null;
+async function initializeFactory() {
+    try {
+        clientFactory = await (0, client_1.createVikunjaClientFactory)(authManager);
+        if (clientFactory) {
+            await (0, client_1.setGlobalClientFactory)(clientFactory);
+        }
+    }
+    catch (error) {
+        logger_1.logger.warn('Failed to initialize client factory during startup:', error);
+        // Factory will be initialized on first authentication
+    }
+}
+// Initialize factory during module load for both production and test environments
+// This ensures the factory is available for tests
+exports.factoryInitializationPromise = initializeFactory()
+    .then(() => {
+    try {
+        if (clientFactory) {
+            (0, tools_1.registerTools)(server, authManager, clientFactory);
+        }
+        else {
+            (0, tools_1.registerTools)(server, authManager, undefined);
+        }
+    }
+    catch (error) {
+        logger_1.logger.error('Failed to initialize:', error);
+        // Fall back to legacy registration for backwards compatibility
+        (0, tools_1.registerTools)(server, authManager, undefined);
+    }
+})
+    .catch((error) => {
+    logger_1.logger.warn('Failed to initialize client factory during module load:', error);
+    (0, tools_1.registerTools)(server, authManager, undefined);
+});
+// Resolve VIKUNJA_API_TOKEN, honoring the VIKUNJA_API_TOKEN_FILE Docker-secrets
+// convention. Setting both the plain variable and its _FILE variant is a hard
+// startup error (see src/config/secrets.ts) rather than a silent precedence choice.
+let vikunjaApiToken;
+try {
+    vikunjaApiToken = (0, secrets_1.readSecretEnv)('VIKUNJA_API_TOKEN');
+}
+catch (error) {
+    logger_1.logger.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+}
+if (process.env.VIKUNJA_URL && vikunjaApiToken) {
+    const connectionMessage = (0, security_1.createSecureConnectionMessage)(process.env.VIKUNJA_URL, vikunjaApiToken);
+    logger_1.logger.info(`Auto-authenticating: ${connectionMessage}`);
+    authManager.connect(process.env.VIKUNJA_URL, vikunjaApiToken);
+    const detectedAuthType = authManager.getAuthType();
+    logger_1.logger.info(`Using detected auth type: ${detectedAuthType}`);
+}
+async function main() {
+    await exports.factoryInitializationPromise;
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    logger_1.logger.info('Vikunja MCP server started');
+    const config = (0, security_1.createSecureLogConfig)({
+        mode: process.env.MCP_MODE,
+        debug: process.env.DEBUG,
+        hasAuth: !!process.env.VIKUNJA_URL && !!vikunjaApiToken,
+        url: process.env.VIKUNJA_URL,
+        token: vikunjaApiToken,
+    });
+    logger_1.logger.debug('Configuration loaded', config);
+}
+// Only start the server if not in test environment
+if (process.env.NODE_ENV !== 'test' && !process.env.JEST_WORKER_ID) {
+    main().catch((error) => {
+        logger_1.logger.error('Failed to start server:', error);
+        process.exit(1);
+    });
+}
+// Essential exports only - eliminated 80+ lines of unnecessary barrel exports
+// Use direct imports instead of centralized re-exports for better tree-shaking
+// Core types that are commonly imported by external code
+var errors_1 = require("./types/errors");
+Object.defineProperty(exports, "MCPError", { enumerable: true, get: function () { return errors_1.MCPError; } });
+Object.defineProperty(exports, "ErrorCode", { enumerable: true, get: function () { return errors_1.ErrorCode; } });
+// Core utilities that are widely used across the codebase
+var logger_2 = require("./utils/logger");
+Object.defineProperty(exports, "logger", { enumerable: true, get: function () { return logger_2.logger; } });
+var auth_error_handler_1 = require("./utils/auth-error-handler");
+Object.defineProperty(exports, "isAuthenticationError", { enumerable: true, get: function () { return auth_error_handler_1.isAuthenticationError; } });
+var retry_1 = require("./utils/retry");
+Object.defineProperty(exports, "withRetry", { enumerable: true, get: function () { return retry_1.withRetry; } });
+Object.defineProperty(exports, "RETRY_CONFIG", { enumerable: true, get: function () { return retry_1.RETRY_CONFIG; } });
+var error_handler_1 = require("./utils/error-handler");
+Object.defineProperty(exports, "transformApiError", { enumerable: true, get: function () { return error_handler_1.transformApiError; } });
+Object.defineProperty(exports, "handleFetchError", { enumerable: true, get: function () { return error_handler_1.handleFetchError; } });
+Object.defineProperty(exports, "handleStatusCodeError", { enumerable: true, get: function () { return error_handler_1.handleStatusCodeError; } });
+var filters_1 = require("./utils/filters");
+Object.defineProperty(exports, "parseFilterString", { enumerable: true, get: function () { return filters_1.parseFilterString; } });
+var memory_1 = require("./utils/memory");
+Object.defineProperty(exports, "validateTaskCountLimit", { enumerable: true, get: function () { return memory_1.validateTaskCountLimit; } });
+var response_factory_1 = require("./utils/response-factory");
+Object.defineProperty(exports, "createStandardResponse", { enumerable: true, get: function () { return response_factory_1.createStandardResponse; } });
+Object.defineProperty(exports, "createErrorResponse", { enumerable: true, get: function () { return response_factory_1.createAorpErrorResponse; } });
+// Session utilities for external usage
+var client_2 = require("./client");
+Object.defineProperty(exports, "getAuthManagerFromContext", { enumerable: true, get: function () { return client_2.getAuthManagerFromContext; } });
+Object.defineProperty(exports, "clearGlobalClientFactory", { enumerable: true, get: function () { return client_2.clearGlobalClientFactory; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/middleware/direct-middleware.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Direct Middleware Application
+ * Simplified middleware functions without wrapper-on-wrapper patterns
+ */
+import type { AuthManager } from '../auth/AuthManager';
+export declare function applyRateLimiting<T extends unknown[], R>(toolName: string, handler: (...args: T) => Promise<R>): (...args: T) => Promise<R>;
+export declare function applyPermissions<T extends unknown[], R>(toolName: string, authManager: AuthManager, handler: (...args: T) => Promise<R>): (...args: T) => Promise<R>;
+export declare function applyBothMiddleware<T extends unknown[], R>(toolName: string, authManager: AuthManager, handler: (...args: T) => Promise<R>): (...args: T) => Promise<R>;
+//# sourceMappingURL=direct-middleware.d.ts.map

package/dist/middleware/direct-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-middleware.d.ts","sourceRoot":"","sources":["../../src/middleware/direct-middleware.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAOvD,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,EACtD,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAClC,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAE5B;AAGD,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,EACrD,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAClC,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CA8B5B;AAGD,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,EACxD,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAClC,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAG5B"}