@exposify/nestjs 0.0.0-stage → 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Exposify
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,40 @@
-# Temporary Holding Version
+# @exposify/nestjs
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+NestJS integration for [Exposify](../../README.md): your controllers become MCP
+tools that AI agents can call, with schemas and descriptions from
+`@nestjs/swagger`.
+
+```ts
+import { mountAiReady } from "@exposify/nestjs";
+
+const app = await NestFactory.create(AppModule);
+app.setGlobalPrefix("api");
+mountAiReady(app); // MCP endpoint at /mcp
+await app.listen(3000);
+```
+
+```ts
+import { McpDescribe, McpExposed, McpHidden } from "@exposify/nestjs";
+
+@Controller("orders")
+export class OrdersController {
+  @Get() list() {}                                   // reads are exposed by default
+
+  @Post() @McpDescribe({ name: "place_order", description: "Place an order; reserves stock." })
+  create(@Body() dto: CreateOrderDto) {}             // writes need an opt-in
+
+  @Delete(":id") remove() {}                         // hidden (a write, no opt-in)
+
+  @Get("internal") @McpHidden() internal() {}        // a read kept from agents
+}
+```
+
+- Tool calls go through Nest itself, so guards, pipes, interceptors and
+  filters apply exactly as for any HTTP client.
+- Input schemas come from your DTOs' `@ApiProperty` metadata; descriptions
+  from `@ApiOperation({ summary })` unless `@McpDescribe` sets one.
+- The decorators write an `x-exposify` extension into the Swagger document,
+  so they need `@nestjs/swagger` (a peer dependency). Without it, use
+  `@exposify/express`'s `aiReady({ expose: [...] })` directly.
+- Express platform only (the Nest default); Fastify isn't supported yet.
+- `npx exposify-express setup` / `inspect` / `describe` work on Nest projects.

package/dist/index.cjs

@@ -0,0 +1,56 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  McpDescribe: () => McpDescribe,
+  McpExposed: () => McpExposed,
+  McpHidden: () => McpHidden,
+  aiReady: () => import_express2.aiReady,
+  mountAiReady: () => mountAiReady
+});
+module.exports = __toCommonJS(index_exports);
+var import_swagger = require("@nestjs/swagger");
+var import_core = require("@exposify/core");
+var import_express = require("@exposify/express");
+var import_express2 = require("@exposify/express");
+var mark = (ext) => (0, import_swagger.ApiExtension)(import_core.EXPOSIFY_EXTENSION, ext);
+function McpExposed() {
+  return mark({ expose: true });
+}
+function McpHidden() {
+  return mark({ hidden: true });
+}
+function McpDescribe(meta) {
+  return mark({ ...meta.name ? { name: meta.name } : {}, ...meta.description ? { description: meta.description } : {}, expose: true });
+}
+function mountAiReady(app, options = {}) {
+  const { swaggerConfig, openapi, ...rest } = options;
+  const document = openapi ?? import_swagger.SwaggerModule.createDocument(app, swaggerConfig ?? new import_swagger.DocumentBuilder().build());
+  app.use((0, import_express.aiReady)({ ...rest, openapi: document }));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  McpDescribe,
+  McpExposed,
+  McpHidden,
+  aiReady,
+  mountAiReady
+});

package/dist/index.d.cts

