@brightchain/brightchain-api-lib 0.14.0 → 0.15.0

package/src/lib/controllers/identity/directoryController.js

@@ -0,0 +1,288 @@
+"use strict";
+/**
+ * DirectoryController — REST API for the public key directory.
+ *
+ * Routes:
+ *   GET  /search              — Search the public key directory
+ *   GET  /profile/:memberId   — Get a member's public profile
+ *   PUT  /profile              — Create or update a public profile
+ *   POST /profile/:memberId/privacy — Toggle privacy mode
+ *
+ * Requirements: 5.1-5.10
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DirectoryController = void 0;
+const proofPlatform_1 = require("@brightchain/brightchain-lib/lib/enumerations/proofPlatform");
+const identity_1 = require("@brightchain/brightchain-lib/lib/services/identity");
+const node_express_suite_1 = require("@digitaldefiance/node-express-suite");
+const errorResponse_1 = require("../../utils/errorResponse");
+const base_1 = require("../base");
+// ─── Controller ─────────────────────────────────────────────────────────────
+/**
+ * Controller for the public key directory.
+ *
+ * Delegates to {@link PublicKeyDirectoryService} in brightchain-lib for
+ * search, profile management, and privacy mode toggling.
+ *
+ * @requirements 5.1, 5.2, 5.3, 5.4, 5.5, 5.6, 5.7, 5.8, 5.9, 5.10
+ */
+class DirectoryController extends base_1.BaseController {
+    constructor(application) {
+        super(application);
+        this.directoryService = null;
+    }
+    /**
+     * Inject the directory service instance.
+     * Must be called during application initialisation before handling requests.
+     */
+    setDirectoryService(service) {
+        this.directoryService = service;
+    }
+    getDirectoryService() {
+        if (!this.directoryService) {
+            throw new Error('PublicKeyDirectoryService not initialized');
+        }
+        return this.directoryService;
+    }
+    // ─── Route definitions ──────────────────────────────────────────────────
+    initRouteDefinitions() {
+        const noAuth = {
+            useAuthentication: false,
+            useCryptoAuthentication: false,
+        };
+        this.routeDefinitions = [
+            (0, node_express_suite_1.routeConfig)('get', '/search', {
+                ...noAuth,
+                handlerKey: 'searchDirectory',
+                openapi: {
+                    summary: 'Search the public key directory',
+                    description: 'Searches profiles by display name, social username, or member ID with relevance ranking and pagination.',
+                    tags: ['Directory'],
+                    responses: {
+                        200: {
+                            schema: 'SearchDirectoryResponse',
+                            description: 'Search results',
+                        },
+                        400: {
+                            schema: 'ApiErrorResponse',
+                            description: 'Missing search query',
+                        },
+                    },
+                },
+            }),
+            (0, node_express_suite_1.routeConfig)('get', '/profile/:memberId', {
+                ...noAuth,
+                handlerKey: 'getProfile',
+                openapi: {
+                    summary: 'Get a member public profile',
+                    description: 'Returns the public profile for a member by ID, regardless of privacy mode.',
+                    tags: ['Directory'],
+                    responses: {
+                        200: {
+                            schema: 'GetProfileResponse',
+                            description: 'Profile found',
+                        },
+                        404: {
+                            schema: 'ApiErrorResponse',
+                            description: 'Profile not found',
+                        },
+                    },
+                },
+            }),
+            (0, node_express_suite_1.routeConfig)('put', '/profile', {
+                ...noAuth,
+                handlerKey: 'updateProfile',
+                openapi: {
+                    summary: 'Create or update a public profile',
+                    description: 'Adds a new profile or updates an existing one in the directory.',
+                    tags: ['Directory'],
+                    responses: {
+                        200: {
+                            schema: 'UpdateProfileResponse',
+                            description: 'Profile updated',
+                        },
+                        400: {
+                            schema: 'ApiErrorResponse',
+                            description: 'Invalid profile data',
+                        },
+                    },
+                },
+            }),
+            (0, node_express_suite_1.routeConfig)('post', '/profile/:memberId/privacy', {
+                ...noAuth,
+                handlerKey: 'togglePrivacy',
+                openapi: {
+                    summary: 'Toggle privacy mode for a profile',
+                    description: 'Toggles whether a profile appears in directory search results.',
+                    tags: ['Directory'],
+                    responses: {
+                        200: {
+                            schema: 'TogglePrivacyResponse',
+                            description: 'Privacy mode toggled',
+                        },
+                        404: {
+                            schema: 'ApiErrorResponse',
+                            description: 'Profile not found',
+                        },
+                    },
+                },
+            }),
+        ];
+        this.handlers = {
+            searchDirectory: this.handleSearch.bind(this),
+            getProfile: this.handleGetProfile.bind(this),
+            updateProfile: this.handleUpdateProfile.bind(this),
+            togglePrivacy: this.handleTogglePrivacy.bind(this),
+        };
+    }
+    // ─── Handlers ─────────────────────────────────────────────────────────
+    /**
+     * GET /search — Search the public key directory.
+     *
+     * Query params: q (required), limit, offset, platformFilter
+     *
+     * @requirements 5.2, 5.3, 5.5, 5.9, 5.10
+     */
+    async handleSearch(req) {
+        try {
+            const { q, limit, offset, platformFilter } = req.query;
+            if (!q || typeof q !== 'string' || q.trim().length === 0) {
+                return (0, errorResponse_1.validationError)('Missing required query parameter: q');
+            }
+            // Validate platformFilter if provided
+            if (platformFilter &&
+                !Object.values(proofPlatform_1.ProofPlatform).includes(platformFilter)) {
+                return (0, errorResponse_1.validationError)(`Invalid platformFilter: ${platformFilter} (expected one of ${Object.values(proofPlatform_1.ProofPlatform).join(', ')})`);
+            }
+            const directory = this.getDirectoryService();
+            const searchResult = directory.search(q, {
+                limit: limit ? parseInt(limit, 10) : undefined,
+                offset: offset ? parseInt(offset, 10) : undefined,
+                platformFilter: platformFilter
+                    ? platformFilter
+                    : undefined,
+            });
+            return {
+                statusCode: 200,
+                response: {
+                    status: 'success',
+                    data: {
+                        results: searchResult.results,
+                        totalCount: searchResult.totalCount,
+                        hasMore: searchResult.hasMore,
+                    },
+                    message: `Found ${searchResult.totalCount} result(s)`,
+                },
+            };
+        }
+        catch (error) {
+            return (0, errorResponse_1.handleError)(error);
+        }
+    }
+    /**
+     * GET /profile/:memberId — Get a member's public profile.
+     *
+     * Returns the profile regardless of privacy mode (direct lookup).
+     *
+     * @requirements 5.1, 5.9
+     */
+    async handleGetProfile(req) {
+        try {
+            const { memberId } = req.params;
+            if (!memberId) {
+                return (0, errorResponse_1.validationError)('Missing required parameter: memberId');
+            }
+            const directory = this.getDirectoryService();
+            const profile = directory.getProfile(memberId);
+            return {
+                statusCode: 200,
+                response: {
+                    status: 'success',
+                    data: profile,
+                    message: 'Profile found',
+                },
+            };
+        }
+        catch (error) {
+            if (error instanceof identity_1.ProfileNotFoundError) {
+                const { memberId } = req.params;
+                return (0, errorResponse_1.notFoundError)('Profile', memberId);
+            }
+            return (0, errorResponse_1.handleError)(error);
+        }
+    }
+    /**
+     * PUT /profile — Create or update a public profile.
+     *
+     * @requirements 5.1, 5.7, 5.8
+     */
+    async handleUpdateProfile(req) {
+        try {
+            const profile = req.body;
+            if (!profile || typeof profile !== 'object') {
+                return (0, errorResponse_1.validationError)('Missing request body');
+            }
+            if (!profile.memberId || typeof profile.memberId !== 'string') {
+                return (0, errorResponse_1.validationError)('Missing required field: memberId');
+            }
+            if (!profile.displayName || typeof profile.displayName !== 'string') {
+                return (0, errorResponse_1.validationError)('Missing required field: displayName');
+            }
+            if (!profile.publicKey || typeof profile.publicKey !== 'string') {
+                return (0, errorResponse_1.validationError)('Missing required field: publicKey');
+            }
+            const directory = this.getDirectoryService();
+            directory.updateProfile(profile);
+            // Retrieve the stored profile (may have updated timestamps)
+            const stored = directory.getProfile(profile.memberId);
+            return {
+                statusCode: 200,
+                response: {
+                    status: 'success',
+                    data: stored,
+                    message: 'Profile updated',
+                },
+            };
+        }
+        catch (error) {
+            if (error instanceof identity_1.InvalidProfileError) {
+                return (0, errorResponse_1.validationError)(error.message);
+            }
+            return (0, errorResponse_1.handleError)(error);
+        }
+    }
+    /**
+     * POST /profile/:memberId/privacy — Toggle privacy mode.
+     *
+     * @requirements 5.6, 5.9
+     */
+    async handleTogglePrivacy(req) {
+        try {
+            const { memberId } = req.params;
+            if (!memberId) {
+                return (0, errorResponse_1.validationError)('Missing required parameter: memberId');
+            }
+            const directory = this.getDirectoryService();
+            const privacyMode = directory.togglePrivacyMode(memberId);
+            return {
+                statusCode: 200,
+                response: {
+                    status: 'success',
+                    data: { privacyMode },
+                    message: privacyMode
+                        ? 'Privacy mode enabled — profile hidden from search'
+                        : 'Privacy mode disabled — profile visible in search',
+                },
+            };
+        }
+        catch (error) {
+            if (error instanceof identity_1.ProfileNotFoundError) {
+                const { memberId } = req.params;
+                return (0, errorResponse_1.notFoundError)('Profile', memberId);
+            }
+            return (0, errorResponse_1.handleError)(error);
+        }
+    }
+}
+exports.DirectoryController = DirectoryController;
+//# sourceMappingURL=directoryController.js.map

