@vorionsys/security 1.0.0

package/dist/api/versioning/backward-compat.js

@@ -0,0 +1,161 @@
+/**
+ * Backward Compatibility Plugin
+ *
+ * Provides redirects and aliases from legacy unversioned routes
+ * to the new versioned routes. This allows clients to migrate gradually.
+ *
+ * @packageDocumentation
+ */
+import fp from 'fastify-plugin';
+import { createLogger } from '../../common/logger.js';
+import { CURRENT_VERSION, getVersionedPrefix } from './index.js';
+const compatLogger = createLogger({ component: 'api-backward-compat' });
+/**
+ * Legacy routes that should be redirected to versioned equivalents
+ */
+const LEGACY_ROUTES = [
+    // Intent routes
+    { method: 'POST', path: '/intents', target: '/intents' },
+    { method: 'GET', path: '/intents', target: '/intents' },
+    { method: 'GET', path: '/intents/:id', target: '/intents/:id' },
+    { method: 'DELETE', path: '/intents/:id', target: '/intents/:id' },
+    { method: 'POST', path: '/intents/:id/cancel', target: '/intents/:id/cancel' },
+    { method: 'GET', path: '/intents/:id/verify', target: '/intents/:id/verify' },
+    { method: 'POST', path: '/intents/:id/replay', target: '/intents/:id/replay' },
+    { method: 'GET', path: '/intents/:id/escalation', target: '/intents/:id/escalation' },
+    { method: 'POST', path: '/intents/bulk', target: '/intents/bulk' },
+    // Escalation routes
+    { method: 'GET', path: '/escalations', target: '/escalations' },
+    { method: 'GET', path: '/escalations/:id', target: '/escalations/:id' },
+    { method: 'POST', path: '/escalations/:id/acknowledge', target: '/escalations/:id/acknowledge' },
+    { method: 'POST', path: '/escalations/:id/approve', target: '/escalations/:id/approve' },
+    { method: 'POST', path: '/escalations/:id/reject', target: '/escalations/:id/reject' },
+    { method: 'POST', path: '/escalations/:id/assign', target: '/escalations/:id/assign' },
+    { method: 'DELETE', path: '/escalations/:id/assign/:userId', target: '/escalations/:id/assign/:userId' },
+    { method: 'GET', path: '/escalations/:id/approvers', target: '/escalations/:id/approvers' },
+    // Audit routes
+    { method: 'GET', path: '/audit', target: '/audit' },
+    { method: 'GET', path: '/audit/:id', target: '/audit/:id' },
+    { method: 'GET', path: '/audit/target/:targetType/:targetId', target: '/audit/target/:targetType/:targetId' },
+    { method: 'GET', path: '/audit/trace/:traceId', target: '/audit/trace/:traceId' },
+    { method: 'GET', path: '/audit/stats', target: '/audit/stats' },
+    { method: 'POST', path: '/audit/verify', target: '/audit/verify' },
+    // Policy routes
+    { method: 'POST', path: '/policies', target: '/policies' },
+    { method: 'GET', path: '/policies', target: '/policies' },
+    { method: 'GET', path: '/policies/:id', target: '/policies/:id' },
+    { method: 'PUT', path: '/policies/:id', target: '/policies/:id' },
+    { method: 'POST', path: '/policies/:id/publish', target: '/policies/:id/publish' },
+    { method: 'POST', path: '/policies/:id/deprecate', target: '/policies/:id/deprecate' },
+    { method: 'POST', path: '/policies/:id/archive', target: '/policies/:id/archive' },
+    { method: 'DELETE', path: '/policies/:id', target: '/policies/:id' },
+    // Webhook routes
+    { method: 'POST', path: '/webhooks', target: '/webhooks' },
+    { method: 'GET', path: '/webhooks', target: '/webhooks' },
+    { method: 'DELETE', path: '/webhooks/:id', target: '/webhooks/:id' },
+    { method: 'GET', path: '/webhooks/:id/deliveries', target: '/webhooks/:id/deliveries' },
+    // GDPR routes
+    { method: 'POST', path: '/intent/gdpr/export', target: '/intent/gdpr/export' },
+    { method: 'GET', path: '/intent/gdpr/export/:requestId', target: '/intent/gdpr/export/:requestId' },
+    { method: 'GET', path: '/intent/gdpr/export/:requestId/download', target: '/intent/gdpr/export/:requestId/download' },
+    { method: 'DELETE', path: '/intent/gdpr/data', target: '/intent/gdpr/data' },
+    // Admin routes
+    { method: 'POST', path: '/admin/cleanup', target: '/admin/cleanup' },
+    { method: 'POST', path: '/admin/dlq/:jobId/retry', target: '/admin/dlq/:jobId/retry' },
+    { method: 'POST', path: '/admin/users/:userId/revoke-tokens', target: '/admin/users/:userId/revoke-tokens' },
+    // Auth routes
+    { method: 'POST', path: '/auth/logout', target: '/auth/logout' },
+    // Proof routes
+    { method: 'GET', path: '/proofs/:id', target: '/proofs/:id' },
+    { method: 'POST', path: '/proofs/:id/verify', target: '/proofs/:id/verify' },
+    // Trust routes
+    { method: 'GET', path: '/trust/:entityId', target: '/trust/:entityId' },
+    // Constraint routes
+    { method: 'POST', path: '/constraints/validate', target: '/constraints/validate' },
+];
+/**
+ * Build redirect URL preserving path parameters and query string
+ */
+function buildRedirectUrl(request, legacyPath, targetPath, legacyBasePath) {
+    const versionedPrefix = getVersionedPrefix(CURRENT_VERSION);
+    // Extract the actual path after the base path
+    const urlPath = request.url.split('?')[0];
+    const queryString = request.url.includes('?') ? request.url.slice(request.url.indexOf('?')) : '';
+    // Replace the legacy base path with versioned prefix
+    const newPath = urlPath.replace(legacyBasePath, versionedPrefix);
+    return newPath + queryString;
+}
+/**
+ * Backward Compatibility Plugin
+ *
+ * Registers redirect routes from legacy unversioned paths to versioned paths.
+ * Adds deprecation warning headers to encourage migration.
+ */
+const backwardCompatPluginAsync = async (fastify, opts) => {
+    const { enableRedirects = true, logLegacyUsage = true, redirectStatusCode = 307, legacyBasePath = '/api', } = opts;
+    if (!enableRedirects) {
+        compatLogger.info('Backward compatibility redirects disabled');
+        return;
+    }
+    const versionedPrefix = getVersionedPrefix(CURRENT_VERSION);
+    // Create redirect handler factory
+    const createRedirectHandler = (legacyPath, targetPath) => {
+        return async (request, reply) => {
+            const redirectUrl = buildRedirectUrl(request, legacyPath, targetPath, legacyBasePath);
+            if (logLegacyUsage) {
+                compatLogger.warn({
+                    legacyPath: request.url,
+                    redirectTo: redirectUrl,
+                    method: request.method,
+                    ip: request.ip,
+                    userAgent: request.headers['user-agent'],
+                }, 'Legacy unversioned API route used - redirecting to versioned route');
+            }
+            // Add deprecation headers
+            reply.header('Deprecation', 'true');
+            reply.header('Sunset', '2025-12-31'); // Set appropriate sunset date
+            reply.header('Link', `<${redirectUrl}>; rel="successor-version"`);
+            reply.header('Warning', `299 - "This endpoint is deprecated. Please use ${versionedPrefix} prefix for all API calls."`);
+            return reply.redirect(redirectUrl, redirectStatusCode);
+        };
+    };
+    // Register all legacy route redirects
+    for (const route of LEGACY_ROUTES) {
+        const legacyFullPath = `${legacyBasePath}${route.path}`;
+        // Skip if route matches versioned pattern
+        if (route.path.startsWith('/v')) {
+            continue;
+        }
+        try {
+            const handler = createRedirectHandler(route.path, route.target);
+            switch (route.method) {
+                case 'GET':
+                    fastify.get(legacyFullPath, handler);
+                    break;
+                case 'POST':
+                    fastify.post(legacyFullPath, handler);
+                    break;
+                case 'PUT':
+                    fastify.put(legacyFullPath, handler);
+                    break;
+                case 'DELETE':
+                    fastify.delete(legacyFullPath, handler);
+                    break;
+            }
+        }
+        catch (error) {
+            // Route may already exist, log and continue
+            compatLogger.debug({ path: legacyFullPath, method: route.method, error }, 'Could not register legacy redirect (route may already exist)');
+        }
+    }
+    compatLogger.info({ routeCount: LEGACY_ROUTES.length, redirectStatusCode }, 'Backward compatibility redirects registered');
+};
+/**
+ * Backward Compatibility Plugin (wrapped with fastify-plugin)
+ */
+export const backwardCompatPlugin = fp(backwardCompatPluginAsync, {
+    name: 'api-backward-compat',
+    fastify: '>=4.x',
+});
+export default backwardCompatPlugin;
+//# sourceMappingURL=backward-compat.js.map

