@allmightypush/push-express 1.0.0

package/README.md

@@ -0,0 +1,194 @@
+# @allmightypush/push-express
+
+Express middleware for managing push notification subscriptions.
+
+## Installation
+
+```bash
+npm install @allmightypush/push-express @allmightypush/push-core express
+```
+
+## Quick Start
+
+```typescript
+import express from 'express';
+import { createExpressMiddleware } from '@allmightypush/push-express';
+import { SQLiteStorageAdapter } from '@allmightypush/push-storage-sqlite';
+
+const app = express();
+const storage = new SQLiteStorageAdapter({ filename: './push.db' });
+
+app.use(express.json());
+app.use('/api/push', createExpressMiddleware({ storageAdapter: storage }));
+
+app.listen(3000, () => {
+  console.log('Server running on port 3000');
+});
+```
+
+## API Endpoints
+
+### POST /subscriptions
+
+Create a new push notification subscription.
+
+**Request Body:**
+```json
+{
+  "endpoint": "https://fcm.googleapis.com/fcm/send/...",
+  "keys": {
+    "p256dh": "user-public-key",
+    "auth": "user-auth-secret"
+  },
+  "userId": "optional-user-id",
+  "metadata": {
+    "deviceType": "mobile",
+    "appVersion": "1.0.0"
+  }
+}
+```
+
+**Response:** `201 Created`
+```json
+{
+  "id": "subscription-id",
+  "endpoint": "https://fcm.googleapis.com/fcm/send/...",
+  "keys": { "p256dh": "...", "auth": "..." },
+  "userId": "optional-user-id",
+  "status": "active",
+  "createdAt": "2024-01-01T00:00:00.000Z",
+  "updatedAt": "2024-01-01T00:00:00.000Z"
+}
+```
+
+### GET /subscriptions/:id
+
+Retrieve a subscription by ID.
+
+**Response:** `200 OK` or `404 Not Found`
+
+### GET /subscriptions
+
+List subscriptions with optional filtering and pagination.
+
+**Query Parameters:**
+- `userId` - Filter by user ID
+- `status` - Filter by status (active, expired, failed)
+- `limit` - Maximum results (default: 100)
+- `offset` - Pagination offset (default: 0)
+
+**Response:** `200 OK`
+```json
+{
+  "subscriptions": [...],
+  "total": 10,
+  "limit": 100,
+  "offset": 0
+}
+```
+
+### PATCH /subscriptions/:id
+
+Update a subscription.
+
+**Request Body:**
+```json
+{
+  "status": "expired",
+  "metadata": { "updated": true }
+}
+```
+
+**Response:** `200 OK` or `404 Not Found`
+
+### DELETE /subscriptions/:id
+
+Delete a subscription.
+
+**Response:** `204 No Content` or `404 Not Found`
+
+## Configuration Options
+
+```typescript
+interface ExpressMiddlewareOptions {
+  // Storage adapter for managing subscriptions (required)
+  storageAdapter: StorageAdapter;
+
+  // Optional authentication middleware
+  authMiddleware?: (req, res, next) => void;
+
+  // Custom base path (default: '')
+  basePath?: string;
+
+  // Custom validation function
+  validateSubscription?: (subscription) => Promise<void> | void;
+}
+```
+
+## Examples
+
+### With Authentication
+
+```typescript
+import { createExpressMiddleware } from '@allmightypush/push-express';
+
+const authMiddleware = (req, res, next) => {
+  const token = req.headers.authorization?.replace('Bearer ', '');
+  
+  if (!token || !isValidToken(token)) {
+    return res.status(401).json({ error: 'Unauthorized' });
+  }
+  
+  next();
+};
+
+app.use('/api/push', createExpressMiddleware({
+  storageAdapter: storage,
+  authMiddleware,
+}));
+```
+
+### With Custom Validation
+
+```typescript
+app.use('/api/push', createExpressMiddleware({
+  storageAdapter: storage,
+  validateSubscription: async (data) => {
+    // Ensure endpoint uses HTTPS
+    if (!data.endpoint?.startsWith('https://')) {
+      throw new Error('Endpoint must use HTTPS');
+    }
+    
+    // Check against allowed domains
+    const url = new URL(data.endpoint);
+    if (!allowedDomains.includes(url.hostname)) {
+      throw new Error('Endpoint domain not allowed');
+    }
+  },
+}));
+```
+
+### With Custom Base Path
+
+```typescript
+app.use('/api/push', createExpressMiddleware({
+  storageAdapter: storage,
+  basePath: '/v1', // Routes will be /api/push/v1/subscriptions
+}));
+```
+
+## Error Handling
+
+The middleware returns appropriate HTTP status codes:
+
+- `200 OK` - Successful GET/PATCH
+- `201 Created` - Successful POST
+- `204 No Content` - Successful DELETE
+- `400 Bad Request` - Invalid input
+- `401 Unauthorized` - Authentication failed (if auth middleware used)
+- `404 Not Found` - Resource not found
+- `500 Internal Server Error` - Server error
+
+## License
+
+MIT

