@bopen-io/messagebox-server 1.1.5

package/out/src/routes/permissions/getQuote.js

@@ -0,0 +1,165 @@
+import { PublicKey } from '@bsv/sdk';
+import { Logger } from '../../utils/logger.js';
+import { getRecipientFee, getServerDeliveryFee } from '../../utils/messagePermissions.js';
+/**
+ * @swagger
+ * /permissions/quote:
+ *   get:
+ *     summary: Get message delivery quote(s)
+ *     description: Get pricing information for sending messages to one or many recipients' message boxes
+ *     tags:
+ *       - Permissions
+ *     parameters:
+ *       - in: query
+ *         name: recipient
+ *         required: true
+ *         schema:
+ *           oneOf:
+ *             - type: string
+ *             - type: array
+ *               items:
+ *                 type: string
+ *         description: identityKey of the recipient, or multiple recipients by repeating the parameter (?recipient=A&recipient=B)
+ *       - in: query
+ *         name: messageBox
+ *         required: true
+ *         schema:
+ *           type: string
+ *         description: messageBox type
+ *     responses:
+ *       200:
+ *         description: Quote(s) retrieved successfully
+ *       400:
+ *         description: Invalid request parameters
+ *       401:
+ *         description: Authentication required
+ *       500:
+ *         description: Internal server error
+ */
+export default {
+    type: 'get',
+    path: '/permissions/quote',
+    func: async (req, res) => {
+        try {
+            Logger.log('[DEBUG] Processing message quote request');
+            console.log('[DEBUG] Processing message quote request');
+            // Validate authentication (the caller is the SENDER)
+            const sender = req.auth?.identityKey;
+            if (sender == null) {
+                Logger.log('[DEBUG] Authentication required for message quote');
+                return res.status(401).json({
+                    status: 'error',
+                    code: 'ERR_AUTHENTICATION_REQUIRED',
+                    description: 'Authentication required.'
+                });
+            }
+            const { recipient, messageBox } = req.query;
+            // Required params
+            if (recipient == null || messageBox == null) {
+                Logger.log('[DEBUG] Missing required parameters for message quote');
+                return res.status(400).json({
+                    status: 'error',
+                    code: 'ERR_MISSING_PARAMETERS',
+                    description: 'recipient and messageBox parameters are required.'
+                });
+            }
+            // Normalize recipients to array (preserve order)
+            const recipients = Array.isArray(recipient) ? recipient : [recipient];
+            if (recipients.length === 0) {
+                return res.status(400).json({
+                    status: 'error',
+                    code: 'ERR_MISSING_PARAMETERS',
+                    description: 'At least one recipient is required.'
+                });
+            }
+            // Validate each recipient public key
+            const invalidIdx = [];
+            for (let i = 0; i < recipients.length; i++) {
+                try {
+                    PublicKey.fromString(recipients[i]);
+                }
+                catch {
+                    invalidIdx.push(i);
+                }
+            }
+            if (invalidIdx.length > 0) {
+                Logger.log('[DEBUG] Invalid recipient public key format in array');
+                return res.status(400).json({
+                    status: 'error',
+                    code: 'ERR_INVALID_PUBLIC_KEY',
+                    description: `Invalid recipient public key at index(es): ${invalidIdx.join(', ')}.`
+                });
+            }
+            // Delivery fee for this messageBox (applies per message/recipient)
+            const perMessageDeliveryFee = await getServerDeliveryFee(messageBox);
+            // Single-recipient path → keep legacy response shape for compatibility
+            if (recipients.length === 1) {
+                const recipientKey = recipients[0];
+                const recipientFee = await getRecipientFee(recipientKey, sender, messageBox);
+                return res.status(200).json({
+                    status: 'success',
+                    description: 'Message delivery quote generated.',
+                    quote: {
+                        deliveryFee: perMessageDeliveryFee,
+                        recipientFee
+                    }
+                });
+            }
+            // Multi-recipient path → compute per-recipient, plus aggregates
+            const quotesByRecipient = [];
+            const blockedRecipients = [];
+            let totalRecipientFees = 0;
+            let totalDeliveryFees = 0;
+            // Helper to map fee -> status
+            const feeToStatus = (fee) => {
+                if (fee === -1)
+                    return 'blocked';
+                if (fee === 0)
+                    return 'always_allow';
+                return 'payment_required';
+            };
+            for (const r of recipients) {
+                const recipientFee = await getRecipientFee(r, sender, messageBox);
+                const status = feeToStatus(recipientFee);
+                quotesByRecipient.push({
+                    recipient: r,
+                    messageBox,
+                    deliveryFee: perMessageDeliveryFee,
+                    recipientFee,
+                    status
+                });
+                // Aggregate: count deliveryFee per intended message, and recipientFee if not blocked
+                totalDeliveryFees += perMessageDeliveryFee;
+                if (recipientFee === -1) {
+                    blockedRecipients.push(r);
+                }
+                else {
+                    totalRecipientFees += recipientFee;
+                }
+            }
+            const totals = {
+                deliveryFees: totalDeliveryFees,
+                recipientFees: totalRecipientFees,
+                // If any are blocked, caller may want to handle those separately.
+                // We still provide a full monetary total for non-blocked recipients:
+                totalForPayableRecipients: totalDeliveryFees + totalRecipientFees
+            };
+            return res.status(200).json({
+                status: 'success',
+                description: `Message delivery quotes generated for ${recipients.length} recipients.`,
+                quotesByRecipient,
+                totals,
+                blockedRecipients
+            });
+        }
+        catch (error) {
+            Logger.error('[ERROR] Internal Server Error in message quote:', error);
+            return res.status(500).json({
+                status: 'error',
+                code: 'ERR_INTERNAL',
+                description: 'An internal error has occurred.'
+            });
+        }
+    }
+};
+//# sourceMappingURL=getQuote.js.map

