@hed-hog/address 0.0.350 → 0.0.351

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

@@ -1 +1 @@
-{"version":3,"file":"address.module.d.ts","sourceRoot":"","sources":["../src/address.module.ts"],"names":[],"mappings":"AAQA,qBAWa,aAAa;CAAG"}
+{"version":3,"file":"address.module.d.ts","sourceRoot":"","sources":["../src/address.module.ts"],"names":[],"mappings":"AASA,qBAWa,aAAa;CAAG"}

package/dist/address.module.js

@@ -14,6 +14,7 @@ const api_pagination_1 = require("@hed-hog/api-pagination");
 const api_prisma_1 = require("@hed-hog/api-prisma");
 const address_controller_1 = require("./address.controller");
 const address_service_1 = require("./address.service");
+const address_mcp_tools_1 = require("./mcp-tools/address.mcp-tools");
 let AddressModule = class AddressModule {
 };
 exports.AddressModule = AddressModule;
@@ -26,7 +27,7 @@ exports.AddressModule = AddressModule = __decorate([
             (0, common_1.forwardRef)(() => api_locale_1.LocaleModule)
         ],
         controllers: [address_controller_1.AddressController],
-        providers: [address_service_1.AddressService],
+        providers: [address_service_1.AddressService, address_mcp_tools_1.AddressMcpTools],
         exports: [address_service_1.AddressService]
     })
 ], AddressModule);

