@uvrn/api 1.0.0

package/dist/middleware/errorHandler.js

@@ -0,0 +1,67 @@
+"use strict";
+/**
+ * Global Error Handler
+ * Handles uncaught errors and formats error responses
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerErrorHandler = registerErrorHandler;
+/**
+ * Register global error handler
+ */
+function registerErrorHandler(server) {
+    server.setErrorHandler((error, request, reply) => {
+        // Log the error
+        request.log.error({
+            err: error,
+            url: request.url,
+            method: request.method
+        }, 'Request error');
+        // Determine status code
+        const statusCode = error.statusCode || 500;
+        // Map error to code
+        let errorCode = 'INTERNAL_ERROR';
+        if (statusCode === 400)
+            errorCode = 'BAD_REQUEST';
+        else if (statusCode === 404)
+            errorCode = 'NOT_FOUND';
+        else if (statusCode === 415)
+            errorCode = 'UNSUPPORTED_MEDIA_TYPE';
+        else if (statusCode === 429)
+            errorCode = 'RATE_LIMIT_EXCEEDED';
+        else if (statusCode === 503)
+            errorCode = 'SERVICE_UNAVAILABLE';
+        // Build error response
+        const errorResponse = {
+            error: {
+                code: errorCode,
+                message: error.message || 'An unexpected error occurred',
+                details: {
+                    statusCode
+                }
+            }
+        };
+        // Don't expose internal error details in production
+        if (process.env.NODE_ENV !== 'production' && error.stack) {
+            errorResponse.error.details = {
+                ...errorResponse.error.details,
+                stack: error.stack
+            };
+        }
+        reply.code(statusCode).send(errorResponse);
+    });
+    // Handle 404 errors
+    server.setNotFoundHandler((request, reply) => {
+        const errorResponse = {
+            error: {
+                code: 'NOT_FOUND',
+                message: `Route ${request.method} ${request.url} not found`,
+                details: {
+                    method: request.method,
+                    url: request.url
+                }
+            }
+        };
+        reply.code(404).send(errorResponse);
+    });
+}
+//# sourceMappingURL=errorHandler.js.map

package/dist/middleware/errorHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandler.js","sourceRoot":"","sources":["../../src/middleware/errorHandler.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAQH,oDAyDC;AA5DD;;GAEG;AACH,SAAgB,oBAAoB,CAAC,MAAuB;IAC1D,MAAM,CAAC,eAAe,CAAC,CAAC,KAAmB,EAAE,OAAuB,EAAE,KAAmB,EAAE,EAAE;QAC3F,gBAAgB;QAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;YAChB,GAAG,EAAE,KAAK;YACV,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,EAAE,eAAe,CAAC,CAAC;QAEpB,wBAAwB;QACxB,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,GAAG,CAAC;QAE3C,oBAAoB;QACpB,IAAI,SAAS,GAAG,gBAAgB,CAAC;QACjC,IAAI,UAAU,KAAK,GAAG;YAAE,SAAS,GAAG,aAAa,CAAC;aAC7C,IAAI,UAAU,KAAK,GAAG;YAAE,SAAS,GAAG,WAAW,CAAC;aAChD,IAAI,UAAU,KAAK,GAAG;YAAE,SAAS,GAAG,wBAAwB,CAAC;aAC7D,IAAI,UAAU,KAAK,GAAG;YAAE,SAAS,GAAG,qBAAqB,CAAC;aAC1D,IAAI,UAAU,KAAK,GAAG;YAAE,SAAS,GAAG,qBAAqB,CAAC;QAE/D,uBAAuB;QACvB,MAAM,aAAa,GAAkB;YACnC,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,8BAA8B;gBACxD,OAAO,EAAE;oBACP,UAAU;iBACX;aACF;SACF,CAAC;QAEF,oDAAoD;QACpD,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YACzD,aAAa,CAAC,KAAK,CAAC,OAAO,GAAG;gBAC5B,GAAG,aAAa,CAAC,KAAK,CAAC,OAAO;gBAC9B,KAAK,EAAE,KAAK,CAAC,KAAK;aACnB,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,oBAAoB;IACpB,MAAM,CAAC,kBAAkB,CAAC,CAAC,OAAuB,EAAE,KAAmB,EAAE,EAAE;QACzE,MAAM,aAAa,GAAkB;YACnC,KAAK,EAAE;gBACL,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,SAAS,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,YAAY;gBAC3D,OAAO,EAAE;oBACP,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,GAAG,EAAE,OAAO,CAAC,GAAG;iBACjB;aACF;SACF,CAAC;QAEF,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/routes/delta.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Delta Engine API Routes
+ * Endpoints for bundle processing, validation, and verification
+ */
+import { FastifyInstance } from 'fastify';
+/**
+ * Register delta engine routes
+ */
+export declare function registerDeltaRoutes(server: FastifyInstance): Promise<void>;
+//# sourceMappingURL=delta.d.ts.map

