11 Commits

Author SHA1 Message Date
ramvignesh-b a004322970 test: refactor test setup for dynamic redis client imports
CI / build (pull_request) Successful in 22s
2026-05-12 05:46:31 +05:30
ramvignesh-b 282618bc1c test: migrate global test prefixes to explicit imports
CI / build (pull_request) Failing after 20s
2026-05-12 05:42:27 +05:30
ramvignesh-b dcf5cd3551 refactor: modularize OpenAPI configuration and extract version constants into separate files
CI / build (pull_request) Failing after 22s
2026-05-12 05:27:29 +05:30
ramvignesh-b 9edb7fd989 refactor: update OpenAPI documentation metadata 2026-05-12 05:20:32 +05:30
ramvignesh-b 0a276b9a63 refactor: centralize versioning and path constants and standardize routes across the application and test suites 2026-05-12 05:17:07 +05:30
ramvignesh-b 5d8a9ccb3e refactor: update API documentation routes and paths to v1 naming convention 2026-05-12 05:01:58 +05:30
ramvignesh-b cf37904083 feat: version API and auth endpoints under /v1 prefix and update documentation labels 2026-05-12 04:57:19 +05:30
ramvignesh-b f3349fced4 feat: improve OpenAPI documentation by adding tags and route summaries 2026-05-12 04:52:03 +05:30
ramvignesh-b 4554b2e734 feat: add API reference link to dashboard navigation bar 2026-05-12 04:46:42 +05:30
ramvignesh-b 106edb8bb7 feat: hide api key input when authenticated 2026-05-12 04:42:33 +05:30
ramvignesh-b f89b5b4437 feat: add functionality to delete provider configurations and associated tokens via UI and API 2026-05-12 04:40:55 +05:30
26 changed files with 553 additions and 867 deletions
Binary file not shown.

Before

Width:  |  Height:  |  Size: 286 KiB

After

Width:  |  Height:  |  Size: 110 KiB

