{"bugs":{"url":"https://github.com/angular/universal/issues"},"dist":{"shasum":"227de0028b58ccba701a526b1f6fcfd07f5916d9","tarball":"https://registry.npmjs.org/@nguniversal/express-engine/-/express-engine-16.1.0-next.0.tgz","fileCount":36,"integrity":"sha512-29zzofI3BY85BMiCMx3msKwJITnwhoEh/ppIvkMhzKn0K0rHVhF8k3dQvwvT1o1EEWuvxci+7KhiDnBTmdsb+w==","signatures":[{"sig":"MEUCIE3xdmTE4Nq8D0+NhxBByBJK+1EKy5opw6GXOF7FTwS7AiEAxUu6UHJ/s4qCiJbqg22VdPUplG2We8BYxK8OvuxQzUw=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":149018},"name":"@nguniversal/express-engine","type":"module","module":"./fesm2022/express-engine.mjs","readme":"# Angular Express Engine\n\nThis is an Express Engine for running Angular Apps on the server for server side rendering.\n\n## Usage\n\n`npm install @nguniversal/express-engine --save`\n\nTo use it, set the engine and then route requests to it\n\n```ts\nimport express from 'express';\nimport { ngExpressEngine } from '@nguniversal/express-engine';\n\nconst app = express();\n\n// Set the engine\napp.engine(\n  'html',\n  ngExpressEngine({\n    bootstrap: ServerAppModule, // Give it a module to bootstrap\n  }),\n);\n\napp.set('view engine', 'html');\n\napp.get('/**/*', (req: Request, res: Response) => {\n  res.render('../dist/index', {\n    req,\n    res,\n  });\n});\n```\n\n## Configuring the URL and Document\n\nIt is possible to override the default URL and document fetched when the rendering engine\nis called. To do so, simply pass in a `url` and/or `document` string to the renderer as follows:\n\n```ts\napp.get('/**/*', (req: Request, res: Response) => {\n  let url = 'http://someurl.com';\n  let doc = '<html><head><title>New doc</title></head></html>';\n  res.render('../dist/index', {\n    req,\n    res,\n    url,\n    document: doc,\n  });\n});\n```\n\n## Extra Providers\n\nExtra Providers can be provided either on engine setup\n\n```ts\napp.engine(\n  'html',\n  ngExpressEngine({\n    bootstrap: ServerAppModule,\n    providers: [ServerService],\n  }),\n);\n```\n\n## Advanced Usage\n\n### Request based Bootstrap\n\nThe Bootstrap module as well as more providers can be passed on request\n\n```ts\napp.get('/**/*', (req: Request, res: Response) => {\n  res.render('../dist/index', {\n    req,\n    res,\n    bootstrap: OtherServerAppModule,\n    providers: [OtherServerService],\n  });\n});\n```\n\n### Using the Request and Response\n\nThe Request and Response objects are injected into the app via injection tokens.\nYou can access them by @Inject\n\n```ts\nimport { Request } from 'express';\nimport { REQUEST } from '@nguniversal/express-engine/tokens';\n\n@Injectable()\nexport class RequestService {\n  constructor(@Inject(REQUEST) private request: Request) {}\n}\n```\n\nIf your app runs on the client side too, you will have to provide your own versions of these in the client app.\n\n### Using a Custom Callback\n\nYou can also use a custom callback to better handle your errors\n\n```ts\napp.get('/**/*', (req: Request, res: Response) => {\n  res.render(\n    '../dist/index',\n    {\n      req,\n      res,\n    },\n    (err: Error, html: string) => {\n      res.status(html ? 200 : 500).send(html || err.message);\n    },\n  );\n});\n```\n","engines":{"node":"^16.14.0 || >=18.10.0"},"exports":{".":{"esm":"./esm2022/express-engine.mjs","types":"./index.d.ts","default":"./fesm2022/express-engine.mjs","esm2022":"./esm2022/express-engine.mjs"},"./tokens":{"esm":"./esm2022/tokens/tokens.mjs","types":"./tokens/index.d.ts","default":"./fesm2022/tokens.mjs","esm2022":"./esm2022/tokens/tokens.mjs"},"./package.json":{"default":"./package.json"}},"gitHead":"a12cc9f76408fb184ffff10fc89a03b2964b63bf","license":"MIT","typings":"./index.d.ts","_npmUser":{"name":"google-wombot","email":"node-team-npm+wombot@google.com"},"homepage":"https://github.com/angular/universal","keywords":["express","ssr","universal"],"ng-update":{"packageGroup":["@nguniversal/builders","@nguniversal/common","@nguniversal/express-engine"],"packageGroupName":"@nguniversal/express-engine"},"repository":{"url":"git+https://github.com/angular/universal.git","type":"git"},"schematics":"./schematics/collection.json","_npmVersion":"8.19.4","description":"Express Engine for running Server Angular Apps","directories":{},"maintainers":[{"name":"angular","email":"devops+npm@angular.io"},{"name":"google-wombot","email":"node-team-npm+wombot@google.com"}],"_nodeVersion":"18.16.0","dependencies":{"tslib":"^2.3.0","@nguniversal/common":"16.1.0-next.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","peerDependencies":{"express":"^4.15.2","@angular/core":"^16.0.0 || ^16.1.0-next.0","@angular/common":"^16.0.0 || ^16.1.0-next.0"},"_npmOperationalInternal":{"tmp":"tmp/express-engine_16.1.0-next.0_1684503401208_0.7040644358726649","host":"s3://npm-registry-packages"},"_id":"@nguniversal/express-engine@16.1.0-next.0","version":"16.1.0-next.0"}