@modyo/mcp 0.1.0

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

@@ -0,0 +1,26 @@
+export interface DocsDiscoveryResult {
+    flatPaths: string[];
+    pathMap: Map<string, string>;
+}
+/**
+ * Auto-discover tool documentation from a docs directory.
+ * Scans for **\/*.md files and creates a flat path mapping.
+ *
+ * @param docsPath - Absolute path to the docs directory
+ * @returns Object with flatPaths array and pathMap for lookup
+ *
+ * @example
+ * // Discovers docs/tools/types/manage.md -> "types-manage"
+ * const { flatPaths, pathMap } = await discoverDocs("/path/to/docs/tools");
+ */
+export declare function discoverDocs(docsPath: string): Promise<DocsDiscoveryResult>;
+/**
+ * Get the content of a specific documentation file.
+ *
+ * @param docsPath - Absolute path to the docs directory
+ * @param toolPath - Flat path identifier (e.g., "types-manage")
+ * @param pathMap - Map from flat paths to file paths
+ * @returns Markdown content or null if not found
+ */
+export declare function getDocContent(docsPath: string, toolPath: string, pathMap: Map<string, string>): Promise<string | null>;
+//# sourceMappingURL=docsDiscovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docsDiscovery.d.ts","sourceRoot":"","sources":["../../../src/shared/helpers/docsDiscovery.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,mBAAmB,CAAC,CAmC9B;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYxB"}

package/build/shared/helpers/docsDiscovery.js