-3
View File
@@ -19,6 +19,3 @@ docs/
# OS # OS
.DS_Store .DS_Store
Thumbs.db Thumbs.db
# Worktrees
.worktrees/
+36 -78
View File
@@ -1,124 +1,82 @@
# toknd — The Minimal Token Broker # toknd — Auth Broker
![Dashboard Screenshot](.docs/screenshot.png) ![Dashboard Screenshot](.docs/screenshot.png)
Building integrations is fun until you have to manage the tokens. Suddenly, you're writing cron jobs to handle refresh cycles, dealing with expired sessions in the middle of background tasks, and copying OAuth secrets manually across multiple microservices. **toknd** is a minimal, centralized authentication and token broker. Built with **Bun**, **Hono**, and **Redis**, it serves as a middleware layer that manages OAuth2 providers, token persistence, and automatic refreshes, allowing your applications to focus on their core logic.
If you are building AI agents that need to take actions in the real world, the absolute last thing you want is your LLM trying to debug an OAuth redirect flow.
**toknd** is a minimal, centralized authentication and auth token broker and middleware with **native multi-tenancy**. Built with **Bun**, **Hono**, and **Redis**, it acts as a secure "wallet" that sits between your applications and the external APIs they need to access.
You just need to authenticate once. toknd manages the lifecycle of the tokens forever, securely isolated by tenant.
---
## Why does this exist?
There are massive enterprise identity brokers (like Auth0 or Dex), and then there are reverse proxies (like oauth2-proxy). **toknd** is built to bridge the gap while remaining minimal and open-source. It provides the lightweight, developer-friendly infrastructure of a proxy, but with the specific "Token Vault" and **Multi-Tenancy** capabilities required for modern AI and microservice architectures—without the bloat, vendor lock-in, or SaaS costs.
## Use-Cases
- **Multi-Tenant SaaS Platforms:** If you are building a platform where *your* users need to connect their own GitHub or Google accounts, toknd handles the isolation. Use a unique `tenantId` for each of your customers to keep their credentials safe and separate.
- **The Ultimate AI Agent Wallet:** Equip your autonomous agents with a secure keychain. When your agent needs to hit a service backed by oauth, like GitHub or Notion API, it just asks toknd for a token. It gets a short-lived Bearer token instantly, keeping your permanent secrets completely isolated from dynamic AI environments.
- **Set It and Forget It:** toknd handles automated background refreshes. Your data ingestion pipelines, RAG syncs, and headless integration workers will never stall out due to a `401 Unauthorized` error again.
- **Microservice Centralization:** Stop implementing OAuth in every new service. Centralize your credentials so your microservices only need one internal API key to request valid access tokens for any configured provider.
- **Secure Secret Isolation:** OAuth client IDs, secrets, and long-lived refresh tokens stay locked inside toknd's Redis vault, drastically reducing your attack surface. All you need to do is secure the store.
## Features ## Features
- **Native Multi-Tenancy:** Isolate tokens for unlimited users/tenants using a single instance. - Centralized management for multiple OAuth2 providers (Google, Trakt, GitHub, etc.).
- **Drop-in Infrastructure:** Deploys in seconds via Docker (or Podman) Compose or just a simple Bun script. - Automatic token refreshes.
- **Centralized Provider Management:** Native support for managing multiple OAuth2 providers (Google, GitHub, Trakt, etc.). - Secure and isolated API access via API key authentication.
- **API Key Security:** Isolated and secure access to the broker via master API keys. Each instance can use its own key for isolation. - Web-based dashboard for configuration management.
- **Web Dashboard:** Built-in clean ad modern UI for managing provider configurations and viewing live token statuses. - Docker Compose support for simplified deployment.
- **Blisteringly Fast:** Powered by Bun and Redis for ultra-low latency token retrieval. - High performance and low-latency powered by Bun and Redis.
## Tech Stack ## Tech Stack
- **Runtime**: [Bun](https://bun.sh/) - **Runtime**: [Bun](https://bun.sh/)
- **Web Framework**: [Hono](https://hono.dev/) - **Web Framework**: [Hono](https://hono.dev/)
- **Data Store**: [Redis](https://redis.io/) - **Data Store**: Redis
- **Styling**: [Tailwind CSS](https://tailwindcss.com/) & [DaisyUI](https://daisyui.com/) - **Styling**: Tailwind CSS & DaisyUI
- **Schema & Validation**: [Zod](https://zod.dev/) - **Schema & Validation**: Zod
- **Docs**: [Scalar](https://github.com/scalar/scalar)
---
## Getting Started ## Getting Started
toknd is designed to be too easy to set-up. You can deploy it as a containerized service or host it directly on bare metal. toknd can be deployed either as a containerized service or self-hosted directly on your hardware.
### 1. Environment Setup ### 1. Environment Setup
Clone the repository and set up your environment: Clone the repository and create your environment file:
```bash ```bash
git clone https://git.ramvignesh.dev/toknd_auth.git
cd toknd
cp .env.example .env cp .env.example .env
``` ```
Open `.env`, define your own strong `API_KEY`, and map the ports (optional) Define a strong `API_KEY` and ensure `REDIS_URL` points to a valid Redis instance.
### 2. Choose Deployment Method ### 2. Choose Deployment Method
#### Option A: Docker Compose (Recommended) #### Option A: Containerized (Recommended)
The easiest way to get up and running. This spins up both toknd and a dedicated Redis instance. This is the easiest way to get up and running, as it bundles the application and a Redis instance together.
- **Development (with Hot-Reload)**:
```bash
podman compose up --build
```
- **Production**: - **Production**:
```bash ```bash
docker compose up -d --build docker compose up -d --build
(or)
podman compose up -d --build
``` ```
#### Option B: Self-Hosting (Bare Metal)
#### Option B: Bare Metal Ideal for lightweight deployments or custom environments where you already have Bun and Redis.
If you already have Bun and Redis running in your environment.
1. **Install Dependencies**: 1. **Install Dependencies**:
```bash ```bash
bun install bun install
``` ```
2. **Start the Server**: 2. **Start the Server**:
- **Development**: `bun run dev` (with hot-reload)
- **Production**: `bun run start` - **Production**: `bun run start`
- **Development**: `bun run dev` *Note: Ensure your Redis server is running and accessible via the `REDIS_URL` in your `.env`.*
*Note: Make sure your Redis server is running and accessible via the `HOST` and `PORT` in your `.env`.*
--- ---
## Usage & API Reference ## API Reference
toknd provides a built-in **Scalar API Reference** so you can explore and test endpoints right from your browser. toknd provides a built-in **Scalar API Reference** that allows you to explore and test all endpoints directly from your browser.
- **Interactive UI**: [http://localhost:3000/api](http://localhost:3000/api) (or `/docs`) - **Interactive UI**: [http://localhost:3000/api](http://localhost:3000/api) (or `/docs`)
- **OpenAPI Spec**: [http://localhost:3000/doc](http://localhost:3000/doc) - **OpenAPI Spec (JSON)**: [http://localhost:3000/doc](http://localhost:3000/doc)
### Multi-Tenancy & The Golden Rule All protected endpoints require a Bearer token in the `Authorization` header:
All protected endpoints require your master API key and a **Tenant ID** for isolation: `Authorization: Bearer <your_master_api_key>`
1. **Authentication:** Use your API key in the `Authorization` header. ### Core Concepts
2. **Isolation:** Pass your unique tenant identifier in the `X-Tenant-ID` header. - **Token Brokerage**: Automated access token retrieval and background refreshes for all configured providers.
- **Provider Management**: Register and manage OAuth2 providers via the Dashboard or the configuration API.
```http ## Dashboard
Authorization: Bearer <your_master_api_key> Access the **toknd** dashboard at:
X-Tenant-ID: <unique_user_or_org_id> `http://localhost:3000/app`
```
### Starting an OAuth Flow The dashboard allows you to manage provider configurations, view live token statuses, and manually trigger refreshes. Authenticate using your **Master API Key**.
To connect a new account for a specific tenant, redirect the user to:
`http://localhost:3000/v1/auth/{provider}/login?tenantId={your_tenant_id}`
### The Dashboard
REST API too complicated to use? No problem!
You absolutely don't have to manage everything via curl. Access the web dashboard to configure providers, trigger manual refreshes, and monitor token health:
**`http://localhost:3000/app`**
*(Authenticate using your Master API Key).*
--- ---
## Contributing
This is an open-source passion project built to solve a real headache in modern application architecture. Pull requests, issues, and feature requests (especially for new built-in OAuth providers!) are highly encouraged.
## License
MIT
-1
View File
@@ -8,7 +8,6 @@ services:
- REDIS_HOST=redis - REDIS_HOST=redis
- REDIS_PORT=6379 - REDIS_PORT=6379
- API_KEY=${API_KEY} - API_KEY=${API_KEY}
- APP_PORT=3000
depends_on: depends_on:
- redis - redis
Binary file not shown.

Before

Width:  |  Height:  |  Size: 21 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 77 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 19 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 745 B

Binary file not shown.

Before

Width:  |  Height:  |  Size: 2.0 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 15 KiB

-19
View File
@@ -1,19 +0,0 @@
{
"name": "toknd_auth_broker",
"short_name": "toknd",
"icons": [
{
"src": "/android-chrome-192x192.png",
"sizes": "192x192",
"type": "image/png"
},
{
"src": "/android-chrome-512x512.png",
"sizes": "512x512",
"type": "image/png"
}
],
"theme_color": "#bdff00",
"background_color": "#000",
"display": "standalone"
}
+2 -2
View File
@@ -43,8 +43,8 @@ export class ConfigManager {
async deleteProviderConfig(provider: string): Promise<void> { async deleteProviderConfig(provider: string): Promise<void> {
await this.redis.del(`config:${provider}`); await this.redis.del(`config:${provider}`);
// Also clean up tokens across all tenants // Also clean up tokens
const tokenKeys = await this.redis.keys(`tenant:*:provider:${provider}:*`); const tokenKeys = await this.redis.keys(`provider:${provider}:*`);
if (tokenKeys.length > 0) { if (tokenKeys.length > 0) {
await this.redis.del(...tokenKeys); await this.redis.del(...tokenKeys);
} }
+14 -14
View File
@@ -7,38 +7,38 @@ export class TokenManager {
private provider: OAuthProvider, private provider: OAuthProvider,
) {} ) {}
async getAccessToken(tenantId: string, providerName: string): Promise<string | null> { async getAccessToken(providerName: string): Promise<string | null> {
const accessKey = `tenant:${tenantId}:provider:${providerName}:access_token`; const accessKey = `provider:${providerName}:access_token`;
const cached = await this.redis.get(accessKey); const cached = await this.redis.get(accessKey);
if (cached) return cached; if (cached) return cached;
const refreshKey = `tenant:${tenantId}:provider:${providerName}:refresh_token`; const refreshKey = `provider:${providerName}:refresh_token`;
const refreshToken = await this.redis.get(refreshKey); const refreshToken = await this.redis.get(refreshKey);
if (!refreshToken) return null; if (!refreshToken) return null;
const tokens = await this.provider.refreshToken(refreshToken); const tokens = await this.provider.refreshToken(refreshToken);
await this.saveTokens(tenantId, providerName, tokens); await this.saveTokens(providerName, tokens);
return tokens.accessToken; return tokens.accessToken;
} }
async refreshAccessToken(tenantId: string, providerName: string): Promise<string | null> { async refreshAccessToken(providerName: string): Promise<string | null> {
const refreshKey = `tenant:${tenantId}:provider:${providerName}:refresh_token`; const refreshKey = `provider:${providerName}:refresh_token`;
const refreshToken = await this.redis.get(refreshKey); const refreshToken = await this.redis.get(refreshKey);
if (!refreshToken) return null; if (!refreshToken) return null;
const tokens = await this.provider.refreshToken(refreshToken); const tokens = await this.provider.refreshToken(refreshToken);
await this.saveTokens(tenantId, providerName, tokens); await this.saveTokens(providerName, tokens);
return tokens.accessToken; return tokens.accessToken;
} }
async saveTokens(tenantId: string, providerName: string, tokens: TokenResponse) { async saveTokens(providerName: string, tokens: TokenResponse) {
const baseKey = `tenant:${tenantId}:provider:${providerName}`;
await this.redis.set(`${baseKey}:access_token`, tokens.accessToken, "EX", tokens.expiresIn);
await this.redis.set(`${baseKey}:refresh_token`, tokens.refreshToken);
await this.redis.set(`${baseKey}:last_updated`, new Date().toISOString());
await this.redis.set( await this.redis.set(
`${baseKey}:expires_at`, `provider:${providerName}:access_token`,
new Date(Date.now() + tokens.expiresIn * 1000).toISOString(), tokens.accessToken,
"EX",
tokens.expiresIn,
); );
await this.redis.set(`provider:${providerName}:refresh_token`, tokens.refreshToken);
await this.redis.set(`provider:${providerName}:last_updated`, new Date().toISOString());
} }
} }
+1 -4
View File
@@ -6,7 +6,7 @@ import { prettyJSON } from "hono/pretty-json";
import { config } from "./config"; import { config } from "./config";
import { API_PREFIX, AUTH_PREFIX, DOCS_PREFIX } from "./constants"; import { API_PREFIX, AUTH_PREFIX, DOCS_PREFIX } from "./constants";
import { redis } from "./core/RedisClient"; import { redis } from "./core/RedisClient";
import { openApiSpec, securityScheme, tenantIdScheme } from "./openapi"; import { openApiSpec, securityScheme } from "./openapi";
import { apiRoutes } from "./routes/api"; import { apiRoutes } from "./routes/api";
import { authRoutes } from "./routes/auth"; import { authRoutes } from "./routes/auth";
import { configRoutes } from "./routes/config"; import { configRoutes } from "./routes/config";
@@ -17,7 +17,6 @@ const app = new OpenAPIHono({ strict: false });
// OpenAPI specs // OpenAPI specs
app.doc(`${DOCS_PREFIX}/openapi.json`, openApiSpec); app.doc(`${DOCS_PREFIX}/openapi.json`, openApiSpec);
app.openAPIRegistry.registerComponent("securitySchemes", "API_KEY", securityScheme); app.openAPIRegistry.registerComponent("securitySchemes", "API_KEY", securityScheme);
app.openAPIRegistry.registerComponent("securitySchemes", "TENANT_ID", tenantIdScheme);
// Scalar API Reference // Scalar API Reference
app.get( app.get(
@@ -35,8 +34,6 @@ app.use("*", prettyJSON());
app.get("/", (c) => c.redirect("/app")); app.get("/", (c) => c.redirect("/app"));
app.get("/favicon.ico", serveStatic({ path: "./public/favicon.ico" }));
app.use("/static/*", serveStatic({ root: "./public" }));
app.get("/app/dashboard.js", serveStatic({ path: "./src/views/dashboard.js" })); app.get("/app/dashboard.js", serveStatic({ path: "./src/views/dashboard.js" }));
app.route(AUTH_PREFIX, authRoutes); app.route(AUTH_PREFIX, authRoutes);
app.route(`${API_PREFIX}/config`, configRoutes); app.route(`${API_PREFIX}/config`, configRoutes);
+2 -9
View File
@@ -6,7 +6,7 @@ export const openApiSpec = {
version: `${API_VERSION}.${APP_VERSION}`, version: `${API_VERSION}.${APP_VERSION}`,
title: "toknd Auth Broker API", title: "toknd Auth Broker API",
description: description:
"A high-performance OAuth2 broker and token management service with multi-tenancy support. Designed to centralize provider configurations and automate token lifecycle management across distributed systems, securely isolated by Tenant IDs.", "A high-performance OAuth2 broker and token management service. Designed to centralize provider configurations and automate token lifecycle management across distributed systems.",
}, },
tags: [ tags: [
{ {
@@ -22,17 +22,10 @@ export const openApiSpec = {
description: "System-level OAuth2 handshake and callback processing.", description: "System-level OAuth2 handshake and callback processing.",
}, },
], ],
security: [{ API_KEY: [], TENANT_ID: [] }], security: [{ API_KEY: [] }],
}; };
export const securityScheme = { export const securityScheme = {
type: "http", type: "http",
scheme: "bearer", scheme: "bearer",
} as const; } as const;
export const tenantIdScheme = {
type: "apiKey",
in: "header",
name: "X-Tenant-ID",
description: "The unique identifier for the tenant (user or organization).",
} as const;
+13 -39
View File
@@ -15,10 +15,6 @@ const StatusResponseSchema = z
accessToken: z.string().nullable(), accessToken: z.string().nullable(),
refreshToken: z.string().nullable(), refreshToken: z.string().nullable(),
lastUpdated: z.string().nullable(), lastUpdated: z.string().nullable(),
expiresAt: z.string().nullable().openapi({
example: "2026-05-12T10:00:00.000Z",
description: "ISO timestamp of when the access token expires",
}),
}), }),
) )
.openapi("StatusResponse"); .openapi("StatusResponse");
@@ -36,10 +32,6 @@ const RefreshResponseSchema = z
accessToken: z.string().nullable(), accessToken: z.string().nullable(),
refreshToken: z.string().nullable(), refreshToken: z.string().nullable(),
lastUpdated: z.string().nullable(), lastUpdated: z.string().nullable(),
expiresAt: z.string().nullable().openapi({
example: "2026-05-12T10:00:00.000Z",
description: "ISO timestamp of when the access token expires",
}),
}), }),
}) })
.openapi("RefreshResponse"); .openapi("RefreshResponse");
@@ -54,13 +46,8 @@ const ErrorSchema = z
const statusRoute = createRoute({ const statusRoute = createRoute({
method: "get", method: "get",
path: "/status", path: "/status",
security: [{ API_KEY: [], TENANT_ID: [] }], security: [{ API_KEY: [] }],
tags: ["Tokens"], tags: ["Tokens"],
request: {
headers: z.object({
"x-tenant-id": z.string().openapi({ example: "my-tenant" }),
}),
},
responses: { responses: {
200: { 200: {
content: { "application/json": { schema: StatusResponseSchema } }, content: { "application/json": { schema: StatusResponseSchema } },
@@ -72,15 +59,12 @@ const statusRoute = createRoute({
const tokenRoute = createRoute({ const tokenRoute = createRoute({
method: "get", method: "get",
path: "/token/{provider}", path: "/token/{provider}",
security: [{ API_KEY: [], TENANT_ID: [] }], security: [{ API_KEY: [] }],
tags: ["Tokens"], tags: ["Tokens"],
request: { request: {
params: z.object({ params: z.object({
provider: z.string().openapi({ example: "trakt" }), provider: z.string().openapi({ example: "trakt" }),
}), }),
headers: z.object({
"x-tenant-id": z.string().openapi({ example: "my-tenant" }),
}),
}, },
responses: { responses: {
200: { 200: {
@@ -97,15 +81,12 @@ const tokenRoute = createRoute({
const refreshRoute = createRoute({ const refreshRoute = createRoute({
method: "post", method: "post",
path: "/refresh/{provider}", path: "/refresh/{provider}",
security: [{ API_KEY: [], TENANT_ID: [] }], security: [{ API_KEY: [] }],
tags: ["Tokens"], tags: ["Tokens"],
request: { request: {
params: z.object({ params: z.object({
provider: z.string().openapi({ example: "trakt" }), provider: z.string().openapi({ example: "trakt" }),
}), }),
headers: z.object({
"x-tenant-id": z.string().openapi({ example: "my-tenant" }),
}),
}, },
responses: { responses: {
200: { 200: {
@@ -123,18 +104,15 @@ const refreshRoute = createRoute({
apiRoutes.use("*", authMiddleware); apiRoutes.use("*", authMiddleware);
apiRoutes.openapi(statusRoute, async (c) => { apiRoutes.openapi(statusRoute, async (c) => {
const tenantId = c.req.valid("header")["x-tenant-id"];
const configManager = new ConfigManager(redis); const configManager = new ConfigManager(redis);
const providers = await configManager.getAllProviders(); const providers = await configManager.getAllProviders();
const status: z.infer<typeof StatusResponseSchema> = {}; const status: z.infer<typeof StatusResponseSchema> = {};
for (const provider of Object.keys(providers)) { for (const provider of Object.keys(providers)) {
const baseKey = `tenant:${tenantId}:provider:${provider}`; const accessToken = await redis.get(`provider:${provider}:access_token`);
const accessToken = await redis.get(`${baseKey}:access_token`); const refreshToken = await redis.get(`provider:${provider}:refresh_token`);
const refreshToken = await redis.get(`${baseKey}:refresh_token`); const lastUpdated = await redis.get(`provider:${provider}:last_updated`);
const lastUpdated = await redis.get(`${baseKey}:last_updated`); status[provider] = { accessToken, refreshToken, lastUpdated };
const expiresAt = await redis.get(`${baseKey}:expires_at`);
status[provider] = { accessToken, refreshToken, lastUpdated, expiresAt };
} }
return c.json(status, 200); return c.json(status, 200);
@@ -142,7 +120,6 @@ apiRoutes.openapi(statusRoute, async (c) => {
apiRoutes.openapi(tokenRoute, async (c) => { apiRoutes.openapi(tokenRoute, async (c) => {
const providerName = c.req.valid("param").provider; const providerName = c.req.valid("param").provider;
const tenantId = c.req.valid("header")["x-tenant-id"];
const configManager = new ConfigManager(redis); const configManager = new ConfigManager(redis);
const providerConfig = await configManager.getProviderConfig(providerName); const providerConfig = await configManager.getProviderConfig(providerName);
@@ -153,7 +130,7 @@ apiRoutes.openapi(tokenRoute, async (c) => {
const provider = new GenericProvider(providerName, providerConfig); const provider = new GenericProvider(providerName, providerConfig);
const tokenManager = new TokenManager(redis, provider); const tokenManager = new TokenManager(redis, provider);
const accessToken = await tokenManager.getAccessToken(tenantId, providerName); const accessToken = await tokenManager.getAccessToken(providerName);
if (!accessToken) { if (!accessToken) {
return c.json({ error: "No tokens found for provider" }, 404); return c.json({ error: "No tokens found for provider" }, 404);
} }
@@ -162,7 +139,6 @@ apiRoutes.openapi(tokenRoute, async (c) => {
apiRoutes.openapi(refreshRoute, async (c) => { apiRoutes.openapi(refreshRoute, async (c) => {
const providerName = c.req.valid("param").provider; const providerName = c.req.valid("param").provider;
const tenantId = c.req.valid("header")["x-tenant-id"];
const configManager = new ConfigManager(redis); const configManager = new ConfigManager(redis);
const providerConfig = await configManager.getProviderConfig(providerName); const providerConfig = await configManager.getProviderConfig(providerName);
@@ -173,17 +149,15 @@ apiRoutes.openapi(refreshRoute, async (c) => {
const provider = new GenericProvider(providerName, providerConfig); const provider = new GenericProvider(providerName, providerConfig);
const tokenManager = new TokenManager(redis, provider); const tokenManager = new TokenManager(redis, provider);
await tokenManager.refreshAccessToken(tenantId, providerName); await tokenManager.refreshAccessToken(providerName);
const baseKey = `tenant:${tenantId}:provider:${providerName}`; const accessToken = await redis.get(`provider:${providerName}:access_token`);
const accessToken = await redis.get(`${baseKey}:access_token`); const refreshToken = await redis.get(`provider:${providerName}:refresh_token`);
const refreshToken = await redis.get(`${baseKey}:refresh_token`); const lastUpdated = await redis.get(`provider:${providerName}:last_updated`);
const lastUpdated = await redis.get(`${baseKey}:last_updated`);
const expiresAt = await redis.get(`${baseKey}:expires_at`);
return c.json( return c.json(
{ {
success: true, success: true,
status: { accessToken, refreshToken, lastUpdated, expiresAt }, status: { accessToken, refreshToken, lastUpdated },
}, },
200, 200,
); );
+10 -27
View File
@@ -23,9 +23,6 @@ const loginRoute = createRoute({
params: z.object({ params: z.object({
provider: z.string().openapi({ example: "trakt" }), provider: z.string().openapi({ example: "trakt" }),
}), }),
query: z.object({
tenantId: z.string().openapi({ example: "my-tenant" }),
}),
}, },
responses: { responses: {
302: { 302: {
@@ -45,13 +42,16 @@ const callbackRoute = createRoute({
summary: "OAuth2 callback handler (Managed by System)", summary: "OAuth2 callback handler (Managed by System)",
request: { request: {
query: z.object({ query: z.object({
state: z.string().openapi({ description: "Composite state: tenantId:providerName" }), state: z
.string()
.openapi({ description: "The provider name (passed as state during login)" }),
code: z.string().openapi({ description: "The authorization code from the provider" }), code: z.string().openapi({ description: "The authorization code from the provider" }),
}), }),
}, },
responses: { responses: {
302: { 200: {
description: "Redirect to success page", description: "Success page indicating successful token exchange",
content: { "text/html": { schema: { type: "string" } } },
}, },
400: { 400: {
content: { "application/json": { schema: AuthErrorResponse } }, content: { "application/json": { schema: AuthErrorResponse } },
@@ -71,7 +71,6 @@ const callbackRoute = createRoute({
// Implementations // Implementations
authRoutes.openapi(loginRoute, async (c) => { authRoutes.openapi(loginRoute, async (c) => {
const providerName = c.req.valid("param").provider; const providerName = c.req.valid("param").provider;
const tenantId = c.req.valid("query").tenantId;
const configManager = new ConfigManager(redis); const configManager = new ConfigManager(redis);
const providerConfig = await configManager.getProviderConfig(providerName); const providerConfig = await configManager.getProviderConfig(providerName);
@@ -89,27 +88,11 @@ authRoutes.openapi(loginRoute, async (c) => {
const url = new URL(c.req.url); const url = new URL(c.req.url);
const redirectUri = providerConfig.redirectUri || `${url.origin}/auth/callback`; const redirectUri = providerConfig.redirectUri || `${url.origin}/auth/callback`;
// Pass both tenantId and providerName in state return c.redirect(provider.getAuthUrl(providerName, redirectUri));
const state = `${tenantId}:${providerName}`;
return c.redirect(provider.getAuthUrl(state, redirectUri));
}); });
authRoutes.openapi(callbackRoute, async (c) => { authRoutes.openapi(callbackRoute, async (c) => {
const { state, code } = c.req.valid("query"); const { state: providerName, code } = c.req.valid("query");
// state is expected to be "tenantId:providerName"
const parts = state.split(":");
if (parts.length !== 2) {
return c.json(
{
error: "Invalid State",
message: "The state parameter is invalid.",
},
400,
);
}
const [tenantId, providerName] = parts;
const configManager = new ConfigManager(redis); const configManager = new ConfigManager(redis);
const providerConfig = await configManager.getProviderConfig(providerName); const providerConfig = await configManager.getProviderConfig(providerName);
@@ -132,9 +115,9 @@ authRoutes.openapi(callbackRoute, async (c) => {
try { try {
const tokens = await provider.exchangeCode(code, redirectUri); const tokens = await provider.exchangeCode(code, redirectUri);
await tokenManager.saveTokens(tenantId, providerName, tokens); await tokenManager.saveTokens(providerName, tokens);
return c.redirect(`/app/success?provider=${providerName}&tenantId=${tenantId}`); return c.redirect(`/app/success?provider=${providerName}`);
} catch (error) { } catch (error) {
const errorMessage = error instanceof Error ? error.message : "An unexpected error occurred."; const errorMessage = error instanceof Error ? error.message : "An unexpected error occurred.";
console.error(`[OAuth Error] ${errorMessage}`); console.error(`[OAuth Error] ${errorMessage}`);
+369 -497
View File
@@ -16,7 +16,6 @@ export const Layout = (props: { title: string; children: Child; isUnlocked?: boo
<meta charset="UTF-8" /> <meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>{props.title}</title> <title>{props.title}</title>
<link rel="icon" type="image/png" href="/favicon.ico" />
<link href="https://cdn.jsdelivr.net/npm/daisyui@5" rel="stylesheet" type="text/css" /> <link href="https://cdn.jsdelivr.net/npm/daisyui@5" rel="stylesheet" type="text/css" />
<script src="https://cdn.jsdelivr.net/npm/@tailwindcss/browser@4"></script> <script src="https://cdn.jsdelivr.net/npm/@tailwindcss/browser@4"></script>
<link <link
@@ -36,15 +35,12 @@ export const Layout = (props: { title: string; children: Child; isUnlocked?: boo
.font-mono { .font-mono {
font-family: "DM Mono", monospace; font-family: "DM Mono", monospace;
} }
.text-xxs {
font-size: 10px;
}
`} `}
</style> </style>
</head> </head>
<body <body
class="bg-base-200/50 min-h-screen font-['DM_Sans',sans-serif] antialiased text-base-content tracking-tight" class="bg-base-200/50 min-h-screen font-['DM_Sans',sans-serif] antialiased text-base-content tracking-tight"
x-data={`dashboard({ x-data={`dashboard({
initialIsUnlocked: ${props.isUnlocked || false}, initialIsUnlocked: ${props.isUnlocked || false},
apiVersion: '${API_VERSION}', apiVersion: '${API_VERSION}',
appVersion: '${APP_VERSION}', appVersion: '${APP_VERSION}',
@@ -63,555 +59,431 @@ export const Layout = (props: { title: string; children: Child; isUnlocked?: boo
export const Dashboard = (props: { isUnlocked: boolean }) => ( export const Dashboard = (props: { isUnlocked: boolean }) => (
<Layout title="toknd — Auth Broker Dashboard" isUnlocked={props.isUnlocked}> <Layout title="toknd — Auth Broker Dashboard" isUnlocked={props.isUnlocked}>
<div class="flex flex-col min-h-screen"> <div class="navbar bg-base-100 shadow-sm px-4 md:px-8 border-b border-base-300">
<div class="navbar bg-base-100 shadow-sm px-4 md:px-8 border-b border-base-300 relative z-50"> <div class="flex-1 flex items-center gap-6">
<div class="flex-1 flex items-center gap-6"> <div class="flex items-center gap-2">
<div class="flex items-center gap-2"> <div class="w-8 h-8 bg-primary rounded-lg flex items-center justify-center text-primary-content font-semibold text-lg">
<div class="w-8 h-8 bg-primary rounded-lg flex items-center justify-center text-primary-content font-semibold text-lg"> <i class="ph-duotone ph-fingerprint"></i>
<i class="ph-duotone ph-fingerprint"></i> </div>
</div> <div class="text-xl font-semibold tracking-tight">
<div class="text-xl font-semibold tracking-tight"> toknd <span class="text-xs font-normal opacity-50 ml-1">auth broker</span>
toknd <span class="text-xs font-normal opacity-50 ml-1">auth broker</span>
</div>
</div> </div>
</div> </div>
<div class="flex-none lg:hidden"> <nav class="hidden md:flex items-center gap-1">
<label for="mobile-menu" class="btn btn-square btn-ghost">
<i class="ph-duotone ph-chart-donut text-3xl"></i>
</label>
</div>
<input type="checkbox" id="mobile-menu" class="peer hidden" />
<div class="fixed inset-y-0 right-0 w-80 bg-base-100 border-l border-base-300 shadow-2xl p-6 flex flex-col gap-6 transform translate-x-full peer-checked:translate-x-0 transition-transform z-50 lg:static lg:flex-none lg:w-auto lg:bg-transparent lg:border-none lg:shadow-none lg:p-0 lg:flex-row lg:items-center lg:gap-4 lg:translate-x-0 lg:z-auto">
<div class="flex justify-end lg:hidden">
<label for="mobile-menu" class="btn btn-ghost btn-square">
<i class="ph-bold ph-circle-dashed text-2xl"></i>
</label>
</div>
<a <a
href={DOCS_PREFIX} href={DOCS_PREFIX}
target="_blank" target="_blank"
class="btn btn-ghost justify-start lg:justify-center lg:btn-sm text-base-content/60 hover:text-primary gap-3 lg:gap-2 w-full lg:w-auto px-3" class="btn btn-ghost btn-sm text-base-content/60 hover:text-primary gap-2 px-3"
rel="noopener" rel="noopener"
> >
<i class="ph-duotone ph-book-open text-lg"></i> <i class="ph-duotone ph-book-open text-lg"></i>
<span class="font-bold uppercase tracking-widest"> <span class="font-bold uppercase tracking-widest text-xs">
API Reference API Reference{" "}
<sup class="text-xxs opacity-50 ml-0.5"> <sup class="text-[8px] opacity-50 ml-0.5">
{API_VERSION}.{APP_VERSION} {API_VERSION}.{APP_VERSION}
</sup> </sup>
</span> </span>
</a> </a>
</nav>
</div>
<div class="flex-none hidden sm:flex">
<template x-if="!isUnlocked">
<div class="join border border-base-200/50 bg-base-200/50 rounded-xl overflow-hidden focus-within:border-primary transition-colors">
<div class="join-item flex items-center px-4 bg-base-200">
<i class="ph-duotone ph-key text-secondary text-lg"></i>
</div>
<div class="relative flex-1" x-data="{ show: false }">
<input
x-bind:type="show ? 'text' : 'password'"
id="apiKey"
name="apiKey"
x-model="apiKey"
aria-label="Master API Key"
placeholder="API_KEY"
class="input join-item input-sm bg-transparent border-none focus:outline-none w-48 lg:w-64 text-xs pr-10 font-mono"
/>
<button
type="button"
x-on:click="show = !show"
class="absolute right-2 top-1/2 -translate-y-1/2 btn btn-ghost btn-xs btn-square"
>
<i x-bind:class="show ? 'ph-duotone ph-eye-slash text-base opacity-50' : 'ph-duotone ph-eye text-base opacity-50'"></i>
</button>
</div>
<button
x-on:click="unlock()"
type="submit"
class="btn btn-primary btn-sm join-item px-6"
x-bind:disabled="loading"
>
<i class="ph-duotone ph-lock-key-open text-lg" x-show="!loading"></i>
<span class="loading loading-spinner loading-xs" x-show="loading"></span>
<span
class="ml-1 hidden md:inline"
x-text="loading ? 'Unlocking...' : 'Unlock'"
></span>
</button>
</div>
</template>
<div class="divider my-0 opacity-50 lg:hidden"></div> <template x-if="isUnlocked">
<button
x-on:click="logout()"
type="button"
class="btn btn-ghost btn-sm text-error hover:bg-error/10 gap-2 px-4"
x-bind:disabled="loading"
>
<i class="ph-bold ph-power text-lg"></i>
<span class="font-bold uppercase tracking-wider text-xs">Logout</span>
</button>
</template>
</div>
</div>
<template x-if="!isUnlocked"> <div class="container mx-auto p-4 md:p-8 max-w-7xl">
<div class="flex flex-col lg:flex-row gap-4 items-start lg:items-center w-full lg:w-auto"> <div class="grid grid-cols-1 lg:grid-cols-12 gap-6 md:gap-8">
<div class="join border border-base-200/50 bg-base-200/50 rounded-xl overflow-hidden focus-within:border-primary transition-colors w-full lg:w-auto"> <div class="card bg-base-100 shadow-xl border border-base-300 lg:col-span-4 self-start">
<div class="join-item flex items-center px-4 bg-base-200"> <div class="card-body p-6">
<i class="ph-duotone ph-key text-secondary text-lg"></i> <div class="flex items-center gap-2 mb-4">
</div> <div class="w-2 h-6 bg-primary rounded-full"></div>
<div class="relative flex-1" x-data="{ show: false }"> <h2 class="card-title text-xl font-semibold">Configure Provider</h2>
</div>
<form x-on:submit="saveConfig" class="space-y-4">
<div class="form-control">
<label htmlFor="providerName" class="label py-1">
<span class="label-text flex items-center gap-2">
Provider ID
<span class="tooltip tooltip-top" data-tip="Internal name for this service.">
<i class="ph ph-info opacity-50 cursor-help"></i>
</span>
</span>
</label>
<input
type="text"
id="providerName"
x-model="form.providerName"
placeholder="e.g. trakt"
required
class="input input-bordered w-full focus:input-primary"
/>
</div>
<div class="divider text-xs opacity-50 my-2 uppercase tracking-widest">
Credentials
</div>
<div class="form-control">
<label htmlFor="clientId" class="label py-1">
<span class="label-text">Client ID</span>
</label>
<input
type="text"
id="clientId"
x-model="form.clientId"
placeholder="OAuth client id"
required
class="input input-bordered w-full focus:input-primary"
/>
</div>
<div class="form-control" x-data="{ show: false }">
<label htmlFor="clientSecret" class="label py-1">
<span class="label-text">Client Secret</span>
</label>
<div class="relative">
<input <input
x-bind:type="show ? 'text' : 'password'" x-bind:type="show ? 'text' : 'password'"
id="apiKey" id="clientSecret"
name="apiKey" x-model="form.clientSecret"
x-model="apiKey" placeholder="OAuth client secret"
aria-label="Master API Key" required
placeholder="API_KEY" class="input input-bordered w-full focus:input-primary pr-12"
class="input join-item input-sm bg-transparent border-none focus:outline-none w-full lg:w-64 text-xs pr-10 font-mono"
/> />
<button <button
type="button" type="button"
x-on:click="show = !show" x-on:click="show = !show"
class="absolute right-2 top-1/2 -translate-y-1/2 btn btn-ghost btn-xs btn-square" class="absolute right-3 top-1/2 -translate-y-1/2 btn btn-ghost btn-xs btn-square"
> >
<i x-bind:class="show ? 'ph-duotone ph-eye-slash text-base opacity-50' : 'ph-duotone ph-eye text-base opacity-50'"></i> <i x-bind:class="show ? 'ph-duotone ph-eye-slash text-lg opacity-40' : 'ph-duotone ph-eye text-lg opacity-40'"></i>
</button> </button>
</div> </div>
<button
x-on:click="unlock(); document.getElementById('mobile-menu').checked = false;"
type="submit"
class="btn btn-primary btn-sm join-item px-6"
x-bind:disabled="loading"
>
<i class="ph-duotone ph-lock-key-open text-lg" x-show="!loading"></i>
<span class="loading loading-spinner loading-xs" x-show="loading"></span>
<span
class="ml-1 hidden lg:inline"
x-text="loading ? 'Unlocking...' : 'Unlock'"
></span>
</button>
</div> </div>
</div>
</template>
<template x-if="isUnlocked"> <div class="divider text-xs opacity-50 my-2 uppercase tracking-widest">Endpoints</div>
<div class="flex flex-col lg:flex-row items-start lg:items-center gap-4 w-full lg:w-auto">
<form <div class="form-control">
class="join border border-base-200/50 bg-base-200/50 rounded-xl overflow-hidden focus-within:border-primary transition-colors w-full lg:w-auto" <label htmlFor="authUrl" class="label py-1">
x-on:submit="$event.preventDefault(); if(isTenantLocked) { isTenantLocked = false; } else { isTenantLocked = true; fetchProviders(); document.getElementById('mobile-menu').checked = false; }" <span class="label-text">Auth URL</span>
> </label>
<div class="join-item flex items-center px-4 bg-base-300 opacity-70"> <input
<i class="ph-duotone ph-identification-badge text-xl text-primary"></i> type="url"
id="authUrl"
x-model="form.authUrl"
placeholder="https://trakt.tv/oauth/authorize"
required
class="input input-bordered w-full focus:input-primary"
/>
</div>
<div class="form-control">
<label htmlFor="tokenUrl" class="label py-1">
<span class="label-text">Token URL</span>
</label>
<input
type="url"
id="tokenUrl"
x-model="form.tokenUrl"
placeholder="https://api.trakt.tv/oauth/token"
required
class="input input-bordered w-full focus:input-primary"
/>
</div>
<div class="form-control">
<label htmlFor="redirectUri" class="label py-1">
<span class="label-text">Redirect URI</span>
</label>
<div class="relative group">
<input
type="url"
id="redirectUri"
x-bind:value="getRedirectUri()"
readonly
class="input input-bordered w-full pr-12 focus:outline-none cursor-default opacity-80"
/>
<button
type="button"
x-on:click="copyToClipboard(getRedirectUri())"
class="btn btn-ghost btn-xs absolute right-2 top-1/2 -translate-y-1/2 text-base-content/40 hover:text-primary transition-colors"
>
<i class="ph-duotone ph-copy text-lg"></i>
</button>
</div> </div>
<div class="label py-0.5">
<span class="label-text-alt opacity-40 italic text-xs">
Must match provider's callback URL
</span>
</div>
</div>
<div class="form-control">
<label htmlFor="scope" class="label py-1">
<span class="label-text">Scope</span>
</label>
<input <input
type="text" type="text"
x-model="tenantId" id="scope"
x-bind:readonly="isTenantLocked" x-model="form.scope"
placeholder="Tenant ID" placeholder="public"
class="input join-item input-sm bg-transparent border-none focus:outline-none flex-1 lg:flex-none lg:w-48 text-xs font-mono transition-opacity" class="input input-bordered w-full focus:input-primary"
x-bind:class="isTenantLocked ? 'opacity-60 cursor-default' : ''"
/> />
</div>
<div class="card-actions pt-4">
<button <button
type="submit" type="submit"
class="btn btn-sm join-item px-4" class="btn btn-primary w-full shadow-md"
x-bind:class="isTenantLocked ? 'btn-neutral' : 'btn-secondary'" x-bind:disabled="loading"
x-bind:title="isTenantLocked ? 'Edit Tenant ID' : 'Apply Tenant ID'"
> >
<i <i class="ph ph-plus-bold mr-1"></i>
class="text-lg" Save Configuration
x-bind:class="isTenantLocked ? 'ph-thin ph-pencil-simple' : 'ph-bold ph-check'"
></i>
</button> </button>
</form> </div>
</form>
</div>
</div>
<div class="card bg-base-100 shadow-xl border border-base-300 lg:col-span-8 overflow-hidden">
<div class="card-body p-0">
<div class="p-6 pb-4 flex justify-between items-center bg-base-100">
<div class="flex items-center gap-2">
<div class="w-2 h-6 bg-primary rounded-full"></div>
<h2 class="card-title text-xl font-semibold">Provider Registry</h2>
</div>
<button <button
x-on:click="logout(); document.getElementById('mobile-menu').checked = false;"
type="button" type="button"
class="btn btn-ghost text-error hover:bg-error/10 gap-2 w-full lg:w-auto lg:btn-sm px-4 justify-start lg:justify-center" x-on:click="fetchProviders()"
x-bind:disabled="loading" class="btn btn-sm btn-base"
x-bind:disabled="!isUnlocked || loading"
> >
<i class="ph-bold ph-power text-lg"></i> <i x-bind:class="loading ? 'ph ph-arrows-clockwise animate-spin mr-1' : 'ph ph-arrows-clockwise mr-1'"></i>
<span class="font-bold uppercase tracking-wider text-xs">Logout</span> Refresh List
</button> </button>
</div> </div>
</template>
</div>
<div
class="fixed inset-0 bg-black/50 z-40 hidden peer-checked:block lg:hidden"
></div>
</div>
<div class="container mx-auto p-4 md:p-8 max-w-7xl"> <div class="relative min-h-[400px]">
<div class="grid grid-cols-1 lg:grid-cols-12 gap-6 md:gap-8"> <div
<div class="card bg-base-100 shadow-xl border border-base-300 lg:col-span-4 self-start"> x-show="loading && providers.length > 0"
<div class="card-body p-6"> class="absolute inset-0 bg-base-100/50 backdrop-blur-md z-10 flex items-center justify-center"
<div class="flex items-center gap-2 mb-4"> >
<i class="ph-duotone ph-shield-plus text-2xl text-primary mb-1"></i> <span class="loading loading-spinner loading-lg text-primary"></span>
<div class="w-1 h-6 bg-primary/50 rounded-full"></div>
<h2 class="card-title text-xl font-semibold">Configure Provider</h2>
</div> </div>
<form x-on:submit="saveConfig" class="space-y-4"> <div x-show="!isUnlocked" class="p-20 text-center opacity-30">
<div class="form-control"> <div class="flex flex-col items-center gap-3">
<label htmlFor="providerName" class="label py-1"> <i class="ph ph-lock-key text-6xl"></i>
<span class="label-text flex items-center gap-2"> <p class="font-medium">Enter Master API Key to access registry</p>
Provider ID
<span
class="tooltip tooltip-top before:text-left"
data-tip="Internal name for this service. This will define your login URL (e.g. /auth/trakt/login)."
>
<i class="ph ph-info opacity-50 cursor-help"></i>
</span>
</span>
</label>
<input
type="text"
id="providerName"
x-model="form.providerName"
placeholder="e.g. trakt"
required
class="input input-bordered w-full focus:input-primary"
/>
</div> </div>
<div class="divider text-xs opacity-50 my-2 uppercase tracking-widest">
Credentials
</div>
<div class="form-control">
<label htmlFor="clientId" class="label py-1">
<span class="label-text flex items-center gap-2">
Client ID
<span
class="tooltip tooltip-top before:text-left"
data-tip="Found in the 'API' or 'Developer' section of the provider. Sometimes called 'App ID' or 'Consumer Key'."
>
<i class="ph ph-info opacity-50 cursor-help text-xs"></i>
</span>
</span>
</label>
<input
type="text"
id="clientId"
x-model="form.clientId"
placeholder="OAuth client id"
required
class="input input-bordered w-full focus:input-primary"
/>
</div>
<div class="form-control" x-data="{ show: false }">
<label htmlFor="clientSecret" class="label py-1">
<span class="label-text flex items-center gap-2">
Client Secret
<span
class="tooltip tooltip-top before:text-left"
data-tip="Found next to the Client ID. This is your private key—never share it or put it in client-side code."
>
<i class="ph ph-info opacity-50 cursor-help text-xs"></i>
</span>
</span>
</label>
<div class="relative">
<input
x-bind:type="show ? 'text' : 'password'"
id="clientSecret"
x-model="form.clientSecret"
placeholder="OAuth client secret"
required
class="input input-bordered w-full focus:input-primary pr-12"
/>
<button
type="button"
x-on:click="show = !show"
class="absolute right-3 top-1/2 -translate-y-1/2 btn btn-ghost btn-xs btn-square"
>
<i x-bind:class="show ? 'ph-duotone ph-eye-slash text-lg opacity-40' : 'ph-duotone ph-eye text-lg opacity-40'"></i>
</button>
</div>
</div>
<div class="divider text-xs opacity-50 my-2 uppercase tracking-widest">
Endpoints
</div>
<div class="form-control">
<label htmlFor="authUrl" class="label py-1">
<span class="label-text flex items-center gap-2">
Auth URL
<span
class="tooltip tooltip-top before:text-left"
data-tip="The page where users click 'Authorize'. Usually found in OAuth2 docs under 'Endpoints' or 'Authorize'."
>
<i class="ph ph-info opacity-50 cursor-help text-xs"></i>
</span>
</span>
</label>
<input
type="url"
id="authUrl"
x-model="form.authUrl"
placeholder="https://trakt.tv/oauth/authorize"
required
class="input input-bordered w-full focus:input-primary"
/>
</div>
<div class="form-control">
<label htmlFor="tokenUrl" class="label py-1">
<span class="label-text flex items-center gap-2">
Token URL
<span
class="tooltip tooltip-top before:text-left"
data-tip="The background API used to trade the code for a token. Usually ends in '/token' or '/access_token'."
>
<i class="ph ph-info opacity-50 cursor-help text-xs"></i>
</span>
</span>
</label>
<input
type="url"
id="tokenUrl"
x-model="form.tokenUrl"
placeholder="https://api.trakt.tv/oauth/token"
required
class="input input-bordered w-full focus:input-primary"
/>
</div>
<div class="form-control">
<label htmlFor="redirectUri" class="label py-1">
<span class="label-text flex items-center gap-2">
Redirect URI
<span
class="tooltip tooltip-top before:text-left"
data-tip="The provider will redirect the code to this URI. Copy this URL and paste it into the 'Redirect URI' or 'Callback URL' field in your OAuth provider's settings."
>
<i class="ph ph-info opacity-50 cursor-help text-xs"></i>
</span>
</span>
</label>
<div class="relative group">
<input
type="url"
id="redirectUri"
x-bind:value="getRedirectUri()"
readonly
class="input input-bordered w-full pr-12 focus:outline-none cursor-default opacity-80"
/>
<button
type="button"
x-on:click="copyToClipboard(getRedirectUri())"
class="btn btn-ghost btn-xs absolute right-2 top-1/2 -translate-y-1/2 text-base-content/40 hover:text-primary transition-colors"
>
<i class="ph-duotone ph-copy text-lg"></i>
</button>
</div>
<div class="label py-0.5">
<span class="label-text-alt opacity-40 italic text-xs">
Must match provider's callback URL
</span>
</div>
</div>
<div class="form-control">
<label htmlFor="scope" class="label py-1">
<span class="label-text flex items-center gap-2">
Scope
<span
class="tooltip tooltip-top before:text-left"
data-tip="Determines what data you're allowed to access. Multiple scopes are usually space-separated."
>
<i class="ph ph-info opacity-50 cursor-help text-xs"></i>
</span>
</span>
</label>
<input
type="text"
id="scope"
x-model="form.scope"
placeholder="public"
class="input input-bordered w-full focus:input-primary"
/>
</div>
<div class="card-actions pt-4">
<button
type="submit"
class="btn btn-primary w-full shadow-md"
x-bind:disabled="loading"
>
<i class="ph ph-plus-bold mr-1"></i>
Save Configuration
</button>
</div>
</form>
</div>
</div>
<div class="card bg-base-100 shadow-xl border border-base-300 lg:col-span-8 overflow-hidden">
<div class="card-body p-0">
<div class="p-6 pb-4 flex justify-between items-center bg-base-100">
<div class="flex items-center gap-2">
<i class="ph-duotone ph-shipping-container text-2xl text-primary"></i>
<div class="w-1 h-6 bg-primary/50 rounded-full"></div>
<h2 class="card-title text-xl font-semibold">Provider Registry</h2>
</div>
<button
type="button"
x-on:click="fetchProviders()"
class="btn btn-sm btn-neutral"
x-bind:disabled="!isUnlocked || loading"
>
<i x-bind:class="loading ? 'ph ph-arrows-clockwise animate-spin mr-1' : 'ph ph-arrows-clockwise mr-1'"></i>
Refresh List
</button>
</div> </div>
<div class="relative min-h-[400px]"> <div
<div x-show="isUnlocked && providers.length === 0 && !loading"
x-show="loading && providers.length > 0" class="p-20 text-center opacity-30"
class="absolute inset-0 bg-base-100/50 backdrop-blur-md z-10 flex items-center justify-center" >
> <div class="flex flex-col items-center gap-3">
<span class="loading loading-spinner loading-lg text-primary"></span> <i class="ph ph-folder-open text-6xl"></i>
<p class="font-medium">No providers configured yet</p>
</div> </div>
</div>
<div x-show="!isUnlocked" class="p-20 text-center opacity-30"> <div
<div class="flex flex-col items-center gap-3"> x-show="isUnlocked && providers.length > 0"
<i class="ph ph-lock-key text-6xl"></i> class="p-6 grid grid-cols-1 md:grid-cols-2 gap-4"
<p class="font-medium">Enter Master API Key to access registry</p> >
</div> <template x-for="provider in providers" x-bind:key="provider.name">
</div> <div class="card bg-base-200/50 border border-base-300 shadow-sm hover:shadow-md transition-all group">
<div class="card-body p-5">
<div <div class="flex flex-col mb-4">
x-show="isUnlocked && providers.length === 0 && !loading" <div class="flex justify-between items-start">
class="p-20 text-center opacity-30"
>
<div class="flex flex-col items-center gap-3">
<i class="ph ph-folder-open text-6xl"></i>
<p class="font-medium">No providers configured yet</p>
</div>
</div>
<div
x-show="isUnlocked && providers.length > 0"
class="p-6 grid grid-cols-1 md:grid-cols-2 gap-4"
>
<template x-for="provider in providers" x-bind:key="provider.name">
<div class="card bg-base-200/50 border border-base-300 shadow-sm hover:shadow-md transition-all group">
<div class="card-body p-5">
<div class="flex flex-col mb-4">
<div class="flex justify-between items-start">
<span
x-text="provider.name"
class="text-lg font-black text-base-content/90 uppercase"
></span>
<button
type="button"
x-on:click="deleteProvider(provider.name)"
class="btn btn-error btn-xs mt-1 opacity-0 group-hover:opacity-40 transition-all duration-300"
title="Delete Provider"
>
<i class="ph-bold ph-trash text-lg"></i>
</button>
</div>
<span <span
x-text="provider.config.clientId" x-text="provider.name"
x-bind:title="provider.config.clientId" class="text-lg font-black text-base-content/90 uppercase"
class="text-xs opacity-40 truncate font-mono"
></span> ></span>
</div>
<div class="space-y-4">
<div x-data="{ show: false }">
<div class="text-xs uppercase font-semibold opacity-30 block mb-1">
Access Token
</div>
<div
x-show="provider.status.accessToken"
class="flex items-center gap-2 bg-base-100 rounded border border-base-300 p-1 pl-3"
>
<input
x-bind:type="show ? 'text' : 'password'"
x-bind:value="provider.status.accessToken"
readonly
class="bg-transparent border-none outline-none shadow-none focus:ring-0 text-xs flex-1 min-w-0 font-mono"
/>
<div class="flex gap-1">
<button
type="button"
x-on:click="show = !show"
class="btn btn-ghost btn-xs btn-square"
>
<i x-bind:class="show ? 'ph-duotone ph-eye-slash text-base opacity-50' : 'ph-duotone ph-eye text-base opacity-50'"></i>
</button>
<button
type="button"
x-on:click="copyToClipboard(provider.status.accessToken)"
class="btn btn-ghost btn-xs btn-square"
>
<i class="ph-duotone ph-copy-simple text-base opacity-50"></i>
</button>
</div>
</div>
<div
x-show="!provider.status.accessToken"
class="h-8 flex items-center px-3 bg-base-300/30 rounded text-xs italic opacity-40"
>
Not Authenticated
</div>
</div>
<div x-data="{ show: false }">
<div class="text-xs uppercase font-semibold opacity-30 block mb-1">
Refresh Token
</div>
<div
x-show="provider.status.refreshToken"
class="flex items-center gap-2 bg-base-100 rounded border border-base-300 p-1 pl-3"
>
<input
x-bind:type="show ? 'text' : 'password'"
x-bind:value="provider.status.refreshToken"
readonly
class="bg-transparent border-none outline-none shadow-none focus:ring-0 text-xs flex-1 min-w-0 font-mono"
/>
<div class="flex gap-1">
<button
type="button"
x-on:click="show = !show"
class="btn btn-ghost btn-xs btn-square"
>
<i x-bind:class="show ? 'ph-duotone ph-eye-slash text-base opacity-50' : 'ph-duotone ph-eye text-base opacity-50'"></i>
</button>
<button
type="button"
x-on:click="copyToClipboard(provider.status.refreshToken)"
class="btn btn-ghost btn-xs btn-square"
>
<i class="ph-duotone ph-copy-simple text-base opacity-50"></i>
</button>
</div>
</div>
<div
x-show="!provider.status.refreshToken"
class="h-8 flex items-center px-3 bg-base-300/30 rounded text-xs italic opacity-40"
>
Not Authenticated
</div>
</div>
</div>
<div class="divider my-3 opacity-10"></div>
<div
x-show="provider.status.accessToken"
class="grid grid-cols-2 gap-4 mb-5"
>
<div class="p-1 flex flex-col gap-0.5">
<span class="text-xxs font-bold opacity-20 uppercase tracking-wide">
Last Updated
</span>
<span
x-text="formatTime(provider.status.lastUpdated)"
class="text-xs text-secondary/75 font-bold font-mono tracking-wider opacity-60"
></span>
</div>
<div class="p-1 flex flex-col gap-0.5 items-end text-right">
<span class="text-xxs font-bold opacity-20 uppercase tracking-widest">
Expires In
</span>
<span
x-text="formatExpiry(provider.status.expiresAt)"
x-bind:class="isExpired(provider.status.expiresAt) ? 'text-error' : 'text-primary'"
class="text-xs font-bold font-mono tracking-wide"
></span>
</div>
</div>
<div class="flex flex-col gap-2">
<div class="grid grid-cols-2 gap-2">
<button
type="button"
x-on:click={`window.open('${AUTH_PREFIX}/' + provider.name + '/login?tenantId=' + encodeURIComponent(tenantId), '_blank')`}
class="btn btn-primary btn-sm"
>
<i class="ph-bold ph-link"></i> Connect
</button>
<button
type="button"
x-on:click="editProvider(provider)"
class="btn btn-neutral btn-sm"
>
<i class="ph-bold ph-pencil-simple"></i> Edit
</button>
</div>
<button <button
type="button" type="button"
x-on:click="forceRefresh(provider.name)" x-on:click="deleteProvider(provider.name)"
class="btn btn-secondary w-full" class="btn btn-error btn-xs mt-1 opacity-0 group-hover:opacity-100 transition-all duration-300"
x-bind:disabled="loading || !provider.status.accessToken" title="Delete Provider"
> >
<i class="ph-bold ph-arrows-clockwise text-base mr-1"></i> <i class="ph-bold ph-trash text-lg"></i>
<span class="text-xs uppercase font-bold tracking-widest">
Refresh Tokens
</span>
</button> </button>
</div> </div>
<span
x-text="provider.config.clientId"
x-bind:title="provider.config.clientId"
class="text-xs opacity-40 truncate font-mono"
></span>
</div>
<div class="space-y-4">
<div x-data="{ show: false }">
<div class="text-xs uppercase font-semibold opacity-30 block mb-1">
Access Token
</div>
<div
x-show="provider.status.accessToken"
class="flex items-center gap-2 bg-base-100 rounded border border-base-300 p-1 pl-3"
>
<input
x-bind:type="show ? 'text' : 'password'"
x-bind:value="provider.status.accessToken"
readonly
class="bg-transparent border-none outline-none shadow-none focus:ring-0 text-xs flex-1 min-w-0 font-mono"
/>
<div class="flex gap-1">
<button
type="button"
x-on:click="show = !show"
class="btn btn-ghost btn-xs btn-square"
>
<i x-bind:class="show ? 'ph-duotone ph-eye-slash text-base opacity-50' : 'ph-duotone ph-eye text-base opacity-50'"></i>
</button>
<button
type="button"
x-on:click="copyToClipboard(provider.status.accessToken)"
class="btn btn-ghost btn-xs btn-square"
>
<i class="ph-duotone ph-copy-simple text-base opacity-50"></i>
</button>
</div>
</div>
<div
x-show="!provider.status.accessToken"
class="h-8 flex items-center px-3 bg-base-300/30 rounded text-xs italic opacity-40"
>
Not Authenticated
</div>
</div>
<div x-data="{ show: false }">
<div class="text-xs uppercase font-semibold opacity-30 block mb-1">
Refresh Token
</div>
<div
x-show="provider.status.refreshToken"
class="flex items-center gap-2 bg-base-100 rounded border border-base-300 p-1 pl-3"
>
<input
x-bind:type="show ? 'text' : 'password'"
x-bind:value="provider.status.refreshToken"
readonly
class="bg-transparent border-none outline-none shadow-none focus:ring-0 text-xs flex-1 min-w-0 font-mono"
/>
<div class="flex gap-1">
<button
type="button"
x-on:click="show = !show"
class="btn btn-ghost btn-xs btn-square"
>
<i x-bind:class="show ? 'ph-duotone ph-eye-slash text-base opacity-50' : 'ph-duotone ph-eye text-base opacity-50'"></i>
</button>
<button
type="button"
x-on:click="copyToClipboard(provider.status.refreshToken)"
class="btn btn-ghost btn-xs btn-square"
>
<i class="ph-duotone ph-copy-simple text-base opacity-50"></i>
</button>
</div>
</div>
<div
x-show="!provider.status.refreshToken"
class="h-8 flex items-center px-3 bg-base-300/30 rounded text-xs italic opacity-40"
>
Not Authenticated
</div>
</div>
</div>
<div class="divider my-3 opacity-10"></div>
<div class="flex justify-between items-center mb-4">
<span class="text-xs font-semibold opacity-30 uppercase">Last Updated</span>
<span
x-text="formatTime(provider.status.lastUpdated)"
class="text-xs font-medium opacity-60"
></span>
</div>
<div class="flex flex-col gap-2">
<div class="grid grid-cols-2 gap-2">
<button
type="button"
x-on:click={`window.open('${AUTH_PREFIX}/' + provider.name + '/login', '_blank')`}
class="btn btn-primary btn-sm"
>
<i class="ph-bold ph-link"></i> Connect
</button>
<button
type="button"
x-on:click="editProvider(provider)"
class="btn btn-secondary btn-sm"
>
<i class="ph-bold ph-pencil-simple"></i> Edit
</button>
</div>
<button
type="button"
x-on:click="forceRefresh(provider.name)"
class="btn btn-base w-full"
x-bind:disabled="loading || !provider.status.accessToken"
>
<i class="ph-bold ph-arrows-clockwise text-base mr-1"></i>
<span class="text-xs uppercase font-bold tracking-widest">
Refresh Tokens
</span>
</button>
</div> </div>
</div> </div>
</template> </div>
</div> </template>
</div> </div>
</div> </div>
</div> </div>
+1 -1
View File
@@ -1,2 +1,2 @@
export const API_VERSION = "v1"; export const API_VERSION = "v1";
export const APP_VERSION = "1.1"; export const APP_VERSION = "1.0";
+3 -45
View File
@@ -1,12 +1,4 @@
document.addEventListener("alpine:init", () => { document.addEventListener("alpine:init", () => {
const formatDate = (date) => {
return date.toLocaleDateString("en-US", {
month: "short",
day: "2-digit",
year: "numeric",
});
};
const formatTime = (timestamp) => { const formatTime = (timestamp) => {
if (!timestamp) return "Never"; if (!timestamp) return "Never";
const date = new Date(timestamp); const date = new Date(timestamp);
@@ -15,27 +7,13 @@ document.addEventListener("alpine:init", () => {
if (diff < 60) return "Just now"; if (diff < 60) return "Just now";
if (diff < 3600) return `${Math.floor(diff / 60)}m ago`; if (diff < 3600) return `${Math.floor(diff / 60)}m ago`;
if (diff < 86400) return `${Math.floor(diff / 3600)}h ago`; if (diff < 86400) return `${Math.floor(diff / 3600)}h ago`;
return formatDate(date); return date.toLocaleDateString();
};
const formatExpiry = (timestamp) => {
if (!timestamp) return "Expired";
const date = new Date(timestamp);
const diff = Math.floor((date - Date.now()) / 1000);
if (diff <= 0) return "Expired";
if (diff < 60) return `${diff}s`;
if (diff < 3600) return `${Math.floor(diff / 60)}m`;
if (diff < 86400) return `${Math.floor(diff / 3600)}h`;
return `${formatDate(date)}`;
}; };
window.Alpine.data( window.Alpine.data(
"dashboard", "dashboard",
({ initialIsUnlocked, apiPrefix, authPrefix, docsPrefix, apiVersion, appVersion }) => ({ ({ initialIsUnlocked, apiPrefix, authPrefix, docsPrefix, apiVersion, appVersion }) => ({
apiKey: "", apiKey: "",
tenantId: localStorage.getItem("toknd_tenant_id") || "default",
isTenantLocked: !!localStorage.getItem("toknd_tenant_id"),
isUnlocked: initialIsUnlocked, isUnlocked: initialIsUnlocked,
apiPrefix, apiPrefix,
authPrefix, authPrefix,
@@ -59,9 +37,6 @@ document.addEventListener("alpine:init", () => {
}, },
init() { init() {
this.$watch("tenantId", (val) => {
localStorage.setItem("toknd_tenant_id", val);
});
if (this.isUnlocked) { if (this.isUnlocked) {
this.fetchProviders(); this.fetchProviders();
} }
@@ -109,9 +84,7 @@ document.addEventListener("alpine:init", () => {
try { try {
const [configRes, statusRes] = await Promise.all([ const [configRes, statusRes] = await Promise.all([
fetch(`${this.apiPrefix}/config`), fetch(`${this.apiPrefix}/config`),
fetch(`${this.apiPrefix}/status`, { fetch(`${this.apiPrefix}/status`),
headers: { "x-tenant-id": this.tenantId },
}),
]); ]);
if (configRes.status === 401 || statusRes.status === 401) { if (configRes.status === 401 || statusRes.status === 401) {
@@ -133,12 +106,7 @@ document.addEventListener("alpine:init", () => {
return Object.entries(config).map(([name, cfg]) => ({ return Object.entries(config).map(([name, cfg]) => ({
name, name,
config: cfg, config: cfg,
status: status[name] || { status: status[name] || { accessToken: null, refreshToken: null, lastUpdated: null },
accessToken: null,
refreshToken: null,
lastUpdated: null,
expiresAt: null,
},
})); }));
}, },
@@ -187,7 +155,6 @@ document.addEventListener("alpine:init", () => {
try { try {
const res = await fetch(`${this.apiPrefix}/refresh/${name}`, { const res = await fetch(`${this.apiPrefix}/refresh/${name}`, {
method: "POST", method: "POST",
headers: { "x-tenant-id": this.tenantId },
}); });
if (res.status === 401) { if (res.status === 401) {
@@ -267,15 +234,6 @@ document.addEventListener("alpine:init", () => {
formatTime(timestamp) { formatTime(timestamp) {
return formatTime(timestamp); return formatTime(timestamp);
}, },
formatExpiry(timestamp) {
return formatExpiry(timestamp);
},
isExpired(timestamp) {
if (!timestamp) return true;
return new Date(timestamp) < new Date();
},
}), }),
); );
}); });
+9 -30
View File
@@ -1,17 +1,18 @@
// @ts-nocheck
import { describe, expect, it, mock } from "bun:test"; import { describe, expect, it, mock } from "bun:test";
import { ConfigManager } from "../../src/core/ConfigManager"; import { ConfigManager } from "../../src/core/ConfigManager";
describe("ConfigManager", () => { describe("ConfigManager", () => {
it("should save and retrieve provider configuration", async () => { it("should save and retrieve provider configuration", async () => {
const storage: Record<string, string> = {}; const storage = {};
const redis = { const redis = {
set: mock((key: string, val: string) => { set: mock((key, val) => {
storage[key] = val; storage[key] = val;
return Promise.resolve(); return Promise.resolve();
}), }),
get: mock((key: string) => Promise.resolve(storage[key] || null)), get: mock((key) => Promise.resolve(storage[key] || null)),
}; };
const manager = new ConfigManager(redis as any); const manager = new ConfigManager(redis);
const traktConfig = { const traktConfig = {
clientId: "trakt-client-id", clientId: "trakt-client-id",
clientSecret: "trakt-client-secret", clientSecret: "trakt-client-secret",
@@ -23,14 +24,14 @@ describe("ConfigManager", () => {
await manager.setProviderConfig("trakt", traktConfig); await manager.setProviderConfig("trakt", traktConfig);
const retrieved = await manager.getProviderConfig("trakt"); const retrieved = await manager.getProviderConfig("trakt");
expect(retrieved).toEqual(traktConfig as any); expect(retrieved).toEqual(traktConfig);
expect(redis.set).toHaveBeenCalled(); expect(redis.set).toHaveBeenCalled();
}); });
it("should return all providers", async () => { it("should return all providers", async () => {
const redis = { const redis = {
keys: mock(() => Promise.resolve(["config:trakt", "config:github"])), keys: mock(() => Promise.resolve(["config:trakt", "config:github"])),
get: mock((key: string) => get: mock((key) =>
Promise.resolve( Promise.resolve(
JSON.stringify({ JSON.stringify({
clientId: `${key}-id`, clientId: `${key}-id`,
@@ -42,7 +43,7 @@ describe("ConfigManager", () => {
), ),
), ),
}; };
const manager = new ConfigManager(redis as any); const manager = new ConfigManager(redis);
const providers = await manager.getAllProviders(); const providers = await manager.getAllProviders();
@@ -52,32 +53,10 @@ describe("ConfigManager", () => {
it("should return null for non-existent provider", async () => { it("should return null for non-existent provider", async () => {
const redis = { get: mock(() => Promise.resolve(null)) }; const redis = { get: mock(() => Promise.resolve(null)) };
const manager = new ConfigManager(redis as any); const manager = new ConfigManager(redis);
const config = await manager.getProviderConfig("missing-provider"); const config = await manager.getProviderConfig("missing-provider");
expect(config).toBeNull(); expect(config).toBeNull();
}); });
it("should delete provider configuration and all tenant tokens", async () => {
const redis = {
del: mock(() => Promise.resolve()),
keys: mock(() =>
Promise.resolve([
"tenant:1:provider:trakt:access_token",
"tenant:2:provider:trakt:access_token",
]),
),
};
const manager = new ConfigManager(redis as any);
await manager.deleteProviderConfig("trakt");
expect(redis.del).toHaveBeenCalledWith("config:trakt");
expect(redis.keys).toHaveBeenCalledWith("tenant:*:provider:trakt:*");
expect(redis.del).toHaveBeenCalledWith(
"tenant:1:provider:trakt:access_token",
"tenant:2:provider:trakt:access_token",
);
});
}); });
+12 -28
View File
@@ -1,17 +1,15 @@
// @ts-nocheck
import { describe, expect, it, mock } from "bun:test"; import { describe, expect, it, mock } from "bun:test";
import { TokenManager } from "../../src/core/TokenManager"; import { TokenManager } from "../../src/core/TokenManager";
describe("TokenManager", () => { describe("TokenManager", () => {
const tenantId = "test-tenant";
it("should return token from redis if available", async () => { it("should return token from redis if available", async () => {
const redis = { get: mock(() => Promise.resolve("active-access-token")) }; const redis = { get: mock(() => Promise.resolve("active-access-token")) };
const manager = new TokenManager(redis as any, {} as any); const manager = new TokenManager(redis, {});
const token = await manager.getAccessToken(tenantId, "trakt"); const token = await manager.getAccessToken("trakt");
expect(token).toBe("active-access-token"); expect(token).toBe("active-access-token");
expect(redis.get).toHaveBeenCalledWith(`tenant:${tenantId}:provider:trakt:access_token`);
}); });
it("should refresh token if access token is missing but refresh token exists", async () => { it("should refresh token if access token is missing but refresh token exists", async () => {
@@ -28,26 +26,19 @@ describe("TokenManager", () => {
}), }),
), ),
}; };
const manager = new TokenManager(redis as any, provider as any); const manager = new TokenManager(redis, provider);
const token = await manager.getAccessToken(tenantId, "trakt"); const token = await manager.getAccessToken("trakt");
expect(token).toBe("newly-refreshed-access-token"); expect(token).toBe("newly-refreshed-access-token");
expect(redis.get).toHaveBeenCalledWith(`tenant:${tenantId}:provider:trakt:access_token`); expect(redis.set).toHaveBeenCalled();
expect(redis.get).toHaveBeenCalledWith(`tenant:${tenantId}:provider:trakt:refresh_token`);
expect(redis.set).toHaveBeenCalledWith(
`tenant:${tenantId}:provider:trakt:access_token`,
"newly-refreshed-access-token",
"EX",
3600,
);
}); });
it("should return null if no tokens are found", async () => { it("should return null if no tokens are found", async () => {
const redis = { get: mock(() => Promise.resolve(null)) }; const redis = { get: mock(() => Promise.resolve(null)) };
const manager = new TokenManager(redis as any, {} as any); const manager = new TokenManager(redis, {});
const token = await manager.getAccessToken(tenantId, "trakt"); const token = await manager.getAccessToken("trakt");
expect(token).toBeNull(); expect(token).toBeNull();
}); });
@@ -66,26 +57,19 @@ describe("TokenManager", () => {
}), }),
), ),
}; };
const manager = new TokenManager(redis as any, provider as any); const manager = new TokenManager(redis, provider);
const token = await manager.refreshAccessToken(tenantId, "trakt"); const token = await manager.refreshAccessToken("trakt");
expect(token).toBe("manually-refreshed-access-token"); expect(token).toBe("manually-refreshed-access-token");
expect(redis.get).toHaveBeenCalledWith(`tenant:${tenantId}:provider:trakt:refresh_token`);
expect(provider.refreshToken).toHaveBeenCalledWith("existing-refresh-token"); expect(provider.refreshToken).toHaveBeenCalledWith("existing-refresh-token");
expect(redis.set).toHaveBeenCalledWith(
`tenant:${tenantId}:provider:trakt:access_token`,
"manually-refreshed-access-token",
"EX",
3600,
);
}); });
it("should return null in refreshAccessToken if no refresh token is found", async () => { it("should return null in refreshAccessToken if no refresh token is found", async () => {
const redis = { get: mock(() => Promise.resolve(null)) }; const redis = { get: mock(() => Promise.resolve(null)) };
const manager = new TokenManager(redis as any, {} as any); const manager = new TokenManager(redis, {});
const token = await manager.refreshAccessToken(tenantId, "trakt"); const token = await manager.refreshAccessToken("trakt");
expect(token).toBeNull(); expect(token).toBeNull();
}); });
+60 -35
View File
@@ -1,3 +1,4 @@
// @ts-nocheck
import { describe, expect, it, spyOn } from "bun:test"; import { describe, expect, it, spyOn } from "bun:test";
import { API_PREFIX } from "../../src/constants"; import { API_PREFIX } from "../../src/constants";
import { redis } from "../../src/core/RedisClient"; import { redis } from "../../src/core/RedisClient";
@@ -12,8 +13,6 @@ describe("API Integration", () => {
scope: "public", scope: "public",
}); });
const tenantId = "test-tenant";
it("should return 401 if API Key is missing", async () => { it("should return 401 if API Key is missing", async () => {
const res = await app.request(`${API_PREFIX}/status`); const res = await app.request(`${API_PREFIX}/status`);
@@ -31,7 +30,7 @@ describe("API Integration", () => {
}); });
it("should return 503 for health check if redis is down", async () => { it("should return 503 for health check if redis is down", async () => {
(redis as any).status = "connecting"; redis.status = "connecting";
const res = await app.request("/health"); const res = await app.request("/health");
const body = await res.json(); const body = await res.json();
@@ -41,31 +40,18 @@ describe("API Integration", () => {
expect(body.redis).toBe("connecting"); expect(body.redis).toBe("connecting");
}); });
it("should return 400 if X-Tenant-ID is missing", async () => { it("should return 200 for status with valid API Key", async () => {
const res = await app.request(`${API_PREFIX}/status`, { redis.keys.mockReturnValue(Promise.resolve(["config:trakt"]));
headers: { redis.get.mockImplementation((key) => {
Authorization: "Bearer test-api-key",
},
});
expect(res.status).toBe(400);
});
it("should return 200 for status with valid API Key and X-Tenant-ID", async () => {
(redis.keys as any).mockReturnValue(Promise.resolve(["config:trakt"]));
(redis.get as any).mockImplementation((key) => {
if (key.includes("config")) return Promise.resolve(mockTraktConfig); if (key.includes("config")) return Promise.resolve(mockTraktConfig);
if (key.includes(`tenant:${tenantId}:provider:trakt:access_token`)) if (key.includes("access_token")) return Promise.resolve("current-access-token");
return Promise.resolve("current-access-token"); if (key.includes("refresh_token")) return Promise.resolve("current-refresh-token");
if (key.includes(`tenant:${tenantId}:provider:trakt:refresh_token`))
return Promise.resolve("current-refresh-token");
return Promise.resolve(null); return Promise.resolve(null);
}); });
const res = await app.request(`${API_PREFIX}/status`, { const res = await app.request(`${API_PREFIX}/status`, {
headers: { headers: {
Authorization: "Bearer test-api-key", Authorization: "Bearer test-api-key",
"X-Tenant-ID": tenantId,
}, },
}); });
@@ -73,35 +59,76 @@ describe("API Integration", () => {
const body = await res.json(); const body = await res.json();
expect(body.trakt).toBeDefined(); expect(body.trakt).toBeDefined();
expect(body.trakt.accessToken).toBe("current-access-token"); expect(body.trakt.accessToken).toBe("current-access-token");
expect(redis.get).toHaveBeenCalledWith(`tenant:${tenantId}:provider:trakt:access_token`);
}); });
it("should return token for a configured provider with X-Tenant-ID", async () => { it("should return 200 for status with valid Cookie", async () => {
(redis.get as any).mockImplementation((key) => { redis.keys.mockReturnValue(Promise.resolve(["config:trakt"]));
redis.get.mockImplementation((key) => {
if (key.includes("config")) return Promise.resolve(mockTraktConfig);
if (key.includes("access_token")) return Promise.resolve("current-access-token");
return Promise.resolve(null);
});
const res = await app.request(`${API_PREFIX}/status`, {
headers: {
Cookie: "toknd_api_key=test-api-key",
},
});
expect(res.status).toBe(200);
const body = await res.json();
expect(body.trakt).toBeDefined();
});
it("should return 404 for unknown provider token", async () => {
const res = await app.request(`${API_PREFIX}/token/unconfigured-provider`, {
headers: {
Authorization: "Bearer test-api-key",
},
});
expect(res.status).toBe(404);
});
it("should return token for a configured provider", async () => {
redis.get.mockImplementation((key) => {
if (key.includes("config:trakt")) return Promise.resolve(mockTraktConfig); if (key.includes("config:trakt")) return Promise.resolve(mockTraktConfig);
if (key.includes(`tenant:${tenantId}:provider:trakt:access_token`)) if (key.includes("access_token")) return Promise.resolve("trakt-active-token");
return Promise.resolve("trakt-active-token");
return Promise.resolve(null); return Promise.resolve(null);
}); });
const res = await app.request(`${API_PREFIX}/token/trakt`, { const res = await app.request(`${API_PREFIX}/token/trakt`, {
headers: { headers: {
Authorization: "Bearer test-api-key", Authorization: "Bearer test-api-key",
"X-Tenant-ID": tenantId,
}, },
}); });
expect(res.status).toBe(200); expect(res.status).toBe(200);
const body = await res.json(); const body = await res.json();
expect(body.access_token).toBe("trakt-active-token"); expect(body.access_token).toBe("trakt-active-token");
expect(redis.get).toHaveBeenCalledWith(`tenant:${tenantId}:provider:trakt:access_token`);
}); });
it("should successfully refresh a token with X-Tenant-ID", async () => { it("should return 404 if no access token is in redis for a valid provider", async () => {
(redis.get as any).mockImplementation((key) => { redis.get.mockImplementation((key) => {
if (key.includes("config:trakt")) return Promise.resolve(mockTraktConfig); if (key.includes("config:trakt")) return Promise.resolve(mockTraktConfig);
if (key.includes(`tenant:${tenantId}:provider:trakt:refresh_token`)) return Promise.resolve(null);
return Promise.resolve("old-refresh-token"); });
const res = await app.request(`${API_PREFIX}/token/trakt`, {
headers: {
Authorization: "Bearer test-api-key",
},
});
expect(res.status).toBe(404);
const body = await res.json();
expect(body.error).toContain("No tokens found");
});
it("should successfully refresh a token", async () => {
redis.get.mockImplementation((key) => {
if (key.includes("config:trakt")) return Promise.resolve(mockTraktConfig);
if (key.includes("refresh_token")) return Promise.resolve("old-refresh-token");
return Promise.resolve("new-access-token-from-refresh"); return Promise.resolve("new-access-token-from-refresh");
}); });
@@ -114,14 +141,13 @@ describe("API Integration", () => {
refresh_token: "new-refresh-token-from-fetch", refresh_token: "new-refresh-token-from-fetch",
expires_in: 3600, expires_in: 3600,
}), }),
} as any), }),
); );
const res = await app.request(`${API_PREFIX}/refresh/trakt`, { const res = await app.request(`${API_PREFIX}/refresh/trakt`, {
method: "POST", method: "POST",
headers: { headers: {
Authorization: "Bearer test-api-key", Authorization: "Bearer test-api-key",
"X-Tenant-ID": tenantId,
}, },
}); });
@@ -129,6 +155,5 @@ describe("API Integration", () => {
const body = await res.json(); const body = await res.json();
expect(body.success).toBe(true); expect(body.success).toBe(true);
expect(body.status.accessToken).toBe("new-access-token-from-refresh"); expect(body.status.accessToken).toBe("new-access-token-from-refresh");
expect(redis.get).toHaveBeenCalledWith(`tenant:${tenantId}:provider:trakt:refresh_token`);
}); });
}); });
+13 -23
View File
@@ -1,3 +1,4 @@
// @ts-nocheck
import { describe, expect, it, spyOn } from "bun:test"; import { describe, expect, it, spyOn } from "bun:test";
import { AUTH_PREFIX } from "../../src/constants"; import { AUTH_PREFIX } from "../../src/constants";
import { redis } from "../../src/core/RedisClient"; import { redis } from "../../src/core/RedisClient";
@@ -12,25 +13,21 @@ describe("Auth Integration", () => {
scope: "public", scope: "public",
}); });
const tenantId = "test-tenant"; it("should redirect to provider login", async () => {
redis.get.mockImplementation((key) => {
it("should redirect to provider login with tenantId in state", async () => {
(redis.get as any).mockImplementation((key: string) => {
if (key.includes("config:trakt")) return Promise.resolve(mockProviderConfig); if (key.includes("config:trakt")) return Promise.resolve(mockProviderConfig);
return Promise.resolve(null); return Promise.resolve(null);
}); });
const res = await app.request(`${AUTH_PREFIX}/trakt/login?tenantId=${tenantId}`); const res = await app.request(`${AUTH_PREFIX}/trakt/login`);
expect(res.status).toBe(302); expect(res.status).toBe(302);
const location = res.headers.get("Location") || ""; expect(res.headers.get("Location")).toContain("trakt.tv/oauth/authorize");
expect(location).toContain("trakt.tv/oauth/authorize"); expect(res.headers.get("Location")).toContain("client_id=trakt-client-id");
expect(location).toContain("client_id=trakt-client-id");
expect(location).toContain(`state=${encodeURIComponent(`${tenantId}:trakt`)}`);
}); });
it("should handle callback and exchange code using tenantId from state", async () => { it("should handle callback and exchange code", async () => {
(redis.get as any).mockImplementation((key: string) => { redis.get.mockImplementation((key) => {
if (key.includes("config:trakt")) return Promise.resolve(mockProviderConfig); if (key.includes("config:trakt")) return Promise.resolve(mockProviderConfig);
return Promise.resolve(null); return Promise.resolve(null);
}); });
@@ -44,26 +41,19 @@ describe("Auth Integration", () => {
refresh_token: "exchange-refresh-token", refresh_token: "exchange-refresh-token",
expires_in: 3600, expires_in: 3600,
}), }),
} as any), }),
); );
const res = await app.request( const res = await app.request(`${AUTH_PREFIX}/callback?state=trakt&code=temporary-auth-code`);
`${AUTH_PREFIX}/callback?state=${tenantId}:trakt&code=temporary-auth-code`,
);
expect(res.status).toBe(302); expect(res.status).toBe(302);
expect(res.headers.get("Location")).toBe(`/app/success?provider=trakt&tenantId=${tenantId}`); expect(res.headers.get("Location")).toBe("/app/success?provider=trakt");
expect(redis.set).toHaveBeenCalledWith( expect(redis.set).toHaveBeenCalled();
`tenant:${tenantId}:provider:trakt:access_token`,
"exchange-access-token",
"EX",
3600,
);
expect(fetchSpy).toHaveBeenCalled(); expect(fetchSpy).toHaveBeenCalled();
}); });
it("should return 404 if provider not configured during login", async () => { it("should return 404 if provider not configured during login", async () => {
const res = await app.request(`${AUTH_PREFIX}/unknown-provider/login?tenantId=${tenantId}`); const res = await app.request(`${AUTH_PREFIX}/unknown-provider/login`);
expect(res.status).toBe(404); expect(res.status).toBe(404);
}); });
+5 -7
View File
@@ -1,3 +1,4 @@
// @ts-nocheck
import { describe, expect, it } from "bun:test"; import { describe, expect, it } from "bun:test";
import { API_PREFIX } from "../../src/constants"; import { API_PREFIX } from "../../src/constants";
import { redis } from "../../src/core/RedisClient"; import { redis } from "../../src/core/RedisClient";
@@ -5,8 +6,8 @@ import { app } from "../../src/index";
describe("Config Integration", () => { describe("Config Integration", () => {
it("should list all configured providers", async () => { it("should list all configured providers", async () => {
(redis.keys as any).mockReturnValue(Promise.resolve(["config:trakt"])); redis.keys.mockReturnValue(Promise.resolve(["config:trakt"]));
(redis.get as any).mockImplementation(() => redis.get.mockImplementation(() =>
Promise.resolve( Promise.resolve(
JSON.stringify({ JSON.stringify({
clientId: "trakt-client-id", clientId: "trakt-client-id",
@@ -72,8 +73,7 @@ describe("Config Integration", () => {
expect(res.status).toBe(400); expect(res.status).toBe(400);
}); });
it("should delete a provider configuration and clean up all tenant tokens", async () => { it("should delete a provider configuration", async () => {
(redis.keys as any).mockReturnValue(Promise.resolve(["tenant:1:provider:trakt:token"]));
const res = await app.request(`${API_PREFIX}/config/trakt`, { const res = await app.request(`${API_PREFIX}/config/trakt`, {
method: "DELETE", method: "DELETE",
headers: { headers: {
@@ -82,8 +82,6 @@ describe("Config Integration", () => {
}); });
expect(res.status).toBe(200); expect(res.status).toBe(200);
expect(redis.del).toHaveBeenCalledWith("config:trakt"); expect(redis.del).toHaveBeenCalled();
expect(redis.keys).toHaveBeenCalledWith("tenant:*:provider:trakt:*");
expect(redis.del).toHaveBeenCalledWith("tenant:1:provider:trakt:token");
}); });
}); });
+3 -5
View File
@@ -1,3 +1,4 @@
// @ts-nocheck
import { describe, expect, it } from "bun:test"; import { describe, expect, it } from "bun:test";
import { API_PREFIX } from "../../src/constants"; import { API_PREFIX } from "../../src/constants";
import { redis } from "../../src/core/RedisClient"; import { redis } from "../../src/core/RedisClient";
@@ -22,15 +23,12 @@ describe("Dashboard & Common Integration", () => {
}); });
it("should return 500 for internal errors", async () => { it("should return 500 for internal errors", async () => {
(redis.keys as any).mockImplementationOnce(() => { redis.keys.mockImplementationOnce(() => {
throw new Error("Redis Crash"); throw new Error("Redis Crash");
}); });
const res = await app.request(`${API_PREFIX}/status`, { const res = await app.request(`${API_PREFIX}/status`, {
headers: { headers: { Authorization: "Bearer test-api-key" },
Authorization: "Bearer test-api-key",
"X-Tenant-ID": "test-tenant",
},
}); });
expect(res.status).toBe(500); expect(res.status).toBe(500);