@kkuffour/solid-moderation-plugin 0.2.2 → 0.3.0

package/dist/ModerationHandler.js

@@ -0,0 +1,158 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModerationHandler = void 0;
+const community_server_1 = require("@solid/community-server");
+const fs_1 = require("fs");
+class ModerationHandler extends community_server_1.OperationHandler {
+    constructor(client, enabled, imageNudityThreshold, textSexualThreshold, textToxicThreshold, videoNudityThreshold) {
+        super();
+        this.logger = (0, community_server_1.getLoggerFor)(this);
+        this.client = client;
+        this.enabled = enabled;
+        this.imageNudityThreshold = imageNudityThreshold;
+        this.textSexualThreshold = textSexualThreshold;
+        this.textToxicThreshold = textToxicThreshold;
+        this.videoNudityThreshold = videoNudityThreshold;
+        this.logger.info('ModerationHandler initialized');
+        this.logger.info(`  Enabled: ${enabled}`);
+        this.logger.info(`  Thresholds: image=${imageNudityThreshold}, text=${textSexualThreshold}/${textToxicThreshold}, video=${videoNudityThreshold}`);
+    }
+    async handle({ operation }) {
+        this.logger.info(`[MODERATION] Handler called: ${operation.method} ${operation.target.path}`);
+        if (!this.enabled) {
+            this.logger.info('[MODERATION] Handler disabled, passing through');
+            throw new community_server_1.NotFoundHttpError();
+        }
+        if (!this.shouldModerate(operation)) {
+            this.logger.info(`[MODERATION] Operation not moderatable: ${operation.method}`);
+            throw new community_server_1.NotFoundHttpError();
+        }
+        const contentType = operation.body?.metadata.contentType;
+        if (!contentType || !this.isModeratable(contentType)) {
+            this.logger.info(`[MODERATION] Content type not moderatable: ${contentType}`);
+            throw new community_server_1.NotFoundHttpError();
+        }
+        this.logger.info(`[MODERATION] Starting moderation: ${operation.method} ${contentType} to ${operation.target.path}`);
+        try {
+            this.logger.info('[MODERATION] Reading request body...');
+            const chunks = [];
+            for await (const chunk of operation.body.data) {
+                chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+            }
+            const buffer = Buffer.concat(chunks);
+            this.logger.info(`[MODERATION] Body read: ${buffer.length} bytes`);
+            if (contentType.startsWith('image/')) {
+                this.logger.info('[MODERATION] Calling image moderation...');
+                await this.moderateImage(operation.target.path, buffer, contentType);
+            }
+            else if (contentType.startsWith('video/')) {
+                this.logger.info('[MODERATION] Calling video moderation...');
+                await this.moderateVideo(operation.target.path, buffer, contentType);
+            }
+            else if (contentType.startsWith('text/')) {
+                this.logger.info('[MODERATION] Calling text moderation...');
+                await this.moderateText(operation.target.path, buffer);
+            }
+            operation.body.data = (0, community_server_1.guardedStreamFrom)(buffer);
+            this.logger.info(`[MODERATION] ✅ Content APPROVED: ${operation.target.path}`);
+        }
+        catch (error) {
+            if (error instanceof community_server_1.ForbiddenHttpError) {
+                this.logger.warn(`[MODERATION] ❌ Content BLOCKED: ${operation.target.path} - ${error.message}`);
+                throw error;
+            }
+            this.logger.error(`[MODERATION] ⚠️ Moderation failed: ${error.message}`);
+            this.logger.warn('[MODERATION] Allowing content through (fail-open policy)');
+        }
+        throw new community_server_1.NotFoundHttpError();
+    }
+    shouldModerate(operation) {
+        return (operation.method === 'POST' || operation.method === 'PUT' || operation.method === 'PATCH') &&
+            operation.body;
+    }
+    isModeratable(contentType) {
+        return contentType.startsWith('image/') ||
+            contentType.startsWith('video/') ||
+            contentType.startsWith('text/');
+    }
+    async moderateImage(path, buffer, contentType) {
+        const tempFile = `/tmp/moderation_${Date.now()}.${this.getFileExtension(contentType)}`;
+        this.logger.info(`[MODERATION] Writing temp file: ${tempFile}`);
+        (0, fs_1.writeFileSync)(tempFile, buffer);
+        try {
+            this.logger.info('[MODERATION] Calling SightEngine API for image analysis...');
+            const result = await this.client.analyzeImage(tempFile);
+            this.logger.info(`[MODERATION] SightEngine response: ${JSON.stringify(result)}`);
+            if (result.nudity?.raw && result.nudity.raw > this.imageNudityThreshold) {
+                this.logger.warn(`[MODERATION] Image BLOCKED: ${path} - nudity ${result.nudity.raw.toFixed(2)} > ${this.imageNudityThreshold}`);
+                throw new community_server_1.ForbiddenHttpError(`Image contains inappropriate content (nudity: ${result.nudity.raw.toFixed(2)})`);
+            }
+            this.logger.info(`[MODERATION] Image passed: nudity ${result.nudity?.raw?.toFixed(2) || 'N/A'} <= ${this.imageNudityThreshold}`);
+        }
+        finally {
+            try {
+                (0, fs_1.unlinkSync)(tempFile);
+                this.logger.info(`[MODERATION] Cleaned up temp file: ${tempFile}`);
+            }
+            catch {
+                this.logger.warn(`[MODERATION] Failed to cleanup: ${tempFile}`);
+            }
+        }
+    }
+    async moderateVideo(path, buffer, contentType) {
+        const tempFile = `/tmp/moderation_${Date.now()}.${this.getFileExtension(contentType)}`;
+        this.logger.info(`[MODERATION] Writing temp file: ${tempFile}`);
+        (0, fs_1.writeFileSync)(tempFile, buffer);
+        try {
+            this.logger.info('[MODERATION] Calling SightEngine API for video analysis...');
+            const result = await this.client.analyzeVideo(tempFile);
+            this.logger.info(`[MODERATION] SightEngine response: ${JSON.stringify(result)}`);
+            if (result.nudity?.raw && result.nudity.raw > this.videoNudityThreshold) {
+                this.logger.warn(`[MODERATION] Video BLOCKED: ${path} - nudity ${result.nudity.raw.toFixed(2)} > ${this.videoNudityThreshold}`);
+                throw new community_server_1.ForbiddenHttpError(`Video contains inappropriate content (nudity: ${result.nudity.raw.toFixed(2)})`);
+            }
+            this.logger.info(`[MODERATION] Video passed: nudity ${result.nudity?.raw?.toFixed(2) || 'N/A'} <= ${this.videoNudityThreshold}`);
+        }
+        finally {
+            try {
+                (0, fs_1.unlinkSync)(tempFile);
+                this.logger.info(`[MODERATION] Cleaned up temp file: ${tempFile}`);
+            }
+            catch {
+                this.logger.warn(`[MODERATION] Failed to cleanup: ${tempFile}`);
+            }
+        }
+    }
+    async moderateText(path, buffer) {
+        const text = buffer.toString('utf-8');
+        this.logger.info(`[MODERATION] Text length: ${text.length} chars`);
+        this.logger.info('[MODERATION] Calling SightEngine API for text analysis...');
+        const result = await this.client.analyzeText(text);
+        this.logger.info(`[MODERATION] SightEngine response: ${JSON.stringify(result)}`);
+        const violations = [];
+        if (result.sexual > this.textSexualThreshold) {
+            violations.push(`sexual (${result.sexual.toFixed(2)} > ${this.textSexualThreshold})`);
+        }
+        if (result.toxic > this.textToxicThreshold) {
+            violations.push(`toxic (${result.toxic.toFixed(2)} > ${this.textToxicThreshold})`);
+        }
+        if (violations.length > 0) {
+            this.logger.warn(`[MODERATION] Text BLOCKED: ${path} - ${violations.join(', ')}`);
+            throw new community_server_1.ForbiddenHttpError(`Text contains inappropriate content: ${violations.join(', ')}`);
+        }
+        this.logger.info(`[MODERATION] Text passed: sexual ${result.sexual.toFixed(2)}, toxic ${result.toxic.toFixed(2)}`);
+    }
+    getFileExtension(contentType) {
+        const map = {
+            'image/jpeg': 'jpg',
+            'image/png': 'png',
+            'image/gif': 'gif',
+            'image/webp': 'webp',
+            'video/mp4': 'mp4',
+            'video/webm': 'webm',
+        };
+        return map[contentType] || 'bin';
+    }
+}
+exports.ModerationHandler = ModerationHandler;
+//# sourceMappingURL=ModerationHandler.js.map

