\n \n\n# Fastify Logto Integration\n> 🔐 [Fastify](https://fastify.dev/) plugin for integrating with [Logto](https://logto.io), a modern open-source identity platform.\n\n## Features\n\n- Plug-and-play authentication and session management with Logto.\n- Secure route protection using Fastify decorators.\n- Works seamlessly with Fastify 4+ and TypeScript.\n\n## Installation\nTo install the package, use your preferred package manager:\n\n```bash\nnpm install @albirex/fastify-logto\n# or\nyarn add @albirex/fastify-logto\n# or\npnpm add @albirex/fastify-logto\n```\n\n## Usage\n### Basic setup\n```javascript\nimport Fastify from 'fastify';\nimport fastifyLogto from 'fastify-logto';\n\nconst app = Fastify();\n\napp.register(fastifyLogto, {\n appId: 'your-logto-app-id',\n appSecret: 'your-logto-app-secret',\n endpoint: 'https://your-logto-endpoint.com',\n baseUrl: 'http://localhost:3000',\n cookieSecret: 'your-cookie-secret', // use a strong secret in production\n});\n\n```\n\n### Protecting routes\n```javascript\napp.get('/profile', {\n preHandler: app.verifyLogto,\n handler: async (request, reply) => {\n const userInfo = await request.getLogtoUser();\n return { user: userInfo };\n }\n});\n```\n\n## Configuration options\n| Property | Type | Description |\n| ------------ | ------------------ | ------------------------------------------------ |\n| appId | string | Your Logto application's ID. |\n| appSecret | string | Your Logto application's secret. |\n| endpoint | string | Your Logto server endpoint. |\n| cookieSecret | string | Secret used for signing cookies (sessions). |\n| baseUrl | string, optional | Your app's base URL (for callback routing). |\n| scopes | string[], optional | Define the scopes required for your application. |\n\n## API\n### Decorators\n- request.getLogtoUser(): Retrieves the authenticated user's information.\n- app.verifyLogto: PreHandler function to enforce authentication.\n\n## Development\n```bash\npnpm install\npnpm build\npnpm test\n```\n### Local linking\n```bash\npnpm link --global\ncd ../your-app\npnpm link --global fastify-logto\n```\n## License\nThis project is licensed under the MIT License.\n\n## Contributing\nContributions are welcome! Please open an issue or submit a pull request for any enhancements or bug fixes.\n\nFor more information and advanced usage, please refer to the official documentation for [Platformatic](https://platformatic.dev/docs/db/plugin) and [LogTo](https://docs.logto.io/introduction).","readmeFilename":"README.md"}
![\"NPM](\"https://img.shields.io/npm/v/%40albirex%2Ffastify-logto\")
![\"GitHub](\"https://img.shields.io/github/license/albiper/fastify-logto\")
![\"GitHub](\"https://img.shields.io/github/actions/workflow/status/albiper/fastify-logto/npm-publish.yml\")
\n![\"NPM](\"https://img.shields.io/npm/dm/%40albirex%2Ffastify-logto\")
\n