@vinkius-core/mcp-fusion 2.6.0 → 2.8.0

package/dist/client/FusionClient.js

@@ -27,6 +27,110 @@
  */
 import {} from '../core/response.js';
 // ============================================================================
+// Structured Client Error
+// ============================================================================
+/**
+ * Structured error parsed from a `<tool_error>` XML envelope.
+ *
+ * Provides typed access to self-healing fields so client code
+ * can programmatically react to server errors without regex parsing.
+ */
+export class FusionClientError extends Error {
+    /** Error code from the `code` attribute (e.g. `'NOT_FOUND'`). */
+    code;
+    /** Recovery suggestion from `<recovery>` element. */
+    recovery;
+    /** Available actions from `<available_actions>` children. */
+    availableActions;
+    /** Error severity from the `severity` attribute. */
+    severity;
+    /** Raw ToolResponse that caused the error. */
+    raw;
+    constructor(message, code, raw, options) {
+        super(message);
+        this.name = 'FusionClientError';
+        this.code = code;
+        this.raw = raw;
+        this.recovery = options?.recovery;
+        this.availableActions = Object.freeze(options?.availableActions ?? []);
+        this.severity = options?.severity ?? 'error';
+    }
+}
+// ============================================================================
+// XML Error Parser (Internal)
+// ============================================================================
+/**
+ * Decode XML entities back to their original characters.
+ *
+ * Reverses the escaping applied by `escapeXml()` and `escapeXmlAttr()`
+ * so that parsed error messages are human-readable.
+ *
+ * @internal
+ */
+function unescapeXml(str) {
+    return str
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&apos;/g, "'")
+        .replace(/&amp;/g, '&'); // &amp; must be last to avoid double-decode
+}
+/**
+ * Parse a `<tool_error>` XML envelope into structured fields.
+ *
+ * Coupled to the output format of `toolError()` from `response.ts`.
+ * Uses regex for lightweight parsing — acceptable since the XML is
+ * self-produced by the framework, not user-authored.
+ *
+ * @internal
+ */
+function parseToolErrorXml(text) {
+    const codeMatch = text.match(/<tool_error\s[^>]*code="([^"]+)"/);
+    const severityMatch = text.match(/<tool_error\s[^>]*severity="([^"]+)"/);
+    const messageMatch = text.match(/<message>([\s\S]*?)<\/message>/);
+    const recoveryMatch = text.match(/<recovery>([\s\S]*?)<\/recovery>/);
+    if (!messageMatch)
+        return null;
+    const actions = [];
+    const actionMatches = text.matchAll(/<action>([\s\S]*?)<\/action>/g);
+    for (const m of actionMatches) {
+        if (m[1])
+            actions.push(unescapeXml(m[1].trim()));
+    }
+    // Fallback: legacy comma-separated format
+    if (actions.length === 0) {
+        const legacyMatch = text.match(/<available_actions>([\s\S]*?)<\/available_actions>/);
+        if (legacyMatch?.[1]) {
+            actions.push(...legacyMatch[1].split(',').map(a => unescapeXml(a.trim())).filter(Boolean));
+        }
+    }
+    const recovery = recoveryMatch?.[1] != null ? unescapeXml(recoveryMatch[1].trim()) : undefined;
+    const result = {
+        code: codeMatch?.[1] != null ? unescapeXml(codeMatch[1]) : 'UNKNOWN',
+        message: unescapeXml(messageMatch[1].trim()),
+        availableActions: actions,
+        severity: severityMatch?.[1] ?? 'error',
+    };
+    if (recovery !== undefined) {
+        result.recovery = recovery;
+    }
+    return result;
+}
+// ============================================================================
+// Middleware Chain Compiler (Internal)
+// ============================================================================
+/** @internal */
+function compileClientMiddleware(middleware, terminal) {
+    let chain = terminal;
+    // Wrap from right to left: first middleware in array = outermost
+    for (let i = middleware.length - 1; i >= 0; i--) {
+        const mw = middleware[i];
+        const next = chain;
+        chain = (action, args) => mw(action, args, next);
+    }
+    return chain;
+}
+// ============================================================================
 // Factory
 // ============================================================================
 /**
@@ -38,6 +142,7 @@ import {} from '../core/response.js';
  *
  * @typeParam TRouter - The router map (use `InferRouter<typeof registry>`)
  * @param transport - The MCP transport layer
+ * @param options - Client options (middleware, error handling)
  * @returns A typed {@link FusionClient}
  *
  * @example
@@ -55,21 +160,78 @@ import {} from '../core/response.js';
  * // TS error: missing required arg 'name'
  * await client.execute('projects.create', {});
  * ```
+ *
+ * @example
+ * ```typescript
+ * // With client middleware and throwOnError
+ * const client = createFusionClient<AppRouter>(transport, {
+ *     throwOnError: true,
+ *     middleware: [
+ *         async (action, args, next) => {
+ *             console.log(`[Client] calling ${action}`);
+ *             const result = await next(action, args);
+ *             console.log(`[Client] ${action} done`);
+ *             return result;
+ *         },
+ *     ],
+ * });
+ * ```
  */
