@chaaskit/server 0.1.0

package/dist/oauth/server.js

@@ -0,0 +1,410 @@
+/**
+ * OAuth 2.1 Server Implementation
+ *
+ * Implements OAuth 2.1 with PKCE for MCP client authentication.
+ * Supports:
+ * - Dynamic client registration (RFC 7591)
+ * - Authorization code flow with PKCE
+ * - Token refresh
+ * - Token revocation
+ */
+import crypto from 'crypto';
+import bcrypt from 'bcryptjs';
+import { db } from '@chaaskit/db';
+import { getConfig } from '../config/loader.js';
+// =============================================================================
+// Helpers
+// =============================================================================
+/**
+ * Generate a cryptographically secure random string
+ */
+function generateSecureToken(length = 32) {
+    return crypto.randomBytes(length).toString('hex');
+}
+/**
+ * Hash a token for storage
+ */
+function hashToken(token) {
+    return crypto.createHash('sha256').update(token).digest('hex');
+}
+/**
+ * Verify PKCE code challenge
+ */
+function verifyCodeChallenge(codeVerifier, codeChallenge, method) {
+    if (method === 'S256') {
+        const hash = crypto.createHash('sha256').update(codeVerifier).digest();
+        const computed = hash
+            .toString('base64')
+            .replace(/\+/g, '-')
+            .replace(/\//g, '_')
+            .replace(/=/g, '');
+        return computed === codeChallenge;
+    }
+    // Plain method (not recommended but supported)
+    return codeVerifier === codeChallenge;
+}
+/**
+ * Get OAuth configuration with defaults
+ */
+function getOAuthConfig() {
+    const config = getConfig();
+    const oauthConfig = config.mcp?.server?.oauth;
+    return {
+        enabled: oauthConfig?.enabled ?? false,
+        allowDynamicRegistration: oauthConfig?.allowDynamicRegistration ?? false,
+        accessTokenTTLSeconds: oauthConfig?.accessTokenTTLSeconds ?? 3600,
+        refreshTokenTTLSeconds: oauthConfig?.refreshTokenTTLSeconds ?? 30 * 24 * 60 * 60, // 30 days
+    };
+}
+// =============================================================================
+// Client Registration
+// =============================================================================
+/**
+ * Register a new OAuth client (RFC 7591 Dynamic Client Registration)
+ */
+export async function registerClient(registration) {
+    const oauthConfig = getOAuthConfig();
+    if (!oauthConfig.allowDynamicRegistration) {
+        throw new Error('Dynamic client registration is not enabled');
+    }
+    // Generate client credentials
+    const clientId = `mcp_${generateSecureToken(16)}`;
+    const clientSecret = generateSecureToken(32);
+    // Determine auth method
+    const tokenEndpointAuthMethod = registration.token_endpoint_auth_method || 'none';
+    const needsSecret = tokenEndpointAuthMethod !== 'none';
+    // Create client in database
+    await db.oAuthClient.create({
+        data: {
+            clientId,
+            clientSecretHash: needsSecret ? await bcrypt.hash(clientSecret, 10) : null,
+            clientName: registration.client_name,
+            clientUri: registration.client_uri,
+            redirectUris: JSON.stringify(registration.redirect_uris),
+            grantTypes: JSON.stringify(registration.grant_types || ['authorization_code', 'refresh_token']),
+            responseTypes: JSON.stringify(registration.response_types || ['code']),
+            tokenEndpointAuth: tokenEndpointAuthMethod,
+            isActive: true,
+        },
+    });
+    console.log(`[OAuth] Registered new client: ${registration.client_name} (${clientId})`);
+    return {
+        client_id: clientId,
+        client_secret: needsSecret ? clientSecret : undefined,
+        client_name: registration.client_name,
+        redirect_uris: registration.redirect_uris,
+        grant_types: registration.grant_types || ['authorization_code', 'refresh_token'],
+        response_types: registration.response_types || ['code'],
+        token_endpoint_auth_method: tokenEndpointAuthMethod,
+        client_uri: registration.client_uri,
+    };
+}
+// =============================================================================
+// Authorization Code
+// =============================================================================
+/**
+ * Generate an authorization code for the OAuth flow
+ */
+export async function generateAuthorizationCode(params) {
+    const { clientId, userId, redirectUri, scope, codeChallenge, codeChallengeMethod } = params;
+    // Verify client exists
+    const client = await db.oAuthClient.findUnique({
+        where: { clientId },
+    });
+    if (!client || !client.isActive) {
+        throw new Error('Invalid client');
+    }
+    // Verify redirect URI
+    const allowedRedirectUris = JSON.parse(client.redirectUris);
+    if (!allowedRedirectUris.includes(redirectUri)) {
+        throw new Error('Invalid redirect URI');
+    }
+    // Generate authorization code
+    const code = generateSecureToken(32);
+    // Store in database (expires in 10 minutes)
+    await db.oAuthAuthorizationCode.create({
+        data: {
+            code,
+            clientId: client.id,
+            userId,
+            redirectUri,
+            scope,
+            codeChallenge,
+            codeChallengeMethod: codeChallengeMethod || 'S256',
+            expiresAt: new Date(Date.now() + 10 * 60 * 1000),
+        },
+    });
+    console.log(`[OAuth] Generated auth code for user ${userId}, client ${clientId}`);
+    return code;
+}
+// =============================================================================
+// Token Exchange
+// =============================================================================
+/**
+ * Exchange an authorization code for tokens
+ */
+export async function exchangeCodeForTokens(params) {
+    const { code, clientId, redirectUri, codeVerifier } = params;
+    const oauthConfig = getOAuthConfig();
+    // Find the authorization code
+    const authCode = await db.oAuthAuthorizationCode.findUnique({
+        where: { code },
+        include: {
+            client: true,
+        },
+    });
+    if (!authCode) {
+        throw new Error('Invalid authorization code');
+    }
+    // Verify code hasn't expired
+    if (authCode.expiresAt < new Date()) {
+        await db.oAuthAuthorizationCode.delete({ where: { id: authCode.id } });
+        throw new Error('Authorization code expired');
+    }
+    // Verify code hasn't been used
+    if (authCode.usedAt) {
+        throw new Error('Authorization code already used');
+    }
+    // Verify client
+    if (authCode.client.clientId !== clientId) {
+        throw new Error('Client mismatch');
+    }
+    // Verify redirect URI
+    if (authCode.redirectUri !== redirectUri) {
+        throw new Error('Redirect URI mismatch');
+    }
+    // Verify PKCE code verifier
+    if (!verifyCodeChallenge(codeVerifier, authCode.codeChallenge, authCode.codeChallengeMethod)) {
+        throw new Error('Invalid code verifier');
+    }
+    // Mark code as used
+    await db.oAuthAuthorizationCode.update({
+        where: { id: authCode.id },
+        data: { usedAt: new Date() },
+    });
+    // Generate tokens
+    const accessToken = generateSecureToken(32);
+    const refreshToken = generateSecureToken(32);
+    const accessTokenExpiresAt = new Date(Date.now() + oauthConfig.accessTokenTTLSeconds * 1000);
+    const refreshTokenExpiresAt = new Date(Date.now() + oauthConfig.refreshTokenTTLSeconds * 1000);
+    // Store tokens
+    await db.oAuthToken.create({
+        data: {
+            tokenHash: hashToken(accessToken),
+            refreshTokenHash: hashToken(refreshToken),
+            clientId: authCode.client.id,
+            userId: authCode.userId,
+            scope: authCode.scope,
+            expiresAt: accessTokenExpiresAt,
+            refreshExpiresAt: refreshTokenExpiresAt,
+        },
+    });
+    console.log(`[OAuth] Issued tokens for user ${authCode.userId}, client ${clientId}`);
+    return {
+        access_token: accessToken,
+        token_type: 'Bearer',
+        expires_in: oauthConfig.accessTokenTTLSeconds,
+        refresh_token: refreshToken,
+        scope: authCode.scope || undefined,
+    };
+}
+/**
+ * Refresh an access token
+ */
+export async function refreshAccessToken(params) {
+    const { refreshToken, clientId } = params;
+    const oauthConfig = getOAuthConfig();
+    const refreshTokenHash = hashToken(refreshToken);
+    // Find the token
+    const token = await db.oAuthToken.findUnique({
+        where: { refreshTokenHash },
+        include: {
+            client: true,
+        },
+    });
+    if (!token) {
+        throw new Error('Invalid refresh token');
+    }
+    // Verify client
+    if (token.client.clientId !== clientId) {
+        throw new Error('Client mismatch');
+    }
+    // Verify token isn't revoked
+    if (token.revokedAt) {
+        throw new Error('Token has been revoked');
+    }
+    // Verify refresh token hasn't expired
+    if (token.refreshExpiresAt && token.refreshExpiresAt < new Date()) {
+        throw new Error('Refresh token expired');
+    }
+    // Generate new access token (keep same refresh token)
+    const newAccessToken = generateSecureToken(32);
+    const accessTokenExpiresAt = new Date(Date.now() + oauthConfig.accessTokenTTLSeconds * 1000);
+    // Update token record
+    await db.oAuthToken.update({
+        where: { id: token.id },
+        data: {
+            tokenHash: hashToken(newAccessToken),
+            expiresAt: accessTokenExpiresAt,
+        },
+    });
+    console.log(`[OAuth] Refreshed token for user ${token.userId}, client ${clientId}`);
+    return {
+        access_token: newAccessToken,
+        token_type: 'Bearer',
+        expires_in: oauthConfig.accessTokenTTLSeconds,
+        scope: token.scope || undefined,
+    };
+}
+// =============================================================================
+// Token Revocation
+// =============================================================================
+/**
+ * Revoke a token
+ */
+export async function revokeToken(params) {
+    const { token, tokenTypeHint } = params;
+    const tokenHash = hashToken(token);
+    // Try to find by access token hash
+    let oauthToken = await db.oAuthToken.findUnique({
+        where: { tokenHash },
+    });
+    // If not found and hint is refresh_token, try refresh token hash
+    if (!oauthToken && tokenTypeHint === 'refresh_token') {
+        oauthToken = await db.oAuthToken.findUnique({
+            where: { refreshTokenHash: tokenHash },
+        });
+    }
+    // If still not found, try refresh token hash anyway
+    if (!oauthToken) {
+        oauthToken = await db.oAuthToken.findUnique({
+            where: { refreshTokenHash: tokenHash },
+        });
+    }
+    if (oauthToken && !oauthToken.revokedAt) {
+        await db.oAuthToken.update({
+            where: { id: oauthToken.id },
+            data: { revokedAt: new Date() },
+        });
+        console.log(`[OAuth] Revoked token for user ${oauthToken.userId}`);
+    }
+}
+/**
+ * Revoke all tokens for a client-user pair
+ */
+export async function revokeAllTokensForClient(clientId, userId) {
+    const client = await db.oAuthClient.findUnique({
+        where: { clientId },
+    });
+    if (!client) {
+        return;
+    }
+    await db.oAuthToken.updateMany({
+        where: {
+            clientId: client.id,
+            userId,
+            revokedAt: null,
+        },
+        data: { revokedAt: new Date() },
+    });
+    console.log(`[OAuth] Revoked all tokens for user ${userId}, client ${clientId}`);
+}
+// =============================================================================
+// Token Validation
+// =============================================================================
+/**
+ * Validate an access token and return token info
+ */
+export async function validateAccessToken(accessToken) {
+    const tokenHash = hashToken(accessToken);
+    const token = await db.oAuthToken.findUnique({
+        where: { tokenHash },
+        include: {
+            client: true,
+        },
+    });
+    if (!token) {
+        return null;
+    }
+    // Check if expired
+    if (token.expiresAt < new Date()) {
+        return null;
+    }
+    // Check if revoked
+    if (token.revokedAt) {
+        return null;
+    }
+    // Check if client is still active
+    if (!token.client.isActive) {
+        return null;
+    }
+    return {
+        userId: token.userId,
+        clientId: token.client.clientId,
+        scope: token.scope || undefined,
+        expiresAt: token.expiresAt,
+    };
+}
+// =============================================================================
+// Client Management
+// =============================================================================
+/**
+ * Get OAuth apps authorized by a user
+ */
+export async function getAuthorizedApps(userId) {
+    // Find all active tokens for this user
+    const tokens = await db.oAuthToken.findMany({
+        where: {
+            userId,
+            revokedAt: null,
+        },
+        include: {
+            client: true,
+        },
+        orderBy: {
+            createdAt: 'desc',
+        },
+    });
+    // Group by client (use most recent token per client)
+    const clientMap = new Map();
+    for (const token of tokens) {
+        if (!clientMap.has(token.client.clientId)) {
+            clientMap.set(token.client.clientId, {
+                clientId: token.client.clientId,
+                clientName: token.client.clientName,
+                clientUri: token.client.clientUri || undefined,
+                scope: token.scope || undefined,
+                authorizedAt: token.createdAt,
+            });
+        }
+    }
+    return Array.from(clientMap.values());
+}
+// =============================================================================
+// Server Metadata
+// =============================================================================
+/**
+ * Get OAuth 2.0 Authorization Server Metadata (RFC 8414)
+ */
+export function getAuthorizationServerMetadata() {
+    const config = getConfig();
+    const oauthConfig = getOAuthConfig();
+    const apiUrl = process.env.API_URL || 'http://localhost:3000';
+    const metadata = {
+        issuer: apiUrl,
+        authorization_endpoint: `${apiUrl}/oauth/authorize`,
+        token_endpoint: `${apiUrl}/oauth/token`,
+        revocation_endpoint: `${apiUrl}/oauth/revoke`,
+        response_types_supported: ['code'],
+        grant_types_supported: ['authorization_code', 'refresh_token'],
+        token_endpoint_auth_methods_supported: ['none', 'client_secret_basic', 'client_secret_post'],
+        code_challenge_methods_supported: ['S256'],
+        scopes_supported: ['mcp:tools', 'mcp:resources'],
+    };
+    // Add registration endpoint if enabled
+    if (oauthConfig.allowDynamicRegistration) {
+        metadata.registration_endpoint = `${apiUrl}/oauth/register`;
+    }
+    return metadata;
+}
+//# sourceMappingURL=server.js.map

package/dist/oauth/server.js.map

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

package/dist/queue/cli.js

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+/**
+ * Standalone Queue Worker CLI
+ *
+ * Runs queue workers as a separate process from the main server.
+ * Useful for:
+ * - Scaling workers independently from web servers
+ * - Running workers on dedicated compute (e.g., ECS tasks, K8s jobs)
+ * - Separating concerns in production deployments
+ *
+ * Usage:
+ *   pnpm queue-worker
+ *
+ * Environment variables:
+ *   QUEUE_CONCURRENCY - Number of concurrent job processors (default: 5)
+ *   QUEUE_POLL_INTERVAL - Fallback poll interval in ms (default: 1000)
+ *   QUEUE_SHUTDOWN_TIMEOUT - Graceful shutdown timeout in ms (default: 30000)
+ *   SCHEDULER_ENABLED - Enable the scheduler (default: false)
+ *   SCHEDULER_POLL_INTERVAL - Scheduler poll interval in ms (default: 60000)
+ */
+import 'dotenv/config';
+import { loadConfigAsync, getConfig } from '../config/loader.js';
+import { initializeQueueProvider, closeQueueProvider, getQueueProvider, startWorker, stopWorker, startScheduler, stopScheduler, } from './index.js';
+// Parse environment variables
+const concurrency = parseInt(process.env.QUEUE_CONCURRENCY || '5', 10);
+const pollInterval = parseInt(process.env.QUEUE_POLL_INTERVAL || '1000', 10);
+const shutdownTimeout = parseInt(process.env.QUEUE_SHUTDOWN_TIMEOUT || '30000', 10);
+const schedulerEnabled = process.env.SCHEDULER_ENABLED === 'true';
+const schedulerPollInterval = parseInt(process.env.SCHEDULER_POLL_INTERVAL || '60000', 10);
+async function main() {
+    console.log('[Queue Worker] Starting standalone worker...');
+    console.log(`[Queue Worker] Concurrency: ${concurrency}`);
+    console.log(`[Queue Worker] Scheduler: ${schedulerEnabled ? 'enabled' : 'disabled'}`);
+    // Load application config
+    await loadConfigAsync();
+    const config = getConfig();
+    if (!config.queue?.enabled) {
+        console.error('[Queue Worker] Queue system is disabled in config');
+        process.exit(1);
+    }
+    // Initialize queue provider
+    await initializeQueueProvider(config.queue);
+    const provider = getQueueProvider();
+    // Start worker
+    const workerConfig = {
+        mode: 'standalone',
+        concurrency,
+        pollInterval,
+        shutdownTimeout,
+    };
+    console.log('[Queue Worker] Starting worker...');
+    await startWorker({ provider, config: workerConfig });
+    console.log('[Queue Worker] Worker started');
+    // Start scheduler if enabled
+    if (schedulerEnabled || config.queue.scheduler?.enabled) {
+        const schedulerConfig = {
+            enabled: true,
+            pollInterval: schedulerPollInterval,
+        };
+        console.log('[Queue Worker] Starting scheduler...');
+        await startScheduler({ provider, config: schedulerConfig });
+        console.log('[Queue Worker] Scheduler started');
+    }
+    // Setup graceful shutdown
+    let isShuttingDown = false;
+    const shutdown = async (signal) => {
+        if (isShuttingDown) {
+            console.log('[Queue Worker] Forced shutdown');
+            process.exit(1);
+        }
+        isShuttingDown = true;
+        console.log(`[Queue Worker] Received ${signal}, shutting down...`);
+        try {
+            await stopScheduler();
+            await stopWorker();
+            await closeQueueProvider();
+            console.log('[Queue Worker] Shutdown complete');
+            process.exit(0);
+        }
+        catch (error) {
+            console.error('[Queue Worker] Error during shutdown:', error);
+            process.exit(1);
+        }
+    };
+    process.on('SIGINT', () => shutdown('SIGINT'));
+    process.on('SIGTERM', () => shutdown('SIGTERM'));
+    console.log('[Queue Worker] Ready and waiting for jobs...');
+}
+main().catch((error) => {
+    console.error('[Queue Worker] Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/queue/cli.js.map

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

package/dist/queue/handlers/index.js

@@ -0,0 +1,91 @@
+/**
+ * Job Handler Registry
+ *
+ * Provides a central registry for job handlers. Job handlers are functions
+ * that process jobs of a specific type.
+ *
+ * @example
+ * ```typescript
+ * import { registerJobHandler } from './queue/handlers/index.js';
+ *
+ * registerJobHandler('email:send', async (job, ctx) => {
+ *   ctx.log('Sending email to', job.payload.to);
+ *   await sendEmail(job.payload);
+ * });
+ * ```
+ */
+// Registry of job handlers by type
+const handlers = new Map();
+/**
+ * Register a handler for a specific job type.
+ *
+ * @param type - The job type to handle (e.g., 'email:send', 'report:generate')
+ * @param handler - The function that processes jobs of this type
+ * @param description - Optional description for debugging/monitoring
+ */
+export function registerJobHandler(type, handler, description) {
+    if (handlers.has(type)) {
+        console.warn(`[Queue] Overwriting existing handler for job type: ${type}`);
+    }
+    handlers.set(type, {
+        handler: handler,
+        description,
+    });
+    console.log(`[Queue] Registered handler for job type: ${type}${description ? ` (${description})` : ''}`);
+}
+/**
+ * Get the handler for a specific job type.
+ *
+ * @param type - The job type
+ * @returns The registered handler, or undefined if not found
+ */
+export function getJobHandler(type) {
+    return handlers.get(type);
+}
+/**
+ * Check if a handler exists for a specific job type.
+ *
+ * @param type - The job type
+ * @returns True if a handler is registered
+ */
+export function hasJobHandler(type) {
+    return handlers.has(type);
+}
+/**
+ * Get all registered job types.
+ *
+ * @returns Array of registered job type strings
+ */
+export function getRegisteredJobTypes() {
+    return Array.from(handlers.keys());
+}
+/**
+ * Unregister a handler (mainly for testing).
+ *
+ * @param type - The job type to unregister
+ */
+export function unregisterJobHandler(type) {
+    return handlers.delete(type);
+}
+/**
+ * Clear all handlers (mainly for testing).
+ */
+export function clearJobHandlers() {
+    handlers.clear();
+}
+/**
+ * Execute a job using its registered handler.
+ *
+ * @param job - The job to execute
+ * @param ctx - The job context
+ * @returns The result from the handler
+ * @throws Error if no handler is registered for the job type
+ */
+export async function executeJob(job, ctx) {
+    const registered = handlers.get(job.type);
+    if (!registered) {
+        throw new Error(`No handler registered for job type: ${job.type}`);
+    }
+    return registered.handler(job, ctx);
+}
+//# sourceMappingURL=index.js.map

package/dist/queue/handlers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/queue/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AASH,mCAAmC;AACnC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA6B,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,OAAsC,EACtC,WAAoB;IAEpB,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC,sDAAsD,IAAI,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE;QACjB,OAAO,EAAE,OAAqB;QAC9B,WAAW;KACZ,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,4CAA4C,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,KAAK,WAAW,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC3G,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAA0B,EAC1B,GAAe;IAEf,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAE1C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,uCAAuC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAqB,CAAC;AAC1D,CAAC"}