@mcpmesh/sdk 2.8.2 → 3.0.1

package/dist/__tests__/service-view-types.spec.js

@@ -0,0 +1,66 @@
+/**
+ * Strict-mode COMPILE test for the documented service-view consumer idiom
+ * (RFC #1280). The failure mode this guards against: "docs show code that
+ * doesn't compile." The project's `tsc --noEmit` (strict) type-checks this file,
+ * so if the documented idiom in service-view.ts's `MeshServiceFacade` JSDoc ever
+ * stops compiling, the build breaks here.
+ *
+ * The idiom functions below are never INVOKED (they'd construct a real
+ * MeshAgent); they exist purely so the compiler checks their bodies. Vitest runs
+ * the trivial assertion so this counts as a spec.
+ */
+import { describe, it, expect } from "vitest";
+import { z } from "zod";
+import { mesh } from "../index.js";
+// ── The canonical documented idiom, verbatim: un-annotated params + a cast on
+// the view slot at point of use. Must compile under strictFunctionTypes. ──────
+function _documentedConsumerIdiom() {
+    const server = {};
+    const agent = mesh(server, { name: "example", httpPort: 0 });
+    const Media = mesh.serviceView({
+        methods: {
+            caption: { capability: "media.caption", required: true, tags: ["+fast"] },
+            thumbnail: "media.thumbnail",
+        },
+        minAvailable: 1,
+    });
+    agent.addTool({
+        name: "process",
+        parameters: z.object({ text: z.string() }),
+        dependencies: ["audit_log", Media],
+        execute: async (args, auditLog, media) => {
+            const svc = media;
+            // Both spec method keys are typed on the facade, callable with the
+            // McpMeshTool signature (args?, options?) => Promise<unknown>.
+            const cap = await svc.caption({ text: args.text });
+            await svc.thumbnail();
+            // Ordinary McpMeshTool deps are consumed with the same cast idiom.
+            const audit = auditLog;
+            if (audit)
+                await audit({ event: "captioned" });
+            return cap;
+        },
+    });
+}
+// ── Producer sugar idiom, verbatim. ──────────────────────────────────────────
+function _documentedProducerIdiom() {
+    const server = {};
+    const agent = mesh(server, { name: "producer", httpPort: 0 });
+    agent.addService("media", {
+        caption: async (args) => ({ caption: args.text }),
+        thumbnail: {
+            execute: async (args) => ({ url: args.assetId }),
+            tags: ["fast"],
+            description: "thumbnail",
+        },
+    });
+}
+const _facadeMethodIsCallable = async () => undefined;
+describe("service-view documented idiom compiles under strict", () => {
+    it("type-checks the consumer + producer idioms (compile-only)", () => {
+        expect(typeof _documentedConsumerIdiom).toBe("function");
+        expect(typeof _documentedProducerIdiom).toBe("function");
+        expect(typeof _facadeMethodIsCallable).toBe("function");
+    });
+});
+//# sourceMappingURL=service-view-types.spec.js.map

package/dist/__tests__/service-view-types.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-view-types.spec.js","sourceRoot":"","sources":["../../src/__tests__/service-view-types.spec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAA4C,MAAM,aAAa,CAAC;AAE7E,+EAA+E;AAC/E,gFAAgF;AAChF,SAAS,wBAAwB;IAC/B,MAAM,MAAM,GAAG,EAA0C,CAAC;IAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;IAE7D,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC;QAC7B,OAAO,EAAE;YACP,OAAO,EAAE,EAAE,UAAU,EAAE,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE;YACzE,SAAS,EAAE,iBAAiB;SAC7B;QACD,YAAY,EAAE,CAAC;KAChB,CAAC,CAAC;IAEH,KAAK,CAAC,OAAO,CAAC;QACZ,IAAI,EAAE,SAAS;QACf,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;QAC1C,YAAY,EAAE,CAAC,WAAW,EAAE,KAAK,CAAC;QAClC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE;YACvC,MAAM,GAAG,GAAG,KAAwC,CAAC;YACrD,mEAAmE;YACnE,+DAA+D;YAC/D,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YACnD,MAAM,GAAG,CAAC,SAAS,EAAE,CAAC;YACtB,mEAAmE;YACnE,MAAM,KAAK,GAAG,QAA8B,CAAC;YAC7C,IAAI,KAAK;gBAAE,MAAM,KAAK,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;YAC/C,OAAO,GAAG,CAAC;QACb,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,gFAAgF;AAChF,SAAS,wBAAwB;IAC/B,MAAM,MAAM,GAAG,EAA0C,CAAC;IAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;IAE9D,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE;QACxB,OAAO,EAAE,KAAK,EAAE,IAAsB,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QACnE,SAAS,EAAE;YACT,OAAO,EAAE,KAAK,EAAE,IAAyB,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;YACrE,IAAI,EAAE,CAAC,MAAM,CAAC;YACd,WAAW,EAAE,WAAW;SACzB;KACF,CAAC,CAAC;AACL,CAAC;AAQD,MAAM,uBAAuB,GAA4B,KAAK,IAAI,EAAE,CAAC,SAAS,CAAC;AAE/E,QAAQ,CAAC,qDAAqD,EAAE,GAAG,EAAE;IACnE,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACzD,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACzD,MAAM,CAAC,OAAO,uBAAuB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/service-view.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=service-view.spec.d.ts.map

package/dist/__tests__/service-view.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-view.spec.d.ts","sourceRoot":"","sources":["../../src/__tests__/service-view.spec.ts"],"names":[],"mappings":""}