{"_id":"@grpc-web/middleware","_rev":"1-98b2f539a35715c3ae97a007c4b0d153","name":"@grpc-web/middleware","dist-tags":{"latest":"0.1.0"},"versions":{"0.0.1":{"name":"@grpc-web/middleware","version":"0.0.1","description":"gRPC Web middleware for Express and Connect.","main":"src/index.js","types":"src/index.d.ts","dependencies":{"base64-stream":"^1.0.0","debug":"^4.3.4","parseurl":"^1.3.3"},"engines":{"node":">=16"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/marella/node-grpc-web.git","directory":"packages/middleware"},"bugs":{"url":"https://github.com/marella/node-grpc-web/issues"},"homepage":"https://github.com/marella/node-grpc-web/tree/main/packages/middleware","keywords":["grpc","grpc-web","express","connect","middleware","proxy","server","web","http","http2","backend"],"publishConfig":{"access":"public"},"gitHead":"8f0cd3a077d072c0c139122b36e74ffc91b6be79","_id":"@grpc-web/middleware@0.0.1","_nodeVersion":"18.15.0","_npmVersion":"9.5.0","dist":{"integrity":"sha512-3JhRkEy2WPWApFaKQasUDsgTfefN29HSN8XQjLleFmvrw7yxHaW/jynGQyl04tqVILJN8FzNLPmSrDV2T+MGOQ==","shasum":"47e5f15fa09c6c959d4cfcdf12665615268c5018","tarball":"https://registry.npmjs.org/@grpc-web/middleware/-/middleware-0.0.1.tgz","fileCount":6,"unpackedSize":10890,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDo2th5kTtN+phkD1b9TpyDA2QRe4wBlpKuoy/kK/omhgIgM7fcxP7+JFTknS5r9/nbatmOOauScWIuA+NLPgNygLM="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJkOez4ACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmrB/Q/+L8p2S5R37QlBCBqtXXDeqT/jmBp06Wkkb2KWN/9h7s7spsAj\r\n0YQrxrmSo4NEtn9GkGHBX6Yii+0OjAqh0JQFDKnW0ES+McqdZ2YxHdicT0aO\r\n4F4E5VSqSxfOzV1AOrg4/aS08xuv5L5dMh/BKC1P0I82A3DlBxM2QjPVrRDp\r\ngWqySXkmBgCktwWsGB66sBJpJwiAu6BdahAK7aantymMn+BO5zQTZ9dTSHOp\r\nsQx5oeZ2EfF6IFZbfyfLBm75fcddCjIKF3Hx97220EDOvNO51sKouR9++LC6\r\nOKxx3HnAjIOf+gnFQaG7q+sgduN4z5j3TATKqnsrsLKtPpngQpOcrKHHMTlF\r\n1tquJ53qGKfDUruga4OoTOL5fSBZ6cYCUVnZd7aYHsotKAzTdc0i9J+uaTII\r\nXUcY0t76EaodHLKq3Cw+P8cHLPe8OsHODmqbHIPoa/gLlD8wAynvY60oq8cY\r\nSgttxZc0U94nhtViaZ6wgheu0FP2krx6L/3ZKUm+jbWJ3bZ1Zw2blvggnSua\r\nX928gZOsjELawMjc2vd2lAlWT58Dlsal6V1Or3O2s8+xLoSs6UGfI5kVfQH1\r\n+u0oJnHpPxXadochsc2FoJjPZsE3jmbhTNuvKZtWF8FISwUN0elO/y/y27pu\r\nRoDpz9XWqXIsE/ZGBRni+QP763/0MWLB77U=\r\n=DsH8\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"marella","email":"mv.ravindra@yahoo.com"},"directories":{},"maintainers":[{"name":"marella","email":"mv.ravindra@yahoo.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/middleware_0.0.1_1681517815837_0.5304036528298164"},"_hasShrinkwrap":false},"0.1.0":{"name":"@grpc-web/middleware","version":"0.1.0","description":"gRPC Web middleware for Express and Connect.","main":"src/index.js","types":"src/index.d.ts","dependencies":{"base64-stream":"^1.0.0","debug":"^4.3.4","parseurl":"^1.3.3"},"engines":{"node":">=16"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/marella/node-grpc-web.git","directory":"packages/middleware"},"bugs":{"url":"https://github.com/marella/node-grpc-web/issues"},"homepage":"https://github.com/marella/node-grpc-web/tree/main/packages/middleware","keywords":["grpc","grpc-web","express","connect","middleware","proxy","server","web","http","http2","backend"],"publishConfig":{"access":"public"},"gitHead":"c5fcdd42190322cef97034b796bf7f978a4d83a3","_id":"@grpc-web/middleware@0.1.0","_nodeVersion":"18.15.0","_npmVersion":"9.5.0","dist":{"integrity":"sha512-MEkAZ38lLCPvQVhtdowhD8GlXUioifwRrrUPYHmFWPAxnNCBcJzRJEmnuGRR3fkVL6MIVBBy8RIGuJ5FM0M7pA==","shasum":"d69fb0f1f817389247242f0960bc0555dbee432b","tarball":"https://registry.npmjs.org/@grpc-web/middleware/-/middleware-0.1.0.tgz","fileCount":6,"unpackedSize":10890,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIAo+mUXT8HsFCSIjKHrrBHbESrqkGts3+NntEzrLrcTRAiEAzONb+qSHm50jdYs2puwBtjg5SUW2Iu8tB6GbW9p86RY="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJkOfHaACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmp1uw//WlQG/rmYCfG+0YaUJNtzeqcjvf8dT4xq6grF34QARJLrNN5X\r\nT0pqLTSZ4zWN/2daBgwam2H0oWx3uQz2+cbfrTCPO/j53e9q7vhgkI8nMz5A\r\nz5aj5dqi+fumGpvtl02BoGm8gQ/w7dHeB8RJmzFE2l5EraAJ6a2AmSGz5B4E\r\nSkCf2FHJxeFjd5+TXWWC7ahFnZJbwT/fZOAkBzJPufdA1d3TBHrHuFkv6Tr/\r\nJB9kVRVHkA9jAuRX46slAfO0D3tdcLIMwr7jTyB4QXmWM0g5kvarv+TpO1pg\r\n5IaXNv6uT9/S7nwvR3MaWLxLgPx/hO4hPbrs+qgO7wb0ijkW5+t2xyYQRNYI\r\nP5ObFlH9pkQ/qmWLL5HGQg8RHvACiDYhE6kT0SisaKEwdP/e8eEGacZOb2e2\r\n+72ELKpf7sCd34wcrHqYPhpOVq/RgexGOpAFjl2udl/DU9QjI41zyZY+qPGo\r\nEAKbZDGf2g8nnnb4mBkn6uXnLApnFxkZCIOPLKYUzaKy30CzJeYLiuZNEDbT\r\nwZjvQFBwOAkCIVkAcRp3EW1sSmAY4+pII5qczYRC2WtpnysTjXzS5BLuALje\r\nZloRAq/i3Bb7hUslpeVuCfUGpZx1WPltMBqpOC5+T7ExmDvflZIKuRhV5Vw/\r\njY5LeBTKKyyNLSYePbfe/V3Pcyoc4/apQQE=\r\n=aXx3\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"marella","email":"mv.ravindra@yahoo.com"},"directories":{},"maintainers":[{"name":"marella","email":"mv.ravindra@yahoo.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/middleware_0.1.0_1681519066683_0.6908767114980228"},"_hasShrinkwrap":false}},"time":{"created":"2023-04-15T00:16:55.782Z","0.0.1":"2023-04-15T00:16:55.981Z","modified":"2023-04-15T00:37:47.036Z","0.1.0":"2023-04-15T00:37:46.908Z"},"maintainers":[{"name":"marella","email":"mv.ravindra@yahoo.com"}],"description":"gRPC Web middleware for Express and Connect.","homepage":"https://github.com/marella/node-grpc-web/tree/main/packages/middleware","keywords":["grpc","grpc-web","express","connect","middleware","proxy","server","web","http","http2","backend"],"repository":{"type":"git","url":"git+https://github.com/marella/node-grpc-web.git","directory":"packages/middleware"},"bugs":{"url":"https://github.com/marella/node-grpc-web/issues"},"license":"MIT","readme":"# [@grpc-web/middleware](https://github.com/marella/node-grpc-web/tree/main/packages/middleware) [![npm](https://img.shields.io/npm/v/@grpc-web/middleware)](https://www.npmjs.com/package/@grpc-web/middleware) [![tests](https://github.com/marella/node-grpc-web/actions/workflows/tests.yml/badge.svg)](https://github.com/marella/node-grpc-web/actions/workflows/tests.yml) [![coverage](https://coveralls.io/repos/github/marella/node-grpc-web/badge.svg)](https://coveralls.io/github/marella/node-grpc-web)\n\ngRPC Web middleware for Express and Connect.\n\n> For standalone proxy, see [`@grpc-web/proxy`](https://www.npmjs.com/package/@grpc-web/proxy)\n\n## Installation\n\n```sh\nnpm install @grpc-web/middleware\n```\n\n## Usage\n\nThis middleware proxies gRPC Web requests to the given gRPC server and can be used with existing Express and Connect applications. Here is a full working example of a proxy server created using `express` and `cors` packages:\n\n```js\nconst express = require('express');\nconst cors = require('cors');\nconst grpcWeb = require('@grpc-web/middleware');\n\nconst app = express();\napp.use(cors({ exposedHeaders: ['grpc-status', 'grpc-message'] }));\napp.use(grpcWeb('http://localhost:9090'));\napp.listen(8080);\n```\n\nIn above example, `express` can be replaced with `connect`. The address `http://localhost:9090` refers to the gRPC server address to which gRPC Web requests are forwarded to and `8080` refers to the port on which the proxy server is running.\n\ngRPC Web middleware only handles gRPC Web requests and ignores normal HTTP requests, so it can be used together with normal web applications:\n\n```js\napp.use(grpcWeb('http://localhost:9090'));\n\napp.get('/', (req, res) => {\n  res.send('Hello World');\n});\n```\n\nIt can be run in the same process as the gRPC server:\n\n```js\n// Express or Connect server\napp.use(grpcWeb('http://localhost:9090'));\napp.listen(8080);\n\n// gRPC server\nconst server = new grpc.Server();\nserver.addProtoService(service, implementation);\nserver.bind('0.0.0.0:9090', credentials);\nserver.start();\n```\n\nIt also accepts a custom function which can used for configuring the HTTP/2 connection to the gRPC server:\n\n```js\nconst http2 = require('node:http2');\n\napp.use(\n  grpcWeb(() => {\n    return http2.connect('http://localhost:9090');\n  })\n);\n```\n\n## License\n\n[MIT](https://github.com/marella/node-grpc-web/blob/main/packages/middleware/LICENSE)\n","readmeFilename":"README.md"}