package/dist/cjs/index.js

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createExpressMiddleware = createExpressMiddleware;
+function validateSubscriptionData(data) {
+    if (!data.endpoint || typeof data.endpoint !== 'string') {
+        throw new Error('Missing or invalid endpoint');
+    }
+    if (!data.keys || typeof data.keys !== 'object') {
+        throw new Error('Missing or invalid keys');
+    }
+    if (!data.keys.p256dh || typeof data.keys.p256dh !== 'string') {
+        throw new Error('Missing or invalid keys.p256dh');
+    }
+    if (!data.keys.auth || typeof data.keys.auth !== 'string') {
+        throw new Error('Missing or invalid keys.auth');
+    }
+}
+function createExpressMiddleware(options) {
+    const { storageAdapter, authMiddleware, basePath = '', validateSubscription } = options;
+    const express = require('express');
+    const router = express.Router();
+    if (authMiddleware) {
+        router.use(authMiddleware);
+    }
+    router.post(`${basePath}/subscriptions`, async (req, res) => {
+        try {
+            validateSubscriptionData(req.body);
+            if (validateSubscription) {
+                await validateSubscription(req.body);
+            }
+            const subscription = await storageAdapter.createSubscription({
+                endpoint: req.body.endpoint,
+                keys: {
+                    p256dh: req.body.keys.p256dh,
+                    auth: req.body.keys.auth,
+                },
+                userId: req.body.userId,
+                metadata: req.body.metadata,
+            });
+            res.status(201).json(subscription);
+        }
+        catch (error) {
+            if (error.message.includes('Missing') || error.message.includes('invalid') || error.message.includes('must')) {
+                res.status(400).json({ error: error.message });
+            }
+            else {
+                res.status(500).json({ error: 'Failed to create subscription' });
+            }
+        }
+    });
+    router.get(`${basePath}/subscriptions/:id`, async (req, res) => {
+        try {
+            const subscription = await storageAdapter.getSubscriptionById(req.params.id);
+            if (!subscription) {
+                res.status(404).json({ error: 'Subscription not found' });
+                return;
+            }
+            res.json(subscription);
+        }
+        catch (error) {
+            res.status(500).json({ error: 'Failed to retrieve subscription' });
+        }
+    });
+    router.get(`${basePath}/subscriptions`, async (req, res) => {
+        try {
+            const filters = {};
+            if (req.query.userId) {
+                filters.userId = req.query.userId;
+            }
+            if (req.query.status) {
+                filters.status = req.query.status;
+            }
+            const limit = req.query.limit ? parseInt(req.query.limit, 10) : 100;
+            const offset = req.query.offset ? parseInt(req.query.offset, 10) : 0;
+            const subscriptions = await storageAdapter.findSubscriptions(filters);
+            const paginatedResults = subscriptions.slice(offset, offset + limit);
+            res.json({
+                subscriptions: paginatedResults,
+                total: subscriptions.length,
+                limit,
+                offset,
+            });
+        }
+        catch (error) {
+            res.status(500).json({ error: 'Failed to list subscriptions' });
+        }
+    });
+    router.patch(`${basePath}/subscriptions/:id`, async (req, res) => {
+        try {
+            const subscription = await storageAdapter.getSubscriptionById(req.params.id);
+            if (!subscription) {
+                res.status(404).json({ error: 'Subscription not found' });
+                return;
+            }
+            const updates = {};
+            if (req.body.status) {
+                if (!['active', 'expired', 'failed'].includes(req.body.status)) {
+                    res.status(400).json({ error: 'Invalid status value' });
+                    return;
+                }
+                updates.status = req.body.status;
+            }
+            if (req.body.metadata !== undefined) {
+                updates.metadata = req.body.metadata;
+            }
+            const updatedSubscription = await storageAdapter.updateSubscription(req.params.id, updates);
+            res.json(updatedSubscription);
+        }
+        catch (error) {
+            res.status(500).json({ error: 'Failed to update subscription' });
+        }
+    });
+    router.delete(`${basePath}/subscriptions/:id`, async (req, res) => {
+        try {
+            const subscription = await storageAdapter.getSubscriptionById(req.params.id);
+            if (!subscription) {
+                res.status(404).json({ error: 'Subscription not found' });
+                return;
+            }
+            await storageAdapter.deleteSubscription(req.params.id);
+            res.status(204).send();
+        }
+        catch (error) {
+            res.status(500).json({ error: 'Failed to delete subscription' });
+        }
+    });
+    return router;
+}
+exports.default = createExpressMiddleware;
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

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

