@servicelabsco/slabs-access-manager 1.0.26 → 1.0.27

package/dist/mcp/tools/get.listing.tool.d.ts

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+import { McpToolResultInterface } from '../interfaces/mcp.tool.result.interface';
+import { McpTool } from './mcp.tool';
+type GetListingInput = {
+    slug: string;
+};
+export declare class GetListingTool extends McpTool<GetListingInput> {
+    readonly name = "get_listing";
+    readonly title = "Get listing page";
+    readonly description: string;
+    readonly inputSchema: {
+        slug: z.ZodString;
+    };
+    protected readonly readOnly = true;
+    execute(args: GetListingInput): Promise<McpToolResultInterface>;
+}
+export {};

package/dist/mcp/tools/get.listing.tool.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetListingTool = void 0;
+const zod_1 = require("zod");
+const mcp_tool_1 = require("./mcp.tool");
+const inputSchema = {
+    slug: zod_1.z.string().min(3).max(100).describe('Listing page identifier/slug, e.g. "orders" or "business-users".'),
+};
+class GetListingTool extends mcp_tool_1.McpTool {
+    constructor() {
+        super(...arguments);
+        this.name = 'get_listing';
+        this.title = 'Get listing page';
+        this.description = 'Fetch the configuration and data for a listing page by its slug. Returns { definition, preferences, detail }. ' +
+            "Use this to discover a listing's columns and existing preferences before creating or updating one.";
+        this.inputSchema = inputSchema;
+        this.readOnly = true;
+    }
+    execute(args) {
+        return this.run(() => this.client.request({ method: 'GET', path: `v1/b/listing-page/${encodeURIComponent(args.slug)}` }));
+    }
+}
+exports.GetListingTool = GetListingTool;
+//# sourceMappingURL=get.listing.tool.js.map

package/dist/mcp/tools/get.listing.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.listing.tool.js","sourceRoot":"","sources":["../../../src/mcp/tools/get.listing.tool.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,yCAAqC;AAErC,MAAM,WAAW,GAAG;IAChB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,kEAAkE,CAAC;CAChH,CAAC;AAQF,MAAa,cAAe,SAAQ,kBAAwB;IAA5D;;QACa,SAAI,GAAG,aAAa,CAAC;QACrB,UAAK,GAAG,kBAAkB,CAAC;QAC3B,gBAAW,GAChB,gHAAgH;YAChH,oGAAoG,CAAC;QAChG,gBAAW,GAAG,WAAW,CAAC;QAChB,aAAQ,GAAG,IAAI,CAAC;IAKvC,CAAC;IAHG,OAAO,CAAC,IAAqB;QACzB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,qBAAqB,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAC9H,CAAC;CACJ;AAZD,wCAYC"}

package/dist/mcp/tools/index.d.ts

@@ -0,0 +1,5 @@
+export * from './delete.listing.preference.tool';
+export * from './get.listing.tool';
+export * from './mcp.tool';
+export * from './save.listing.preference.tool';
+export * from './tool.registry';

package/dist/mcp/tools/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./delete.listing.preference.tool"), exports);
+__exportStar(require("./get.listing.tool"), exports);
+__exportStar(require("./mcp.tool"), exports);
+__exportStar(require("./save.listing.preference.tool"), exports);
+__exportStar(require("./tool.registry"), exports);
+//# sourceMappingURL=index.js.map

package/dist/mcp/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/tools/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mEAAiD;AAAA,qDAAmC;AAAA,6CAA2B;AAAA,iEAA+C;AAAA,kDAA+B"}

package/dist/mcp/tools/mcp.tool.d.ts