package/src/lib/controllers/identity/directoryController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directoryController.js","sourceRoot":"","sources":["../../../../../../brightchain-api-lib/src/lib/controllers/identity/directoryController.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEH,+FAA4F;AAQ5F,iFAI4D;AAG5D,4EAK6C;AAG7C,6DAImC;AACnC,kCAAyC;AAyCzC,+EAA+E;AAE/E;;;;;;;GAOG;AACH,MAAa,mBAEX,SAAQ,qBAKT;IAGC,YAAY,WAAyC;QACnD,KAAK,CAAC,WAAW,CAAC,CAAC;QAHb,qBAAgB,GAAqC,IAAI,CAAC;IAIlE,CAAC;IAED;;;OAGG;IACI,mBAAmB,CAAC,OAAkC;QAC3D,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC;IAClC,CAAC;IAEO,mBAAmB;QACzB,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAED,2EAA2E;IAEjE,oBAAoB;QAC5B,MAAM,MAAM,GAAG;YACb,iBAAiB,EAAE,KAAK;YACxB,uBAAuB,EAAE,KAAK;SAC/B,CAAC;QAEF,IAAI,CAAC,gBAAgB,GAAG;YACtB,IAAA,gCAAW,EAAC,KAAK,EAAE,SAAS,EAAE;gBAC5B,GAAG,MAAM;gBACT,UAAU,EAAE,iBAAiB;gBAC7B,OAAO,EAAE;oBACP,OAAO,EAAE,iCAAiC;oBAC1C,WAAW,EACT,yGAAyG;oBAC3G,IAAI,EAAE,CAAC,WAAW,CAAC;oBACnB,SAAS,EAAE;wBACT,GAAG,EAAE;4BACH,MAAM,EAAE,yBAAyB;4BACjC,WAAW,EAAE,gBAAgB;yBAC9B;wBACD,GAAG,EAAE;4BACH,MAAM,EAAE,kBAAkB;4BAC1B,WAAW,EAAE,sBAAsB;yBACpC;qBACF;iBACF;aACF,CAAC;YACF,IAAA,gCAAW,EAAC,KAAK,EAAE,oBAAoB,EAAE;gBACvC,GAAG,MAAM;gBACT,UAAU,EAAE,YAAY;gBACxB,OAAO,EAAE;oBACP,OAAO,EAAE,6BAA6B;oBACtC,WAAW,EACT,4EAA4E;oBAC9E,IAAI,EAAE,CAAC,WAAW,CAAC;oBACnB,SAAS,EAAE;wBACT,GAAG,EAAE;4BACH,MAAM,EAAE,oBAAoB;4BAC5B,WAAW,EAAE,eAAe;yBAC7B;wBACD,GAAG,EAAE;4BACH,MAAM,EAAE,kBAAkB;4BAC1B,WAAW,EAAE,mBAAmB;yBACjC;qBACF;iBACF;aACF,CAAC;YACF,IAAA,gCAAW,EAAC,KAAK,EAAE,UAAU,EAAE;gBAC7B,GAAG,MAAM;gBACT,UAAU,EAAE,eAAe;gBAC3B,OAAO,EAAE;oBACP,OAAO,EAAE,mCAAmC;oBAC5C,WAAW,EACT,iEAAiE;oBACnE,IAAI,EAAE,CAAC,WAAW,CAAC;oBACnB,SAAS,EAAE;wBACT,GAAG,EAAE;4BACH,MAAM,EAAE,uBAAuB;4BAC/B,WAAW,EAAE,iBAAiB;yBAC/B;wBACD,GAAG,EAAE;4BACH,MAAM,EAAE,kBAAkB;4BAC1B,WAAW,EAAE,sBAAsB;yBACpC;qBACF;iBACF;aACF,CAAC;YACF,IAAA,gCAAW,EAAC,MAAM,EAAE,4BAA4B,EAAE;gBAChD,GAAG,MAAM;gBACT,UAAU,EAAE,eAAe;gBAC3B,OAAO,EAAE;oBACP,OAAO,EAAE,mCAAmC;oBAC5C,WAAW,EACT,gEAAgE;oBAClE,IAAI,EAAE,CAAC,WAAW,CAAC;oBACnB,SAAS,EAAE;wBACT,GAAG,EAAE;4BACH,MAAM,EAAE,uBAAuB;4BAC/B,WAAW,EAAE,sBAAsB;yBACpC;wBACD,GAAG,EAAE;4BACH,MAAM,EAAE,kBAAkB;4BAC1B,WAAW,EAAE,mBAAmB;yBACjC;qBACF;iBACF;aACF,CAAC;SACH,CAAC;QAEF,IAAI,CAAC,QAAQ,GAAG;YACd,eAAe,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;YAC7C,UAAU,EAAE,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;YAC5C,aAAa,EAAE,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC;YAClD,aAAa,EAAE,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC;SACnD,CAAC;IACJ,CAAC;IAED,yEAAyE;IAEzE;;;;;;OAMG;IACK,KAAK,CAAC,YAAY,CAAC,GAAY;QAIrC,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,GAAI,GAAmB,CAAC,KAAK,CAAC;YAExE,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzD,OAAO,IAAA,+BAAe,EAAC,qCAAqC,CAAC,CAAC;YAChE,CAAC;YAED,sCAAsC;YACtC,IACE,cAAc;gBACd,CAAC,MAAM,CAAC,MAAM,CAAC,6BAAa,CAAC,CAAC,QAAQ,CAAC,cAA+B,CAAC,EACvE,CAAC;gBACD,OAAO,IAAA,+BAAe,EACpB,2BAA2B,cAAc,qBAAqB,MAAM,CAAC,MAAM,CAAC,6BAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACzG,CAAC;YACJ,CAAC;YAED,MAAM,SAAS,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC7C,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE;gBACvC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;gBAC9C,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;gBACjD,cAAc,EAAE,cAAc;oBAC5B,CAAC,CAAE,cAAgC;oBACnC,CAAC,CAAC,SAAS;aACd,CAAC,CAAC;YAEH,OAAO;gBACL,UAAU,EAAE,GAAG;gBACf,QAAQ,EAAE;oBACR,MAAM,EAAE,SAAS;oBACjB,IAAI,EAAE;wBACJ,OAAO,EAAE,YAAY,CAAC,OAAO;wBAC7B,UAAU,EAAE,YAAY,CAAC,UAAU;wBACnC,OAAO,EAAE,YAAY,CAAC,OAAO;qBAC9B;oBACD,OAAO,EAAE,SAAS,YAAY,CAAC,UAAU,YAAY;iBACnB;aACrC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAA,2BAAW,EAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,gBAAgB,CAAC,GAAY;QAIzC,IAAI,CAAC;YACH,MAAM,EAAE,QAAQ,EAAE,GAAI,GAAsB,CAAC,MAAM,CAAC;YACpD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO,IAAA,+BAAe,EAAC,sCAAsC,CAAC,CAAC;YACjE,CAAC;YAED,MAAM,SAAS,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC7C,MAAM,OAAO,GAAG,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YAE/C,OAAO;gBACL,UAAU,EAAE,GAAG;gBACf,QAAQ,EAAE;oBACR,MAAM,EAAE,SAAS;oBACjB,IAAI,EAAE,OAAO;oBACb,OAAO,EAAE,eAAe;iBACK;aAChC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,+BAAoB,EAAE,CAAC;gBAC1C,MAAM,EAAE,QAAQ,EAAE,GAAI,GAAsB,CAAC,MAAM,CAAC;gBACpD,OAAO,IAAA,6BAAa,EAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YAC5C,CAAC;YACD,OAAO,IAAA,2BAAW,EAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,mBAAmB,CAAC,GAAY;QAI5C,IAAI,CAAC;YACH,MAAM,OAAO,GAAI,GAAyB,CAAC,IAAI,CAAC;YAEhD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAC5C,OAAO,IAAA,+BAAe,EAAC,sBAAsB,CAAC,CAAC;YACjD,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBAC9D,OAAO,IAAA,+BAAe,EAAC,kCAAkC,CAAC,CAAC;YAC7D,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;gBACpE,OAAO,IAAA,+BAAe,EAAC,qCAAqC,CAAC,CAAC;YAChE,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;gBAChE,OAAO,IAAA,+BAAe,EAAC,mCAAmC,CAAC,CAAC;YAC9D,CAAC;YAED,MAAM,SAAS,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC7C,SAAS,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YAEjC,4DAA4D;YAC5D,MAAM,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAEtD,OAAO;gBACL,UAAU,EAAE,GAAG;gBACf,QAAQ,EAAE;oBACR,MAAM,EAAE,SAAS;oBACjB,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,iBAAiB;iBACM;aACnC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,8BAAmB,EAAE,CAAC;gBACzC,OAAO,IAAA,+BAAe,EAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACxC,CAAC;YACD,OAAO,IAAA,2BAAW,EAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,mBAAmB,CAAC,GAAY;QAI5C,IAAI,CAAC;YACH,MAAM,EAAE,QAAQ,EAAE,GAAI,GAAsB,CAAC,MAAM,CAAC;YACpD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO,IAAA,+BAAe,EAAC,sCAAsC,CAAC,CAAC;YACjE,CAAC;YAED,MAAM,SAAS,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC7C,MAAM,WAAW,GAAG,SAAS,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;YAE1D,OAAO;gBACL,UAAU,EAAE,GAAG;gBACf,QAAQ,EAAE;oBACR,MAAM,EAAE,SAAS;oBACjB,IAAI,EAAE,EAAE,WAAW,EAAE;oBACrB,OAAO,EAAE,WAAW;wBAClB,CAAC,CAAC,mDAAmD;wBACrD,CAAC,CAAC,mDAAmD;iBACvB;aACnC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,+BAAoB,EAAE,CAAC;gBAC1C,MAAM,EAAE,QAAQ,EAAE,GAAI,GAAsB,CAAC,MAAM,CAAC;gBACpD,OAAO,IAAA,6BAAa,EAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YAC5C,CAAC;YACD,OAAO,IAAA,2BAAW,EAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;CACF;AAhTD,kDAgTC"}