package/dist/ModerationHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModerationHandler.js","sourceRoot":"","sources":["../src/ModerationHandler.ts"],"names":[],"mappings":";;;AAAA,8DAAmI;AAEnI,2BAA+C;AAG/C,MAAa,iBAAkB,SAAQ,mCAAgB;IASrD,YACE,MAA2B,EAC3B,OAAgB,EAChB,oBAA4B,EAC5B,mBAA2B,EAC3B,kBAA0B,EAC1B,oBAA4B;QAE5B,KAAK,EAAE,CAAC;QAhBO,WAAM,GAAG,IAAA,+BAAY,EAAC,IAAI,CAAC,CAAC;QAiB3C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,oBAAoB,GAAG,oBAAoB,CAAC;QACjD,IAAI,CAAC,mBAAmB,GAAG,mBAAmB,CAAC;QAC/C,IAAI,CAAC,kBAAkB,GAAG,kBAAkB,CAAC;QAC7C,IAAI,CAAC,oBAAoB,GAAG,oBAAoB,CAAC;QAEjD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,OAAO,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,oBAAoB,UAAU,mBAAmB,IAAI,kBAAkB,WAAW,oBAAoB,EAAE,CAAC,CAAC;IACpJ,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,EAAE,SAAS,EAAyB;QACtD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gCAAgC,SAAS,CAAC,MAAM,IAAI,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAE9F,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;YACnE,MAAM,IAAI,oCAAiB,EAAE,CAAC;QAChC,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,2CAA2C,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;YAChF,MAAM,IAAI,oCAAiB,EAAE,CAAC;QAChC,CAAC;QAED,MAAM,WAAW,GAAG,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,WAAW,CAAC;QACzD,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE,CAAC;YACrD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,8CAA8C,WAAW,EAAE,CAAC,CAAC;YAC9E,MAAM,IAAI,oCAAiB,EAAE,CAAC;QAChC,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,qCAAqC,SAAS,CAAC,MAAM,IAAI,WAAW,OAAO,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAErH,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;YACzD,MAAM,MAAM,GAAa,EAAE,CAAC;YAC5B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,SAAS,CAAC,IAAK,CAAC,IAAI,EAAE,CAAC;gBAC/C,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YACnE,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACrC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,2BAA2B,MAAM,CAAC,MAAM,QAAQ,CAAC,CAAC;YAEnE,IAAI,WAAW,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACrC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;gBAC7D,MAAM,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;YACvE,CAAC;iBAAM,IAAI,WAAW,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC5C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;gBAC7D,MAAM,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;YACvE,CAAC;iBAAM,IAAI,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;gBAC5D,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACzD,CAAC;YAED,SAAS,CAAC,IAAK,CAAC,IAAI,GAAG,IAAA,oCAAiB,EAAC,MAAM,CAAC,CAAC;YACjD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,oCAAoC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAEhF,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,KAAK,YAAY,qCAAkB,EAAE,CAAC;gBACxC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,mCAAmC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAO,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC3G,MAAM,KAAK,CAAC;YACd,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,sCAAuC,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;YACpF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;QAC/E,CAAC;QAED,MAAM,IAAI,oCAAiB,EAAE,CAAC;IAChC,CAAC;IAEO,cAAc,CAAC,SAAc;QACnC,OAAO,CAAC,SAAS,CAAC,MAAM,KAAK,MAAM,IAAI,SAAS,CAAC,MAAM,KAAK,KAAK,IAAI,SAAS,CAAC,MAAM,KAAK,OAAO,CAAC;YAC3F,SAAS,CAAC,IAAI,CAAC;IACxB,CAAC;IAEO,aAAa,CAAC,WAAmB;QACvC,OAAO,WAAW,CAAC,UAAU,CAAC,QAAQ,CAAC;YAChC,WAAW,CAAC,UAAU,CAAC,QAAQ,CAAC;YAChC,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,IAAY,EAAE,MAAc,EAAE,WAAmB;QAC3E,MAAM,QAAQ,GAAG,mBAAmB,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,EAAE,CAAC;QACvF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,mCAAmC,QAAQ,EAAE,CAAC,CAAC;QAChE,IAAA,kBAAa,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAEhC,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;YAC/E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YACxD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sCAAsC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAEjF,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC;gBACxE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,+BAA+B,IAAI,aAAa,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC,CAAC;gBAChI,MAAM,IAAI,qCAAkB,CAAC,iDAAiD,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACjH,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,qCAAqC,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,oBAAoB,EAAE,CAAC,CAAC;QACnI,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC;gBACH,IAAA,eAAU,EAAC,QAAQ,CAAC,CAAC;gBACrB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sCAAsC,QAAQ,EAAE,CAAC,CAAC;YACrE,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,mCAAmC,QAAQ,EAAE,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,IAAY,EAAE,MAAc,EAAE,WAAmB;QAC3E,MAAM,QAAQ,GAAG,mBAAmB,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,EAAE,CAAC;QACvF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,mCAAmC,QAAQ,EAAE,CAAC,CAAC;QAChE,IAAA,kBAAa,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAEhC,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;YAC/E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YACxD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sCAAsC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAEjF,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC;gBACxE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,+BAA+B,IAAI,aAAa,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC,CAAC;gBAChI,MAAM,IAAI,qCAAkB,CAAC,iDAAiD,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACjH,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,qCAAqC,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,oBAAoB,EAAE,CAAC,CAAC;QACnI,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC;gBACH,IAAA,eAAU,EAAC,QAAQ,CAAC,CAAC;gBACrB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sCAAsC,QAAQ,EAAE,CAAC,CAAC;YACrE,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,mCAAmC,QAAQ,EAAE,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,IAAY,EAAE,MAAc;QACrD,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,6BAA6B,IAAI,CAAC,MAAM,QAAQ,CAAC,CAAC;QAEnE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;QAC9E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sCAAsC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAEjF,MAAM,UAAU,GAAa,EAAE,CAAC;QAEhC,IAAI,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC7C,UAAU,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,mBAAmB,GAAG,CAAC,CAAC;QACxF,CAAC;QAED,IAAI,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC3C,UAAU,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,kBAAkB,GAAG,CAAC,CAAC;QACrF,CAAC;QAED,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,8BAA8B,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAClF,MAAM,IAAI,qCAAkB,CAAC,wCAAwC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChG,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,oCAAoC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACrH,CAAC;IAEO,gBAAgB,CAAC,WAAmB;QAC1C,MAAM,GAAG,GAA2B;YAClC,YAAY,EAAE,KAAK;YACnB,WAAW,EAAE,KAAK;YAClB,WAAW,EAAE,KAAK;YAClB,YAAY,EAAE,MAAM;YACpB,WAAW,EAAE,KAAK;YAClB,YAAY,EAAE,MAAM;SACrB,CAAC;QACF,OAAO,GAAG,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC;IACnC,CAAC;CACF;AAvLD,8CAuLC"}