@@ -0,0 +1,26 @@
+import { INestApplication } from '@nestjs/common';
+import { OpenAPIObject } from '@nestjs/swagger';
+import { ExpressAiReadyOptions } from '@exposify/express';
+export { ExpressAiReadyOptions, aiReady } from '@exposify/express';
+
+/** Let agents call this route (writes are hidden by default). */
+declare function McpExposed(): MethodDecorator;
+/** Keep this route away from agents (reads are exposed by default). */
+declare function McpHidden(): MethodDecorator;
+/** Expose this route with an explicit tool name and/or description. */
+declare function McpDescribe(meta: {
+    name?: string;
+    description?: string;
+}): MethodDecorator;
+interface NestAiReadyOptions extends ExpressAiReadyOptions {
+    /** Base document for SwaggerModule.createDocument (title, version, ...). Default: an empty one. */
+    swaggerConfig?: Omit<OpenAPIObject, "paths">;
+}
+/**
+ * Builds the Swagger document for `app` (unless `openapi` is given) and mounts
+ * aiReady() with it. Call after NestFactory.create() and any setGlobalPrefix /
+ * enableVersioning, before app.listen().
+ */
+declare function mountAiReady(app: INestApplication, options?: NestAiReadyOptions): void;
+
+export { McpDescribe, McpExposed, McpHidden, type NestAiReadyOptions, mountAiReady };

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+import { INestApplication } from '@nestjs/common';
+import { OpenAPIObject } from '@nestjs/swagger';
+import { ExpressAiReadyOptions } from '@exposify/express';
+export { ExpressAiReadyOptions, aiReady } from '@exposify/express';
+
+/** Let agents call this route (writes are hidden by default). */
+declare function McpExposed(): MethodDecorator;
+/** Keep this route away from agents (reads are exposed by default). */
+declare function McpHidden(): MethodDecorator;
+/** Expose this route with an explicit tool name and/or description. */
+declare function McpDescribe(meta: {
+    name?: string;
+    description?: string;
+}): MethodDecorator;
+interface NestAiReadyOptions extends ExpressAiReadyOptions {
+    /** Base document for SwaggerModule.createDocument (title, version, ...). Default: an empty one. */
+    swaggerConfig?: Omit<OpenAPIObject, "paths">;
+}
+/**
+ * Builds the Swagger document for `app` (unless `openapi` is given) and mounts
+ * aiReady() with it. Call after NestFactory.create() and any setGlobalPrefix /
+ * enableVersioning, before app.listen().
+ */
+declare function mountAiReady(app: INestApplication, options?: NestAiReadyOptions): void;
+
+export { McpDescribe, McpExposed, McpHidden, type NestAiReadyOptions, mountAiReady };

package/dist/index.js

@@ -0,0 +1,27 @@
+// src/index.ts
+import { ApiExtension, DocumentBuilder, SwaggerModule } from "@nestjs/swagger";
+import { EXPOSIFY_EXTENSION } from "@exposify/core";
+import { aiReady } from "@exposify/express";
+import { aiReady as aiReady2 } from "@exposify/express";
+var mark = (ext) => ApiExtension(EXPOSIFY_EXTENSION, ext);
+function McpExposed() {
+  return mark({ expose: true });
+}
+function McpHidden() {
+  return mark({ hidden: true });
+}
+function McpDescribe(meta) {
+  return mark({ ...meta.name ? { name: meta.name } : {}, ...meta.description ? { description: meta.description } : {}, expose: true });
+}
+function mountAiReady(app, options = {}) {
+  const { swaggerConfig, openapi, ...rest } = options;
+  const document = openapi ?? SwaggerModule.createDocument(app, swaggerConfig ?? new DocumentBuilder().build());
+  app.use(aiReady({ ...rest, openapi: document }));
+}
+export {
+  McpDescribe,
+  McpExposed,
+  McpHidden,
+  aiReady2 as aiReady,
+  mountAiReady
+};

package/package.json

@@ -1,6 +1,53 @@
 {
   "name": "@exposify/nestjs",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.0.1",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --clean",
+    "typecheck": "tsc --noEmit",
+    "prepack": "yarn build"
+  },
+  "dependencies": {
+    "@exposify/core": "0.3.13",
+    "@exposify/express": "0.3.9"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "^11.0.0 || ^12.0.0",
+    "@nestjs/swagger": "^11.0.0 || ^12.0.0"
+  },
+  "devDependencies": {
+    "@nestjs/common": "^12.1.0",
+    "@nestjs/swagger": "^12.0.0",
+    "@types/node": "^22.0.0",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.1",
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "NestJS integration for Exposify: @McpExposed/@McpHidden/@McpDescribe decorators and one-line mounting, with tool schemas and descriptions from @nestjs/swagger.",
+  "author": "Exposify",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "nestjs",
+    "swagger",
+    "ai-agents"
+  ]
 }