package/src/lib/controllers/identity/identityProofController.d.ts

@@ -0,0 +1,94 @@
+/**
+ * IdentityProofController — REST API for identity proof management.
+ *
+ * Routes:
+ *   POST /create              — Create a new identity proof
+ *   POST /verify              — Verify a proof's signature
+ *   POST /check-url           — Check if a proof URL contains the signed statement
+ *   POST /:id/revoke          — Revoke an identity proof
+ *   GET  /instructions/:platform — Get platform-specific posting instructions
+ *   GET  /list                — List proofs for a member
+ *
+ * Requirements: 4.1-4.10
+ */
+import type { ICheckProofUrlResponse, ICreateProofResponse, IGetInstructionsResponse, IListProofsResponse, IRevokeProofResponse, IVerifyProofResponse } from '@brightchain/brightchain-lib/lib/interfaces/responses/identityProofResponses';
+import { ECIESService, Member, PlatformID } from '@digitaldefiance/ecies-lib';
+import { CoreLanguageCode } from '@digitaldefiance/i18n-lib';
+import { ApiErrorResponse, ApiRequestHandler, TypedHandlers } from '@digitaldefiance/node-express-suite';
+import { IBrightChainApplication } from '../../interfaces/application';
+import { DefaultBackendIdType } from '../../shared-types';
+import { BaseController } from '../base';
+type IdentityProofApiResponse = ICreateProofResponse | IVerifyProofResponse | ICheckProofUrlResponse | IRevokeProofResponse | IGetInstructionsResponse | IListProofsResponse | ApiErrorResponse;
+interface IdentityProofHandlers extends TypedHandlers {
+    createProof: ApiRequestHandler<ICreateProofResponse | ApiErrorResponse>;
+    verifyProof: ApiRequestHandler<IVerifyProofResponse | ApiErrorResponse>;
+    checkProofUrl: ApiRequestHandler<ICheckProofUrlResponse | ApiErrorResponse>;
+    revokeProof: ApiRequestHandler<IRevokeProofResponse | ApiErrorResponse>;
+    getInstructions: ApiRequestHandler<IGetInstructionsResponse | ApiErrorResponse>;
+    listProofs: ApiRequestHandler<IListProofsResponse | ApiErrorResponse>;
+}
+/**
+ * Controller for identity proof creation, verification, and management.
+ *
+ * Delegates to {@link IdentityProofService} in brightchain-lib for
+ * core cryptographic operations.
+ *
+ * @requirements 4.1, 4.2, 4.3, 4.4, 4.5, 4.6, 4.7, 4.8, 4.9, 4.10
+ */
+export declare class IdentityProofController<TID extends PlatformID = DefaultBackendIdType> extends BaseController<TID, IdentityProofApiResponse, IdentityProofHandlers, CoreLanguageCode> {
+    private eciesService;
+    private memberResolver;
+    private readonly proofStore;
+    constructor(application: IBrightChainApplication<TID>);
+    /**
+     * Inject the ECIES service for cryptographic operations.
+     */
+    setEciesService(service: ECIESService<TID>): void;
+    /**
+     * Inject a member resolver function that looks up a Member by ID.
+     * Required for the create endpoint which needs the member's private key.
+     */
+    setMemberResolver(resolver: (memberId: string) => Member<TID> | undefined): void;
+    private getEciesService;
+    private resolveMember;
+    protected initRouteDefinitions(): void;
+    /**
+     * POST /create — Create a new identity proof.
+     *
+     * @requirements 4.1, 4.2, 4.3, 4.8
+     */
+    private handleCreateProof;
+    /**
+     * POST /verify — Verify an identity proof's signature.
+     *
+     * @requirements 4.4
+     */
+    private handleVerifyProof;
+    /**
+     * POST /check-url — Check if a proof URL contains the signed statement.
+     *
+     * @requirements 4.6, 4.10
+     */
+    private handleCheckProofUrl;
+    /**
+     * POST /:id/revoke — Revoke an identity proof.
+     *
+     * @requirements 4.7
+     */
+    private handleRevokeProof;
+    /**
+     * GET /instructions/:platform — Get platform-specific posting instructions.
+     *
+     * @requirements 4.9
+     */
+    private handleGetInstructions;
+    /**
+     * GET /list — List identity proofs for a member.
+     *
+     * @requirements 4.5
+     */
+    private handleListProofs;
+    private mapProofError;
+}
+export {};
+//# sourceMappingURL=identityProofController.d.ts.map