-export function createFusionClient(transport) {
+export function createFusionClient(transport, options) {
+    const throwOnError = options?.throwOnError ?? false;
+    /** Terminal function: builds the MCP call from the dotted action path */
+    function terminalCall(action, args) {
+        const dotIndex = action.indexOf('.');
+        if (dotIndex === -1) {
+            return transport.callTool(action, args);
+        }
+        const toolName = action.substring(0, dotIndex);
+        const actionName = action.substring(dotIndex + 1);
+        return transport.callTool(toolName, {
+            action: actionName,
+            ...args,
+        });
+    }
+    // Compile middleware chain once at creation time
+    const dispatch = (options?.middleware != null && options.middleware.length > 0)
+        ? compileClientMiddleware(options.middleware, terminalCall)
+        : terminalCall;
+    /** Post-process: handle throwOnError */
+    async function executeInternal(action, args) {
+        const result = await dispatch(action, args);
+        if (throwOnError && result.isError) {
+            const text = result.content
+                .map(c => c.text)
+                .join('\n');
+            const parsed = parseToolErrorXml(text);
+            if (parsed) {
+                const opts = {
+                    availableActions: parsed.availableActions,
+                    severity: parsed.severity,
+                };
+                if (parsed.recovery !== undefined) {
+                    opts.recovery = parsed.recovery;
+                }
+                throw new FusionClientError(parsed.message, parsed.code, result, opts);
+            }
+            throw new FusionClientError(text || 'Unknown error', 'UNKNOWN', result);
+        }
+        return result;
+    }
     return {
         async execute(action, args) {
-            // Parse "toolName.actionName" from the action path
-            const dotIndex = action.indexOf('.');
-            if (dotIndex === -1) {
-                return transport.callTool(action, args);
+            return executeInternal(action, args);
+        },
+        async executeBatch(calls, batchOptions) {
+            const items = calls;
+            if (batchOptions?.sequential) {
+                const results = [];
+                for (const call of items) {
+                    results.push(await executeInternal(call.action, call.args));
+                }
+                return results;
             }
-            const toolName = action.substring(0, dotIndex);
-            const actionName = action.substring(dotIndex + 1);
-            return transport.callTool(toolName, {
-                action: actionName,
-                ...args,
-            });
+            return Promise.all(items.map(call => executeInternal(call.action, call.args)));
         },
     };
 }

package/dist/client/FusionClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"FusionClient.js","sourceRoot":"","sources":["../../src/client/FusionClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,EAAqB,MAAM,qBAAqB,CAAC;AAoDxD,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,kBAAkB,CAC9B,SAA0B;IAE1B,OAAO;QACH,KAAK,CAAC,OAAO,CACT,MAAe,EACf,IAAsB;YAEtB,mDAAmD;YACnD,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACrC,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;gBAClB,OAAO,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAC5C,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;YAC/C,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;YAElD,OAAO,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE;gBAChC,MAAM,EAAE,UAAU;gBAClB,GAAG,IAAI;aACV,CAAC,CAAC;QACP,CAAC;KACJ,CAAC;AACN,CAAC"}
+{"version":3,"file":"FusionClient.js","sourceRoot":"","sources":["../../src/client/FusionClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,EAAqB,MAAM,qBAAqB,CAAC;AAmExD,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACxC,iEAAiE;IACxD,IAAI,CAAS;IACtB,qDAAqD;IAC5C,QAAQ,CAAsB;IACvC,6DAA6D;IACpD,gBAAgB,CAAoB;IAC7C,oDAAoD;IAC3C,QAAQ,CAAS;IAC1B,8CAA8C;IACrC,GAAG,CAAe;IAE3B,YACI,OAAe,EACf,IAAY,EACZ,GAAiB,EACjB,OAIC;QAED,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,QAAQ,CAAC;QAClC,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,gBAAgB,IAAI,EAAE,CAAC,CAAC;QACvE,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,OAAO,CAAC;IACjD,CAAC;CACJ;AAoFD,+EAA+E;AAC/E,8BAA8B;AAC9B,+EAA+E;AAE/E;;;;;;;GAOG;AACH,SAAS,WAAW,CAAC,GAAW;IAC5B,OAAO,GAAG;SACL,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,4CAA4C;AAC7E,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,iBAAiB,CAAC,IAAY;IAOnC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACjE,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;IACzE,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;IAClE,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;IAErE,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC;IAE/B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,+BAA+B,CAAC,CAAC;IACrE,KAAK,MAAM,CAAC,IAAI,aAAa,EAAE,CAAC;QAC5B,IAAI,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,0CAA0C;IAC1C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACrF,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnB,OAAO,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/F,CAAC;IACL,CAAC;IAED,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE/F,MAAM,MAAM,GAMR;QACA,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;QACpE,OAAO,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;QAC7C,gBAAgB,EAAE,OAAO;QACzB,QAAQ,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,IAAI,OAAO;KAC1C,CAAC;IAEF,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC/B,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,+EAA+E;AAC/E,uCAAuC;AACvC,+EAA+E;AAE/E,gBAAgB;AAChB,SAAS,uBAAuB,CAC5B,UAA8B,EAC9B,QAAkF;IAElF,IAAI,KAAK,GAAG,QAAQ,CAAC;IAErB,iEAAiE;IACjE,KAAK,IAAI,CAAC,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,CAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,KAAK,CAAC;QACnB,KAAK,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,MAAM,UAAU,kBAAkB,CAC9B,SAA0B,EAC1B,OAA6B;IAE7B,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,IAAI,KAAK,CAAC;IAEpD,yEAAyE;IACzE,SAAS,YAAY,CAAC,MAAc,EAAE,IAA6B;QAC/D,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;YAClB,OAAO,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC5C,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QAC/C,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;QAElD,OAAO,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE;YAChC,MAAM,EAAE,UAAU;YAClB,GAAG,IAAI;SACV,CAAC,CAAC;IACP,CAAC;IAED,iDAAiD;IACjD,MAAM,QAAQ,GAAG,CAAC,OAAO,EAAE,UAAU,IAAI,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QAC3E,CAAC,CAAC,uBAAuB,CAAC,OAAO,CAAC,UAAU,EAAE,YAAY,CAAC;QAC3D,CAAC,CAAC,YAAY,CAAC;IAEnB,wCAAwC;IACxC,KAAK,UAAU,eAAe,CAAC,MAAc,EAAE,IAA6B;QACxE,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAE5C,IAAI,YAAY,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACjC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO;iBACtB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;iBAChB,IAAI,CAAC,IAAI,CAAC,CAAC;YAEhB,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,MAAM,EAAE,CAAC;gBACT,MAAM,IAAI,GAAsF;oBAC5F,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;oBACzC,QAAQ,EAAE,MAAM,CAAC,QAAQ;iBAC5B,CAAC;gBACF,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;oBAChC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;gBACpC,CAAC;gBACD,MAAM,IAAI,iBAAiB,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;YAC3E,CAAC;YAED,MAAM,IAAI,iBAAiB,CAAC,IAAI,IAAI,eAAe,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QAC5E,CAAC;QAED,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,OAAO;QACH,KAAK,CAAC,OAAO,CACT,MAAe,EACf,IAAsB;YAEtB,OAAO,eAAe,CAAC,MAAM,EAAE,IAA+B,CAAC,CAAC;QACpE,CAAC;QAED,KAAK,CAAC,YAAY,CACd,KAAqG,EACrG,YAA+D;YAE/D,MAAM,KAAK,GAAG,KAA4E,CAAC;YAC3F,IAAI,YAAY,EAAE,UAAU,EAAE,CAAC;gBAC3B,MAAM,OAAO,GAAmB,EAAE,CAAC;gBACnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACvB,OAAO,CAAC,IAAI,CAAC,MAAM,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;gBAChE,CAAC;gBACD,OAAO,OAAO,CAAC;YACnB,CAAC;YAED,OAAO,OAAO,CAAC,GAAG,CACd,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAC7D,CAAC;QACN,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/client/index.d.ts

@@ -1,6 +1,6 @@
 /** Client Bounded Context — Barrel Export */
-export { createFusionClient } from './FusionClient.js';
-export type { FusionClient, FusionTransport, RouterMap, } from './FusionClient.js';
+export { createFusionClient, FusionClientError } from './FusionClient.js';
+export type { FusionClient, FusionTransport, RouterMap, ClientMiddleware, FusionClientOptions, } from './FusionClient.js';
 export { createTypedRegistry } from './createTypedRegistry.js';
 export type { InferRouter, TypedToolRegistry } from './InferRouter.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EACR,YAAY,EACZ,eAAe,EACf,SAAS,GACZ,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,YAAY,EACR,YAAY,EACZ,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,mBAAmB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/client/index.js

@@ -1,4 +1,4 @@
 /** Client Bounded Context — Barrel Export */
-export { createFusionClient } from './FusionClient.js';
+export { createFusionClient, FusionClientError } from './FusionClient.js';
 export { createTypedRegistry } from './createTypedRegistry.js';
 //# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAMvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAQ1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/core/StandardSchema.d.ts

@@ -0,0 +1,178 @@
+/**
+ * StandardSchema — Universal Schema Abstraction Layer
+ *
+ * Decouples the MCP Fusion validation engine from Zod specifically,
+ * enabling support for any validator that implements the Standard Schema
+ * specification (`@standard-schema/spec`).
+ *
+ * This allows users to choose lighter alternatives:
+ * - **Zod** (~14kb min): Full-featured, most popular
+ * - **Valibot** (~1kb min via tree-shaking): Ultra-lightweight
+ * - **ArkType** (~5kb min): Fastest runtime validation
+ * - **TypeBox** (~4kb min): JSON Schema native
+ *
+ * ## Standard Schema Spec
+ *
+ * Any object with `~standard` property conforming to:
+ * ```typescript
+ * interface StandardSchema {
+ *   '~standard': {
+ *     version: 1;
+ *     vendor: string;
+ *     validate: (value: unknown) => { value: T } | { issues: Issue[] };
+ *   }
+ * }
+ * ```
+ *
+ * @see https://github.com/standard-schema/standard-schema
+ *
+ * @example
+ * ```typescript
+ * import { toStandardValidator } from '@vinkius-core/mcp-fusion';
+ * import * as v from 'valibot';
+ *
+ * // Valibot schemas work natively via Standard Schema
+ * const schema = v.object({ name: v.string(), age: v.number() });
+ * const validator = toStandardValidator(schema);
+ *
+ * const result = validator.validate({ name: 'Alice', age: 30 });
+ * // { success: true, data: { name: 'Alice', age: 30 } }
+ * ```
+ *
+ * @module
+ */
+/**
+ * Issue reported by a Standard Schema validator.
+ */
+export interface StandardSchemaIssue {
+    readonly message: string;
+    readonly path?: readonly (string | number | symbol)[];
+}
+/**
+ * Standard Schema v1 spec — the universal validator contract.
+ *
+ * Any schema library implementing this interface can be used with
+ * MCP Fusion's validation pipeline.
+ */
+export interface StandardSchemaV1<TInput = unknown, TOutput = TInput> {
+    readonly '~standard': {
+        readonly version: 1;
+        readonly vendor: string;
+        readonly validate: (value: TInput) => {
+            readonly value: TOutput;
+        } | {
+            readonly issues: readonly StandardSchemaIssue[];
+        };
+    };
+}
+/**
+ * Infer the output type from a Standard Schema.
+ */
+export type InferStandardOutput<T> = T extends StandardSchemaV1<unknown, infer O> ? O : never;
+/**
+ * Fusion's internal validation result.
+ */
+export type ValidationResult<T> = {
+    readonly success: true;
+    readonly data: T;
+} | {
+    readonly success: false;
+    readonly issues: readonly StandardSchemaIssue[];
+};
+/**
+ * Universal validator interface used internally by MCP Fusion.
+ *
+ * Wraps any schema library (Zod, Valibot, ArkType, etc.) into
+ * a consistent validation contract.
+ */
+export interface FusionValidator<T = unknown> {
+    /** Run validation and return a result (never throws) */
+    validate(value: unknown): ValidationResult<T>;
+    /** Vendor identifier (e.g. 'zod', 'valibot', 'arktype') */
+    readonly vendor: string;
+    /** Original schema reference (for introspection) */
+    readonly schema: unknown;
+}
+/**
+ * Create a FusionValidator from a Standard Schema v1 compatible schema.
+ *
+ * This is the primary entry point for non-Zod validators. Any schema
+ * library implementing the Standard Schema spec can be used directly.
+ *
+ * @param schema - A Standard Schema v1 compatible schema
+ * @returns A {@link FusionValidator} wrapping the schema
+ *
+ * @example
+ * ```typescript
+ * import * as v from 'valibot'; // ~1kb tree-shaken
+ *
+ * const schema = v.object({ name: v.string() });
+ * const validator = toStandardValidator(schema);
+ *
+ * const ok = validator.validate({ name: 'Alice' });
+ * // { success: true, data: { name: 'Alice' } }
+ *
+ * const err = validator.validate({ name: 42 });
+ * // { success: false, issues: [{ message: 'Expected string', path: ['name'] }] }
+ * ```
+ */
+export declare function toStandardValidator<T>(schema: StandardSchemaV1<unknown, T>): FusionValidator<T>;
+/**
+ * Create a FusionValidator from a raw Zod schema.
+ *
+ * This adapter uses Zod's `.safeParse()` method and maps the result
+ * to the standard FusionValidator interface.
+ *
+ * @param schema - A Zod schema (z.object, z.string, etc.)
+ * @returns A {@link FusionValidator} wrapping the Zod schema
+ *
+ * @example
+ * ```typescript
+ * import { z } from 'zod';
+ *
+ * const schema = z.object({ name: z.string() });
+ * const validator = fromZodSchema(schema);
+ *
+ * const ok = validator.validate({ name: 'Alice' });
+ * // { success: true, data: { name: 'Alice' } }
+ * ```
+ */
+export declare function fromZodSchema<T>(schema: ZodSchemaLike<T>): FusionValidator<T>;
+/**
+ * Check if a value implements the Standard Schema v1 spec.
+ *
+ * @param value - Any value to check
+ * @returns `true` if the value has a valid `~standard` property
+ */
+export declare function isStandardSchema(value: unknown): value is StandardSchemaV1;
+/**
+ * Auto-detect and create a FusionValidator from any supported schema.
+ *
+ * Detection order:
+ * 1. Standard Schema v1 (Valibot, ArkType, etc.)
+ * 2. Zod-like (has `.safeParse()`)
+ * 3. Throws if unrecognized
+ *
+ * @param schema - Any supported schema
+ * @returns A {@link FusionValidator}
+ * @throws If the schema type is not recognized
+ */
+export declare function autoValidator<T = unknown>(schema: unknown): FusionValidator<T>;
+/** Duck-typed Zod schema interface */
+interface ZodSchemaLike<T = unknown> {
+    safeParse(value: unknown): {
+        success: true;
+        data: unknown;
+    } | {
+        success: false;
+        error: {
+            issues: Array<{
+                message: string;
+                path?: (string | number)[];
+            }>;
+        };
+    };
+    parse?(value: unknown): T;
+}
+export {};
+//# sourceMappingURL=StandardSchema.d.ts.map

package/dist/core/StandardSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StandardSchema.d.ts","sourceRoot":"","sources":["../../src/core/StandardSchema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAIH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;CACzD;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,MAAM;IAChE,QAAQ,CAAC,WAAW,EAAE;QAClB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;QACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAC3B;YAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;SAAE,GAC3B;YAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAA;SAAE,CAAC;KAC7D,CAAC;CACL;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,CAAC,SAAS,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAI9F;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IACxB;IAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC5C;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAA;CAAE,CAAC;AAEnF;;;;;GAKG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IACxC,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAC9C,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC5B;AAID;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACjC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC,GACrC,eAAe,CAAC,CAAC,CAAC,CAgBpB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAyB7E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAU1E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,eAAe,CAAC,CAAC,CAAC,CAa9E;AAID,sCAAsC;AACtC,UAAU,aAAa,CAAC,CAAC,GAAG,OAAO;IAC/B,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG;QAAE,OAAO,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,GAAG;QAAE,OAAO,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE;YAAE,MAAM,EAAE,KAAK,CAAC;gBAAE,OAAO,EAAE,MAAM,CAAC;gBAAC,IAAI,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;aAAE,CAAC,CAAA;SAAE,CAAA;KAAE,CAAC;IAC5J,KAAK,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC;CAC7B"}

package/dist/core/StandardSchema.js

@@ -0,0 +1,166 @@
+/**
+ * StandardSchema — Universal Schema Abstraction Layer
+ *
+ * Decouples the MCP Fusion validation engine from Zod specifically,
+ * enabling support for any validator that implements the Standard Schema
+ * specification (`@standard-schema/spec`).
+ *
+ * This allows users to choose lighter alternatives:
+ * - **Zod** (~14kb min): Full-featured, most popular
+ * - **Valibot** (~1kb min via tree-shaking): Ultra-lightweight
+ * - **ArkType** (~5kb min): Fastest runtime validation
+ * - **TypeBox** (~4kb min): JSON Schema native
+ *
+ * ## Standard Schema Spec
+ *
+ * Any object with `~standard` property conforming to:
+ * ```typescript
+ * interface StandardSchema {
+ *   '~standard': {
+ *     version: 1;
+ *     vendor: string;
+ *     validate: (value: unknown) => { value: T } | { issues: Issue[] };
+ *   }
+ * }
+ * ```
+ *
+ * @see https://github.com/standard-schema/standard-schema
+ *
+ * @example
+ * ```typescript
+ * import { toStandardValidator } from '@vinkius-core/mcp-fusion';
+ * import * as v from 'valibot';
+ *
+ * // Valibot schemas work natively via Standard Schema
+ * const schema = v.object({ name: v.string(), age: v.number() });
+ * const validator = toStandardValidator(schema);
+ *
+ * const result = validator.validate({ name: 'Alice', age: 30 });
+ * // { success: true, data: { name: 'Alice', age: 30 } }
+ * ```
+ *
+ * @module
+ */
+// ── Adapters ─────────────────────────────────────────────
+/**
+ * Create a FusionValidator from a Standard Schema v1 compatible schema.
+ *
+ * This is the primary entry point for non-Zod validators. Any schema
+ * library implementing the Standard Schema spec can be used directly.
+ *
+ * @param schema - A Standard Schema v1 compatible schema
+ * @returns A {@link FusionValidator} wrapping the schema
+ *
+ * @example
+ * ```typescript
+ * import * as v from 'valibot'; // ~1kb tree-shaken
+ *
+ * const schema = v.object({ name: v.string() });
+ * const validator = toStandardValidator(schema);
+ *
+ * const ok = validator.validate({ name: 'Alice' });
+ * // { success: true, data: { name: 'Alice' } }
+ *
+ * const err = validator.validate({ name: 42 });
+ * // { success: false, issues: [{ message: 'Expected string', path: ['name'] }] }
+ * ```
+ */
+export function toStandardValidator(schema) {
+    const spec = schema['~standard'];
+    return {
+        validate(value) {
+            const result = spec.validate(value);
+            if ('value' in result) {
+                return { success: true, data: result.value };
+            }
+            return { success: false, issues: result.issues };
+        },
+        vendor: spec.vendor,
+        schema,
+    };
+}
+/**
+ * Create a FusionValidator from a raw Zod schema.
+ *
+ * This adapter uses Zod's `.safeParse()` method and maps the result
+ * to the standard FusionValidator interface.
+ *
+ * @param schema - A Zod schema (z.object, z.string, etc.)
+ * @returns A {@link FusionValidator} wrapping the Zod schema
+ *
+ * @example
+ * ```typescript
+ * import { z } from 'zod';
+ *
+ * const schema = z.object({ name: z.string() });
+ * const validator = fromZodSchema(schema);
+ *
+ * const ok = validator.validate({ name: 'Alice' });
+ * // { success: true, data: { name: 'Alice' } }
+ * ```
+ */
+export function fromZodSchema(schema) {
+    return {
+        validate(value) {
+            const result = schema.safeParse(value);
+            if (result.success) {
+                return { success: true, data: result.data };
+            }
+            // Map Zod errors to StandardSchemaIssue
+            const issues = (result.error?.issues ?? []).map((issue) => {
+                const mapped = { message: issue.message };
+                if (issue.path) {
+                    mapped.path = issue.path;
+                }
+                return mapped;
+            });
+            return { success: false, issues };
+        },
+        vendor: 'zod',
+        schema,
+    };
+}
+/**
+ * Check if a value implements the Standard Schema v1 spec.
+ *
+ * @param value - Any value to check
+ * @returns `true` if the value has a valid `~standard` property
+ */
+export function isStandardSchema(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        '~standard' in value &&
+        typeof value['~standard'] === 'object' &&
+        value['~standard'] !== null &&
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+        value['~standard'].version === 1);
+}
+/**
+ * Auto-detect and create a FusionValidator from any supported schema.
+ *
+ * Detection order:
+ * 1. Standard Schema v1 (Valibot, ArkType, etc.)
+ * 2. Zod-like (has `.safeParse()`)
+ * 3. Throws if unrecognized
+ *
+ * @param schema - Any supported schema
+ * @returns A {@link FusionValidator}
+ * @throws If the schema type is not recognized
+ */
+export function autoValidator(schema) {
+    if (isStandardSchema(schema)) {
+        return toStandardValidator(schema);
+    }
+    if (isZodLike(schema)) {
+        return fromZodSchema(schema);
+    }
+    throw new Error('Unsupported schema type. Expected a Standard Schema v1 (' +
+        'Valibot, ArkType) or Zod schema. See: https://mcp-fusion.vinkius.com/docs/standard-schema');
+}
+/** Duck-type check for Zod-like schemas */
+function isZodLike(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        typeof value.safeParse === 'function');
+}
+//# sourceMappingURL=StandardSchema.js.map

package/dist/core/StandardSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StandardSchema.js","sourceRoot":"","sources":["../../src/core/StandardSchema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAyDH,4DAA4D;AAE5D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,mBAAmB,CAC/B,MAAoC;IAEpC,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IAEjC,OAAO;QACH,QAAQ,CAAC,KAAc;YACnB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAEpC,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;gBACpB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;YACjD,CAAC;YAED,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;QACrD,CAAC;QACD,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,MAAM;KACT,CAAC;AACN,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,aAAa,CAAI,MAAwB;IACrD,OAAO;QACH,QAAQ,CAAC,KAAc;YACnB,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAEvC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACjB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAS,EAAE,CAAC;YACrD,CAAC;YAED,wCAAwC;YACxC,MAAM,MAAM,GAA0B,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAClE,CAAC,KAAsD,EAAE,EAAE;gBACvD,MAAM,MAAM,GAAwB,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;gBAC/D,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;oBACZ,MAAiD,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;gBACzE,CAAC;gBACD,OAAO,MAAM,CAAC;YAClB,CAAC,CACJ,CAAC;YAEF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QACtC,CAAC;QACD,MAAM,EAAE,KAAK;QACb,MAAM;KACT,CAAC;AACN,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC3C,OAAO,CACH,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,WAAW,IAAI,KAAK;QACpB,OAAQ,KAA0B,CAAC,WAAW,CAAC,KAAK,QAAQ;QAC3D,KAA0B,CAAC,WAAW,CAAC,KAAK,IAAI;QACjD,uEAAuE;QACtE,KAA0B,CAAC,WAAW,CAAC,CAAC,OAAO,KAAK,CAAC,CACzD,CAAC;AACN,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAc,MAAe;IACtD,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO,mBAAmB,CAAC,MAAsC,CAAC,CAAC;IACvE,CAAC;IAED,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACpB,OAAO,aAAa,CAAC,MAA0B,CAAC,CAAC;IACrD,CAAC;IAED,MAAM,IAAI,KAAK,CACX,0DAA0D;QAC1D,2FAA2F,CAC9F,CAAC;AACN,CAAC;AAUD,2CAA2C;AAC3C,SAAS,SAAS,CAAC,KAAc;IAC7B,OAAO,CACH,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAQ,KAAuB,CAAC,SAAS,KAAK,UAAU,CAC3D,CAAC;AACN,CAAC"}