@@ -0,0 +1,69 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+/**
+ * Auto-discover tool documentation from a docs directory.
+ * Scans for **\/*.md files and creates a flat path mapping.
+ *
+ * @param docsPath - Absolute path to the docs directory
+ * @returns Object with flatPaths array and pathMap for lookup
+ *
+ * @example
+ * // Discovers docs/tools/types/manage.md -> "types-manage"
+ * const { flatPaths, pathMap } = await discoverDocs("/path/to/docs/tools");
+ */
+export async function discoverDocs(docsPath) {
+    const flatPaths = [];
+    const pathMap = new Map();
+    async function scanDirectory(dir, prefix = "") {
+        try {
+            const entries = await fs.readdir(dir, {
+                withFileTypes: true,
+            });
+            for (const entry of entries) {
+                const fullPath = path.join(dir, entry.name);
+                const relativePath = prefix ? `${prefix}/${entry.name}` : entry.name;
+                if (entry.isDirectory()) {
+                    await scanDirectory(fullPath, relativePath);
+                }
+                else if (entry.isFile() && entry.name.endsWith(".md")) {
+                    // Store actual file path (e.g., "types/manage.md")
+                    const filePath = relativePath;
+                    // Create flat path by replacing / with - (e.g., "types-manage")
+                    const flatPath = relativePath.replace(".md", "").replace(/\//g, "-");
+                    flatPaths.push(flatPath);
+                    pathMap.set(flatPath, filePath);
+                }
+            }
+        }
+        catch {
+            // Directory doesn't exist or can't be read - return empty results
+        }
+    }
+    await scanDirectory(docsPath);
+    return {
+        flatPaths: flatPaths.sort(),
+        pathMap,
+    };
+}
+/**
+ * Get the content of a specific documentation file.
+ *
+ * @param docsPath - Absolute path to the docs directory
+ * @param toolPath - Flat path identifier (e.g., "types-manage")
+ * @param pathMap - Map from flat paths to file paths
+ * @returns Markdown content or null if not found
+ */
+export async function getDocContent(docsPath, toolPath, pathMap) {
+    const relativeFilePath = pathMap.get(toolPath);
+    if (!relativeFilePath) {
+        return null;
+    }
+    try {
+        const fullPath = path.join(docsPath, relativeFilePath);
+        return await fs.readFile(fullPath, "utf-8");
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=docsDiscovery.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docsDiscovery.js","sourceRoot":"","sources":["../../../src/shared/helpers/docsDiscovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAO7B;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAgB;IAEhB,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE1C,KAAK,UAAU,aAAa,CAAC,GAAW,EAAE,MAAM,GAAG,EAAE;QACnD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;gBACpC,aAAa,EAAE,IAAI;aACpB,CAAC,CAAC;YAEH,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC5C,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;gBAErE,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;oBACxB,MAAM,aAAa,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;gBAC9C,CAAC;qBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;oBACxD,mDAAmD;oBACnD,MAAM,QAAQ,GAAG,YAAY,CAAC;oBAC9B,gEAAgE;oBAChE,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;oBACrE,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBACzB,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBAClC,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,kEAAkE;QACpE,CAAC;IACH,CAAC;IAED,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC9B,OAAO;QACL,SAAS,EAAE,SAAS,CAAC,IAAI,EAAE;QAC3B,OAAO;KACR,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAgB,EAChB,QAAgB,EAChB,OAA4B;IAE5B,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC/C,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;QACvD,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,13 @@
+export declare const DOCS_ROOT: string;
+export declare const DOCS_TOOLS_PATH: string;
+/**
+ * Get the full path to a documentation file
+ * @param relativePath - Path relative to docs/ folder
+ */
+export declare function getDocsPath(relativePath: string): string;
+/**
+ * Get the full path to a tool documentation file
+ * @param relativePath - Path relative to docs/tools/ folder
+ */
+export declare function getToolDocsPath(relativePath: string): string;
+//# sourceMappingURL=getDocsPath.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getDocsPath.d.ts","sourceRoot":"","sources":["../../../src/shared/helpers/getDocsPath.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,SAAS,QAA4C,CAAC;AACnE,eAAO,MAAM,eAAe,QAA2B,CAAC;AAExD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE5D"}

package/build/shared/helpers/getDocsPath.js

@@ -0,0 +1,33 @@
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+/**
+ * Get the path to the docs folder relative to this module.
+ *
+ * This works correctly whether running from:
+ * - Source code (npm run dev)
+ * - Built package (npm start)
+ * - npx @modyo/mcp (installed in npm cache)
+ *
+ * The key is using import.meta.url instead of process.cwd(),
+ * which always returns the actual module location, not the user's working directory.
+ */
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// From build/shared/helpers/ go up 3 levels to package root, then into docs
+export const DOCS_ROOT = join(__dirname, "..", "..", "..", "docs");
+export const DOCS_TOOLS_PATH = join(DOCS_ROOT, "tools");
+/**
+ * Get the full path to a documentation file
+ * @param relativePath - Path relative to docs/ folder
+ */
+export function getDocsPath(relativePath) {
+    return join(DOCS_ROOT, relativePath);
+}
+/**
+ * Get the full path to a tool documentation file
+ * @param relativePath - Path relative to docs/tools/ folder
+ */
+export function getToolDocsPath(relativePath) {
+    return join(DOCS_TOOLS_PATH, relativePath);
+}
+//# sourceMappingURL=getDocsPath.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getDocsPath.js","sourceRoot":"","sources":["../../../src/shared/helpers/getDocsPath.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,4EAA4E;AAC5E,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AACnE,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AAExD;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,YAAoB;IAC9C,OAAO,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,YAAoB;IAClD,OAAO,IAAI,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;AAC7C,CAAC"}

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

@@ -0,0 +1,11 @@
+import type { Logger } from "../types/Logger.js";
+/**
+ * Get a repository instance using the configured platform from environment variables
+ *
+ * @param RepositoryClass - Repository constructor
+ * @param logger - Logger instance
+ * @returns Repository instance
+ * @throws Error if platform not configured
+ */
+export declare function getRepositoryOrThrow<T>(RepositoryClass: new (url: string, token: string, logger: Logger) => T, logger: Logger): Promise<T>;
+//# sourceMappingURL=getRepositoryOrThrow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getRepositoryOrThrow.d.ts","sourceRoot":"","sources":["../../../src/shared/helpers/getRepositoryOrThrow.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,eAAe,EAAE,KAAK,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC,EACtE,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,CAAC,CAAC,CAiBZ"}

package/build/shared/helpers/getRepositoryOrThrow.js

@@ -0,0 +1,21 @@
+import { singlePlatformProvider } from "../providers/SinglePlatformProvider.js";
+/**
+ * Get a repository instance using the configured platform from environment variables
+ *
+ * @param RepositoryClass - Repository constructor
+ * @param logger - Logger instance
+ * @returns Repository instance
+ * @throws Error if platform not configured
+ */
+export async function getRepositoryOrThrow(RepositoryClass, logger) {
+    const platform = singlePlatformProvider.getPlatform();
+    if (!platform) {
+        throw new Error(`Platform not configured. Set MODYO_URL and MODYO_TOKEN environment variables.`);
+    }
+    // Validate platform has required fields
+    if (!platform.url || !platform.token) {
+        throw new Error(`Platform is missing required fields (url: ${!!platform.url}, token: ${!!platform.token}). Check MODYO_URL and MODYO_TOKEN environment variables.`);
+    }
+    return new RepositoryClass(platform.url, platform.token, logger);
+}
+//# sourceMappingURL=getRepositoryOrThrow.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getRepositoryOrThrow.js","sourceRoot":"","sources":["../../../src/shared/helpers/getRepositoryOrThrow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAGhF;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,eAAsE,EACtE,MAAc;IAEd,MAAM,QAAQ,GAAG,sBAAsB,CAAC,WAAW,EAAE,CAAC;IAEtD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,+EAA+E,CAChF,CAAC;IACJ,CAAC;IAED,wCAAwC;IACxC,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CACb,6CAA6C,CAAC,CAAC,QAAQ,CAAC,GAAG,YAAY,CAAC,CAAC,QAAQ,CAAC,KAAK,2DAA2D,CACnJ,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,eAAe,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AACnE,CAAC"}

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

@@ -0,0 +1,16 @@
+export { singlePlatformProvider } from "../providers/SinglePlatformProvider.js";
+export * from "./assetsHelpers.js";
+export { cleanObject } from "./cleanObject.js";
+export { type BatchOptions, type BatchResult, processBatch, } from "./concurrentBatch.js";
+export * from "./contentOffloadHelper.js";
+export { type DocsDiscoveryResult, discoverDocs, getDocContent, } from "./docsDiscovery.js";
+export { DOCS_ROOT, DOCS_TOOLS_PATH, getDocsPath, getToolDocsPath, } from "./getDocsPath.js";
+export { getRepositoryOrThrow } from "./getRepositoryOrThrow.js";
+export { type Job, JobManager, type JobProgress, type JobStatus, jobManager, } from "./jobManager.js";
+export { logger, pinoLogger } from "./logger.js";
+export { type RetryOptions, retryWithBackoff } from "./retryWithBackoff.js";
+export { slugify } from "./slugify.js";
+export { slugRegex } from "./slugSchema.js";
+export { type DetectedContentType, detectContentType, detectHardcodedColors, type HardcodedColorMatch, hasMissingCspNonce, hasUnnecessaryWrapperTags, type TemplateContentValidation, validateTemplateContent, } from "./templateContentValidator.js";
+export { truncateContent } from "./truncateContent.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,YAAY,GACb,MAAM,sBAAsB,CAAC;AAC9B,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EACL,KAAK,mBAAmB,EACxB,YAAY,EACZ,aAAa,GACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,SAAS,EACT,eAAe,EACf,WAAW,EACX,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EACL,KAAK,GAAG,EACR,UAAU,EACV,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,UAAU,GACX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,KAAK,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EACL,KAAK,mBAAmB,EACxB,iBAAiB,EACjB,qBAAqB,EACrB,KAAK,mBAAmB,EACxB,kBAAkB,EAClB,yBAAyB,EACzB,KAAK,yBAAyB,EAC9B,uBAAuB,GACxB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/build/shared/helpers/index.js

@@ -0,0 +1,16 @@
+export { singlePlatformProvider } from "../providers/SinglePlatformProvider.js";
+export * from "./assetsHelpers.js";
+export { cleanObject } from "./cleanObject.js";
+export { processBatch, } from "./concurrentBatch.js";
+export * from "./contentOffloadHelper.js";
+export { discoverDocs, getDocContent, } from "./docsDiscovery.js";
+export { DOCS_ROOT, DOCS_TOOLS_PATH, getDocsPath, getToolDocsPath, } from "./getDocsPath.js";
+export { getRepositoryOrThrow } from "./getRepositoryOrThrow.js";
+export { JobManager, jobManager, } from "./jobManager.js";
+export { logger, pinoLogger } from "./logger.js";
+export { retryWithBackoff } from "./retryWithBackoff.js";
+export { slugify } from "./slugify.js";
+export { slugRegex } from "./slugSchema.js";
+export { detectContentType, detectHardcodedColors, hasMissingCspNonce, hasUnnecessaryWrapperTags, validateTemplateContent, } from "./templateContentValidator.js";
+export { truncateContent } from "./truncateContent.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAGL,YAAY,GACb,MAAM,sBAAsB,CAAC;AAC9B,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAEL,YAAY,EACZ,aAAa,GACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,SAAS,EACT,eAAe,EACf,WAAW,EACX,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAEL,UAAU,EAGV,UAAU,GACX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAqB,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAEL,iBAAiB,EACjB,qBAAqB,EAErB,kBAAkB,EAClB,yBAAyB,EAEzB,uBAAuB,GACxB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

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

@@ -0,0 +1,157 @@
+/**
+ * Job status types
+ */
+export type JobStatus = "pending" | "processing" | "completed" | "failed";
+/**
+ * Job progress information
+ */
+export interface JobProgress {
+    /**
+     * Current progress count
+     */
+    current: number;
+    /**
+     * Total items to process
+     */
+    total: number;
+    /**
+     * Human-readable progress message
+     */
+    message?: string;
+    /**
+     * Percentage complete (0-100)
+     */
+    percentage?: number;
+}
+/**
+ * Job metadata
+ */
+export interface Job<TResult = any, TError = any> {
+    /**
+     * Unique job identifier
+     */
+    id: string;
+    /**
+     * Job type (e.g., 'space-copy', 'bulk-upload')
+     */
+    type: string;
+    /**
+     * Current job status
+     */
+    status: JobStatus;
+    /**
+     * Progress information
+     */
+    progress?: JobProgress;
+    /**
+     * Job result (when completed)
+     */
+    result?: TResult;
+    /**
+     * Error information (when failed)
+     */
+    error?: TError;
+    /**
+     * Job creation timestamp
+     */
+    createdAt: string;
+    /**
+     * Last update timestamp
+     */
+    updatedAt: string;
+    /**
+     * Additional job-specific data
+     */
+    metadata?: Record<string, any>;
+}
+/**
+ * Simple file-based job manager
+ *
+ * Stores jobs in ~/.modyo-mcp/jobs.db as JSON
+ * Used for async job tracking in single-tenant mode.
+ */
+export declare class JobManager {
+    private dbPath;
+    private jobs;
+    constructor();
+    /**
+     * Load jobs from disk
+     */
+    private loadJobs;
+    /**
+     * Save jobs to disk
+     */
+    private saveJobs;
+    /**
+     * Create a new job
+     *
+     * @param type - Job type identifier
+     * @param metadata - Additional job-specific data
+     * @returns Created job with unique ID
+     */
+    createJob(type: string, metadata?: Record<string, any>): Job;
+    /**
+     * Get a job by ID
+     *
+     * @param jobId - Job identifier
+     * @returns Job or undefined if not found
+     */
+    getJob(jobId: string): Job | undefined;
+    /**
+     * Get all jobs
+     *
+     * @param filter - Optional filter by type or status
+     * @returns Array of jobs
+     */
+    getJobs(filter?: {
+        type?: string;
+        status?: JobStatus;
+    }): Job[];
+    /**
+     * Update job status
+     *
+     * @param jobId - Job identifier
+     * @param status - New status
+     */
+    updateStatus(jobId: string, status: JobStatus): void;
+    /**
+     * Update job progress
+     *
+     * @param jobId - Job identifier
+     * @param progress - Progress information
+     */
+    updateProgress(jobId: string, progress: JobProgress): void;
+    /**
+     * Complete a job with result
+     *
+     * @param jobId - Job identifier
+     * @param result - Job result data
+     */
+    completeJob<TResult>(jobId: string, result: TResult): void;
+    /**
+     * Fail a job with error
+     *
+     * @param jobId - Job identifier
+     * @param error - Error information
+     */
+    failJob<TError>(jobId: string, error: TError): void;
+    /**
+     * Delete a job
+     *
+     * @param jobId - Job identifier
+     * @returns True if deleted, false if not found
+     */
+    deleteJob(jobId: string): boolean;
+    /**
+     * Clean up old completed/failed jobs
+     *
+     * @param olderThanDays - Delete jobs older than this many days (default: 7)
+     * @returns Number of jobs deleted
+     */
+    cleanupOldJobs(olderThanDays?: number): number;
+}
+/**
+ * Global job manager instance
+ */
+export declare const jobManager: JobManager;
+//# sourceMappingURL=jobManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jobManager.d.ts","sourceRoot":"","sources":["../../../src/shared/helpers/jobManager.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,GAAG,CAAC,OAAO,GAAG,GAAG,EAAE,MAAM,GAAG,GAAG;IAC9C;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,MAAM,EAAE,SAAS,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAC;IAEvB;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED;;;;;GAKG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,IAAI,CAA+B;;IAa3C;;OAEG;IACH,OAAO,CAAC,QAAQ;IAkBhB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAShB;;;;;;OAMG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG;IAiB5D;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS;IAItC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,SAAS,CAAA;KAAE,GAAG,GAAG,EAAE;IAkB9D;;;;;OAKG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI;IASpD;;;;;OAKG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI;IAY1D;;;;;OAKG;IACH,WAAW,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAU1D;;;;;OAKG;IACH,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAUnD;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAQjC;;;;;OAKG;IACH,cAAc,CAAC,aAAa,SAAI,GAAG,MAAM;CAsB1C;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,YAAmB,CAAC"}

package/build/shared/helpers/jobManager.js

@@ -0,0 +1,205 @@
+import { randomUUID } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+/**
+ * Simple file-based job manager
+ *
+ * Stores jobs in ~/.modyo-mcp/jobs.db as JSON
+ * Used for async job tracking in single-tenant mode.
+ */
+export class JobManager {
+    dbPath;
+    jobs = new Map();
+    constructor() {
+        const modyoDir = join(homedir(), ".modyo-mcp");
+        if (!existsSync(modyoDir)) {
+            mkdirSync(modyoDir, {
+                recursive: true,
+            });
+        }
+        this.dbPath = join(modyoDir, "jobs.db");
+        this.loadJobs();
+    }
+    /**
+     * Load jobs from disk
+     */
+    loadJobs() {
+        try {
+            if (existsSync(this.dbPath)) {
+                const data = readFileSync(this.dbPath, "utf-8");
+                const jobsArray = JSON.parse(data);
+                this.jobs = new Map(jobsArray.map((job) => [
+                    job.id,
+                    job,
+                ]));
+            }
+        }
+        catch (error) {
+            console.error("Failed to load jobs:", error);
+            this.jobs = new Map();
+        }
+    }
+    /**
+     * Save jobs to disk
+     */
+    saveJobs() {
+        try {
+            const jobsArray = Array.from(this.jobs.values());
+            writeFileSync(this.dbPath, JSON.stringify(jobsArray, null, 2), "utf-8");
+        }
+        catch (error) {
+            console.error("Failed to save jobs:", error);
+        }
+    }
+    /**
+     * Create a new job
+     *
+     * @param type - Job type identifier
+     * @param metadata - Additional job-specific data
+     * @returns Created job with unique ID
+     */
+    createJob(type, metadata) {
+        const job = {
+            id: randomUUID(),
+            type,
+            status: "pending",
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+            ...(metadata !== undefined && {
+                metadata,
+            }),
+        };
+        this.jobs.set(job.id, job);
+        this.saveJobs();
+        return job;
+    }
+    /**
+     * Get a job by ID
+     *
+     * @param jobId - Job identifier
+     * @returns Job or undefined if not found
+     */
+    getJob(jobId) {
+        return this.jobs.get(jobId);
+    }
+    /**
+     * Get all jobs
+     *
+     * @param filter - Optional filter by type or status
+     * @returns Array of jobs
+     */
+    getJobs(filter) {
+        let jobs = Array.from(this.jobs.values());
+        if (filter?.type) {
+            jobs = jobs.filter((job) => job.type === filter.type);
+        }
+        if (filter?.status) {
+            jobs = jobs.filter((job) => job.status === filter.status);
+        }
+        // Sort by creation date (newest first)
+        return jobs.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+    }
+    /**
+     * Update job status
+     *
+     * @param jobId - Job identifier
+     * @param status - New status
+     */
+    updateStatus(jobId, status) {
+        const job = this.jobs.get(jobId);
+        if (job) {
+            job.status = status;
+            job.updatedAt = new Date().toISOString();
+            this.saveJobs();
+        }
+    }
+    /**
+     * Update job progress
+     *
+     * @param jobId - Job identifier
+     * @param progress - Progress information
+     */
+    updateProgress(jobId, progress) {
+        const job = this.jobs.get(jobId);
+        if (job) {
+            job.progress = {
+                ...progress,
+                percentage: Math.round((progress.current / progress.total) * 100),
+            };
+            job.updatedAt = new Date().toISOString();
+            this.saveJobs();
+        }
+    }
+    /**
+     * Complete a job with result
+     *
+     * @param jobId - Job identifier
+     * @param result - Job result data
+     */
+    completeJob(jobId, result) {
+        const job = this.jobs.get(jobId);
+        if (job) {
+            job.status = "completed";
+            job.result = result;
+            job.updatedAt = new Date().toISOString();
+            this.saveJobs();
+        }
+    }
+    /**
+     * Fail a job with error
+     *
+     * @param jobId - Job identifier
+     * @param error - Error information
+     */
+    failJob(jobId, error) {
+        const job = this.jobs.get(jobId);
+        if (job) {
+            job.status = "failed";
+            job.error = error;
+            job.updatedAt = new Date().toISOString();
+            this.saveJobs();
+        }
+    }
+    /**
+     * Delete a job
+     *
+     * @param jobId - Job identifier
+     * @returns True if deleted, false if not found
+     */
+    deleteJob(jobId) {
+        const deleted = this.jobs.delete(jobId);
+        if (deleted) {
+            this.saveJobs();
+        }
+        return deleted;
+    }
+    /**
+     * Clean up old completed/failed jobs
+     *
+     * @param olderThanDays - Delete jobs older than this many days (default: 7)
+     * @returns Number of jobs deleted
+     */
+    cleanupOldJobs(olderThanDays = 7) {
+        const cutoffDate = new Date();
+        cutoffDate.setDate(cutoffDate.getDate() - olderThanDays);
+        const cutoffTime = cutoffDate.getTime();
+        let deletedCount = 0;
+        for (const [jobId, job] of this.jobs.entries()) {
+            if ((job.status === "completed" || job.status === "failed") &&
+                new Date(job.updatedAt).getTime() < cutoffTime) {
+                this.jobs.delete(jobId);
+                deletedCount++;
+            }
+        }
+        if (deletedCount > 0) {
+            this.saveJobs();
+        }
+        return deletedCount;
+    }
+}
+/**
+ * Global job manager instance
+ */
+export const jobManager = new JobManager();
+//# sourceMappingURL=jobManager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jobManager.js","sourceRoot":"","sources":["../../../src/shared/helpers/jobManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAkFjC;;;;;GAKG;AACH,MAAM,OAAO,UAAU;IACb,MAAM,CAAS;IACf,IAAI,GAAqB,IAAI,GAAG,EAAE,CAAC;IAE3C;QACE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC;QAC/C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,SAAS,CAAC,QAAQ,EAAE;gBAClB,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ,EAAE,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,QAAQ;QACd,IAAI,CAAC;YACH,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5B,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAChD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAU,CAAC;gBAC5C,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,CACjB,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC;oBACrB,GAAG,CAAC,EAAE;oBACN,GAAG;iBACJ,CAAC,CACH,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;YAC7C,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;IAED;;OAEG;IACK,QAAQ;QACd,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YACjD,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAC1E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,SAAS,CAAC,IAAY,EAAE,QAA8B;QACpD,MAAM,GAAG,GAAQ;YACf,EAAE,EAAE,UAAU,EAAE;YAChB,IAAI;YACJ,MAAM,EAAE,SAAS;YACjB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI;gBAC5B,QAAQ;aACT,CAAC;SACH,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,KAAa;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,MAA8C;QACpD,IAAI,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAE1C,IAAI,MAAM,EAAE,IAAI,EAAE,CAAC;YACjB,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC;QACxD,CAAC;QAED,IAAI,MAAM,EAAE,MAAM,EAAE,CAAC;YACnB,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5D,CAAC;QAED,uCAAuC;QACvC,OAAO,IAAI,CAAC,IAAI,CACd,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACP,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CACpE,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,KAAa,EAAE,MAAiB;QAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,GAAG,EAAE,CAAC;YACR,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC;YACpB,GAAG,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YACzC,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,KAAa,EAAE,QAAqB;QACjD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,GAAG,EAAE,CAAC;YACR,GAAG,CAAC,QAAQ,GAAG;gBACb,GAAG,QAAQ;gBACX,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC;aAClE,CAAC;YACF,GAAG,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YACzC,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,WAAW,CAAU,KAAa,EAAE,MAAe;QACjD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,GAAG,EAAE,CAAC;YACR,GAAG,CAAC,MAAM,GAAG,WAAW,CAAC;YACzB,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC;YACpB,GAAG,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YACzC,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAS,KAAa,EAAE,KAAa;QAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,GAAG,EAAE,CAAC;YACR,GAAG,CAAC,MAAM,GAAG,QAAQ,CAAC;YACtB,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC;YAClB,GAAG,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YACzC,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,KAAa;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,aAAa,GAAG,CAAC;QAC9B,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC;QAC9B,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,aAAa,CAAC,CAAC;QACzD,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC;QAExC,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;YAC/C,IACE,CAAC,GAAG,CAAC,MAAM,KAAK,WAAW,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC;gBACvD,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,UAAU,EAC9C,CAAC;gBACD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACxB,YAAY,EAAE,CAAC;YACjB,CAAC;QACH,CAAC;QAED,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,CAAC;QAED,OAAO,YAAY,CAAC;IACtB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,UAAU,EAAE,CAAC"}

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

@@ -0,0 +1,19 @@
+import pino from "pino";
+import type { Logger } from "../types/Logger.js";
+/**
+ * Pino logger instance
+ * - Uses pino-pretty in development/debug mode for readable output
+ * - Uses JSON format in production for structured logging
+ */
+export declare const pinoLogger: pino.Logger<never, boolean>;
+/**
+ * Default logger implementation for shared package
+ * Logs using Pino with level-based formatting
+ *
+ * Environment Variables:
+ * - LOG_LEVEL: debug|info|warn|error (granular control)
+ * - DEBUG: true|1 (legacy, equivalent to LOG_LEVEL=debug)
+ * - NODE_ENV: development (enables pretty output)
+ */
+export declare const logger: Logger;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/shared/helpers/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAA4B,MAAM,MAAM,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAwCjD;;;;GAIG;AACH,eAAO,MAAM,UAAU,6BAA2B,CAAC;AAEnD;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM,EAAE,MAcpB,CAAC"}