@modyo/mcp 0.1.0

package/build/shared/helpers/concurrentBatch.d.ts

@@ -0,0 +1,95 @@
+import { type RetryOptions } from "./retryWithBackoff.js";
+/**
+ * Result of a single batch operation
+ */
+export interface BatchResult<T> {
+    /**
+     * Operation status
+     */
+    status: "success" | "failed";
+    /**
+     * Original item
+     */
+    item: T;
+    /**
+     * Operation result (if successful)
+     */
+    result?: any;
+    /**
+     * Error (if failed)
+     */
+    error?: Error;
+}
+/**
+ * Options for batch processing
+ */
+export interface BatchOptions<T> {
+    /**
+     * Items to process
+     */
+    items: T[];
+    /**
+     * Number of items to process in each batch (default: 10)
+     */
+    batchSize?: number;
+    /**
+     * Maximum number of concurrent operations within a batch (default: 5)
+     */
+    maxConcurrent?: number;
+    /**
+     * Operation to perform on each item
+     */
+    operation: (item: T) => Promise<any>;
+    /**
+     * Callback invoked after each item completes (success or failure)
+     * @param completed - Number of items completed so far
+     * @param total - Total number of items
+     */
+    onProgress?: (completed: number, total: number) => void;
+    /**
+     * Whether to continue processing if an item fails (default: true)
+     */
+    continueOnError?: boolean;
+    /**
+     * Retry options for each operation
+     */
+    retryOptions?: RetryOptions;
+}
+/**
+ * Process items in controlled batches with retry support.
+ *
+ * Features:
+ * - Controlled concurrency (max N operations in parallel)
+ * - Batch processing (process items in groups)
+ * - Automatic retry with exponential backoff
+ * - Progress tracking
+ * - Error isolation (one failure doesn't stop others)
+ *
+ * @param options - Batch processing options
+ * @returns Array of results with status for each item
+ *
+ * @example
+ * ```typescript
+ * const results = await processBatch({
+ *   items: entries,
+ *   batchSize: 10,
+ *   maxConcurrent: 5,
+ *   continueOnError: true,
+ *   retryOptions: {
+ *     maxRetries: 3,
+ *     retryableStatusCodes: [429, 503],
+ *   },
+ *   onProgress: (completed, total) => {
+ *     console.log(`Progress: ${completed}/${total}`);
+ *   },
+ *   operation: async (entry) => {
+ *     return await createEntry(entry);
+ *   },
+ * });
+ *
+ * const successCount = results.filter(r => r.status === 'success').length;
+ * const failCount = results.filter(r => r.status === 'failed').length;
+ * ```
+ */
+export declare function processBatch<T>(options: BatchOptions<T>): Promise<Array<BatchResult<T>>>;
+//# sourceMappingURL=concurrentBatch.d.ts.map

package/build/shared/helpers/concurrentBatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrentBatch.d.ts","sourceRoot":"","sources":["../../../src/shared/helpers/concurrentBatch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAoB,MAAM,uBAAuB,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B;;OAEG;IACH,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;IAE7B;;OAEG;IACH,IAAI,EAAE,CAAC,CAAC;IAER;;OAEG;IACH,MAAM,CAAC,EAAE,GAAG,CAAC;IAEb;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B;;OAEG;IACH,KAAK,EAAE,CAAC,EAAE,CAAC;IAEX;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAErC;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAExD;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GACvB,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAyEhC"}

package/build/shared/helpers/concurrentBatch.js