package/out/src/routes/permissions/getQuote.js.map

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

package/out/src/routes/permissions/index.js

@@ -0,0 +1,12 @@
+// Export all permission-related routes
+import setPermission from './setPermission.js';
+import getPermission from './getPermission.js';
+import getQuote from './getQuote.js';
+import listPermissions from './listPermissions.js';
+export const permissionRoutes = [
+    setPermission,
+    getPermission,
+    getQuote,
+    listPermissions
+];
+//# sourceMappingURL=index.js.map

package/out/src/routes/permissions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/routes/permissions/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,OAAO,aAAa,MAAM,oBAAoB,CAAA;AAC9C,OAAO,aAAa,MAAM,oBAAoB,CAAA;AAC9C,OAAO,QAAQ,MAAM,eAAe,CAAA;AACpC,OAAO,eAAe,MAAM,sBAAsB,CAAA;AAElD,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,aAAa;IACb,aAAa;IACb,QAAQ;IACR,eAAe;CAChB,CAAA"}

package/out/src/routes/permissions/listPermissions.js

@@ -0,0 +1,190 @@
+import knexConfig from '../../../knexfile.js';
+import * as knexLib from 'knex';
+import { Logger } from '../../utils/logger.js';
+// Determine the environment (default to development)
+const { NODE_ENV = 'development' } = process.env;
+/**
+ * Knex instance connected based on environment (development, production, or staging).
+ */
+const knex = knexLib.default?.(NODE_ENV === 'production' || NODE_ENV === 'staging'
+    ? knexConfig.production
+    : knexConfig.development) ?? knexLib(NODE_ENV === 'production' || NODE_ENV === 'staging'
+    ? knexConfig.production
+    : knexConfig.development);
+/**
+ * @swagger
+ * /permissions/list:
+ *   get:
+ *     summary: List message permissions for the authenticated user
+ *     description: Retrieve all permissions set by the authenticated user with optional filtering and pagination
+ *     tags:
+ *       - Permissions
+ *     parameters:
+ *       - in: query
+ *         name: messageBox
+ *         required: false
+ *         schema:
+ *           type: string
+ *         description: Optional messageBox type filter (e.g., 'notifications', 'inbox')
+ *       - in: query
+ *         name: limit
+ *         required: false
+ *         schema:
+ *           type: integer
+ *           minimum: 1
+ *           maximum: 1000
+ *           default: 100
+ *         description: Maximum number of permissions to return
+ *       - in: query
+ *         name: offset
+ *         required: false
+ *         schema:
+ *           type: integer
+ *           minimum: 0
+ *           default: 0
+ *         description: Number of permissions to skip for pagination
+ *       - in: query
+ *         name: createdAtOrder
+ *         required: false
+ *         schema:
+ *           type: string
+ *           enum: ['asc', 'desc']
+ *           default: 'desc'
+ *         description: Sort order for created_at date (asc=oldest first, desc=newest first)
+ *     responses:
+ *       200:
+ *         description: Permissions retrieved successfully
+ *         content:
+ *           application/json:
+ *             schema:
+ *               type: object
+ *               properties:
+ *                 status:
+ *                   type: string
+ *                   example: 'success'
+ *                 permissions:
+ *                   type: array
+ *                   items:
+ *                     type: object
+ *                     properties:
+ *                       sender:
+ *                         type: string
+ *                         nullable: true
+ *                         description: Sender identity key (null for box-wide defaults)
+ *                       messageBox:
+ *                         type: string
+ *                         description: MessageBox type
+ *                       recipientFee:
+ *                         type: integer
+ *                         description: Fee setting (-1=block all, 0=always allow, >0=satoshi amount)
+ *                       created_at:
+ *                         type: string
+ *                         format: date-time
+ *                       updated_at:
+ *                         type: string
+ *                         format: date-time
+ *                 total_count:
+ *                   type: integer
+ *                   description: Total number of permissions (useful for pagination)
+ *       400:
+ *         description: Invalid query parameters
+ *       401:
+ *         description: Unauthorized - authentication required
+ *       500:
+ *         description: Internal server error
+ */
+export default {
+    type: 'get',
+    path: '/permissions/list',
+    /**
+     * List message permissions for the authenticated user
+     *
+     * @param {ListPermissionsRequest} req - Authenticated request with query parameters
+     * @param {Response} res - Express response object
+     * @returns {Promise<Response>} JSON response with permissions list
+     */
+    func: async (req, res) => {
+        Logger.log('[DEBUG] Processing /permissions/list request...');
+        try {
+            // Validate authentication
+            if (req.auth?.identityKey == null) {
+                return res.status(401).json({
+                    status: 'error',
+                    code: 'ERR_UNAUTHORIZED',
+                    description: 'Authentication required'
+                });
+            }
+            // Parse and validate query parameters
+            const { messageBox, limit: limitStr, offset: offsetStr, createdAtOrder } = req.query;
+            const limit = limitStr != null ? parseInt(limitStr, 10) : 100;
+            const offset = offsetStr != null ? parseInt(offsetStr, 10) : 0;
+            const sortOrder = createdAtOrder === 'asc' ? 'asc' : 'desc'; // Default to 'desc'
+            // Validate pagination parameters
+            if (isNaN(limit) || limit < 1 || limit > 1000) {
+                return res.status(400).json({
+                    status: 'error',
+                    code: 'ERR_INVALID_LIMIT',
+                    description: 'Limit must be a number between 1 and 1000'
+                });
+            }
+            if (isNaN(offset) || offset < 0) {
+                return res.status(400).json({
+                    status: 'error',
+                    code: 'ERR_INVALID_OFFSET',
+                    description: 'Offset must be a non-negative number'
+                });
+            }
+            // Validate identity key format
+            const recipientKey = req.auth.identityKey;
+            Logger.log(`[DEBUG] Listing permissions for recipient: ${recipientKey}, messageBox: ${messageBox ?? 'all'}, limit: ${limit}, offset: ${offset}, createdAtOrder: ${sortOrder}`);
+            // Build base query
+            let query = knex('message_permissions')
+                .select([
+                'sender',
+                'message_box',
+                'recipient_fee',
+                'created_at',
+                'updated_at'
+            ])
+                .where('recipient', recipientKey)
+                .orderBy([
+                { column: 'message_box', order: 'asc' },
+                { column: 'sender', order: 'asc', nulls: 'first' }, // Box-wide (null) first
+                { column: 'created_at', order: sortOrder }
+            ]);
+            // Apply messageBox filter if provided
+            if (messageBox != null) {
+                query = query.where('message_box', messageBox);
+            }
+            // Get total count for pagination info (before applying limit/offset)
+            const countQuery = query.clone().clearSelect().clearOrder().count('* as count');
+            const [{ count: totalCount }] = await countQuery;
+            const total = parseInt(String(totalCount), 10);
+            // Apply pagination
+            const permissions = await query
+                .limit(limit)
+                .offset(offset);
+            Logger.log(`[DEBUG] Found ${permissions.length} permissions (${total} total)`);
+            return res.status(200).json({
+                status: 'success',
+                permissions: permissions.map(p => ({
+                    sender: p.sender, // null for box-wide defaults
+                    messageBox: p.message_box,
+                    recipientFee: p.recipient_fee,
+                    createdAt: p.created_at,
+                    updatedAt: p.updated_at
+                })),
+                totalCount: total
+            });
+        }
+        catch (error) {
+            Logger.error('[ERROR] Error listing permissions:', error);
+            return res.status(500).json({
+                status: 'error',
+                code: 'ERR_LIST_PERMISSIONS_FAILED',
+                description: 'Failed to list permissions'
+            });
+        }
+    }
+};
+//# sourceMappingURL=listPermissions.js.map