package/dist/address.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"address.module.js","sourceRoot":"","sources":["../src/address.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAoD;AACpD,2CAA8C;AAC9C,oDAAmD;AACnD,4DAA2D;AAC3D,oDAAmD;AACnD,6DAAyD;AACzD,uDAAmD;AAa5C,IAAM,aAAa,GAAnB,MAAM,aAAa;CAAG,CAAA;AAAhB,sCAAa;wBAAb,aAAa;IAXzB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE;YACP,qBAAY,CAAC,OAAO,EAAE;YACtB,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,iCAAgB,CAAC;YAClC,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,yBAAY,CAAC;YAC9B,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,yBAAY,CAAC;SAC/B;QACD,WAAW,EAAE,CAAC,sCAAiB,CAAC;QAChC,SAAS,EAAE,CAAC,gCAAc,CAAC;QAC3B,OAAO,EAAE,CAAC,gCAAc,CAAC;KAC1B,CAAC;GACW,aAAa,CAAG"}
+{"version":3,"file":"address.module.js","sourceRoot":"","sources":["../src/address.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAoD;AACpD,2CAA8C;AAC9C,oDAAmD;AACnD,4DAA2D;AAC3D,oDAAmD;AACnD,6DAAyD;AACzD,uDAAmD;AACnD,qEAAgE;AAazD,IAAM,aAAa,GAAnB,MAAM,aAAa;CAAG,CAAA;AAAhB,sCAAa;wBAAb,aAAa;IAXzB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE;YACP,qBAAY,CAAC,OAAO,EAAE;YACtB,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,iCAAgB,CAAC;YAClC,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,yBAAY,CAAC;YAC9B,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,yBAAY,CAAC;SAC/B;QACD,WAAW,EAAE,CAAC,sCAAiB,CAAC;QAChC,SAAS,EAAE,CAAC,gCAAc,EAAE,mCAAe,CAAC;QAC5C,OAAO,EAAE,CAAC,gCAAc,CAAC;KAC1B,CAAC;GACW,aAAa,CAAG"}

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

@@ -0,0 +1,12 @@
+import { McpContext } from '@hed-hog/core';
+import { AddressService } from '../address.service';
+export declare class AddressMcpTools {
+    private readonly addressService;
+    constructor(addressService: AddressService);
+    list(args: Record<string, any>, _context: McpContext): Promise<any>;
+    get(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=address.mcp-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"address.mcp-tools.d.ts","sourceRoot":"","sources":["../../src/mcp-tools/address.mcp-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAW,MAAM,eAAe,CAAC;AAEpD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,qBACa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,cAAc;gBAAd,cAAc,EAAE,cAAc;IAerD,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC;IAoBnE,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC;IA0BjE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC;IA2BpE,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/address.mcp-tools.js

@@ -0,0 +1,164 @@
+"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.AddressMcpTools = void 0;
+const core_1 = require("@hed-hog/core");
+const common_1 = require("@nestjs/common");
+const address_service_1 = require("../address.service");
+let AddressMcpTools = class AddressMcpTools {
+    constructor(addressService) {
+        this.addressService = addressService;
+    }
+    async list(args, _context) {
+        var _a, _b, _c;
+        return this.addressService.list({
+            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 : '',
+        });
+    }
+    async get(args, context) {
+        return this.addressService.get(args.id, context.locale);
+    }
+    async create(args, context) {
+        return this.addressService.create(args, context.locale);
+    }
+    async update(args, context) {
+        const { id } = args, data = __rest(args, ["id"]);
+        return this.addressService.update(id, data, context.locale);
+    }
+    async delete(args, context) {
+        return this.addressService.delete({ ids: args.ids }, context.locale);
+    }
+};
+exports.AddressMcpTools = AddressMcpTools;
+__decorate([
+    (0, core_1.McpTool)({
+        name: 'address.list',
+        description: 'Lists addresses with pagination and optional search.',
+        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' },
+            },
+        },
+        readOnly: true,
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AddressMcpTools.prototype, "list", null);
+__decorate([
+    (0, core_1.McpTool)({
+        name: 'address.get',
+        description: 'Returns a single address by ID.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'number', description: 'Address ID' },
+            },
+            required: ['id'],
+        },
+        readOnly: true,
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AddressMcpTools.prototype, "get", null);
+__decorate([
+    (0, core_1.McpTool)({
+        name: 'address.create',
+        description: 'Creates a new address.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                address_type: {
+                    type: 'string',
+                    enum: ['RESIDENTIAL', 'COMMERCIAL', 'CORRESPONDENCE', 'ALTERNATIVE', 'WORK', 'BILLING', 'SHIPPING'],
+                    description: 'Address type',
+                },
+                country_code: { type: 'string', description: 'Country code (e.g. BR, US)' },
+                state: { type: 'string', description: 'State or province' },
+                city: { type: 'string', description: 'City' },
+                postal_code: { type: 'string', description: 'Postal / ZIP code' },
+                line1: { type: 'string', description: 'Address line 1' },
+                line2: { type: 'string', description: 'Address line 2 (optional)' },
+                is_primary: { type: 'boolean', description: 'Whether this is the primary address for its type' },
+            },
+            required: ['address_type', 'country_code', 'state', 'city', 'postal_code', 'line1'],
+        },
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AddressMcpTools.prototype, "create", null);
+__decorate([
+    (0, core_1.McpTool)({
+        name: 'address.update',
+        description: 'Updates an existing address by ID.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'number', description: 'Address ID' },
+                address_type: {
+                    type: 'string',
+                    enum: ['RESIDENTIAL', 'COMMERCIAL', 'CORRESPONDENCE', 'ALTERNATIVE', 'WORK', 'BILLING', 'SHIPPING'],
+                    description: 'Address type',
+                },
+                country_code: { type: 'string', description: 'Country code' },
+                state: { type: 'string', description: 'State or province' },
+                city: { type: 'string', description: 'City' },
+                postal_code: { type: 'string', description: 'Postal / ZIP code' },
+                line1: { type: 'string', description: 'Address line 1' },
+                line2: { type: 'string', description: 'Address line 2' },
+                is_primary: { type: 'boolean', description: 'Whether this is the primary address for its type' },
+            },
+            required: ['id'],
+        },
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AddressMcpTools.prototype, "update", null);
+__decorate([
+    (0, core_1.McpTool)({
+        name: 'address.delete',
+        description: 'Deletes one or more addresses by their IDs.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ids: { type: 'array', items: { type: 'number' }, description: 'Address IDs to delete' },
+            },
+            required: ['ids'],
+        },
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AddressMcpTools.prototype, "delete", null);
+exports.AddressMcpTools = AddressMcpTools = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [address_service_1.AddressService])
+], AddressMcpTools);
+//# sourceMappingURL=address.mcp-tools.js.map

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

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

package/hedhog/data/route.yaml

@@ -18,3 +18,47 @@
 - url: /address
   method: DELETE
   relations: *a1
+
+- tool_name: address.list
+  type: MCP
+  name: Address List
+  relations:
+    role:
+      - where:
+          slug: admin
+      - where:
+          slug: admin-address
+
+- tool_name: address.get
+  type: MCP
+  name: Address Get
+  relations:
+    role:
+      - where:
+          slug: admin
+      - where:
+          slug: admin-address
+
+- tool_name: address.create
+  type: MCP
+  name: Address Create
+  relations:
+    role:
+      - where:
+          slug: admin
+
+- tool_name: address.update
+  type: MCP
+  name: Address Update
+  relations:
+    role:
+      - where:
+          slug: admin
+
+- tool_name: address.delete
+  type: MCP
+  name: Address Delete
+  relations:
+    role:
+      - where:
+          slug: admin

package/package.json

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

package/src/address.module.ts

@@ -5,6 +5,7 @@ import { PaginationModule } from '@hed-hog/api-pagination';
 import { PrismaModule } from '@hed-hog/api-prisma';
 import { AddressController } from './address.controller';
 import { AddressService } from './address.service';
+import { AddressMcpTools } from './mcp-tools/address.mcp-tools';
 
 @Module({
   imports: [
@@ -14,7 +15,7 @@ import { AddressService } from './address.service';
     forwardRef(() => LocaleModule)
   ],
   controllers: [AddressController],
-  providers: [AddressService],
+  providers: [AddressService, AddressMcpTools],
   exports: [AddressService]
 })
 export class AddressModule {}

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

@@ -0,0 +1,114 @@
+import { McpContext, McpTool } from '@hed-hog/core';
+import { Injectable } from '@nestjs/common';
+import { AddressService } from '../address.service';
+
+@Injectable()
+export class AddressMcpTools {
+  constructor(private readonly addressService: AddressService) {}
+
+  @McpTool({
+    name: 'address.list',
+    description: 'Lists addresses with pagination and optional search.',
+    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' },
+      },
+    },
+    readOnly: true,
+  })
+  async list(args: Record<string, any>, _context: McpContext): Promise<any> {
+    return this.addressService.list({
+      page: args.page ?? 1,
+      pageSize: args.pageSize ?? 20,
+      search: args.search ?? '',
+    } as any);
+  }
+
+  @McpTool({
+    name: 'address.get',
+    description: 'Returns a single address by ID.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Address ID' },
+      },
+      required: ['id'],
+    },
+    readOnly: true,
+  })
+  async get(args: Record<string, any>, context: McpContext): Promise<any> {
+    return this.addressService.get(args.id, context.locale);
+  }
+
+  @McpTool({
+    name: 'address.create',
+    description: 'Creates a new address.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        address_type: {
+          type: 'string',
+          enum: ['RESIDENTIAL', 'COMMERCIAL', 'CORRESPONDENCE', 'ALTERNATIVE', 'WORK', 'BILLING', 'SHIPPING'],
+          description: 'Address type',
+        },
+        country_code: { type: 'string', description: 'Country code (e.g. BR, US)' },
+        state: { type: 'string', description: 'State or province' },
+        city: { type: 'string', description: 'City' },
+        postal_code: { type: 'string', description: 'Postal / ZIP code' },
+        line1: { type: 'string', description: 'Address line 1' },
+        line2: { type: 'string', description: 'Address line 2 (optional)' },
+        is_primary: { type: 'boolean', description: 'Whether this is the primary address for its type' },
+      },
+      required: ['address_type', 'country_code', 'state', 'city', 'postal_code', 'line1'],
+    },
+  })
+  async create(args: Record<string, any>, context: McpContext): Promise<any> {
+    return this.addressService.create(args as any, context.locale);
+  }
+
+  @McpTool({
+    name: 'address.update',
+    description: 'Updates an existing address by ID.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Address ID' },
+        address_type: {
+          type: 'string',
+          enum: ['RESIDENTIAL', 'COMMERCIAL', 'CORRESPONDENCE', 'ALTERNATIVE', 'WORK', 'BILLING', 'SHIPPING'],
+          description: 'Address type',
+        },
+        country_code: { type: 'string', description: 'Country code' },
+        state: { type: 'string', description: 'State or province' },
+        city: { type: 'string', description: 'City' },
+        postal_code: { type: 'string', description: 'Postal / ZIP code' },
+        line1: { type: 'string', description: 'Address line 1' },
+        line2: { type: 'string', description: 'Address line 2' },
+        is_primary: { type: 'boolean', description: 'Whether this is the primary address for its type' },
+      },
+      required: ['id'],
+    },
+  })
+  async update(args: Record<string, any>, context: McpContext): Promise<any> {
+    const { id, ...data } = args;
+    return this.addressService.update(id, data as any, context.locale);
+  }
+
+  @McpTool({
+    name: 'address.delete',
+    description: 'Deletes one or more addresses by their IDs.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        ids: { type: 'array', items: { type: 'number' }, description: 'Address IDs to delete' },
+      },
+      required: ['ids'],
+    },
+  })
+  async delete(args: Record<string, any>, context: McpContext): Promise<any> {
+    return this.addressService.delete({ ids: args.ids }, context.locale);
+  }
+}