@@ -0,0 +1,20 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { ZodRawShape } from 'zod';
+import { SlabsApiClient } from '../client/slabs.api.client';
+import { McpToolInterface } from '../interfaces/mcp.tool.interface';
+import { McpToolResultInterface } from '../interfaces/mcp.tool.result.interface';
+export declare abstract class McpTool<TArgs = Record<string, unknown>> implements McpToolInterface {
+    protected readonly client: SlabsApiClient;
+    abstract readonly name: string;
+    abstract readonly title: string;
+    abstract readonly description: string;
+    abstract readonly inputSchema: ZodRawShape;
+    protected readonly readOnly: boolean;
+    protected readonly destructive: boolean;
+    constructor(client: SlabsApiClient);
+    abstract execute(args: TArgs): Promise<McpToolResultInterface>;
+    register(server: McpServer): void;
+    protected run(call: () => Promise<unknown>): Promise<McpToolResultInterface>;
+    protected success(data: unknown): McpToolResultInterface;
+    protected failure(error: unknown): McpToolResultInterface;
+}

package/dist/mcp/tools/mcp.tool.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpTool = void 0;
+const slabs_api_error_1 = require("../client/slabs.api.error");
+class McpTool {
+    constructor(client) {
+        this.client = client;
+        this.readOnly = false;
+        this.destructive = false;
+    }
+    register(server) {
+        server.registerTool(this.name, {
+            title: this.title,
+            description: this.description,
+            inputSchema: this.inputSchema,
+            annotations: { readOnlyHint: this.readOnly, destructiveHint: this.destructive },
+        }, async (args) => this.execute(args));
+    }
+    async run(call) {
+        try {
+            return this.success(await call());
+        }
+        catch (error) {
+            return this.failure(error);
+        }
+    }
+    success(data) {
+        const text = typeof data === 'string' ? data : JSON.stringify(data, null, 2);
+        return { content: [{ type: 'text', text: text || 'OK' }] };
+    }
+    failure(error) {
+        if (error instanceof slabs_api_error_1.SlabsApiError) {
+            const text = error.status ? `API error ${error.status}: ${error.message}` : error.message;
+            return { content: [{ type: 'text', text }], isError: true };
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        return { content: [{ type: 'text', text: message }], isError: true };
+    }
+}
+exports.McpTool = McpTool;
+//# sourceMappingURL=mcp.tool.js.map

package/dist/mcp/tools/mcp.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.tool.js","sourceRoot":"","sources":["../../../src/mcp/tools/mcp.tool.ts"],"names":[],"mappings":";;;AAGA,+DAA0D;AAW1D,MAAsB,OAAO;IASzB,YAA+B,MAAsB;QAAtB,WAAM,GAAN,MAAM,CAAgB;QAHlC,aAAQ,GAAY,KAAK,CAAC;QAC1B,gBAAW,GAAY,KAAK,CAAC;IAEQ,CAAC;IAIzD,QAAQ,CAAC,MAAiB;QACtB,MAAM,CAAC,YAAY,CACf,IAAI,CAAC,IAAI,EACT;YACI,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,QAAQ,EAAE,eAAe,EAAE,IAAI,CAAC,WAAW,EAAE;SAClF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAwB,CAAC,CACzD,CAAC;IACN,CAAC;IAES,KAAK,CAAC,GAAG,CAAC,IAA4B;QAC5C,IAAI,CAAC;YACD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;IACL,CAAC;IAES,OAAO,CAAC,IAAa;QAC3B,MAAM,IAAI,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC7E,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;IAC/D,CAAC;IAES,OAAO,CAAC,KAAc;QAC5B,IAAI,KAAK,YAAY,+BAAa,EAAE,CAAC;YACjC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;YAC1F,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAChE,CAAC;QACD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACzE,CAAC;CACJ;AA/CD,0BA+CC"}

package/dist/mcp/tools/save.listing.preference.tool.d.ts

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+import { McpToolResultInterface } from '../interfaces/mcp.tool.result.interface';
+import { McpTool } from './mcp.tool';
+type SaveListingPreferenceInput = {
+    slug: string;
+    id?: number;
+    identifier?: string;
+    column_definition: Record<string, unknown>;
+    query_definition?: Record<string, unknown>;
+    is_global: boolean;
+    is_favourite?: boolean;
+    user_ids?: number[];
+    group_ids?: number[];
+};
+export declare class SaveListingPreferenceTool extends McpTool<SaveListingPreferenceInput> {
+    readonly name = "save_listing_preference";
+    readonly title = "Save listing preference";
+    readonly description: string;
+    readonly inputSchema: {
+        slug: z.ZodString;
+        id: z.ZodOptional<z.ZodNumber>;
+        identifier: z.ZodOptional<z.ZodString>;
+        column_definition: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        query_definition: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        is_global: z.ZodBoolean;
+        is_favourite: z.ZodOptional<z.ZodBoolean>;
+        user_ids: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+        group_ids: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    };
+    execute(args: SaveListingPreferenceInput): Promise<McpToolResultInterface>;
+}
+export {};

package/dist/mcp/tools/save.listing.preference.tool.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SaveListingPreferenceTool = void 0;
+const zod_1 = require("zod");
+const mcp_tool_1 = require("./mcp.tool");
+const jsonObject = zod_1.z.record(zod_1.z.string(), zod_1.z.unknown());
+const inputSchema = {
+    slug: zod_1.z.string().min(3).max(100).describe('Listing page slug the preference belongs to.'),
+    id: zod_1.z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe('Existing preference id. Provide to update an existing preference; omit to create a new one.'),
+    identifier: zod_1.z.string().optional().describe('Optional unique identifier for the preference (e.g. a named view).'),
+    column_definition: jsonObject.describe('Column visibility and ordering configuration. Required. Object keyed by column identifier.'),
+    query_definition: jsonObject.optional().describe('Filter and sort configuration for the preference.'),
+    is_global: zod_1.z
+        .boolean()
+        .describe('Make the preference visible to all users in the business. NOTE: under API-key auth this only takes effect if the client has the ' +
+        '"ua_listing_overrider" role; otherwise the preference is silently saved as private to the API user instead of global.'),
+    is_favourite: zod_1.z.boolean().optional().describe('Mark the preference as a favourite.'),
+    user_ids: zod_1.z.array(zod_1.z.number().int().positive()).optional().describe('User ids allowed to access this preference.'),
+    group_ids: zod_1.z.array(zod_1.z.number().int().positive()).optional().describe('Group ids allowed to access this preference.'),
+};
+class SaveListingPreferenceTool extends mcp_tool_1.McpTool {
+    constructor() {
+        super(...arguments);
+        this.name = 'save_listing_preference';
+        this.title = 'Save listing preference';
+        this.description = 'Create or update a listing preference (column layout, filters, and visibility) for a listing page. ' +
+            'Provide `id` to update an existing preference, omit it to create one. Returns the saved preference.';
+        this.inputSchema = inputSchema;
+    }
+    execute(args) {
+        const { slug, ...body } = args;
+        return this.run(() => this.client.request({ method: 'POST', path: `v1/b/listing-page/${encodeURIComponent(slug)}`, body }));
+    }
+}
+exports.SaveListingPreferenceTool = SaveListingPreferenceTool;
+//# sourceMappingURL=save.listing.preference.tool.js.map

package/dist/mcp/tools/save.listing.preference.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"save.listing.preference.tool.js","sourceRoot":"","sources":["../../../src/mcp/tools/save.listing.preference.tool.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,yCAAqC;AAErC,MAAM,UAAU,GAAG,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AAErD,MAAM,WAAW,GAAG;IAChB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,8CAA8C,CAAC;IACzF,EAAE,EAAE,OAAC;SACA,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,6FAA6F,CAAC;IAC5G,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oEAAoE,CAAC;IAChH,iBAAiB,EAAE,UAAU,CAAC,QAAQ,CAAC,4FAA4F,CAAC;IACpI,gBAAgB,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;IACrG,SAAS,EAAE,OAAC;SACP,OAAO,EAAE;SACT,QAAQ,CACL,kIAAkI;QAC9H,uHAAuH,CAC9H;IACL,YAAY,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IACpF,QAAQ,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IACjH,SAAS,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;CACtH,CAAC;AAkBF,MAAa,yBAA0B,SAAQ,kBAAmC;IAAlF;;QACa,SAAI,GAAG,yBAAyB,CAAC;QACjC,UAAK,GAAG,yBAAyB,CAAC;QAClC,gBAAW,GAChB,qGAAqG;YACrG,qGAAqG,CAAC;QACjG,gBAAW,GAAG,WAAW,CAAC;IAOvC,CAAC;IALG,OAAO,CAAC,IAAgC;QACpC,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAE/B,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAChI,CAAC;CACJ;AAbD,8DAaC"}

package/dist/mcp/tools/tool.registry.d.ts

@@ -0,0 +1,7 @@
+import { SlabsApiClient } from '../client/slabs.api.client';
+import { McpToolInterface } from '../interfaces/mcp.tool.interface';
+export declare class ToolRegistry {
+    private readonly client;
+    constructor(client: SlabsApiClient);
+    tools(): McpToolInterface[];
+}

package/dist/mcp/tools/tool.registry.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolRegistry = void 0;
+const delete_listing_preference_tool_1 = require("./delete.listing.preference.tool");
+const get_listing_tool_1 = require("./get.listing.tool");
+const save_listing_preference_tool_1 = require("./save.listing.preference.tool");
+class ToolRegistry {
+    constructor(client) {
+        this.client = client;
+    }
+    tools() {
+        return [new get_listing_tool_1.GetListingTool(this.client), new save_listing_preference_tool_1.SaveListingPreferenceTool(this.client), new delete_listing_preference_tool_1.DeleteListingPreferenceTool(this.client)];
+    }
+}
+exports.ToolRegistry = ToolRegistry;
+//# sourceMappingURL=tool.registry.js.map

package/dist/mcp/tools/tool.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.registry.js","sourceRoot":"","sources":["../../../src/mcp/tools/tool.registry.ts"],"names":[],"mappings":";;;AAEA,qFAA+E;AAC/E,yDAAoD;AACpD,iFAA2E;AAM3E,MAAa,YAAY;IACrB,YAA6B,MAAsB;QAAtB,WAAM,GAAN,MAAM,CAAgB;IAAG,CAAC;IAEvD,KAAK;QACD,OAAO,CAAC,IAAI,iCAAc,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,wDAAyB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,4DAA2B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACvI,CAAC;CACJ;AAND,oCAMC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@servicelabsco/slabs-access-manager",
-    "version": "1.0.26",
+    "version": "1.0.27",
     "description": "Support for application level menus and dashboards",
     "author": "Hemant Kumar Sah <hemantanshu@gmail.com>",
     "license": "MIT",
@@ -41,6 +41,7 @@
     "dependencies": {
         "@aws-sdk/client-lambda": "^3.1009.0",
         "@googleapis/chat": "^44.6.0",
+        "@modelcontextprotocol/sdk": "^1.29.0",
         "@nestjs/typeorm": "^11.0.0",
         "@servicelabsco/nestjs-utility-services": "^2.0.0",
         "cheerio": "^1.0.0",
@@ -53,7 +54,8 @@
         "googleapis": "^171.4.0",
         "nestjs-command": "^3.1.5",
         "nestjs-console": "^10.0.0",
-        "newrelic": "^13.16.0"
+        "newrelic": "^13.16.0",
+        "zod": "^4.4.3"
     },
     "devDependencies": {
         "@nestjs/cli": "^11.0.16",
@@ -92,7 +94,12 @@
         "rootDir": "src",
         "testRegex": ".*\\.spec\\.ts$",
         "transform": {
-            "^.+\\.(t|j)s$": "ts-jest"
+            "^.+\\.(t|j)s$": [
+                "ts-jest",
+                {
+                    "isolatedModules": true
+                }
+            ]
         },
         "collectCoverageFrom": [
             "**/*.(t|j)s"