package/dist/api/versioning/backward-compat.js.map

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

package/dist/api/versioning/index.d.ts

@@ -0,0 +1,112 @@
+/**
+ * API Versioning Module
+ *
+ * Provides URL-based API versioning with fallback to Accept header negotiation.
+ * Supports deprecation warnings and version-specific error responses.
+ *
+ * @packageDocumentation
+ */
+import type { FastifyRequest, FastifyPluginAsync } from 'fastify';
+/**
+ * Supported API versions
+ */
+export declare const API_VERSIONS: readonly ["v1"];
+export type ApiVersion = (typeof API_VERSIONS)[number];
+/**
+ * Current (latest) API version
+ */
+export declare const CURRENT_VERSION: ApiVersion;
+/**
+ * Deprecated API versions with sunset dates
+ */
+export declare const DEPRECATED_VERSIONS: Record<string, {
+    sunsetDate: string;
+    message: string;
+}>;
+/**
+ * Version extraction result
+ */
+export interface VersionInfo {
+    version: ApiVersion;
+    source: 'url' | 'header' | 'default';
+    isDeprecated: boolean;
+    deprecationMessage?: string;
+    sunsetDate?: string;
+}
+/**
+ * Versioning plugin options
+ */
+export interface VersioningOptions {
+    /** Default version when none specified (defaults to CURRENT_VERSION) */
+    defaultVersion?: ApiVersion;
+    /** Whether to add deprecation warning headers (defaults to true) */
+    includeDeprecationHeaders?: boolean;
+    /** Custom header name for version negotiation (defaults to Accept) */
+    versionHeader?: string;
+    /** Base path prefix (defaults to /api) */
+    basePath?: string;
+}
+/**
+ * Extract API version from request URL path
+ *
+ * Looks for /api/v{N}/ pattern in the URL
+ */
+export declare function extractVersionFromUrl(url: string): ApiVersion | null;
+/**
+ * Extract API version from Accept header
+ *
+ * Supports formats:
+ * - application/vnd.vorion.v1+json
+ * - application/json; version=v1
+ */
+export declare function extractVersionFromAcceptHeader(acceptHeader: string | undefined): ApiVersion | null;
+/**
+ * Extract version from request using URL-first, then Accept header fallback
+ */
+export declare function extractVersion(request: FastifyRequest, defaultVersion?: ApiVersion): VersionInfo;
+/**
+ * Check if a version is supported
+ */
+export declare function isVersionSupported(version: string): version is ApiVersion;
+/**
+ * Get deprecation warning message for default version usage
+ */
+export declare function getDefaultVersionWarning(): string;
+declare module 'fastify' {
+    interface FastifyRequest {
+        apiVersion?: VersionInfo;
+    }
+}
+/**
+ * API Versioning Plugin (wrapped with fastify-plugin for proper encapsulation)
+ */
+export declare const versioningPlugin: FastifyPluginAsync<VersioningOptions>;
+/**
+ * Version-specific error response generator
+ */
+export interface VersionedError {
+    error: {
+        code: string;
+        message: string;
+        version?: string;
+        deprecationNotice?: string;
+    };
+}
+/**
+ * Create a version-specific error response
+ */
+export declare function createVersionedError(code: string, message: string, versionInfo?: VersionInfo): VersionedError;
+/**
+ * Create unsupported version error response
+ */
+export declare function createUnsupportedVersionError(requestedVersion: string): VersionedError;
+/**
+ * Route prefix generator for versioned routes
+ */
+export declare function getVersionedPrefix(version: ApiVersion): string;
+/**
+ * Check if request is for versioned API
+ */
+export declare function isVersionedRequest(request: FastifyRequest): boolean;
+export default versioningPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/api/versioning/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/versioning/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAmB,cAAc,EAAgB,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAMjG;;GAEG;AACH,eAAO,MAAM,YAAY,iBAAkB,CAAC;AAC5C,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,UAAiB,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAEvF,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,UAAU,CAAC;IACpB,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC;IACrC,YAAY,EAAE,OAAO,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wEAAwE;IACxE,cAAc,CAAC,EAAE,UAAU,CAAC;IAC5B,oEAAoE;IACpE,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAMpE;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,IAAI,CAgBlG;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,cAAc,EACvB,cAAc,GAAE,UAA4B,GAC3C,WAAW,CAeb;AAgBD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,IAAI,UAAU,CAEzE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAIjD;AAGD,OAAO,QAAQ,SAAS,CAAC;IACvB,UAAU,cAAc;QACtB,UAAU,CAAC,EAAE,WAAW,CAAC;KAC1B;CACF;AAsED;;GAEG;AACH,eAAO,MAAM,gBAAgB,uCAG3B,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,WAAW,GACxB,cAAc,CAgBhB;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,gBAAgB,EAAE,MAAM,GAAG,cAAc,CAOtF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAE9D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAEnE;AAED,eAAe,gBAAgB,CAAC"}