package/dist/routes/delta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delta.d.ts","sourceRoot":"","sources":["../../src/routes/delta.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AAUxE;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAqGhF"}

package/dist/routes/delta.js

@@ -0,0 +1,97 @@
+"use strict";
+/**
+ * Delta Engine API Routes
+ * Endpoints for bundle processing, validation, and verification
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerDeltaRoutes = registerDeltaRoutes;
+const core_1 = require("@uvrn/core");
+/**
+ * Register delta engine routes
+ */
+async function registerDeltaRoutes(server) {
+    // POST /api/v1/delta/run - Execute engine on bundle
+    server.post('/api/v1/delta/run', async (request, reply) => {
+        try {
+            const bundle = request.body;
+            // Validate bundle schema
+            const validation = (0, core_1.validateBundle)(bundle);
+            if (!validation.valid) {
+                return reply.code(400).send({
+                    error: {
+                        code: 'INVALID_BUNDLE',
+                        message: 'Bundle validation failed',
+                        details: { validationError: validation.error }
+                    }
+                });
+            }
+            // Execute engine
+            const receipt = (0, core_1.runDeltaEngine)(bundle);
+            return reply.code(200).send(receipt);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            request.log.error({ error: errorMessage }, 'Engine execution failed');
+            return reply.code(500).send({
+                error: {
+                    code: 'ENGINE_ERROR',
+                    message: 'Failed to process bundle',
+                    details: { error: errorMessage }
+                }
+            });
+        }
+    });
+    // POST /api/v1/delta/validate - Validate bundle schema
+    server.post('/api/v1/delta/validate', async (request, reply) => {
+        try {
+            const bundle = request.body;
+            const validation = (0, core_1.validateBundle)(bundle);
+            if (!validation.valid) {
+                return reply.code(200).send({
+                    valid: false,
+                    errors: [
+                        {
+                            field: 'bundle',
+                            message: validation.error || 'Validation failed'
+                        }
+                    ]
+                });
+            }
+            return reply.code(200).send({ valid: true });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            request.log.error({ error: errorMessage }, 'Validation failed');
+            return reply.code(500).send({
+                error: {
+                    code: 'VALIDATION_ERROR',
+                    message: 'Failed to validate bundle',
+                    details: { error: errorMessage }
+                }
+            });
+        }
+    });
+    // POST /api/v1/delta/verify - Verify receipt replay
+    server.post('/api/v1/delta/verify', async (request, reply) => {
+        try {
+            const receipt = request.body;
+            const verifyResult = (0, core_1.verifyReceipt)(receipt);
+            return reply.code(200).send({
+                verified: verifyResult.verified,
+                recomputedHash: verifyResult.recomputedHash
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            request.log.error({ error: errorMessage }, 'Verification failed');
+            return reply.code(500).send({
+                error: {
+                    code: 'VERIFICATION_ERROR',
+                    message: 'Failed to verify receipt',
+                    details: { error: errorMessage }
+                }
+            });
+        }
+    });
+}
+//# sourceMappingURL=delta.js.map

package/dist/routes/delta.js.map

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

package/dist/routes/health.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Health and Version Routes
+ * System status and version information endpoints
+ */
+import { FastifyInstance } from 'fastify';
+/**
+ * Register health and version routes
+ */
+export declare function registerHealthRoutes(server: FastifyInstance): Promise<void>;
+//# sourceMappingURL=health.d.ts.map

package/dist/routes/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/routes/health.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AAOxE;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDjF"}

package/dist/routes/health.js

@@ -0,0 +1,56 @@
+"use strict";
+/**
+ * Health and Version Routes
+ * System status and version information endpoints
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerHealthRoutes = registerHealthRoutes;
+const SERVER_START_TIME = Date.now();
+const API_VERSION = '1.0.0';
+const PROTOCOL_VERSION = '1.0';
+/**
+ * Register health and version routes
+ */
+async function registerHealthRoutes(server) {
+    // GET /api/v1/health - Health check endpoint
+    server.get('/api/v1/health', async (_request, reply) => {
+        const uptime = Date.now() - SERVER_START_TIME;
+        // Check if engine is available by attempting to import it
+        let engineAvailable = true;
+        try {
+            require('@uvrn/core');
+        }
+        catch {
+            engineAvailable = false;
+        }
+        const health = {
+            status: engineAvailable ? 'healthy' : 'unhealthy',
+            uptime,
+            version: API_VERSION,
+            engine: {
+                available: engineAvailable
+            },
+            timestamp: new Date().toISOString()
+        };
+        const statusCode = engineAvailable ? 200 : 503;
+        return reply.code(statusCode).send(health);
+    });
+    // GET /api/v1/version - Version information
+    server.get('/api/v1/version', async (_request, reply) => {
+        let engineVersion = 'unknown';
+        try {
+            const enginePkg = require('@uvrn/core/package.json');
+            engineVersion = enginePkg.version;
+        }
+        catch {
+            // Engine version not available
+        }
+        const version = {
+            apiVersion: API_VERSION,
+            engineVersion,
+            protocolVersion: PROTOCOL_VERSION
+        };
+        return reply.code(200).send(version);
+    });
+}
+//# sourceMappingURL=health.js.map

package/dist/routes/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/routes/health.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAYH,oDAiDC;AAxDD,MAAM,iBAAiB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AACrC,MAAM,WAAW,GAAG,OAAO,CAAC;AAC5B,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAE/B;;GAEG;AACI,KAAK,UAAU,oBAAoB,CAAC,MAAuB;IAChE,6CAA6C;IAC7C,MAAM,CAAC,GAAG,CAEP,gBAAgB,EAAE,KAAK,EAAE,QAAwB,EAAE,KAAmB,EAAE,EAAE;QAC3E,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,iBAAiB,CAAC;QAE9C,0DAA0D;QAC1D,IAAI,eAAe,GAAG,IAAI,CAAC;QAC3B,IAAI,CAAC;YACH,OAAO,CAAC,YAAY,CAAC,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC;YACP,eAAe,GAAG,KAAK,CAAC;QAC1B,CAAC;QAED,MAAM,MAAM,GAAmB;YAC7B,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW;YACjD,MAAM;YACN,OAAO,EAAE,WAAW;YACpB,MAAM,EAAE;gBACN,SAAS,EAAE,eAAe;aAC3B;YACD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;QAEF,MAAM,UAAU,GAAG,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAC/C,OAAO,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,4CAA4C;IAC5C,MAAM,CAAC,GAAG,CAEP,iBAAiB,EAAE,KAAK,EAAE,QAAwB,EAAE,KAAmB,EAAE,EAAE;QAC5E,IAAI,aAAa,GAAG,SAAS,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;YACrD,aAAa,GAAG,SAAS,CAAC,OAAO,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,+BAA+B;QACjC,CAAC;QAED,MAAM,OAAO,GAAoB;YAC/B,UAAU,EAAE,WAAW;YACvB,aAAa;YACb,eAAe,EAAE,gBAAgB;SAClC,CAAC;QAEF,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Delta Engine API Server
+ * Fastify-based REST API for bundle processing
+ */
+import { FastifyInstance } from 'fastify';
+import { ServerConfig } from './config/types';
+/**
+ * Create and configure Fastify server instance
+ */
+export declare function createServer(config?: ServerConfig): Promise<FastifyInstance>;
+/**
+ * Start the server
+ */
+export declare function startServer(config?: ServerConfig): Promise<FastifyInstance>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAgB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAKnD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAK9C;;GAEG;AACH,wBAAsB,YAAY,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAuFlF;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAoBjF"}

package/dist/server.js

@@ -0,0 +1,130 @@
+"use strict";
+/**
+ * Delta Engine API Server
+ * Fastify-based REST API for bundle processing
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createServer = createServer;
+exports.startServer = startServer;
+const fastify_1 = __importDefault(require("fastify"));
+const cors_1 = __importDefault(require("@fastify/cors"));
+const helmet_1 = __importDefault(require("@fastify/helmet"));
+const rate_limit_1 = __importDefault(require("@fastify/rate-limit"));
+const loader_1 = require("./config/loader");
+const delta_1 = require("./routes/delta");
+const health_1 = require("./routes/health");
+const errorHandler_1 = require("./middleware/errorHandler");
+/**
+ * Create and configure Fastify server instance
+ */
+async function createServer(config) {
+    // Load configuration
+    const serverConfig = config || (0, loader_1.loadConfig)();
+    // Create Fastify instance with logging
+    const server = (0, fastify_1.default)({
+        logger: {
+            level: serverConfig.logLevel,
+            transport: serverConfig.nodeEnv === 'development' ? {
+                target: 'pino-pretty',
+                options: {
+                    translateTime: 'HH:MM:ss Z',
+                    ignore: 'pid,hostname'
+                }
+            } : undefined
+        }
+    });
+    // Register plugins
+    await server.register(helmet_1.default, {
+        contentSecurityPolicy: serverConfig.nodeEnv === 'production' ? undefined : false
+    });
+    await server.register(cors_1.default, {
+        origin: serverConfig.corsOrigins,
+        credentials: true
+    });
+    await server.register(rate_limit_1.default, {
+        max: serverConfig.rateLimitMax,
+        timeWindow: serverConfig.rateLimitTimeWindow,
+        errorResponseBuilder: () => ({
+            error: {
+                code: 'RATE_LIMIT_EXCEEDED',
+                message: 'Too many requests, please try again later',
+                details: {
+                    rateLimitMax: serverConfig.rateLimitMax,
+                    timeWindow: serverConfig.rateLimitTimeWindow
+                }
+            }
+        })
+    });
+    // Add request logging hook
+    server.addHook('onRequest', async (request, _reply) => {
+        request.log.info({
+            url: request.url,
+            method: request.method,
+            ip: request.ip
+        }, 'Incoming request');
+    });
+    server.addHook('onResponse', async (request, reply) => {
+        request.log.info({
+            url: request.url,
+            method: request.method,
+            statusCode: reply.statusCode,
+            responseTime: reply.elapsedTime
+        }, 'Request completed');
+    });
+    // Validate content-type for POST requests
+    server.addHook('preHandler', async (request, reply) => {
+        if (request.method === 'POST' && request.url.startsWith('/api/v1/delta/')) {
+            const contentType = request.headers['content-type'];
+            if (!contentType || !contentType.includes('application/json')) {
+                return reply.code(415).send({
+                    error: {
+                        code: 'UNSUPPORTED_MEDIA_TYPE',
+                        message: 'Content-Type must be application/json',
+                        details: {
+                            receivedContentType: contentType || 'none'
+                        }
+                    }
+                });
+            }
+        }
+    });
+    // Register routes
+    await (0, health_1.registerHealthRoutes)(server);
+    await (0, delta_1.registerDeltaRoutes)(server);
+    // Register error handler (must be last)
+    (0, errorHandler_1.registerErrorHandler)(server);
+    return server;
+}
+/**
+ * Start the server
+ */
+async function startServer(config) {
+    const serverConfig = config || (0, loader_1.loadConfig)();
+    const server = await createServer(serverConfig);
+    try {
+        await server.listen({
+            port: serverConfig.port,
+            host: serverConfig.host
+        });
+        server.log.info(`🚀 Delta Engine API server running at http://${serverConfig.host}:${serverConfig.port}`);
+        server.log.info(`📊 Health check: http://${serverConfig.host}:${serverConfig.port}/api/v1/health`);
+        server.log.info(`📦 Environment: ${serverConfig.nodeEnv}`);
+        server.log.info(`🔒 Rate limit: ${serverConfig.rateLimitMax} requests per ${serverConfig.rateLimitTimeWindow}`);
+        return server;
+    }
+    catch (error) {
+        server.log.error(error);
+        throw error;
+    }
+}
+// Start server if run directly
+if (require.main === module) {
+    startServer().catch((error) => {
+        console.error('Failed to start server:', error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/types/api.d.ts

@@ -0,0 +1,32 @@
+/**
+ * API-specific type definitions
+ */
+export interface ErrorResponse {
+    error: {
+        code: string;
+        message: string;
+        details?: Record<string, unknown>;
+    };
+}
+export interface HealthResponse {
+    status: 'healthy' | 'unhealthy';
+    uptime: number;
+    version: string;
+    engine: {
+        available: boolean;
+    };
+    timestamp: string;
+}
+export interface VersionResponse {
+    apiVersion: string;
+    engineVersion: string;
+    protocolVersion: string;
+}
+export interface ValidationResponse {
+    valid: boolean;
+    errors?: Array<{
+        field: string;
+        message: string;
+    }>;
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/types/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/types/api.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,SAAS,GAAG,WAAW,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE;QACN,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,KAAK,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACJ"}

package/dist/types/api.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * API-specific type definitions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=api.js.map

package/dist/types/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/types/api.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/jest.config.js

@@ -0,0 +1,13 @@
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  roots: ['<rootDir>/tests'],
+  testMatch: ['**/*.test.ts'],
+  collectCoverageFrom: [
+    'src/**/*.ts',
+    '!src/**/*.d.ts',
+    '!src/index.ts',
+  ],
+  coverageDirectory: 'coverage',
+  coverageReporters: ['text', 'lcov', 'html'],
+};

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@uvrn/api",
+  "version": "1.0.0",
+  "description": "UVRN REST API — HTTP access to bundle processing",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "keywords": [
+    "uvrn",
+    "rest-api",
+    "bundle",
+    "protocol"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "fastify": "^4.25.0",
+    "@fastify/cors": "^8.5.0",
+    "@fastify/rate-limit": "^9.1.0",
+    "@fastify/helmet": "^11.1.0",
+    "@uvrn/core": "1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/jest": "^29.5.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "eslint": "^8.0.0",
+    "jest": "^29.5.0",
+    "pino-pretty": "^10.3.0",
+    "ts-jest": "^29.1.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "dev": "tsx watch src/server.ts",
+    "build": "tsc",
+    "start": "node dist/server.js",
+    "test": "jest",
+    "lint": "eslint src/**/*.ts",
+    "clean": "rm -rf dist"
+  }
+}

package/src/config/loader.ts

@@ -0,0 +1,60 @@
+/**
+ * Configuration Loader
+ * Loads and validates server configuration from environment variables
+ */
+
+import { ServerConfig, ConfigValidationError } from './types';
+
+/**
+ * Load configuration from environment variables with defaults
+ */
+export function loadConfig(): ServerConfig {
+  const config: ServerConfig = {
+    port: parseInt(process.env.PORT || '3000', 10),
+    host: process.env.HOST || '0.0.0.0',
+    corsOrigins: process.env.CORS_ORIGINS?.split(',').map(o => o.trim()) || ['*'],
+    rateLimitMax: parseInt(process.env.RATE_LIMIT_MAX || '100', 10),
+    rateLimitTimeWindow: process.env.RATE_LIMIT_TIME_WINDOW || '1 minute',
+    logLevel: (process.env.LOG_LEVEL as ServerConfig['logLevel']) || 'info',
+    nodeEnv: (process.env.NODE_ENV as ServerConfig['nodeEnv']) || 'development'
+  };
+
+  const errors = validateConfig(config);
+  if (errors.length > 0) {
+    const errorMessages = errors.map(e => `${e.field}: ${e.message}`).join(', ');
+    throw new Error(`Configuration validation failed: ${errorMessages}`);
+  }
+
+  return config;
+}
+
+/**
+ * Validate configuration values
+ */
+function validateConfig(config: ServerConfig): ConfigValidationError[] {
+  const errors: ConfigValidationError[] = [];
+
+  if (config.port < 1 || config.port > 65535) {
+    errors.push({ field: 'port', message: 'Must be between 1 and 65535' });
+  }
+
+  if (!config.host) {
+    errors.push({ field: 'host', message: 'Host cannot be empty' });
+  }
+
+  if (config.rateLimitMax < 1) {
+    errors.push({ field: 'rateLimitMax', message: 'Must be at least 1' });
+  }
+
+  const validLogLevels = ['trace', 'debug', 'info', 'warn', 'error', 'fatal'];
+  if (!validLogLevels.includes(config.logLevel)) {
+    errors.push({ field: 'logLevel', message: `Must be one of: ${validLogLevels.join(', ')}` });
+  }
+
+  const validNodeEnvs = ['development', 'production', 'test'];
+  if (!validNodeEnvs.includes(config.nodeEnv)) {
+    errors.push({ field: 'nodeEnv', message: `Must be one of: ${validNodeEnvs.join(', ')}` });
+  }
+
+  return errors;
+}

package/src/config/types.ts

@@ -0,0 +1,18 @@
+/**
+ * Server Configuration Types
+ */
+
+export interface ServerConfig {
+  port: number;
+  host: string;
+  corsOrigins: string[];
+  rateLimitMax: number;
+  rateLimitTimeWindow: string;
+  logLevel: 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+  nodeEnv: 'development' | 'production' | 'test';
+}
+
+export interface ConfigValidationError {
+  field: string;
+  message: string;
+}

package/src/index.ts

@@ -0,0 +1,13 @@
+/**
+ * Delta Engine API - Entry Point
+ * Exports for programmatic usage
+ */
+
+export { startServer, createServer } from './server';
+export type { ServerConfig } from './config/types';
+export type {
+  ErrorResponse,
+  HealthResponse,
+  VersionResponse,
+  ValidationResponse
+} from './types/api';