@warmio/contracts 1.1.0 → 2.0.0

package/dist/public-discovery.js

@@ -0,0 +1,91 @@
+/**
+ * Separate package descriptor: public discovery metadata is importable by docs
+ * while the edge worker remains the sole request executor.
+ */
+import { DEVELOPERS_PATH, OPENAPI_PATH, PUBLIC_DISCOVERY_MCP_PATH, VERIFY_PATH, } from './api/endpoints.js';
+const emptyInputSchema = {
+    type: 'object',
+    properties: {},
+    additionalProperties: false,
+};
+/** Serializable descriptor. The edge worker owns all request execution and dynamic responses. */
+export const publicDiscoveryMcpDescriptor = {
+    protocolVersion: '2025-06-18',
+    serverInfo: {
+        name: 'warm-public-tools',
+        title: 'Warm Public Discovery Tools',
+        version: '1.0.0',
+    },
+    paths: {
+        developers: DEVELOPERS_PATH,
+        endpoint: PUBLIC_DISCOVERY_MCP_PATH,
+        openapi: OPENAPI_PATH,
+        verify: VERIFY_PATH,
+    },
+    tools: [
+        {
+            annotations: { readOnlyHint: true },
+            description: 'Return Warm API discovery URLs and the current API catalog document.',
+            inputSchema: emptyInputSchema,
+            name: 'warm-get-api-catalog',
+            outputSchema: {
+                type: 'object',
+                properties: {
+                    apiCatalogUrl: { type: 'string' },
+                    payload: { type: 'object' },
+                },
+                required: ['apiCatalogUrl', 'payload'],
+                additionalProperties: false,
+            },
+            title: 'Warm API Catalog',
+        },
+        {
+            annotations: { readOnlyHint: true },
+            description: 'Return the Warm OpenAPI document URL and companion documentation URLs.',
+            inputSchema: emptyInputSchema,
+            name: 'warm-get-openapi',
+            outputSchema: {
+                type: 'object',
+                properties: {
+                    apiCatalogUrl: { type: 'string' },
+                    documentationUrl: { type: 'string' },
+                    openapiUrl: { type: 'string' },
+                },
+                required: ['apiCatalogUrl', 'documentationUrl', 'openapiUrl'],
+                additionalProperties: false,
+            },
+            title: 'Warm OpenAPI',
+        },
+        {
+            annotations: { readOnlyHint: true },
+            description: 'Fetch the current Warm public API verification payload from /api/verify.',
+            inputSchema: emptyInputSchema,
+            name: 'warm-get-service-status',
+            outputSchema: {
+                type: 'object',
+                properties: {
+                    ok: { type: 'boolean' },
+                    payload: {},
+                    error: {
+                        type: 'object',
+                        properties: {
+                            code: {
+                                type: 'string',
+                                enum: ['VERIFY_TIMEOUT', 'VERIFY_NON_JSON', 'VERIFY_UNAVAILABLE'],
+                            },
+                            message: { type: 'string' },
+                        },
+                        required: ['code', 'message'],
+                        additionalProperties: false,
+                    },
+                    status: { type: 'number', minimum: 0 },
+                    statusUrl: { type: 'string' },
+                },
+                required: ['ok', 'status', 'statusUrl'],
+                additionalProperties: false,
+            },
+            title: 'Warm API Verification',
+        },
+    ],
+};
+//# sourceMappingURL=public-discovery.js.map

package/dist/public-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-discovery.js","sourceRoot":"","sources":["../src/public-discovery.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,eAAe,EACf,YAAY,EACZ,yBAAyB,EACzB,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAI5B,MAAM,gBAAgB,GAAG;IACvB,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE,EAAE;IACd,oBAAoB,EAAE,KAAK;CACP,CAAC;AAEvB,iGAAiG;AACjG,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,eAAe,EAAE,YAAY;IAC7B,UAAU,EAAE;QACV,IAAI,EAAE,mBAAmB;QACzB,KAAK,EAAE,6BAA6B;QACpC,OAAO,EAAE,OAAO;KACjB;IACD,KAAK,EAAE;QACL,UAAU,EAAE,eAAe;QAC3B,QAAQ,EAAE,yBAAyB;QACnC,OAAO,EAAE,YAAY;QACrB,MAAM,EAAE,WAAW;KACpB;IACD,KAAK,EAAE;QACL;YACE,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;YACnC,WAAW,EAAE,sEAAsE;YACnF,WAAW,EAAE,gBAAgB;YAC7B,IAAI,EAAE,sBAAsB;YAC5B,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACjC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC5B;gBACD,QAAQ,EAAE,CAAC,eAAe,EAAE,SAAS,CAAC;gBACtC,oBAAoB,EAAE,KAAK;aAC5B;YACD,KAAK,EAAE,kBAAkB;SAC1B;QACD;YACE,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;YACnC,WAAW,EAAE,wEAAwE;YACrF,WAAW,EAAE,gBAAgB;YAC7B,IAAI,EAAE,kBAAkB;YACxB,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACjC,gBAAgB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACpC,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC/B;gBACD,QAAQ,EAAE,CAAC,eAAe,EAAE,kBAAkB,EAAE,YAAY,CAAC;gBAC7D,oBAAoB,EAAE,KAAK;aAC5B;YACD,KAAK,EAAE,cAAc;SACtB;QACD;YACE,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;YACnC,WAAW,EAAE,0EAA0E;YACvF,WAAW,EAAE,gBAAgB;YAC7B,IAAI,EAAE,yBAAyB;YAC/B,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;oBACvB,OAAO,EAAE,EAAE;oBACX,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,IAAI,EAAE;gCACJ,IAAI,EAAE,QAAQ;gCACd,IAAI,EAAE,CAAC,gBAAgB,EAAE,iBAAiB,EAAE,oBAAoB,CAAC;6BAClE;4BACD,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;yBAC5B;wBACD,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;wBAC7B,oBAAoB,EAAE,KAAK;qBAC5B;oBACD,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE;oBACtC,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC9B;gBACD,QAAQ,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC;gBACvC,oBAAoB,EAAE,KAAK;aAC5B;YACD,KAAK,EAAE,uBAAuB;SAC/B;KACF;CACO,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warmio/contracts",
-  "version": "1.1.0",
+  "version": "2.0.0",
   "description": "Side-effect-free public API and MCP contracts for Warm.",
   "license": "UNLICENSED",
   "type": "module",
@@ -38,6 +38,12 @@
       "mcp": [
         "dist/mcp/index.d.ts"
       ],
+      "product": [
+        "dist/product.d.ts"
+      ],
+      "public-discovery": [
+        "dist/public-discovery.d.ts"
+      ],
       "openapi": [
         "dist/openapi/index.d.ts"
       ]
@@ -72,6 +78,14 @@
       "types": "./dist/mcp/index.d.ts",
       "default": "./dist/mcp/index.js"
     },
+    "./product": {
+      "types": "./dist/product.d.ts",
+      "default": "./dist/product.js"
+    },
+    "./public-discovery": {
+      "types": "./dist/public-discovery.d.ts",
+      "default": "./dist/public-discovery.js"
+    },
     "./openapi": {
       "types": "./dist/openapi/index.d.ts",
       "default": "./dist/openapi/index.js"
@@ -80,6 +94,7 @@
   "scripts": {
     "build": "tsc -p tsconfig.build.json && node scripts/copy-openapi-template.mjs",
     "typecheck": "tsc --noEmit",
+    "release-manifest:digest": "node scripts/contract-release-digest.mjs",
     "pack:check": "pnpm pack --dry-run"
   },
   "dependencies": {