package/out/src/routes/permissions/listPermissions.js.map

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

package/out/src/routes/permissions/setPermission.js

@@ -0,0 +1,137 @@
+import { PublicKey } from '@bsv/sdk';
+import { Logger } from '../../utils/logger.js';
+import { setMessagePermission } from '../../utils/messagePermissions.js';
+/**
+ * @swagger
+ * /permissions/set:
+ *   post:
+ *     summary: Set message permission for a sender/box combination or box-wide default
+ *     description: Set permission level for receiving messages. If sender is provided, sets permission for that specific sender. If sender is omitted, sets box-wide default for all senders.
+ *     tags:
+ *       - Permissions
+ *     requestBody:
+ *       required: true
+ *       content:
+ *         application/json:
+ *           schema:
+ *             type: object
+ *             required:
+ *               - messageBox
+ *               - recipientFee
+ *             properties:
+ *               sender:
+ *                 type: string
+ *                 description: identityKey of the sender (optional - if omitted, sets box-wide default for all senders)
+ *               messageBox:
+ *                 type: string
+ *                 description: messageBox type (e.g., 'notifications', 'inbox')
+ *               recipientFee:
+ *                 type: integer
+ *                 description: Fee level (-1=blocked, 0=always allow, >0=satoshi amount required)
+ *     responses:
+ *       200:
+ *         description: Permission successfully set/updated
+ *       400:
+ *         description: Invalid request data
+ *       401:
+ *         description: Authentication required
+ *       500:
+ *         description: Internal server error
+ */
+export default {
+    type: 'post',
+    path: '/permissions/set',
+    func: async (req, res) => {
+        try {
+            Logger.log('[DEBUG] Processing set message permission request');
+            // Validate authentication
+            const recipient = req.auth?.identityKey;
+            if (recipient == null) {
+                Logger.log('[DEBUG] Authentication required for set permission');
+                return res.status(401).json({
+                    status: 'error',
+                    code: 'ERR_AUTHENTICATION_REQUIRED',
+                    description: 'Authentication required.'
+                });
+            }
+            const { sender, messageBox, recipientFee } = req.body;
+            // Validate request body (sender is optional)
+            if (messageBox == null || typeof recipientFee !== 'number') {
+                Logger.log('[DEBUG] Invalid request body for set permission');
+                return res.status(400).json({
+                    status: 'error',
+                    code: 'ERR_INVALID_REQUEST',
+                    description: 'messageBox (string) and recipientFee (number) are required. sender (string) is optional for box-wide settings.'
+                });
+            }
+            // Validate sender public key format only if provided
+            if (sender != null) {
+                try {
+                    PublicKey.fromString(sender);
+                }
+                catch (error) {
+                    Logger.log('[DEBUG] Invalid sender public key format');
+                    return res.status(400).json({
+                        status: 'error',
+                        code: 'ERR_INVALID_PUBLIC_KEY',
+                        description: 'Invalid sender public key format.'
+                    });
+                }
+            }
+            // Validate recipientFee value
+            if (!Number.isInteger(recipientFee)) {
+                Logger.log('[DEBUG] Invalid recipientFee value - must be integer');
+                return res.status(400).json({
+                    status: 'error',
+                    code: 'ERR_INVALID_FEE_VALUE',
+                    description: 'recipientFee must be an integer (-1, 0, or positive number).'
+                });
+            }
+            // Validate messageBox value
+            if (typeof messageBox !== 'string' || messageBox.trim() === '') {
+                Logger.log('[DEBUG] Invalid messageBox value');
+                return res.status(400).json({
+                    status: 'error',
+                    code: 'ERR_INVALID_MESSAGE_BOX',
+                    description: 'messageBox must be a non-empty string.'
+                });
+            }
+            // Set the message permission (convert undefined sender to null for box-wide)
+            const success = await setMessagePermission(recipient, sender ?? null, messageBox, recipientFee);
+            if (success == null) {
+                return res.status(500).json({
+                    status: 'error',
+                    code: 'ERR_DATABASE_ERROR',
+                    description: 'Failed to update message permission.'
+                });
+            }
+            const isBoxWide = sender == null;
+            Logger.log(`[DEBUG] Successfully updated message permission: ${sender ?? 'BOX-WIDE'} -> ${recipient} (${messageBox}), fee: ${recipientFee}`);
+            let description;
+            const senderText = isBoxWide ? 'all senders' : sender;
+            const actionText = isBoxWide ? 'Box-wide default for' : 'Messages from';
+            if (recipientFee === -1) {
+                description = `${actionText} ${senderText} to ${messageBox} ${isBoxWide ? 'is' : 'are'} now blocked.`;
+            }
+            else if (recipientFee === 0) {
+                description = `${actionText} ${senderText} to ${messageBox} ${isBoxWide ? 'is' : 'are'} now always allowed.`;
+            }
+            else {
+                description = `${actionText} ${senderText} to ${messageBox} now require${isBoxWide ? 's' : ''} ${recipientFee} satoshis.`;
+            }
+            return res.status(200).json({
+                status: 'success',
+                description
+            });
+        }
+        catch (error) {
+            Logger.error('[ERROR] Internal Server Error in set permission:', error);
+            return res.status(500).json({
+                status: 'error',
+                code: 'ERR_INTERNAL',
+                description: 'An internal error has occurred.'
+            });
+        }
+    }
+};
+//# sourceMappingURL=setPermission.js.map

package/out/src/routes/permissions/setPermission.js.map

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