package/dist/ModerationHandler.jsonld

@@ -0,0 +1,126 @@
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/@kkuffour/solid-moderation-plugin/^0.3.0/components/context.jsonld",
+    "https://linkedsoftwaredependencies.org/bundles/npm/@kkuffour/solid-moderation-plugin/^0.3.0/config/context.jsonld",
+    "https://linkedsoftwaredependencies.org/bundles/npm/@solid/community-server/^7.0.0/components/context.jsonld"
+  ],
+  "@id": "npmd:@kkuffour/solid-moderation-plugin",
+  "components": [
+    {
+      "@id": "ksmp:dist/ModerationHandler.jsonld#ModerationHandler",
+      "@type": "Class",
+      "requireElement": "ModerationHandler",
+      "extends": [
+        "css:dist/http/ldp/OperationHandler.jsonld#OperationHandler"
+      ],
+      "parameters": [
+        {
+          "@id": "ksmp:dist/ModerationHandler.jsonld#ModerationHandler_enabled",
+          "range": "xsd:boolean"
+        },
+        {
+          "@id": "ksmp:dist/ModerationHandler.jsonld#ModerationHandler_imageNudityThreshold",
+          "range": "xsd:number"
+        },
+        {
+          "@id": "ksmp:dist/ModerationHandler.jsonld#ModerationHandler_textSexualThreshold",
+          "range": "xsd:number"
+        },
+        {
+          "@id": "ksmp:dist/ModerationHandler.jsonld#ModerationHandler_textToxicThreshold",
+          "range": "xsd:number"
+        },
+        {
+          "@id": "ksmp:dist/ModerationHandler.jsonld#ModerationHandler_videoNudityThreshold",
+          "range": "xsd:number"
+        },
+        {
+          "@id": "ksmp:dist/ModerationHandler.jsonld#ModerationHandler_client",
+          "range": "ksmp:dist/providers/SightEngineProvider.jsonld#SightEngineProvider"
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "ksmp:dist/ModerationHandler.jsonld#ModerationHandler__member_logger",
+          "memberFieldName": "logger"
+        },
+        {
+          "@id": "ksmp:dist/ModerationHandler.jsonld#ModerationHandler__member_client",
+          "memberFieldName": "client"
+        },
+        {
+          "@id": "ksmp:dist/ModerationHandler.jsonld#ModerationHandler__member_enabled",
+          "memberFieldName": "enabled"
+        },
+        {
+          "@id": "ksmp:dist/ModerationHandler.jsonld#ModerationHandler__member_imageNudityThreshold",
+          "memberFieldName": "imageNudityThreshold"
+        },
+        {
+          "@id": "ksmp:dist/ModerationHandler.jsonld#ModerationHandler__member_textSexualThreshold",
+          "memberFieldName": "textSexualThreshold"
+        },
+        {
+          "@id": "ksmp:dist/ModerationHandler.jsonld#ModerationHandler__member_textToxicThreshold",
+          "memberFieldName": "textToxicThreshold"
+        },
+        {
+          "@id": "ksmp:dist/ModerationHandler.jsonld#ModerationHandler__member_videoNudityThreshold",
+          "memberFieldName": "videoNudityThreshold"
+        },
+        {
+          "@id": "ksmp:dist/ModerationHandler.jsonld#ModerationHandler__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "ksmp:dist/ModerationHandler.jsonld#ModerationHandler__member_handle",
+          "memberFieldName": "handle"
+        },
+        {
+          "@id": "ksmp:dist/ModerationHandler.jsonld#ModerationHandler__member_shouldModerate",
+          "memberFieldName": "shouldModerate"
+        },
+        {
+          "@id": "ksmp:dist/ModerationHandler.jsonld#ModerationHandler__member_isModeratable",
+          "memberFieldName": "isModeratable"
+        },
+        {
+          "@id": "ksmp:dist/ModerationHandler.jsonld#ModerationHandler__member_moderateImage",
+          "memberFieldName": "moderateImage"
+        },
+        {
+          "@id": "ksmp:dist/ModerationHandler.jsonld#ModerationHandler__member_moderateVideo",
+          "memberFieldName": "moderateVideo"
+        },
+        {
+          "@id": "ksmp:dist/ModerationHandler.jsonld#ModerationHandler__member_moderateText",
+          "memberFieldName": "moderateText"
+        },
+        {
+          "@id": "ksmp:dist/ModerationHandler.jsonld#ModerationHandler__member_getFileExtension",
+          "memberFieldName": "getFileExtension"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "ksmp:dist/ModerationHandler.jsonld#ModerationHandler_client"
+        },
+        {
+          "@id": "ksmp:dist/ModerationHandler.jsonld#ModerationHandler_enabled"
+        },
+        {
+          "@id": "ksmp:dist/ModerationHandler.jsonld#ModerationHandler_imageNudityThreshold"
+        },
+        {
+          "@id": "ksmp:dist/ModerationHandler.jsonld#ModerationHandler_textSexualThreshold"
+        },
+        {
+          "@id": "ksmp:dist/ModerationHandler.jsonld#ModerationHandler_textToxicThreshold"
+        },
+        {
+          "@id": "ksmp:dist/ModerationHandler.jsonld#ModerationHandler_videoNudityThreshold"
+        }
+      ]
+    }
+  ]
+}