@@ -0,0 +1,94 @@
+import { retryWithBackoff } from "./retryWithBackoff.js";
+/**
+ * Process items in controlled batches with retry support.
+ *
+ * Features:
+ * - Controlled concurrency (max N operations in parallel)
+ * - Batch processing (process items in groups)
+ * - Automatic retry with exponential backoff
+ * - Progress tracking
+ * - Error isolation (one failure doesn't stop others)
+ *
+ * @param options - Batch processing options
+ * @returns Array of results with status for each item
+ *
+ * @example
+ * ```typescript
+ * const results = await processBatch({
+ *   items: entries,
+ *   batchSize: 10,
+ *   maxConcurrent: 5,
+ *   continueOnError: true,
+ *   retryOptions: {
+ *     maxRetries: 3,
+ *     retryableStatusCodes: [429, 503],
+ *   },
+ *   onProgress: (completed, total) => {
+ *     console.log(`Progress: ${completed}/${total}`);
+ *   },
+ *   operation: async (entry) => {
+ *     return await createEntry(entry);
+ *   },
+ * });
+ *
+ * const successCount = results.filter(r => r.status === 'success').length;
+ * const failCount = results.filter(r => r.status === 'failed').length;
+ * ```
+ */
+export async function processBatch(options) {
+    const { items, batchSize = 10, operation, onProgress, continueOnError = true, retryOptions = {}, } = options;
+    const results = [];
+    let completed = 0;
+    // Process items in batches
+    for (let i = 0; i < items.length; i += batchSize) {
+        const batch = items.slice(i, i + batchSize);
+        // Process batch with concurrency limit
+        // Note: We use Promise.all here but each operation has its own retry logic
+        const batchResults = await Promise.all(batch.map(async (item) => {
+            try {
+                // Wrap operation with retry logic
+                const result = await retryWithBackoff(() => operation(item), {
+                    ...retryOptions,
+                    onRetry: (attempt, error, delay) => {
+                        // Log retry attempts if retry callback provided
+                        if (retryOptions.onRetry) {
+                            retryOptions.onRetry(attempt, error, delay);
+                        }
+                    },
+                });
+                completed++;
+                if (onProgress) {
+                    onProgress(completed, items.length);
+                }
+                return {
+                    status: "success",
+                    item,
+                    result,
+                };
+            }
+            catch (error) {
+                completed++;
+                if (onProgress) {
+                    onProgress(completed, items.length);
+                }
+                // If continueOnError is false, rethrow to stop all processing
+                if (!continueOnError) {
+                    throw error;
+                }
+                return {
+                    status: "failed",
+                    item,
+                    error: error,
+                };
+            }
+        }));
+        results.push(...batchResults);
+        // Small delay between batches to avoid overwhelming API
+        // This helps with rate limiting even if we're not hitting 429s
+        if (i + batchSize < items.length) {
+            await new Promise((resolve) => setTimeout(resolve, 100));
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=concurrentBatch.js.map

package/build/shared/helpers/concurrentBatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrentBatch.js","sourceRoot":"","sources":["../../../src/shared/helpers/concurrentBatch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAqE5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAwB;IAExB,MAAM,EACJ,KAAK,EACL,SAAS,GAAG,EAAE,EACd,SAAS,EACT,UAAU,EACV,eAAe,GAAG,IAAI,EACtB,YAAY,GAAG,EAAE,GAClB,GAAG,OAAO,CAAC;IAEZ,MAAM,OAAO,GAA0B,EAAE,CAAC;IAC1C,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,2BAA2B;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC;QAE5C,uCAAuC;QACvC,2EAA2E;QAC3E,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,GAAG,CACpC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YACvB,IAAI,CAAC;gBACH,kCAAkC;gBAClC,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE;oBAC3D,GAAG,YAAY;oBACf,OAAO,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;wBACjC,gDAAgD;wBAChD,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;4BACzB,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;wBAC9C,CAAC;oBACH,CAAC;iBACF,CAAC,CAAC;gBAEH,SAAS,EAAE,CAAC;gBACZ,IAAI,UAAU,EAAE,CAAC;oBACf,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;gBACtC,CAAC;gBAED,OAAO;oBACL,MAAM,EAAE,SAAkB;oBAC1B,IAAI;oBACJ,MAAM;iBACP,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,SAAS,EAAE,CAAC;gBACZ,IAAI,UAAU,EAAE,CAAC;oBACf,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;gBACtC,CAAC;gBAED,8DAA8D;gBAC9D,IAAI,CAAC,eAAe,EAAE,CAAC;oBACrB,MAAM,KAAK,CAAC;gBACd,CAAC;gBAED,OAAO;oBACL,MAAM,EAAE,QAAiB;oBACzB,IAAI;oBACJ,KAAK,EAAE,KAAc;iBACtB,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CACH,CAAC;QAEF,OAAO,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,CAAC;QAE9B,wDAAwD;QACxD,+DAA+D;QAC/D,IAAI,CAAC,GAAG,SAAS,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YACjC,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/build/shared/helpers/contentOffloadHelper.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Modyo module types that can have content offloaded
+ */
+export type ModyoModule = "channels" | "content" | "global";
+/**
+ * Categories for Channels module content
+ */
+export type ChannelsCategory = "widgets" | "snippets" | "layouts" | "stylesheets" | "javascripts" | "navigation";
+/**
+ * Categories for Content module content
+ */
+export type ContentCategory = "types" | "entries";
+/**
+ * All possible content categories
+ */
+export type ContentOffloadCategory = ChannelsCategory | ContentCategory;
+/**
+ * Options for offloading content to filesystem
+ */
+export interface OffloadOptions {
+    /** Modyo module (channels, content, global) */
+    module: ModyoModule;
+    /** Context slug (siteSlug for channels, spaceSlug for content, empty for global) */
+    contextSlug?: string;
+    /** Content category (widgets, snippets, layouts, etc.) */
+    category: ContentOffloadCategory;
+    /** Resource name (widget/template/type name - will be slugified) */
+    name: string;
+    /** Subfile identifier for nested content (e.g., 'html', 'css', 'js' for widgets) */
+    subfile?: string;
+    /** File extension override (default based on category) */
+    extension?: string;
+    /** Base path for writing files (defaults to process.cwd()) */
+    basePath?: string | undefined;
+}
+/**
+ * Result of offloading content to filesystem
+ */
+export interface OffloadResult {
+    /** Absolute path to the written file */
+    path: string;
+    /** Relative path from project root (for response) */
+    relativePath: string;
+    /** Number of bytes written */
+    size: number;
+}
+/**
+ * Get the base output directory for offloaded content
+ * @returns Absolute path to the .modyo-mcp directory
+ */
+export declare function getOutputBaseDir(): string;
+/**
+ * Build the output path for offloaded content
+ * @param options - Offload options
+ * @returns Relative path from project root
+ */
+export declare function buildOutputPath(options: OffloadOptions): string;
+/**
+ * Offload content to the filesystem
+ *
+ * Writes content to an organized folder structure:
+ * .modyo-mcp/{module}/{contextSlug}/{category}/{name}/...
+ *
+ * @param content - The content to write (string)
+ * @param options - Offload options specifying location
+ * @returns Result with paths and size
+ *
+ * @example
+ * // Offload a widget's HTML
+ * await offloadContent(widgetHtml, {
+ *   module: 'channels',
+ *   contextSlug: 'my-site',
+ *   category: 'widgets',
+ *   name: 'Hero Banner',
+ *   subfile: 'html'
+ * });
+ * // Writes to: .modyo-mcp/channels/my-site/widgets/hero-banner/html.liquid
+ *
+ * @example
+ * // Offload a snippet
+ * await offloadContent(snippetBody, {
+ *   module: 'channels',
+ *   contextSlug: 'my-site',
+ *   category: 'snippets',
+ *   name: 'header'
+ * });
+ * // Writes to: .modyo-mcp/channels/my-site/snippets/header.liquid
+ */
+export declare function offloadContent(content: string, options: OffloadOptions): Promise<OffloadResult>;
+/**
+ * Offload widget code (html, css, js) to filesystem
+ *
+ * Convenience function for offloading all three widget files at once.
+ * Uses parallel I/O for better performance.
+ *
+ * @param widget - Object containing html, css, js content
+ * @param options - Base offload options (without subfile)
+ * @returns Object with paths for each file type
+ */
+export declare function offloadWidgetCode(widget: {
+    html?: string;
+    css?: string;
+    js?: string;
+}, options: Omit<OffloadOptions, "subfile" | "category">): Promise<{
+    html?: string;
+    css?: string;
+    js?: string;
+}>;
+//# sourceMappingURL=contentOffloadHelper.d.ts.map

package/build/shared/helpers/contentOffloadHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contentOffloadHelper.d.ts","sourceRoot":"","sources":["../../../src/shared/helpers/contentOffloadHelper.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,SAAS,GACT,UAAU,GACV,SAAS,GACT,aAAa,GACb,aAAa,GACb,YAAY,CAAC;AAEjB;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,SAAS,CAAC;AAElD;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,gBAAgB,GAAG,eAAe,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,MAAM,EAAE,WAAW,CAAC;IACpB,oFAAoF;IACpF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,QAAQ,EAAE,sBAAsB,CAAC;IACjC,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd;AAgBD;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAqC/D;AAYD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC,CAiBxB;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE;IACN,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,EACD,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,UAAU,CAAC,GACpD,OAAO,CAAC;IACT,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC,CAkDD"}

package/build/shared/helpers/contentOffloadHelper.js

@@ -0,0 +1,162 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { slugify } from "./slugify.js";
+/**
+ * Default file extensions by category
+ */
+const DEFAULT_EXTENSIONS = {
+    widgets: ".liquid",
+    snippets: ".liquid",
+    layouts: ".liquid",
+    stylesheets: ".css",
+    javascripts: ".js",
+    navigation: ".json",
+    types: ".json",
+    entries: ".json",
+};
+/**
+ * Get the base output directory for offloaded content
+ * @returns Absolute path to the .modyo-mcp directory
+ */
+export function getOutputBaseDir() {
+    return join(process.cwd(), ".modyo-mcp");
+}
+/**
+ * Build the output path for offloaded content
+ * @param options - Offload options
+ * @returns Relative path from project root
+ */
+export function buildOutputPath(options) {
+    const { module, contextSlug, category, name, subfile, extension } = options;
+    const slugifiedName = slugify(name);
+    const ext = extension || DEFAULT_EXTENSIONS[category] || ".txt";
+    const parts = [
+        ".modyo-mcp",
+    ];
+    // Add module
+    parts.push(module);
+    // Add context slug if provided (site or space)
+    if (contextSlug) {
+        parts.push(slugify(contextSlug));
+    }
+    // Add category
+    parts.push(category);
+    // For widgets, create a folder with the widget name
+    if (category === "widgets") {
+        parts.push(slugifiedName);
+        // Add subfile (html, css, js) with extension
+        const filename = subfile ? `${subfile}${ext}` : `index${ext}`;
+        parts.push(filename);
+    }
+    else if (category === "entries" && subfile) {
+        // For entries, subfile is the typeUid
+        parts.push(subfile);
+        parts.push(`${slugifiedName}${ext}`);
+    }
+    else {
+        // For other categories, name is the filename
+        parts.push(`${slugifiedName}${ext}`);
+    }
+    return parts.join("/");
+}
+/**
+ * Ensure a directory exists, creating it recursively if needed
+ * @param dirPath - Directory path to ensure
+ */
+async function ensureDirectoryExists(dirPath) {
+    await mkdir(dirPath, {
+        recursive: true,
+    });
+}
+/**
+ * Offload content to the filesystem
+ *
+ * Writes content to an organized folder structure:
+ * .modyo-mcp/{module}/{contextSlug}/{category}/{name}/...
+ *
+ * @param content - The content to write (string)
+ * @param options - Offload options specifying location
+ * @returns Result with paths and size
+ *
+ * @example
+ * // Offload a widget's HTML
+ * await offloadContent(widgetHtml, {
+ *   module: 'channels',
+ *   contextSlug: 'my-site',
+ *   category: 'widgets',
+ *   name: 'Hero Banner',
+ *   subfile: 'html'
+ * });
+ * // Writes to: .modyo-mcp/channels/my-site/widgets/hero-banner/html.liquid
+ *
+ * @example
+ * // Offload a snippet
+ * await offloadContent(snippetBody, {
+ *   module: 'channels',
+ *   contextSlug: 'my-site',
+ *   category: 'snippets',
+ *   name: 'header'
+ * });
+ * // Writes to: .modyo-mcp/channels/my-site/snippets/header.liquid
+ */
+export async function offloadContent(content, options) {
+    const relativePath = buildOutputPath(options);
+    const baseDir = options.basePath || process.cwd();
+    const absolutePath = join(baseDir, relativePath);
+    // Ensure the directory exists using path.dirname for proper path handling
+    const dirPath = dirname(absolutePath);
+    await ensureDirectoryExists(dirPath);
+    // Write the content
+    await writeFile(absolutePath, content, "utf-8");
+    return {
+        path: absolutePath,
+        relativePath,
+        size: Buffer.byteLength(content, "utf-8"),
+    };
+}
+/**
+ * Offload widget code (html, css, js) to filesystem
+ *
+ * Convenience function for offloading all three widget files at once.
+ * Uses parallel I/O for better performance.
+ *
+ * @param widget - Object containing html, css, js content
+ * @param options - Base offload options (without subfile)
+ * @returns Object with paths for each file type
+ */
+export async function offloadWidgetCode(widget, options) {
+    const results = {};
+    // Build array of promises for parallel execution
+    const operations = [];
+    if (widget.html !== undefined) {
+        operations.push(offloadContent(widget.html, {
+            ...options,
+            category: "widgets",
+            subfile: "html",
+        }).then((result) => {
+            results.html = result.relativePath;
+        }));
+    }
+    if (widget.css !== undefined) {
+        operations.push(offloadContent(widget.css, {
+            ...options,
+            category: "widgets",
+            subfile: "css",
+        }).then((result) => {
+            results.css = result.relativePath;
+        }));
+    }
+    if (widget.js !== undefined) {
+        operations.push(offloadContent(widget.js, {
+            ...options,
+            category: "widgets",
+            subfile: "js",
+        }).then((result) => {
+            results.js = result.relativePath;
+        }));
+    }
+    // Execute all writes in parallel
+    await Promise.all(operations);
+    return results;
+}
+//# sourceMappingURL=contentOffloadHelper.js.map

package/build/shared/helpers/contentOffloadHelper.js.map

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

package/build/shared/helpers/deprecation.d.ts

@@ -0,0 +1,76 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+/**
+ * Metadata about a deprecated tool
+ */
+export interface DeprecationMetadata {
+    /** Version when this tool was deprecated (e.g., "2.0.0") */
+    since: string;
+    /** Name of the replacement tool */
+    replacement: string;
+    /** Brief example of how to use the replacement */
+    example: string;
+    /** Version when this tool will be removed (e.g., "3.0.0") */
+    removalVersion: string;
+    /** URL to migration documentation */
+    documentationUrl: string;
+}
+/**
+ * Logs a deprecation warning to console when a deprecated tool is used
+ *
+ * @param toolName - Name of the deprecated tool
+ * @param metadata - Deprecation metadata
+ *
+ * @example
+ * ```typescript
+ * logDeprecationWarning("entry-create", {
+ *   since: "2.0.0",
+ *   replacement: "entries-manage",
+ *   example: "Use entries-manage with action='manage' and entry creation fields",
+ *   removalVersion: "3.0.0",
+ *   documentationUrl: "modyo://docs/migration/entries#create"
+ * });
+ * ```
+ */
+export declare function logDeprecationWarning(toolName: string, metadata: DeprecationMetadata): void;
+/**
+ * Creates a CallToolResult with deprecation metadata included
+ *
+ * @param content - The actual tool response data
+ * @param metadata - Deprecation metadata to include
+ * @returns CallToolResult with _meta field containing deprecation info
+ *
+ * @example
+ * ```typescript
+ * const result = await this.repository.create(params);
+ * return createDeprecationResponse(result, this.deprecationMetadata);
+ * ```
+ */
+export declare function createDeprecationResponse(content: unknown, metadata: DeprecationMetadata): CallToolResult;
+/**
+ * Class decorator to mark a tool as deprecated
+ *
+ * Automatically adds deprecation metadata to the tool's config and ensures
+ * the tool logs warnings when used.
+ *
+ * @param metadata - Deprecation metadata
+ * @returns Class decorator function
+ *
+ * @example
+ * ```typescript
+ * @markAsDeprecated({
+ *   since: "2.0.0",
+ *   replacement: "entries-manage",
+ *   example: "Use entries-manage with action='manage'",
+ *   removalVersion: "3.0.0",
+ *   documentationUrl: "modyo://docs/migration/entries#create"
+ * })
+ * export class EntryCreateTool extends ToolBase<ParamsSchema> {
+ *   protected config = {
+ *     name: "entry-create",
+ *     description: "Creates a new entry",
+ *   };
+ * }
+ * ```
+ */
+export declare function markAsDeprecated(metadata: DeprecationMetadata): <T extends new (...args: any[]) => any>(TargetClass: T) => T;
+//# sourceMappingURL=deprecation.d.ts.map

package/build/shared/helpers/deprecation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deprecation.d.ts","sourceRoot":"","sources":["../../../src/shared/helpers/deprecation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,cAAc,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,mBAAmB,GAC5B,IAAI,CAQN;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,mBAAmB,GAC5B,cAAc,CA2BhB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,mBAAmB,IAC3C,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,aAAa,CAAC,KAAG,CAAC,CAS3E"}

package/build/shared/helpers/deprecation.js

@@ -0,0 +1,97 @@
+/**
+ * Logs a deprecation warning to console when a deprecated tool is used
+ *
+ * @param toolName - Name of the deprecated tool
+ * @param metadata - Deprecation metadata
+ *
+ * @example
+ * ```typescript
+ * logDeprecationWarning("entry-create", {
+ *   since: "2.0.0",
+ *   replacement: "entries-manage",
+ *   example: "Use entries-manage with action='manage' and entry creation fields",
+ *   removalVersion: "3.0.0",
+ *   documentationUrl: "modyo://docs/migration/entries#create"
+ * });
+ * ```
+ */
+export function logDeprecationWarning(toolName, metadata) {
+    console.warn(`[DEPRECATION WARNING] Tool "${toolName}" is deprecated since v${metadata.since}.\n` +
+        `  → Use "${metadata.replacement}" instead.\n` +
+        `  → Example: ${metadata.example}\n` +
+        `  → Will be removed in v${metadata.removalVersion}\n` +
+        `  → See: ${metadata.documentationUrl}`);
+}
+/**
+ * Creates a CallToolResult with deprecation metadata included
+ *
+ * @param content - The actual tool response data
+ * @param metadata - Deprecation metadata to include
+ * @returns CallToolResult with _meta field containing deprecation info
+ *
+ * @example
+ * ```typescript
+ * const result = await this.repository.create(params);
+ * return createDeprecationResponse(result, this.deprecationMetadata);
+ * ```
+ */
+export function createDeprecationResponse(content, metadata) {
+    // Convert content to object if it's not already
+    const contentObj = typeof content === "object" && content !== null ? content : {};
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    ...contentObj,
+                    _meta: {
+                        deprecated: true,
+                        deprecatedSince: metadata.since,
+                        replacement: metadata.replacement,
+                        removalVersion: metadata.removalVersion,
+                        documentationUrl: metadata.documentationUrl,
+                    },
+                }, null, 2),
+            },
+        ],
+        isError: false,
+    };
+}
+/**
+ * Class decorator to mark a tool as deprecated
+ *
+ * Automatically adds deprecation metadata to the tool's config and ensures
+ * the tool logs warnings when used.
+ *
+ * @param metadata - Deprecation metadata
+ * @returns Class decorator function
+ *
+ * @example
+ * ```typescript
+ * @markAsDeprecated({
+ *   since: "2.0.0",
+ *   replacement: "entries-manage",
+ *   example: "Use entries-manage with action='manage'",
+ *   removalVersion: "3.0.0",
+ *   documentationUrl: "modyo://docs/migration/entries#create"
+ * })
+ * export class EntryCreateTool extends ToolBase<ParamsSchema> {
+ *   protected config = {
+ *     name: "entry-create",
+ *     description: "Creates a new entry",
+ *   };
+ * }
+ * ```
+ */
+export function markAsDeprecated(metadata) {
+    return function (TargetClass) {
+        return class extends TargetClass {
+            config = {
+                ...(super.config || this.config),
+                isDeprecated: true,
+                deprecationMetadata: metadata,
+            };
+        };
+    };
+}
+//# sourceMappingURL=deprecation.js.map

