@haddowg/json-api-mcp 1.3.0 → 1.4.0

package/README.md

@@ -24,8 +24,8 @@ npm install --save-dev @haddowg/json-api-codegen
 ## Generate the model
 
 ```bash
-npx json-api-mcp --input openapi/v5.json --output src/mcp/v5.mcp.json
-npx json-api-mcp --input openapi/v5.json --output src/mcp/v5.mcp.json --check # in CI
+npx @haddowg/json-api-mcp --input openapi/v5.json --output src/mcp/v5.mcp.json
+npx @haddowg/json-api-mcp --input openapi/v5.json --output src/mcp/v5.mcp.json --check # in CI
 ```
 
 Tools include one relationship deep by default, so each tool's schema carries only the types its
@@ -52,8 +52,12 @@ type names, such as a presigned upload URL, under `links`.
 
 Coming from 1.2: a get returns `{ data }` where it returned `{ item }`, a create or update is
 wrapped in `{ data }` instead of coming back bare, and a collection lists its resources under
-`data` instead of `items`. Regenerate the model to get the new shapes. A model generated by 1.2
-still loads and keeps the 1.2 shapes its output schemas describe.
+`data` instead of `items`. A delete returns `{ data: null }` instead of a line of text, a
+meta-only action `{ meta }` instead of the bare meta object, and a URL action
+`{ data: { url, type, expiresAt? } }` instead of the bare object. Regenerate the model to get the
+new shapes. A model generated by 1.2 still loads and keeps the 1.2 shapes its output schemas
+describe. The [migration notes](https://haddowg.github.io/json-api-ts/mcp/#migrating-from-12)
+cover the rest.
 
 Scope filtering counts only the security requirements a caller can meet with its credential
 schemes, the document's `oauth2` schemes unless you pass `credentialSchemes`. Scopes, feature

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { r as writeMcpModel } from "./generate-BcqHRSxB.mjs";
+import { r as writeMcpModel } from "./generate-yf5Kc4Yh.mjs";
 import { realpathSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 //#region src/cli.ts

package/dist/{generate-BcqHRSxB.mjs → generate-yf5Kc4Yh.mjs}

@@ -1445,9 +1445,9 @@ function buildEntry(op, parsed, inputCtx, outputCtx, descriptor) {
 */
 function assertContract(doc) {
 	const contract = doc.info?.["x-generator"]?.contract;
-	if (typeof contract !== "number") throw new Error(`The OpenAPI document declares no generator contract (info.x-generator.contract). @haddowg/json-api-mcp reads contracts 13 to 18; regenerate the document from a newer haddowg/json-api server.`);
-	if (contract < 13) throw new Error(`The OpenAPI document declares generator contract ${contract}, older than this package reads (13 to 18). Regenerate it from a newer haddowg/json-api server.`);
-	if (contract > 18) throw new Error(`The OpenAPI document declares generator contract ${contract}, newer than this package reads (13 to 18). Upgrade @haddowg/json-api-mcp.`);
+	if (typeof contract !== "number") throw new Error(`The OpenAPI document declares no generator contract (info.x-generator.contract). @haddowg/json-api-mcp reads contracts 13 to 19; regenerate the document from a newer haddowg/json-api server.`);
+	if (contract < 13) throw new Error(`The OpenAPI document declares generator contract ${contract}, older than this package reads (13 to 19). Regenerate it from a newer haddowg/json-api server.`);
+	if (contract > 19) throw new Error(`The OpenAPI document declares generator contract ${contract}, newer than this package reads (13 to 19). Upgrade @haddowg/json-api-mcp.`);
 	return contract;
 }
 //#endregion
@@ -1594,4 +1594,4 @@ async function writeMcpModel(options) {
 //#endregion
 export { buildMcpModel as i, serialiseMcpModel as n, writeMcpModel as r, generateMcpModel as t };
 
-//# sourceMappingURL=generate-BcqHRSxB.mjs.map
+//# sourceMappingURL=generate-yf5Kc4Yh.mjs.map