package/dist/esm/index.js

@@ -0,0 +1,127 @@
+function validateSubscriptionData(data) {
+    if (!data.endpoint || typeof data.endpoint !== 'string') {
+        throw new Error('Missing or invalid endpoint');
+    }
+    if (!data.keys || typeof data.keys !== 'object') {
+        throw new Error('Missing or invalid keys');
+    }
+    if (!data.keys.p256dh || typeof data.keys.p256dh !== 'string') {
+        throw new Error('Missing or invalid keys.p256dh');
+    }
+    if (!data.keys.auth || typeof data.keys.auth !== 'string') {
+        throw new Error('Missing or invalid keys.auth');
+    }
+}
+export function createExpressMiddleware(options) {
+    const { storageAdapter, authMiddleware, basePath = '', validateSubscription } = options;
+    const express = require('express');
+    const router = express.Router();
+    if (authMiddleware) {
+        router.use(authMiddleware);
+    }
+    router.post(`${basePath}/subscriptions`, async (req, res) => {
+        try {
+            validateSubscriptionData(req.body);
+            if (validateSubscription) {
+                await validateSubscription(req.body);
+            }
+            const subscription = await storageAdapter.createSubscription({
+                endpoint: req.body.endpoint,
+                keys: {
+                    p256dh: req.body.keys.p256dh,
+                    auth: req.body.keys.auth,
+                },
+                userId: req.body.userId,
+                metadata: req.body.metadata,
+            });
+            res.status(201).json(subscription);
+        }
+        catch (error) {
+            if (error.message.includes('Missing') || error.message.includes('invalid') || error.message.includes('must')) {
+                res.status(400).json({ error: error.message });
+            }
+            else {
+                res.status(500).json({ error: 'Failed to create subscription' });
+            }
+        }
+    });
+    router.get(`${basePath}/subscriptions/:id`, async (req, res) => {
+        try {
+            const subscription = await storageAdapter.getSubscriptionById(req.params.id);
+            if (!subscription) {
+                res.status(404).json({ error: 'Subscription not found' });
+                return;
+            }
+            res.json(subscription);
+        }
+        catch (error) {
+            res.status(500).json({ error: 'Failed to retrieve subscription' });
+        }
+    });
+    router.get(`${basePath}/subscriptions`, async (req, res) => {
+        try {
+            const filters = {};
+            if (req.query.userId) {
+                filters.userId = req.query.userId;
+            }
+            if (req.query.status) {
+                filters.status = req.query.status;
+            }
+            const limit = req.query.limit ? parseInt(req.query.limit, 10) : 100;
+            const offset = req.query.offset ? parseInt(req.query.offset, 10) : 0;
+            const subscriptions = await storageAdapter.findSubscriptions(filters);
+            const paginatedResults = subscriptions.slice(offset, offset + limit);
+            res.json({
+                subscriptions: paginatedResults,
+                total: subscriptions.length,
+                limit,
+                offset,
+            });
+        }
+        catch (error) {
+            res.status(500).json({ error: 'Failed to list subscriptions' });
+        }
+    });
+    router.patch(`${basePath}/subscriptions/:id`, async (req, res) => {
+        try {
+            const subscription = await storageAdapter.getSubscriptionById(req.params.id);
+            if (!subscription) {
+                res.status(404).json({ error: 'Subscription not found' });
+                return;
+            }
+            const updates = {};
+            if (req.body.status) {
+                if (!['active', 'expired', 'failed'].includes(req.body.status)) {
+                    res.status(400).json({ error: 'Invalid status value' });
+                    return;
+                }
+                updates.status = req.body.status;
+            }
+            if (req.body.metadata !== undefined) {
+                updates.metadata = req.body.metadata;
+            }
+            const updatedSubscription = await storageAdapter.updateSubscription(req.params.id, updates);
+            res.json(updatedSubscription);
+        }
+        catch (error) {
+            res.status(500).json({ error: 'Failed to update subscription' });
+        }
+    });
+    router.delete(`${basePath}/subscriptions/:id`, async (req, res) => {
+        try {
+            const subscription = await storageAdapter.getSubscriptionById(req.params.id);
+            if (!subscription) {
+                res.status(404).json({ error: 'Subscription not found' });
+                return;
+            }
+            await storageAdapter.deleteSubscription(req.params.id);
+            res.status(204).send();
+        }
+        catch (error) {
+            res.status(500).json({ error: 'Failed to delete subscription' });
+        }
+    });
+    return router;
+}
+export default createExpressMiddleware;
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,11 @@
+import type { Request, Response, NextFunction, Router } from 'express';
+import type { StorageAdapter, Subscription } from '@allmightypush/push-core';
+export interface ExpressMiddlewareOptions {
+    storageAdapter: StorageAdapter;
+    authMiddleware?: (req: Request, res: Response, next: NextFunction) => void | Promise<void>;
+    basePath?: string;
+    validateSubscription?: (subscription: Partial<Subscription>) => Promise<void> | void;
+}
+export declare function createExpressMiddleware(options: ExpressMiddlewareOptions): Router;
+export default createExpressMiddleware;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAK7E,MAAM,WAAW,wBAAwB;IAIvC,cAAc,EAAE,cAAc,CAAC;IAK/B,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAK3F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAKlB,oBAAoB,CAAC,EAAE,CAAC,YAAY,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACtF;AA0CD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,wBAAwB,GAAG,MAAM,CAqLjF;AAED,eAAe,uBAAuB,CAAC"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@allmightypush/push-express",
+  "version": "1.0.0",
+  "description": "Express middleware for push notification library",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/cjs/index.js",
+      "import": "./dist/esm/index.js",
+      "types": "./dist/types/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "npm run build:cjs && npm run build:esm && npm run build:types",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:types": "tsc -p tsconfig.types.json",
+    "test": "jest --passWithNoTests",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage --passWithNoTests",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "push",
+    "notification",
+    "express",
+    "middleware"
+  ],
+  "author": "Samtes64",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Samtes64/all-mighty-push.git",
+    "directory": "packages/push-express"
+  },
+  "bugs": {
+    "url": "https://github.com/Samtes64/all-mighty-push/issues"
+  },
+  "homepage": "https://github.com/Samtes64/all-mighty-push/tree/main/packages/push-express#readme",
+  "dependencies": {
+    "@allmightypush/push-core": "^1.0.0"
+  },
+  "peerDependencies": {
+    "express": "^4.18.0 || ^5.0.0"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/supertest": "^6.0.2",
+    "express": "^4.18.2",
+    "supertest": "^6.3.3"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}