package/src/lib/controllers/identity/identityProofController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identityProofController.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-api-lib/src/lib/controllers/identity/identityProofController.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EACV,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,8EAA8E,CAAC;AAOtF,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EAEd,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAM1D,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAIzC,KAAK,wBAAwB,GACzB,oBAAoB,GACpB,oBAAoB,GACpB,sBAAsB,GACtB,oBAAoB,GACpB,wBAAwB,GACxB,mBAAmB,GACnB,gBAAgB,CAAC;AAIrB,UAAU,qBAAsB,SAAQ,aAAa;IACnD,WAAW,EAAE,iBAAiB,CAAC,oBAAoB,GAAG,gBAAgB,CAAC,CAAC;IACxE,WAAW,EAAE,iBAAiB,CAAC,oBAAoB,GAAG,gBAAgB,CAAC,CAAC;IACxE,aAAa,EAAE,iBAAiB,CAAC,sBAAsB,GAAG,gBAAgB,CAAC,CAAC;IAC5E,WAAW,EAAE,iBAAiB,CAAC,oBAAoB,GAAG,gBAAgB,CAAC,CAAC;IACxE,eAAe,EAAE,iBAAiB,CAChC,wBAAwB,GAAG,gBAAgB,CAC5C,CAAC;IACF,UAAU,EAAE,iBAAiB,CAAC,mBAAmB,GAAG,gBAAgB,CAAC,CAAC;CACvE;AA8ED;;;;;;;GAOG;AACH,qBAAa,uBAAuB,CAClC,GAAG,SAAS,UAAU,GAAG,oBAAoB,CAC7C,SAAQ,cAAc,CACtB,GAAG,EACH,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,CACjB;IACC,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,cAAc,CAEN;IAChB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;gBAEnC,WAAW,EAAE,uBAAuB,CAAC,GAAG,CAAC;IAIrD;;OAEG;IACI,eAAe,CAAC,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,GAAG,IAAI;IAIxD;;;OAGG;IACI,iBAAiB,CACtB,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,GACtD,IAAI;IAIP,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,aAAa;IAarB,SAAS,CAAC,oBAAoB,IAAI,IAAI;IAqItC;;;;OAIG;YACW,iBAAiB;IAiD/B;;;;OAIG;YACW,iBAAiB;IAqC/B;;;;OAIG;YACW,mBAAmB;IA0CjC;;;;OAIG;YACW,iBAAiB;IAsC/B;;;;OAIG;YACW,qBAAqB;IAyBnC;;;;OAIG;YACW,gBAAgB;IA2B9B,OAAO,CAAC,aAAa;CAiCtB"}