@hed-hog/category 0.0.350 → 0.0.353

package/dist/category.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"category.module.d.ts","sourceRoot":"","sources":["../src/category.module.ts"],"names":[],"mappings":"AAMA,qBASa,cAAc;CAAG"}
+{"version":3,"file":"category.module.d.ts","sourceRoot":"","sources":["../src/category.module.ts"],"names":[],"mappings":"AAOA,qBASa,cAAc;CAAG"}

package/dist/category.module.js

@@ -12,6 +12,7 @@ const api_pagination_1 = require("@hed-hog/api-pagination");
 const common_1 = require("@nestjs/common");
 const category_controller_1 = require("./category.controller");
 const category_service_1 = require("./category.service");
+const category_mcp_tools_1 = require("./mcp-tools/category.mcp-tools");
 let CategoryModule = class CategoryModule {
 };
 exports.CategoryModule = CategoryModule;
@@ -22,7 +23,7 @@ exports.CategoryModule = CategoryModule = __decorate([
             (0, common_1.forwardRef)(() => api_pagination_1.PaginationModule),
         ],
         controllers: [category_controller_1.CategoryController],
-        providers: [category_service_1.CategoryService],
+        providers: [category_service_1.CategoryService, category_mcp_tools_1.CategoryMcpTools],
         exports: [category_service_1.CategoryService],
     })
 ], CategoryModule);