package/dist/components/components.jsonld

@@ -0,0 +1,13 @@
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/@kkuffour/solid-moderation-plugin/^0.3.0/components/context.jsonld",
+    "https://linkedsoftwaredependencies.org/bundles/npm/@kkuffour/solid-moderation-plugin/^0.3.0/config/context.jsonld"
+  ],
+  "@id": "npmd:@kkuffour/solid-moderation-plugin",
+  "@type": "Module",
+  "requireName": "@kkuffour/solid-moderation-plugin",
+  "import": [
+    "npmd:@kkuffour/solid-moderation-plugin/^0.3.0/dist/ModerationHandler.jsonld",
+    "npmd:@kkuffour/solid-moderation-plugin/^0.3.0/dist/providers/SightEngineProvider.jsonld"
+  ]
+}

package/dist/components/context.jsonld

@@ -0,0 +1,11 @@
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/@solid/community-server/^7.0.0/components/context.jsonld",
+    {
+      "ksmp": "https://linkedsoftwaredependencies.org/bundles/npm/@kkuffour/solid-moderation-plugin/",
+      
+      "ModerationHandler": "ksmp:ModerationHandler",
+      "SightEngineProvider": "ksmp:SightEngineProvider"
+    }
+  ]
+}

package/dist/index.d.ts