package/build/shared/helpers/deprecation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deprecation.js","sourceRoot":"","sources":["../../../src/shared/helpers/deprecation.ts"],"names":[],"mappings":"AAkBA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAgB,EAChB,QAA6B;IAE7B,OAAO,CAAC,IAAI,CACV,+BAA+B,QAAQ,0BAA0B,QAAQ,CAAC,KAAK,KAAK;QAClF,YAAY,QAAQ,CAAC,WAAW,cAAc;QAC9C,gBAAgB,QAAQ,CAAC,OAAO,IAAI;QACpC,2BAA2B,QAAQ,CAAC,cAAc,IAAI;QACtD,YAAY,QAAQ,CAAC,gBAAgB,EAAE,CAC1C,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAAgB,EAChB,QAA6B;IAE7B,gDAAgD;IAChD,MAAM,UAAU,GACd,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAEjE,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;oBACE,GAAG,UAAU;oBACb,KAAK,EAAE;wBACL,UAAU,EAAE,IAAI;wBAChB,eAAe,EAAE,QAAQ,CAAC,KAAK;wBAC/B,WAAW,EAAE,QAAQ,CAAC,WAAW;wBACjC,cAAc,EAAE,QAAQ,CAAC,cAAc;wBACvC,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB;qBAC5C;iBACF,EACD,IAAI,EACJ,CAAC,CACF;aACF;SACF;QACD,OAAO,EAAE,KAAK;KACf,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAA6B;IAC5D,OAAO,UAAiD,WAAc;QACpE,OAAO,KAAM,SAAQ,WAAW;YAC9B,MAAM,GAAQ;gBACZ,GAAG,CAAC,KAAK,CAAC,MAAM,IAAK,IAAY,CAAC,MAAM,CAAC;gBACzC,YAAY,EAAE,IAAI;gBAClB,mBAAmB,EAAE,QAAQ;aAC9B,CAAC;SACa,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC"}