package/dist/api/versioning/index.js

@@ -0,0 +1,199 @@
+/**
+ * API Versioning Module
+ *
+ * Provides URL-based API versioning with fallback to Accept header negotiation.
+ * Supports deprecation warnings and version-specific error responses.
+ *
+ * @packageDocumentation
+ */
+import fp from 'fastify-plugin';
+import { createLogger } from '../../common/logger.js';
+const versionLogger = createLogger({ component: 'api-versioning' });
+/**
+ * Supported API versions
+ */
+export const API_VERSIONS = ['v1'];
+/**
+ * Current (latest) API version
+ */
+export const CURRENT_VERSION = 'v1';
+/**
+ * Deprecated API versions with sunset dates
+ */
+export const DEPRECATED_VERSIONS = {
+// Example: 'v0': { sunsetDate: '2025-06-01', message: 'Please migrate to v1' }
+};
+/**
+ * Extract API version from request URL path
+ *
+ * Looks for /api/v{N}/ pattern in the URL
+ */
+export function extractVersionFromUrl(url) {
+    const match = url.match(/\/api\/(v\d+)\//);
+    if (match && API_VERSIONS.includes(match[1])) {
+        return match[1];
+    }
+    return null;
+}
+/**
+ * Extract API version from Accept header
+ *
+ * Supports formats:
+ * - application/vnd.vorion.v1+json
+ * - application/json; version=v1
+ */
+export function extractVersionFromAcceptHeader(acceptHeader) {
+    if (!acceptHeader)
+        return null;
+    // Check for vendor-specific media type: application/vnd.vorion.v1+json
+    const vendorMatch = acceptHeader.match(/application\/vnd\.vorion\.(v\d+)\+json/);
+    if (vendorMatch && API_VERSIONS.includes(vendorMatch[1])) {
+        return vendorMatch[1];
+    }
+    // Check for version parameter: application/json; version=v1
+    const paramMatch = acceptHeader.match(/version=(v\d+)/);
+    if (paramMatch && API_VERSIONS.includes(paramMatch[1])) {
+        return paramMatch[1];
+    }
+    return null;
+}
+/**
+ * Extract version from request using URL-first, then Accept header fallback
+ */
+export function extractVersion(request, defaultVersion = CURRENT_VERSION) {
+    // 1. Try URL-based version (most explicit)
+    const urlVersion = extractVersionFromUrl(request.url);
+    if (urlVersion) {
+        return createVersionInfo(urlVersion, 'url');
+    }
+    // 2. Try Accept header (fallback for version negotiation)
+    const headerVersion = extractVersionFromAcceptHeader(request.headers.accept);
+    if (headerVersion) {
+        return createVersionInfo(headerVersion, 'header');
+    }
+    // 3. Default to latest version (with deprecation warning recommended)
+    return createVersionInfo(defaultVersion, 'default');
+}
+/**
+ * Create version info object with deprecation details
+ */
+function createVersionInfo(version, source) {
+    const deprecation = DEPRECATED_VERSIONS[version];
+    return {
+        version,
+        source,
+        isDeprecated: !!deprecation,
+        deprecationMessage: deprecation?.message,
+        sunsetDate: deprecation?.sunsetDate,
+    };
+}
+/**
+ * Check if a version is supported
+ */
+export function isVersionSupported(version) {
+    return API_VERSIONS.includes(version);
+}
+/**
+ * Get deprecation warning message for default version usage
+ */
+export function getDefaultVersionWarning() {
+    return `API version not specified. Defaulting to ${CURRENT_VERSION}. ` +
+        'For stability, explicitly specify the API version in the URL path (e.g., /api/v1/...) ' +
+        'or via Accept header (application/vnd.vorion.v1+json).';
+}
+/**
+ * API Versioning Plugin
+ *
+ * Adds version extraction and deprecation headers to all requests.
+ * Registers version info on request object for route handlers.
+ */
+const versioningPluginAsync = async (fastify, opts) => {
+    const { defaultVersion = CURRENT_VERSION, includeDeprecationHeaders = true, basePath = '/api', } = opts;
+    // Decorate request with apiVersion property
+    fastify.decorateRequest('apiVersion', null);
+    // Add version extraction hook
+    fastify.addHook('onRequest', async (request, reply) => {
+        // Skip non-API routes (health checks, metrics, etc.)
+        if (!request.url.startsWith(basePath)) {
+            return;
+        }
+        const versionInfo = extractVersion(request, defaultVersion);
+        request.apiVersion = versionInfo;
+        // Add version to response headers
+        reply.header('X-API-Version', versionInfo.version);
+        // Add deprecation headers if applicable
+        if (includeDeprecationHeaders) {
+            if (versionInfo.isDeprecated) {
+                reply.header('Deprecation', 'true');
+                if (versionInfo.sunsetDate) {
+                    reply.header('Sunset', versionInfo.sunsetDate);
+                }
+                reply.header('X-Deprecation-Notice', versionInfo.deprecationMessage ?? 'This API version is deprecated');
+                versionLogger.warn({
+                    version: versionInfo.version,
+                    source: versionInfo.source,
+                    url: request.url,
+                    sunsetDate: versionInfo.sunsetDate,
+                }, 'Deprecated API version used');
+            }
+            // Warn when no version specified (using default)
+            if (versionInfo.source === 'default') {
+                reply.header('Warning', `299 - "${getDefaultVersionWarning()}"`);
+                versionLogger.debug({
+                    defaultVersion: versionInfo.version,
+                    url: request.url,
+                }, 'Request using default API version');
+            }
+        }
+    });
+};
+/**
+ * API Versioning Plugin (wrapped with fastify-plugin for proper encapsulation)
+ */
+export const versioningPlugin = fp(versioningPluginAsync, {
+    name: 'api-versioning',
+    fastify: '>=4.x',
+});
+/**
+ * Create a version-specific error response
+ */
+export function createVersionedError(code, message, versionInfo) {
+    const error = {
+        error: {
+            code,
+            message,
+        },
+    };
+    if (versionInfo) {
+        error.error.version = versionInfo.version;
+        if (versionInfo.isDeprecated) {
+            error.error.deprecationNotice = versionInfo.deprecationMessage;
+        }
+    }
+    return error;
+}
+/**
+ * Create unsupported version error response
+ */
+export function createUnsupportedVersionError(requestedVersion) {
+    return {
+        error: {
+            code: 'UNSUPPORTED_API_VERSION',
+            message: `API version '${requestedVersion}' is not supported. Supported versions: ${API_VERSIONS.join(', ')}`,
+        },
+    };
+}
+/**
+ * Route prefix generator for versioned routes
+ */
+export function getVersionedPrefix(version) {
+    return `/api/${version}`;
+}
+/**
+ * Check if request is for versioned API
+ */
+export function isVersionedRequest(request) {
+    return !!request.apiVersion;
+}
+export default versioningPlugin;
+//# sourceMappingURL=index.js.map

package/dist/api/versioning/index.js.map

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