@@ -1,8 +1,3 @@
-export * from './ModerationOperationHandler';
-export * from './ModerationResourceStore';
-export * from './ModerationConfig';
-export * from './ModerationStore';
-export * from './ModerationRecord';
-export * from './ModerationMixin';
+export * from './ModerationHandler';
 export * from './providers/SightEngineProvider';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iCAAiC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,iCAAiC,CAAC"}

package/dist/index.js

@@ -14,11 +14,6 @@ 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("./ModerationOperationHandler"), exports);
-__exportStar(require("./ModerationResourceStore"), exports);
-__exportStar(require("./ModerationConfig"), exports);
-__exportStar(require("./ModerationStore"), exports);
-__exportStar(require("./ModerationRecord"), exports);
-__exportStar(require("./ModerationMixin"), exports);
+__exportStar(require("./ModerationHandler"), exports);
 __exportStar(require("./providers/SightEngineProvider"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+DAA6C;AAC7C,4DAA0C;AAC1C,qDAAmC;AACnC,oDAAkC;AAClC,qDAAmC;AACnC,oDAAkC;AAClC,kEAAgD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC;AACpC,kEAAgD"}

package/dist/providers/SightEngineProvider.jsonld

@@ -1,7 +1,7 @@
 {
   "@context": [
-    "https://linkedsoftwaredependencies.org/bundles/npm/@kkuffour/solid-moderation-plugin/^0.2.0/components/context.jsonld",
-    "https://linkedsoftwaredependencies.org/bundles/npm/@kkuffour/solid-moderation-plugin/^0.2.0/config/context.jsonld"
+    "https://linkedsoftwaredependencies.org/bundles/npm/@kkuffour/solid-moderation-plugin/^0.3.0/components/context.jsonld",
+    "https://linkedsoftwaredependencies.org/bundles/npm/@kkuffour/solid-moderation-plugin/^0.3.0/config/context.jsonld"
   ],
   "@id": "npmd:@kkuffour/solid-moderation-plugin",
   "components": [

package/package.json

@@ -1,25 +1,24 @@
 {
   "name": "@kkuffour/solid-moderation-plugin",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "Content moderation plugin for Community Solid Server",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "lsd:module": "https://linkedsoftwaredependencies.org/bundles/npm/@kkuffour/solid-moderation-plugin",
-  "lsd:components": "components/components.jsonld",
+  "lsd:components": "dist/components/components.jsonld",
   "lsd:contexts": {
-    "https://linkedsoftwaredependencies.org/bundles/npm/@kkuffour/solid-moderation-plugin/^0.2.0/components/context.jsonld": "components/context.jsonld",
-    "https://linkedsoftwaredependencies.org/bundles/npm/@kkuffour/solid-moderation-plugin/^0.2.0/config/context.jsonld": "config/context.jsonld"
+    "https://linkedsoftwaredependencies.org/bundles/npm/@kkuffour/solid-moderation-plugin/^0.3.0/components/context.jsonld": "dist/components/context.jsonld",
+    "https://linkedsoftwaredependencies.org/bundles/npm/@kkuffour/solid-moderation-plugin/^0.3.0/config/context.jsonld": "config/context.jsonld"
   },
   "lsd:importPaths": {
-    "https://linkedsoftwaredependencies.org/bundles/npm/@solid/moderation-plugin/^1.0.0/components/": "dist/",
-    "https://linkedsoftwaredependencies.org/bundles/npm/@solid/moderation-plugin/^1.0.0/config/": "config/",
-    "https://linkedsoftwaredependencies.org/bundles/npm/@solid/moderation-plugin/^1.0.0/dist/": "dist/"
+    "https://linkedsoftwaredependencies.org/bundles/npm/@kkuffour/solid-moderation-plugin/^0.3.0/components/": "dist/components/",
+    "https://linkedsoftwaredependencies.org/bundles/npm/@kkuffour/solid-moderation-plugin/^0.3.0/config/": "config/",
+    "https://linkedsoftwaredependencies.org/bundles/npm/@kkuffour/solid-moderation-plugin/^0.3.0/dist/": "dist/"
   },
   "scripts": {
     "build": "npm run build:ts && npm run build:components",
     "build:ts": "tsc",
-    "build:components": "componentsjs-generator",
-    "build:copy": "mkdir -p dist/components && cp components/*.jsonld dist/components/",
+    "build:components": "componentsjs-generator -s src -c dist/components -r ksmp && cp components/context.jsonld dist/components/",
     "test": "jest"
   },
   "keywords": [
@@ -34,12 +33,13 @@
     "@solid/community-server": "^7.0.0"
   },
   "dependencies": {
+    "asynchronous-handlers": "^1.0.2",
     "form-data": "^4.0.0"
   },
   "devDependencies": {
     "@solid/community-server": "^7.0.0",
+    "@types/node": "^20.0.0",
     "componentsjs-generator": "^3.1.0",
-    "typescript": "^5.0.0",
-    "@types/node": "^20.0.0"
+    "typescript": "^5.0.0"
   }
 }

package/src/ModerationHandler.ts

@@ -0,0 +1,189 @@
+import { OperationHandler, getLoggerFor, ForbiddenHttpError, NotFoundHttpError, guardedStreamFrom } from '@solid/community-server';
+import type { OperationHandlerInput, ResponseDescription } from '@solid/community-server';
+import { writeFileSync, unlinkSync } from 'fs';
+import type { SightEngineProvider } from './providers/SightEngineProvider';
+
+export class ModerationHandler extends OperationHandler {
+  private readonly logger = getLoggerFor(this);
+  private readonly client: SightEngineProvider;
+  private readonly enabled: boolean;
+  private readonly imageNudityThreshold: number;
+  private readonly textSexualThreshold: number;
+  private readonly textToxicThreshold: number;
+  private readonly videoNudityThreshold: number;
+
+  public constructor(
+    client: SightEngineProvider,
+    enabled: boolean,
+    imageNudityThreshold: number,
+    textSexualThreshold: number,
+    textToxicThreshold: number,
+    videoNudityThreshold: number,
+  ) {
+    super();
+    this.client = client;
+    this.enabled = enabled;
+    this.imageNudityThreshold = imageNudityThreshold;
+    this.textSexualThreshold = textSexualThreshold;
+    this.textToxicThreshold = textToxicThreshold;
+    this.videoNudityThreshold = videoNudityThreshold;
+
+    this.logger.info('ModerationHandler initialized');
+    this.logger.info(`  Enabled: ${enabled}`);
+    this.logger.info(`  Thresholds: image=${imageNudityThreshold}, text=${textSexualThreshold}/${textToxicThreshold}, video=${videoNudityThreshold}`);
+  }
+
+  public async handle({ operation }: OperationHandlerInput): Promise<ResponseDescription> {
+    this.logger.info(`[MODERATION] Handler called: ${operation.method} ${operation.target.path}`);
+    
+    if (!this.enabled) {
+      this.logger.info('[MODERATION] Handler disabled, passing through');
+      throw new NotFoundHttpError();
+    }
+
+    if (!this.shouldModerate(operation)) {
+      this.logger.info(`[MODERATION] Operation not moderatable: ${operation.method}`);
+      throw new NotFoundHttpError();
+    }
+
+    const contentType = operation.body?.metadata.contentType;
+    if (!contentType || !this.isModeratable(contentType)) {
+      this.logger.info(`[MODERATION] Content type not moderatable: ${contentType}`);
+      throw new NotFoundHttpError();
+    }
+
+    this.logger.info(`[MODERATION] Starting moderation: ${operation.method} ${contentType} to ${operation.target.path}`);
+
+    try {
+      this.logger.info('[MODERATION] Reading request body...');
+      const chunks: Buffer[] = [];
+      for await (const chunk of operation.body!.data) {
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+      }
+      const buffer = Buffer.concat(chunks);
+      this.logger.info(`[MODERATION] Body read: ${buffer.length} bytes`);
+
+      if (contentType.startsWith('image/')) {
+        this.logger.info('[MODERATION] Calling image moderation...');
+        await this.moderateImage(operation.target.path, buffer, contentType);
+      } else if (contentType.startsWith('video/')) {
+        this.logger.info('[MODERATION] Calling video moderation...');
+        await this.moderateVideo(operation.target.path, buffer, contentType);
+      } else if (contentType.startsWith('text/')) {
+        this.logger.info('[MODERATION] Calling text moderation...');
+        await this.moderateText(operation.target.path, buffer);
+      }
+
+      operation.body!.data = guardedStreamFrom(buffer);
+      this.logger.info(`[MODERATION] ✅ Content APPROVED: ${operation.target.path}`);
+
+    } catch (error: unknown) {
+      if (error instanceof ForbiddenHttpError) {
+        this.logger.warn(`[MODERATION] ❌ Content BLOCKED: ${operation.target.path} - ${(error as Error).message}`);
+        throw error;
+      }
+      this.logger.error(`[MODERATION] ⚠️ Moderation failed: ${(error as Error).message}`);
+      this.logger.warn('[MODERATION] Allowing content through (fail-open policy)');
+    }
+
+    throw new NotFoundHttpError();
+  }
+
+  private shouldModerate(operation: any): boolean {
+    return (operation.method === 'POST' || operation.method === 'PUT' || operation.method === 'PATCH') && 
+           operation.body;
+  }
+
+  private isModeratable(contentType: string): boolean {
+    return contentType.startsWith('image/') || 
+           contentType.startsWith('video/') || 
+           contentType.startsWith('text/');
+  }
+
+  private async moderateImage(path: string, buffer: Buffer, contentType: string): Promise<void> {
+    const tempFile = `/tmp/moderation_${Date.now()}.${this.getFileExtension(contentType)}`;
+    this.logger.info(`[MODERATION] Writing temp file: ${tempFile}`);
+    writeFileSync(tempFile, buffer);
+
+    try {
+      this.logger.info('[MODERATION] Calling SightEngine API for image analysis...');
+      const result = await this.client.analyzeImage(tempFile);
+      this.logger.info(`[MODERATION] SightEngine response: ${JSON.stringify(result)}`);
+
+      if (result.nudity?.raw && result.nudity.raw > this.imageNudityThreshold) {
+        this.logger.warn(`[MODERATION] Image BLOCKED: ${path} - nudity ${result.nudity.raw.toFixed(2)} > ${this.imageNudityThreshold}`);
+        throw new ForbiddenHttpError(`Image contains inappropriate content (nudity: ${result.nudity.raw.toFixed(2)})`);
+      }
+      this.logger.info(`[MODERATION] Image passed: nudity ${result.nudity?.raw?.toFixed(2) || 'N/A'} <= ${this.imageNudityThreshold}`);
+    } finally {
+      try {
+        unlinkSync(tempFile);
+        this.logger.info(`[MODERATION] Cleaned up temp file: ${tempFile}`);
+      } catch {
+        this.logger.warn(`[MODERATION] Failed to cleanup: ${tempFile}`);
+      }
+    }
+  }
+
+  private async moderateVideo(path: string, buffer: Buffer, contentType: string): Promise<void> {
+    const tempFile = `/tmp/moderation_${Date.now()}.${this.getFileExtension(contentType)}`;
+    this.logger.info(`[MODERATION] Writing temp file: ${tempFile}`);
+    writeFileSync(tempFile, buffer);
+
+    try {
+      this.logger.info('[MODERATION] Calling SightEngine API for video analysis...');
+      const result = await this.client.analyzeVideo(tempFile);
+      this.logger.info(`[MODERATION] SightEngine response: ${JSON.stringify(result)}`);
+
+      if (result.nudity?.raw && result.nudity.raw > this.videoNudityThreshold) {
+        this.logger.warn(`[MODERATION] Video BLOCKED: ${path} - nudity ${result.nudity.raw.toFixed(2)} > ${this.videoNudityThreshold}`);
+        throw new ForbiddenHttpError(`Video contains inappropriate content (nudity: ${result.nudity.raw.toFixed(2)})`);
+      }
+      this.logger.info(`[MODERATION] Video passed: nudity ${result.nudity?.raw?.toFixed(2) || 'N/A'} <= ${this.videoNudityThreshold}`);
+    } finally {
+      try {
+        unlinkSync(tempFile);
+        this.logger.info(`[MODERATION] Cleaned up temp file: ${tempFile}`);
+      } catch {
+        this.logger.warn(`[MODERATION] Failed to cleanup: ${tempFile}`);
+      }
+    }
+  }
+
+  private async moderateText(path: string, buffer: Buffer): Promise<void> {
+    const text = buffer.toString('utf-8');
+    this.logger.info(`[MODERATION] Text length: ${text.length} chars`);
+    
+    this.logger.info('[MODERATION] Calling SightEngine API for text analysis...');
+    const result = await this.client.analyzeText(text);
+    this.logger.info(`[MODERATION] SightEngine response: ${JSON.stringify(result)}`);
+
+    const violations: string[] = [];
+
+    if (result.sexual > this.textSexualThreshold) {
+      violations.push(`sexual (${result.sexual.toFixed(2)} > ${this.textSexualThreshold})`);
+    }
+
+    if (result.toxic > this.textToxicThreshold) {
+      violations.push(`toxic (${result.toxic.toFixed(2)} > ${this.textToxicThreshold})`);
+    }
+
+    if (violations.length > 0) {
+      this.logger.warn(`[MODERATION] Text BLOCKED: ${path} - ${violations.join(', ')}`);
+      throw new ForbiddenHttpError(`Text contains inappropriate content: ${violations.join(', ')}`);
+    }
+    this.logger.info(`[MODERATION] Text passed: sexual ${result.sexual.toFixed(2)}, toxic ${result.toxic.toFixed(2)}`);
+  }
+
+  private getFileExtension(contentType: string): string {
+    const map: Record<string, string> = {
+      'image/jpeg': 'jpg',
+      'image/png': 'png',
+      'image/gif': 'gif',
+      'image/webp': 'webp',
+      'video/mp4': 'mp4',
+      'video/webm': 'webm',
+    };
+    return map[contentType] || 'bin';
+  }
+}

package/src/index.ts

@@ -1,7 +1,2 @@
-export * from './ModerationOperationHandler';
-export * from './ModerationResourceStore';
-export * from './ModerationConfig';
-export * from './ModerationStore';
-export * from './ModerationRecord';
-export * from './ModerationMixin';
+export * from './ModerationHandler';
 export * from './providers/SightEngineProvider';