package/dist/category.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"category.module.js","sourceRoot":"","sources":["../src/category.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,oDAAmD;AACnD,4DAA2D;AAC3D,2CAAoD;AACpD,+DAA2D;AAC3D,yDAAqD;AAW9C,IAAM,cAAc,GAApB,MAAM,cAAc;CAAG,CAAA;AAAjB,wCAAc;yBAAd,cAAc;IAT1B,IAAA,eAAM,EAAC;QACN,OAAO,EAAE;YACP,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,yBAAY,CAAC;YAC9B,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,iCAAgB,CAAC;SACnC;QACD,WAAW,EAAE,CAAC,wCAAkB,CAAC;QACjC,SAAS,EAAE,CAAC,kCAAe,CAAC;QAC5B,OAAO,EAAE,CAAC,kCAAe,CAAC;KAC3B,CAAC;GACW,cAAc,CAAG"}
+{"version":3,"file":"category.module.js","sourceRoot":"","sources":["../src/category.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,oDAAmD;AACnD,4DAA2D;AAC3D,2CAAoD;AACpD,+DAA2D;AAC3D,yDAAqD;AACrD,uEAAkE;AAW3D,IAAM,cAAc,GAApB,MAAM,cAAc;CAAG,CAAA;AAAjB,wCAAc;yBAAd,cAAc;IAT1B,IAAA,eAAM,EAAC;QACN,OAAO,EAAE;YACP,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,yBAAY,CAAC;YAC9B,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,iCAAgB,CAAC;SACnC;QACD,WAAW,EAAE,CAAC,wCAAkB,CAAC;QACjC,SAAS,EAAE,CAAC,kCAAe,EAAE,qCAAgB,CAAC;QAC9C,OAAO,EAAE,CAAC,kCAAe,CAAC;KAC3B,CAAC;GACW,cAAc,CAAG"}

package/dist/mcp-tools/category.mcp-tools.d.ts

@@ -0,0 +1,15 @@
+import { McpContext } from '@hed-hog/core';
+import { CategoryService } from '../category.service';
+export declare class CategoryMcpTools {
+    private readonly categoryService;
+    constructor(categoryService: CategoryService);
+    list(args: Record<string, any>, context: McpContext): Promise<any>;
+    root(_args: Record<string, any>, context: McpContext): Promise<any>;
+    stats(_args: Record<string, any>, _context: McpContext): Promise<any>;
+    get(args: Record<string, any>, context: McpContext): Promise<any>;
+    getByParent(args: Record<string, any>, context: McpContext): Promise<any>;
+    create(args: Record<string, any>, context: McpContext): Promise<any>;
+    update(args: Record<string, any>, context: McpContext): Promise<any>;
+    delete(args: Record<string, any>, context: McpContext): Promise<any>;
+}
+//# sourceMappingURL=category.mcp-tools.d.ts.map

package/dist/mcp-tools/category.mcp-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"category.mcp-tools.d.ts","sourceRoot":"","sources":["../../src/mcp-tools/category.mcp-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAW,MAAM,eAAe,CAAC;AAEpD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,qBACa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,eAAe;gBAAf,eAAe,EAAE,eAAe;IAiBvD,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC;IAelE,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC;IAUnE,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC;IAgBrE,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC;IAgBjE,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC;IAuBzE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC;IAwBpE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC;IAgBpE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC;CAG3E"}

package/dist/mcp-tools/category.mcp-tools.js

@@ -0,0 +1,204 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CategoryMcpTools = void 0;
+const core_1 = require("@hed-hog/core");
+const common_1 = require("@nestjs/common");
+const category_service_1 = require("../category.service");
+let CategoryMcpTools = class CategoryMcpTools {
+    constructor(categoryService) {
+        this.categoryService = categoryService;
+    }
+    async list(args, context) {
+        var _a, _b, _c, _d, _e;
+        return this.categoryService.findAll({ page: (_a = args.page) !== null && _a !== void 0 ? _a : 1, pageSize: (_b = args.pageSize) !== null && _b !== void 0 ? _b : 20, search: (_c = args.search) !== null && _c !== void 0 ? _c : '' }, context.locale, (_d = args.status) !== null && _d !== void 0 ? _d : 'all', (_e = args.parent) !== null && _e !== void 0 ? _e : 'all');
+    }
+    async root(_args, context) {
+        return this.categoryService.getRootCategories(context.locale);
+    }
+    async stats(_args, _context) {
+        return this.categoryService.getStats();
+    }
+    async get(args, context) {
+        return this.categoryService.getById(context.locale, args.id);
+    }
+    async getByParent(args, context) {
+        return this.categoryService.getByParent(String(args.categoryId), context.locale);
+    }
+    async create(args, context) {
+        return this.categoryService.create(context.locale, args);
+    }
+    async update(args, context) {
+        const { id } = args, data = __rest(args, ["id"]);
+        return this.categoryService.update(context.locale, id, data);
+    }
+    async delete(args, context) {
+        return this.categoryService.delete(args.id, context.locale);
+    }
+};
+exports.CategoryMcpTools = CategoryMcpTools;
+__decorate([
+    (0, core_1.McpTool)({
+        name: 'category.list',
+        description: 'Lists categories with pagination and optional status / parent filters.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                page: { type: 'number', description: 'Page number (default: 1)' },
+                pageSize: { type: 'number', description: 'Items per page (default: 20)' },
+                search: { type: 'string', description: 'Search term (matches slug)' },
+                status: { type: 'string', enum: ['active', 'inactive', 'all'], description: 'Filter by status (default: all)' },
+                parent: { type: 'string', description: 'Filter by parent slug; use "root" for top-level categories, "all" for no filter' },
+            },
+        },
+        readOnly: true,
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], CategoryMcpTools.prototype, "list", null);
+__decorate([
+    (0, core_1.McpTool)({
+        name: 'category.root',
+        description: 'Returns active root categories (categories without a parent).',
+        inputSchema: { type: 'object', properties: {} },
+        readOnly: true,
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], CategoryMcpTools.prototype, "root", null);
+__decorate([
+    (0, core_1.McpTool)({
+        name: 'category.stats',
+        description: 'Returns category counts: total, totalActive, totalInactive, totalRoot.',
+        inputSchema: { type: 'object', properties: {} },
+        readOnly: true,
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], CategoryMcpTools.prototype, "stats", null);
+__decorate([
+    (0, core_1.McpTool)({
+        name: 'category.get',
+        description: 'Returns a single category by ID, including locale translations.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'number', description: 'Category ID' },
+            },
+            required: ['id'],
+        },
+        readOnly: true,
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], CategoryMcpTools.prototype, "get", null);
+__decorate([
+    (0, core_1.McpTool)({
+        name: 'category.get-by-parent',
+        description: 'Returns categories that are direct children of the given parent category ID.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                categoryId: { type: 'number', description: 'Parent category ID' },
+            },
+            required: ['categoryId'],
+        },
+        readOnly: true,
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], CategoryMcpTools.prototype, "getByParent", null);
+__decorate([
+    (0, core_1.McpTool)({
+        name: 'category.create',
+        description: 'Creates a new category with multi-locale names.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                slug: { type: 'string', description: 'Unique slug identifier' },
+                category_id: { type: 'number', description: 'Parent category ID (omit for root category)' },
+                color: { type: 'string', description: 'Color in hex format (e.g. #ff0000)' },
+                icon: { type: 'string', description: 'Icon identifier' },
+                status: { type: 'string', enum: ['active', 'inactive'], description: 'Category status' },
+                locale: {
+                    type: 'object',
+                    description: 'Locale translations as Record<localeCode, { name: string }> (e.g. { "en": { "name": "Electronics" } })',
+                },
+            },
+            required: ['slug', 'locale'],
+        },
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], CategoryMcpTools.prototype, "create", null);
+__decorate([
+    (0, core_1.McpTool)({
+        name: 'category.update',
+        description: 'Updates an existing category by ID.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'number', description: 'Category ID' },
+                slug: { type: 'string', description: 'Unique slug identifier' },
+                category_id: { type: 'number', description: 'Parent category ID' },
+                color: { type: 'string', description: 'Color in hex format' },
+                icon: { type: 'string', description: 'Icon identifier' },
+                status: { type: 'string', enum: ['active', 'inactive'], description: 'Category status' },
+                locale: {
+                    type: 'object',
+                    description: 'Locale translations as Record<localeCode, { name: string }>',
+                },
+            },
+            required: ['id'],
+        },
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], CategoryMcpTools.prototype, "update", null);
+__decorate([
+    (0, core_1.McpTool)({
+        name: 'category.delete',
+        description: 'Deletes a category by ID.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'number', description: 'Category ID' },
+            },
+            required: ['id'],
+        },
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], CategoryMcpTools.prototype, "delete", null);
+exports.CategoryMcpTools = CategoryMcpTools = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [category_service_1.CategoryService])
+], CategoryMcpTools);
+//# sourceMappingURL=category.mcp-tools.js.map

package/dist/mcp-tools/category.mcp-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"category.mcp-tools.js","sourceRoot":"","sources":["../../src/mcp-tools/category.mcp-tools.ts"],"names":[],"mappings":"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"}

package/hedhog/data/route.yaml

@@ -61,4 +61,78 @@
       - where:
           slug: admin
       - where:
-          slug: admin-category
+          slug: admin-category
+
+- tool_name: category.list
+  type: MCP
+  name: Category List
+  relations:
+    role:
+      - where:
+          slug: admin
+      - where:
+          slug: admin-category
+
+- tool_name: category.root
+  type: MCP
+  name: Category Root
+  relations:
+    role:
+      - where:
+          slug: admin
+      - where:
+          slug: admin-category
+
+- tool_name: category.stats
+  type: MCP
+  name: Category Stats
+  relations:
+    role:
+      - where:
+          slug: admin
+      - where:
+          slug: admin-category
+
+- tool_name: category.get
+  type: MCP
+  name: Category Get
+  relations:
+    role:
+      - where:
+          slug: admin
+      - where:
+          slug: admin-category
+
+- tool_name: category.get-by-parent
+  type: MCP
+  name: Category Get By Parent
+  relations:
+    role:
+      - where:
+          slug: admin
+      - where:
+          slug: admin-category
+
+- tool_name: category.create
+  type: MCP
+  name: Category Create
+  relations:
+    role:
+      - where:
+          slug: admin
+
+- tool_name: category.update
+  type: MCP
+  name: Category Update
+  relations:
+    role:
+      - where:
+          slug: admin
+
+- tool_name: category.delete
+  type: MCP
+  name: Category Delete
+  relations:
+    role:
+      - where:
+          slug: admin

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hed-hog/category",
-  "version": "0.0.350",
+  "version": "0.0.353",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "dependencies": {
@@ -10,10 +10,10 @@
     "@nestjs/jwt": "^11",
     "@nestjs/mapped-types": "*",
     "@hed-hog/api-locale": "0.0.14",
-    "@hed-hog/api-pagination": "0.0.7",
-    "@hed-hog/core": "0.0.350",
     "@hed-hog/api-prisma": "0.0.6",
-    "@hed-hog/api": "0.0.8"
+    "@hed-hog/api-pagination": "0.0.7",
+    "@hed-hog/api": "0.0.8",
+    "@hed-hog/core": "0.0.353"
   },
   "exports": {
     ".": {

package/src/category.module.ts

@@ -3,6 +3,7 @@ import { PaginationModule } from '@hed-hog/api-pagination';
 import { Module, forwardRef } from '@nestjs/common';
 import { CategoryController } from './category.controller';
 import { CategoryService } from './category.service';
+import { CategoryMcpTools } from './mcp-tools/category.mcp-tools';
 
 @Module({
   imports: [
@@ -10,7 +11,7 @@ import { CategoryService } from './category.service';
     forwardRef(() => PaginationModule),
   ],
   controllers: [CategoryController],
-  providers: [CategoryService],
+  providers: [CategoryService, CategoryMcpTools],
   exports: [CategoryService],
 })
 export class CategoryModule {}

package/src/mcp-tools/category.mcp-tools.ts

@@ -0,0 +1,147 @@
+import { McpContext, McpTool } from '@hed-hog/core';
+import { Injectable } from '@nestjs/common';
+import { CategoryService } from '../category.service';
+
+@Injectable()
+export class CategoryMcpTools {
+  constructor(private readonly categoryService: CategoryService) {}
+
+  @McpTool({
+    name: 'category.list',
+    description: 'Lists categories with pagination and optional status / parent filters.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        page: { type: 'number', description: 'Page number (default: 1)' },
+        pageSize: { type: 'number', description: 'Items per page (default: 20)' },
+        search: { type: 'string', description: 'Search term (matches slug)' },
+        status: { type: 'string', enum: ['active', 'inactive', 'all'], description: 'Filter by status (default: all)' },
+        parent: { type: 'string', description: 'Filter by parent slug; use "root" for top-level categories, "all" for no filter' },
+      },
+    },
+    readOnly: true,
+  })
+  async list(args: Record<string, any>, context: McpContext): Promise<any> {
+    return this.categoryService.findAll(
+      { page: args.page ?? 1, pageSize: args.pageSize ?? 20, search: args.search ?? '' } as any,
+      context.locale,
+      args.status ?? 'all',
+      args.parent ?? 'all',
+    );
+  }
+
+  @McpTool({
+    name: 'category.root',
+    description: 'Returns active root categories (categories without a parent).',
+    inputSchema: { type: 'object', properties: {} },
+    readOnly: true,
+  })
+  async root(_args: Record<string, any>, context: McpContext): Promise<any> {
+    return this.categoryService.getRootCategories(context.locale);
+  }
+
+  @McpTool({
+    name: 'category.stats',
+    description: 'Returns category counts: total, totalActive, totalInactive, totalRoot.',
+    inputSchema: { type: 'object', properties: {} },
+    readOnly: true,
+  })
+  async stats(_args: Record<string, any>, _context: McpContext): Promise<any> {
+    return this.categoryService.getStats();
+  }
+
+  @McpTool({
+    name: 'category.get',
+    description: 'Returns a single category by ID, including locale translations.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Category ID' },
+      },
+      required: ['id'],
+    },
+    readOnly: true,
+  })
+  async get(args: Record<string, any>, context: McpContext): Promise<any> {
+    return this.categoryService.getById(context.locale, args.id);
+  }
+
+  @McpTool({
+    name: 'category.get-by-parent',
+    description: 'Returns categories that are direct children of the given parent category ID.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        categoryId: { type: 'number', description: 'Parent category ID' },
+      },
+      required: ['categoryId'],
+    },
+    readOnly: true,
+  })
+  async getByParent(args: Record<string, any>, context: McpContext): Promise<any> {
+    return this.categoryService.getByParent(String(args.categoryId), context.locale);
+  }
+
+  @McpTool({
+    name: 'category.create',
+    description: 'Creates a new category with multi-locale names.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        slug: { type: 'string', description: 'Unique slug identifier' },
+        category_id: { type: 'number', description: 'Parent category ID (omit for root category)' },
+        color: { type: 'string', description: 'Color in hex format (e.g. #ff0000)' },
+        icon: { type: 'string', description: 'Icon identifier' },
+        status: { type: 'string', enum: ['active', 'inactive'], description: 'Category status' },
+        locale: {
+          type: 'object',
+          description: 'Locale translations as Record<localeCode, { name: string }> (e.g. { "en": { "name": "Electronics" } })',
+        },
+      },
+      required: ['slug', 'locale'],
+    },
+  })
+  async create(args: Record<string, any>, context: McpContext): Promise<any> {
+    return this.categoryService.create(context.locale, args as any);
+  }
+
+  @McpTool({
+    name: 'category.update',
+    description: 'Updates an existing category by ID.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Category ID' },
+        slug: { type: 'string', description: 'Unique slug identifier' },
+        category_id: { type: 'number', description: 'Parent category ID' },
+        color: { type: 'string', description: 'Color in hex format' },
+        icon: { type: 'string', description: 'Icon identifier' },
+        status: { type: 'string', enum: ['active', 'inactive'], description: 'Category status' },
+        locale: {
+          type: 'object',
+          description: 'Locale translations as Record<localeCode, { name: string }>',
+        },
+      },
+      required: ['id'],
+    },
+  })
+  async update(args: Record<string, any>, context: McpContext): Promise<any> {
+    const { id, ...data } = args;
+    return this.categoryService.update(context.locale, id, data as any);
+  }
+
+  @McpTool({
+    name: 'category.delete',
+    description: 'Deletes a category by ID.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Category ID' },
+      },
+      required: ['id'],
+    },
+  })
+  async delete(args: Record<string, any>, context: McpContext): Promise<any> {
+    return this.categoryService.delete(args.id, context.locale);
+  }
+}