@layer-ai/core 2.0.3 → 2.0.5

package/dist/index.d.ts

@@ -5,6 +5,10 @@ export { default as logsRouter } from './routes/v1/logs.js';
 export { default as completeRouter } from './routes/v2/complete.js';
 export { default as chatRouter } from './routes/v3/chat.js';
 export { default as imageRouter } from './routes/v3/image.js';
+export { default as videoRouter } from './routes/v3/video.js';
+export { default as embeddingsRouter } from './routes/v3/embeddings.js';
+export { default as ttsRouter } from './routes/v3/tts.js';
+export { default as ocrRouter } from './routes/v3/ocr.js';
 export { authenticate } from './middleware/auth.js';
 export type {} from './middleware/auth.js';
 export { db } from './lib/db/postgres.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAG5D,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGpE,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAG9D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAG3C,OAAO,EAAE,EAAE,EAAE,MAAM,sBAAsB,CAAC;AAC1C,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAGrD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD,eAAO,MAAM,gBAAgB,GAAU,QAAQ,MAAM,KAAG,OAAO,CAAC,MAAM,CAGrE,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAU,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAG3E,CAAC;AAGF,cAAc,6BAA6B,CAAC;AAG5C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAG5D,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGpE,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG1D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAG3C,OAAO,EAAE,EAAE,EAAE,MAAM,sBAAsB,CAAC;AAC1C,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAGrD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD,eAAO,MAAM,gBAAgB,GAAU,QAAQ,MAAM,KAAG,OAAO,CAAC,MAAM,CAGrE,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAU,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAG3E,CAAC;AAGF,cAAc,6BAA6B,CAAC;AAG5C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -8,6 +8,10 @@ export { default as completeRouter } from './routes/v2/complete.js';
 // v3 routes
 export { default as chatRouter } from './routes/v3/chat.js';
 export { default as imageRouter } from './routes/v3/image.js';
+export { default as videoRouter } from './routes/v3/video.js';
+export { default as embeddingsRouter } from './routes/v3/embeddings.js';
+export { default as ttsRouter } from './routes/v3/tts.js';
+export { default as ocrRouter } from './routes/v3/ocr.js';
 // Middleware
 export { authenticate } from './middleware/auth.js';
 // Database

package/dist/routes/v3/embeddings.d.ts

@@ -0,0 +1,4 @@
+import type { Router as RouterType } from 'express';
+declare const router: RouterType;
+export default router;
+//# sourceMappingURL=embeddings.d.ts.map

package/dist/routes/v3/embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../../src/routes/v3/embeddings.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,SAAS,CAAC;AAOpD,QAAA,MAAM,MAAM,EAAE,UAAqB,CAAC;AA8OpC,eAAe,MAAM,CAAC"}

package/dist/routes/v3/embeddings.js

@@ -0,0 +1,196 @@
+import { Router } from 'express';
+import { db } from '../../lib/db/postgres.js';
+import { authenticate } from '../../middleware/auth.js';
+import { callAdapter, normalizeModelId } from '../../lib/provider-factory.js';
+import { OverrideField } from '@layer-ai/sdk';
+const router = Router();
+// MARK:- Helper Functions
+function isOverrideAllowed(allowOverrides, field) {
+    if (allowOverrides === undefined || allowOverrides === null || allowOverrides === true)
+        return true;
+    if (allowOverrides === false)
+        return false;
+    return allowOverrides[field] ?? false;
+}
+function resolveFinalRequest(gateConfig, request) {
+    let finalModel = gateConfig.model;
+    if (request.model && isOverrideAllowed(gateConfig.allowOverrides, OverrideField.Model)) {
+        try {
+            finalModel = normalizeModelId(request.model);
+        }
+        catch {
+            finalModel = gateConfig.model;
+        }
+    }
+    // For embeddings, we don't merge gate config like we do for chat
+    return {
+        ...request,
+        type: 'embeddings',
+        model: normalizeModelId(finalModel),
+    };
+}
+function getModelsToTry(gateConfig, primaryModel) {
+    const modelsToTry = [primaryModel];
+    if (gateConfig.routingStrategy === 'fallback' && gateConfig.fallbackModels?.length) {
+        modelsToTry.push(...gateConfig.fallbackModels);
+    }
+    return modelsToTry;
+}
+async function executeWithFallback(request, modelsToTry, userId) {
+    let result = null;
+    let lastError = null;
+    let modelUsed = request.model;
+    for (const modelToTry of modelsToTry) {
+        try {
+            const modelRequest = { ...request, model: modelToTry };
+            result = await callAdapter(modelRequest, userId);
+            modelUsed = modelToTry;
+            break;
+        }
+        catch (error) {
+            lastError = error;
+            console.log(`Model ${modelToTry} failed, trying next fallback...`, error instanceof Error ? error.message : error);
+            continue;
+        }
+    }
+    if (!result) {
+        throw lastError || new Error('All models failed');
+    }
+    return { result, modelUsed };
+}
+async function executeWithRoundRobin(gateConfig, request, userId) {
+    if (!gateConfig.fallbackModels?.length) {
+        const result = await callAdapter(request, userId);
+        return { result, modelUsed: request.model };
+    }
+    const allModels = [gateConfig.model, ...gateConfig.fallbackModels];
+    const modelIndex = Math.floor(Math.random() * allModels.length);
+    const selectedModel = allModels[modelIndex];
+    const modelRequest = { ...request, model: selectedModel };
+    const result = await callAdapter(modelRequest, userId);
+    return { result, modelUsed: selectedModel };
+}
+async function executeWithRouting(gateConfig, request, userId) {
+    const modelsToTry = getModelsToTry(gateConfig, request.model);
+    switch (gateConfig.routingStrategy) {
+        case 'fallback':
+            return await executeWithFallback(request, modelsToTry, userId);
+        case 'round-robin':
+            return await executeWithRoundRobin(gateConfig, request, userId);
+        case 'single':
+        default:
+            const result = await callAdapter(request, userId);
+            return { result, modelUsed: request.model };
+    }
+}
+// MARK:- Route Handler
+router.post('/', authenticate, async (req, res) => {
+    const startTime = Date.now();
+    if (!req.userId) {
+        res.status(401).json({ error: 'unauthorized', message: 'Missing user ID' });
+        return;
+    }
+    const userId = req.userId;
+    let gateConfig = null;
+    let request = null;
+    try {
+        const rawRequest = req.body;
+        if (!rawRequest.gateId) {
+            res.status(400).json({ error: 'bad_request', message: 'Missing required field: gateId' });
+            return;
+        }
+        const isUUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(rawRequest.gateId);
+        if (!isUUID) {
+            res.status(400).json({ error: 'bad_request', message: 'gateId must be a valid UUID' });
+            return;
+        }
+        gateConfig = await db.getGateByUserAndId(userId, rawRequest.gateId);
+        if (!gateConfig) {
+            res.status(404).json({ error: 'not_found', message: `Gate with ID "${rawRequest.gateId}" not found` });
+            return;
+        }
+        // Validate embeddings-specific fields
+        if (!rawRequest.data?.input) {
+            res.status(400).json({ error: 'bad_request', message: 'Missing required field: data.input' });
+            return;
+        }
+        // Validate input is string or array of strings
+        const input = rawRequest.data.input;
+        if (typeof input !== 'string' && !Array.isArray(input)) {
+            res.status(400).json({ error: 'bad_request', message: 'data.input must be a string or array of strings' });
+            return;
+        }
+        if (Array.isArray(input)) {
+            if (input.length === 0) {
+                res.status(400).json({ error: 'bad_request', message: 'data.input array must not be empty' });
+                return;
+            }
+            if (!input.every(item => typeof item === 'string')) {
+                res.status(400).json({ error: 'bad_request', message: 'data.input array must contain only strings' });
+                return;
+            }
+        }
+        // Warn if gate is configured for a different task type
+        if (gateConfig.taskType && gateConfig.taskType !== 'embeddings') {
+            console.warn(`[Type Mismatch] Gate "${gateConfig.name}" (${gateConfig.id}) configured for taskType="${gateConfig.taskType}" ` +
+                `but received request to /v3/embeddings endpoint. Processing as embeddings request.`);
+        }
+        request = {
+            gateId: rawRequest.gateId,
+            type: 'embeddings',
+            data: rawRequest.data,
+            model: rawRequest.model,
+            metadata: rawRequest.metadata
+        };
+        const finalRequest = resolveFinalRequest(gateConfig, request);
+        const { result, modelUsed } = await executeWithRouting(gateConfig, finalRequest, userId);
+        const latencyMs = Date.now() - startTime;
+        // Log request to database
+        db.logRequest({
+            userId,
+            gateId: gateConfig.id,
+            gateName: gateConfig.name,
+            modelRequested: request.model || gateConfig.model,
+            modelUsed: modelUsed,
+            promptTokens: result.usage?.promptTokens || 0,
+            completionTokens: result.usage?.completionTokens || 0,
+            totalTokens: result.usage?.totalTokens || 0,
+            costUsd: result.cost || 0,
+            latencyMs,
+            success: true,
+            errorMessage: null,
+            userAgent: req.headers['user-agent'] || null,
+            ipAddress: req.ip || null,
+        }).catch(err => console.error('Failed to log request:', err));
+        // Return LayerResponse with additional metadata
+        const response = {
+            ...result,
+            model: modelUsed,
+            latencyMs,
+        };
+        res.json(response);
+    }
+    catch (error) {
+        const latencyMs = Date.now() - startTime;
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        db.logRequest({
+            userId,
+            gateId: gateConfig?.id || null,
+            gateName: req.body?.gate || null,
+            modelRequested: (request?.model || gateConfig?.model) || 'unknown',
+            modelUsed: null,
+            promptTokens: 0,
+            completionTokens: 0,
+            totalTokens: 0,
+            costUsd: 0,
+            latencyMs,
+            success: false,
+            errorMessage,
+            userAgent: req.headers['user-agent'] || null,
+            ipAddress: req.ip || null,
+        }).catch(err => console.error('Failed to log request:', err));
+        console.error('Embeddings error:', error);
+        res.status(500).json({ error: 'internal_error', message: errorMessage });
+    }
+});
+export default router;

package/dist/routes/v3/ocr.d.ts

@@ -0,0 +1,4 @@
+import type { Router as RouterType } from 'express';
+declare const router: RouterType;
+export default router;
+//# sourceMappingURL=ocr.d.ts.map

package/dist/routes/v3/ocr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ocr.d.ts","sourceRoot":"","sources":["../../../src/routes/v3/ocr.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,SAAS,CAAC;AAOpD,QAAA,MAAM,MAAM,EAAE,UAAqB,CAAC;AAgOpC,eAAe,MAAM,CAAC"}

package/dist/routes/v3/ocr.js

@@ -0,0 +1,184 @@
+import { Router } from 'express';
+import { db } from '../../lib/db/postgres.js';
+import { authenticate } from '../../middleware/auth.js';
+import { callAdapter, normalizeModelId } from '../../lib/provider-factory.js';
+import { OverrideField } from '@layer-ai/sdk';
+const router = Router();
+// MARK:- Helper Functions
+function isOverrideAllowed(allowOverrides, field) {
+    if (allowOverrides === undefined || allowOverrides === null || allowOverrides === true)
+        return true;
+    if (allowOverrides === false)
+        return false;
+    return allowOverrides[field] ?? false;
+}
+function resolveFinalRequest(gateConfig, request) {
+    let finalModel = gateConfig.model;
+    if (request.model && isOverrideAllowed(gateConfig.allowOverrides, OverrideField.Model)) {
+        try {
+            finalModel = normalizeModelId(request.model);
+        }
+        catch {
+            finalModel = gateConfig.model;
+        }
+    }
+    // For OCR, we don't merge gate config like we do for chat
+    return {
+        ...request,
+        type: 'ocr',
+        model: normalizeModelId(finalModel),
+    };
+}
+function getModelsToTry(gateConfig, primaryModel) {
+    const modelsToTry = [primaryModel];
+    if (gateConfig.routingStrategy === 'fallback' && gateConfig.fallbackModels?.length) {
+        modelsToTry.push(...gateConfig.fallbackModels);
+    }
+    return modelsToTry;
+}
+async function executeWithFallback(request, modelsToTry, userId) {
+    let result = null;
+    let lastError = null;
+    let modelUsed = request.model;
+    for (const modelToTry of modelsToTry) {
+        try {
+            const modelRequest = { ...request, model: modelToTry };
+            result = await callAdapter(modelRequest, userId);
+            modelUsed = modelToTry;
+            break;
+        }
+        catch (error) {
+            lastError = error;
+            console.log(`Model ${modelToTry} failed, trying next fallback...`, error instanceof Error ? error.message : error);
+            continue;
+        }
+    }
+    if (!result) {
+        throw lastError || new Error('All models failed');
+    }
+    return { result, modelUsed };
+}
+async function executeWithRoundRobin(gateConfig, request, userId) {
+    if (!gateConfig.fallbackModels?.length) {
+        const result = await callAdapter(request, userId);
+        return { result, modelUsed: request.model };
+    }
+    const allModels = [gateConfig.model, ...gateConfig.fallbackModels];
+    const modelIndex = Math.floor(Math.random() * allModels.length);
+    const selectedModel = allModels[modelIndex];
+    const modelRequest = { ...request, model: selectedModel };
+    const result = await callAdapter(modelRequest, userId);
+    return { result, modelUsed: selectedModel };
+}
+async function executeWithRouting(gateConfig, request, userId) {
+    const modelsToTry = getModelsToTry(gateConfig, request.model);
+    switch (gateConfig.routingStrategy) {
+        case 'fallback':
+            return await executeWithFallback(request, modelsToTry, userId);
+        case 'round-robin':
+            return await executeWithRoundRobin(gateConfig, request, userId);
+        case 'single':
+        default:
+            const result = await callAdapter(request, userId);
+            return { result, modelUsed: request.model };
+    }
+}
+// MARK:- Route Handler
+router.post('/', authenticate, async (req, res) => {
+    const startTime = Date.now();
+    if (!req.userId) {
+        res.status(401).json({ error: 'unauthorized', message: 'Missing user ID' });
+        return;
+    }
+    const userId = req.userId;
+    let gateConfig = null;
+    let request = null;
+    try {
+        const rawRequest = req.body;
+        if (!rawRequest.gateId) {
+            res.status(400).json({ error: 'bad_request', message: 'Missing required field: gateId' });
+            return;
+        }
+        const isUUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(rawRequest.gateId);
+        if (!isUUID) {
+            res.status(400).json({ error: 'bad_request', message: 'gateId must be a valid UUID' });
+            return;
+        }
+        gateConfig = await db.getGateByUserAndId(userId, rawRequest.gateId);
+        if (!gateConfig) {
+            res.status(404).json({ error: 'not_found', message: `Gate with ID "${rawRequest.gateId}" not found` });
+            return;
+        }
+        // Validate OCR-specific fields - must have one of documentUrl, imageUrl, or base64
+        const data = rawRequest.data;
+        if (!data || (!data.documentUrl && !data.imageUrl && !data.base64)) {
+            res.status(400).json({
+                error: 'bad_request',
+                message: 'Missing required field: data must contain one of documentUrl, imageUrl, or base64'
+            });
+            return;
+        }
+        // Warn if gate is configured for a different task type
+        if (gateConfig.taskType && gateConfig.taskType !== 'document') {
+            console.warn(`[Type Mismatch] Gate "${gateConfig.name}" (${gateConfig.id}) configured for taskType="${gateConfig.taskType}" ` +
+                `but received request to /v3/ocr endpoint. Processing as OCR request.`);
+        }
+        request = {
+            gateId: rawRequest.gateId,
+            type: 'ocr',
+            data: rawRequest.data,
+            model: rawRequest.model,
+            metadata: rawRequest.metadata
+        };
+        const finalRequest = resolveFinalRequest(gateConfig, request);
+        const { result, modelUsed } = await executeWithRouting(gateConfig, finalRequest, userId);
+        const latencyMs = Date.now() - startTime;
+        // Log request to database
+        db.logRequest({
+            userId,
+            gateId: gateConfig.id,
+            gateName: gateConfig.name,
+            modelRequested: request.model || gateConfig.model,
+            modelUsed: modelUsed,
+            promptTokens: result.usage?.promptTokens || 0,
+            completionTokens: result.usage?.completionTokens || 0,
+            totalTokens: result.usage?.totalTokens || 0,
+            costUsd: result.cost || 0,
+            latencyMs,
+            success: true,
+            errorMessage: null,
+            userAgent: req.headers['user-agent'] || null,
+            ipAddress: req.ip || null,
+        }).catch(err => console.error('Failed to log request:', err));
+        // Return LayerResponse with additional metadata
+        const response = {
+            ...result,
+            model: modelUsed,
+            latencyMs,
+        };
+        res.json(response);
+    }
+    catch (error) {
+        const latencyMs = Date.now() - startTime;
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        db.logRequest({
+            userId,
+            gateId: gateConfig?.id || null,
+            gateName: req.body?.gate || null,
+            modelRequested: (request?.model || gateConfig?.model) || 'unknown',
+            modelUsed: null,
+            promptTokens: 0,
+            completionTokens: 0,
+            totalTokens: 0,
+            costUsd: 0,
+            latencyMs,
+            success: false,
+            errorMessage,
+            userAgent: req.headers['user-agent'] || null,
+            ipAddress: req.ip || null,
+        }).catch(err => console.error('Failed to log request:', err));
+        console.error('OCR error:', error);
+        res.status(500).json({ error: 'internal_error', message: errorMessage });
+    }
+});
+export default router;

package/dist/routes/v3/tts.d.ts

@@ -0,0 +1,4 @@
+import type { Router as RouterType } from 'express';
+declare const router: RouterType;
+export default router;
+//# sourceMappingURL=tts.d.ts.map

package/dist/routes/v3/tts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tts.d.ts","sourceRoot":"","sources":["../../../src/routes/v3/tts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,SAAS,CAAC;AAOpD,QAAA,MAAM,MAAM,EAAE,UAAqB,CAAC;AA4NpC,eAAe,MAAM,CAAC"}

package/dist/routes/v3/tts.js

@@ -0,0 +1,180 @@
+import { Router } from 'express';
+import { db } from '../../lib/db/postgres.js';
+import { authenticate } from '../../middleware/auth.js';
+import { callAdapter, normalizeModelId } from '../../lib/provider-factory.js';
+import { OverrideField } from '@layer-ai/sdk';
+const router = Router();
+// MARK:- Helper Functions
+function isOverrideAllowed(allowOverrides, field) {
+    if (allowOverrides === undefined || allowOverrides === null || allowOverrides === true)
+        return true;
+    if (allowOverrides === false)
+        return false;
+    return allowOverrides[field] ?? false;
+}
+function resolveFinalRequest(gateConfig, request) {
+    let finalModel = gateConfig.model;
+    if (request.model && isOverrideAllowed(gateConfig.allowOverrides, OverrideField.Model)) {
+        try {
+            finalModel = normalizeModelId(request.model);
+        }
+        catch {
+            finalModel = gateConfig.model;
+        }
+    }
+    // For TTS, we don't merge gate config like we do for chat
+    return {
+        ...request,
+        type: 'tts',
+        model: normalizeModelId(finalModel),
+    };
+}
+function getModelsToTry(gateConfig, primaryModel) {
+    const modelsToTry = [primaryModel];
+    if (gateConfig.routingStrategy === 'fallback' && gateConfig.fallbackModels?.length) {
+        modelsToTry.push(...gateConfig.fallbackModels);
+    }
+    return modelsToTry;
+}
+async function executeWithFallback(request, modelsToTry, userId) {
+    let result = null;
+    let lastError = null;
+    let modelUsed = request.model;
+    for (const modelToTry of modelsToTry) {
+        try {
+            const modelRequest = { ...request, model: modelToTry };
+            result = await callAdapter(modelRequest, userId);
+            modelUsed = modelToTry;
+            break;
+        }
+        catch (error) {
+            lastError = error;
+            console.log(`Model ${modelToTry} failed, trying next fallback...`, error instanceof Error ? error.message : error);
+            continue;
+        }
+    }
+    if (!result) {
+        throw lastError || new Error('All models failed');
+    }
+    return { result, modelUsed };
+}
+async function executeWithRoundRobin(gateConfig, request, userId) {
+    if (!gateConfig.fallbackModels?.length) {
+        const result = await callAdapter(request, userId);
+        return { result, modelUsed: request.model };
+    }
+    const allModels = [gateConfig.model, ...gateConfig.fallbackModels];
+    const modelIndex = Math.floor(Math.random() * allModels.length);
+    const selectedModel = allModels[modelIndex];
+    const modelRequest = { ...request, model: selectedModel };
+    const result = await callAdapter(modelRequest, userId);
+    return { result, modelUsed: selectedModel };
+}
+async function executeWithRouting(gateConfig, request, userId) {
+    const modelsToTry = getModelsToTry(gateConfig, request.model);
+    switch (gateConfig.routingStrategy) {
+        case 'fallback':
+            return await executeWithFallback(request, modelsToTry, userId);
+        case 'round-robin':
+            return await executeWithRoundRobin(gateConfig, request, userId);
+        case 'single':
+        default:
+            const result = await callAdapter(request, userId);
+            return { result, modelUsed: request.model };
+    }
+}
+// MARK:- Route Handler
+router.post('/', authenticate, async (req, res) => {
+    const startTime = Date.now();
+    if (!req.userId) {
+        res.status(401).json({ error: 'unauthorized', message: 'Missing user ID' });
+        return;
+    }
+    const userId = req.userId;
+    let gateConfig = null;
+    let request = null;
+    try {
+        const rawRequest = req.body;
+        if (!rawRequest.gateId) {
+            res.status(400).json({ error: 'bad_request', message: 'Missing required field: gateId' });
+            return;
+        }
+        const isUUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(rawRequest.gateId);
+        if (!isUUID) {
+            res.status(400).json({ error: 'bad_request', message: 'gateId must be a valid UUID' });
+            return;
+        }
+        gateConfig = await db.getGateByUserAndId(userId, rawRequest.gateId);
+        if (!gateConfig) {
+            res.status(404).json({ error: 'not_found', message: `Gate with ID "${rawRequest.gateId}" not found` });
+            return;
+        }
+        // Validate TTS-specific fields
+        if (!rawRequest.data?.input || typeof rawRequest.data.input !== 'string' || rawRequest.data.input.trim().length === 0) {
+            res.status(400).json({ error: 'bad_request', message: 'Missing required field: data.input (must be a non-empty string)' });
+            return;
+        }
+        // Warn if gate is configured for a different task type
+        if (gateConfig.taskType && gateConfig.taskType !== 'tts') {
+            console.warn(`[Type Mismatch] Gate "${gateConfig.name}" (${gateConfig.id}) configured for taskType="${gateConfig.taskType}" ` +
+                `but received request to /v3/tts endpoint. Processing as TTS request.`);
+        }
+        request = {
+            gateId: rawRequest.gateId,
+            type: 'tts',
+            data: rawRequest.data,
+            model: rawRequest.model,
+            metadata: rawRequest.metadata
+        };
+        const finalRequest = resolveFinalRequest(gateConfig, request);
+        const { result, modelUsed } = await executeWithRouting(gateConfig, finalRequest, userId);
+        const latencyMs = Date.now() - startTime;
+        // Log request to database
+        db.logRequest({
+            userId,
+            gateId: gateConfig.id,
+            gateName: gateConfig.name,
+            modelRequested: request.model || gateConfig.model,
+            modelUsed: modelUsed,
+            promptTokens: result.usage?.promptTokens || 0,
+            completionTokens: result.usage?.completionTokens || 0,
+            totalTokens: result.usage?.totalTokens || 0,
+            costUsd: result.cost || 0,
+            latencyMs,
+            success: true,
+            errorMessage: null,
+            userAgent: req.headers['user-agent'] || null,
+            ipAddress: req.ip || null,
+        }).catch(err => console.error('Failed to log request:', err));
+        // Return LayerResponse with additional metadata
+        const response = {
+            ...result,
+            model: modelUsed,
+            latencyMs,
+        };
+        res.json(response);
+    }
+    catch (error) {
+        const latencyMs = Date.now() - startTime;
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        db.logRequest({
+            userId,
+            gateId: gateConfig?.id || null,
+            gateName: req.body?.gate || null,
+            modelRequested: (request?.model || gateConfig?.model) || 'unknown',
+            modelUsed: null,
+            promptTokens: 0,
+            completionTokens: 0,
+            totalTokens: 0,
+            costUsd: 0,
+            latencyMs,
+            success: false,
+            errorMessage,
+            userAgent: req.headers['user-agent'] || null,
+            ipAddress: req.ip || null,
+        }).catch(err => console.error('Failed to log request:', err));
+        console.error('TTS error:', error);
+        res.status(500).json({ error: 'internal_error', message: errorMessage });
+    }
+});
+export default router;

package/dist/routes/v3/video.d.ts

@@ -0,0 +1,4 @@
+import type { Router as RouterType } from 'express';
+declare const router: RouterType;
+export default router;
+//# sourceMappingURL=video.d.ts.map

package/dist/routes/v3/video.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video.d.ts","sourceRoot":"","sources":["../../../src/routes/v3/video.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,SAAS,CAAC;AAOpD,QAAA,MAAM,MAAM,EAAE,UAAqB,CAAC;AA6NpC,eAAe,MAAM,CAAC"}

package/dist/routes/v3/video.js

@@ -0,0 +1,181 @@
+import { Router } from 'express';
+import { db } from '../../lib/db/postgres.js';
+import { authenticate } from '../../middleware/auth.js';
+import { callAdapter, normalizeModelId } from '../../lib/provider-factory.js';
+import { OverrideField } from '@layer-ai/sdk';
+const router = Router();
+// MARK:- Helper Functions
+function isOverrideAllowed(allowOverrides, field) {
+    if (allowOverrides === undefined || allowOverrides === null || allowOverrides === true)
+        return true;
+    if (allowOverrides === false)
+        return false;
+    return allowOverrides[field] ?? false;
+}
+function resolveFinalRequest(gateConfig, request) {
+    let finalModel = gateConfig.model;
+    if (request.model && isOverrideAllowed(gateConfig.allowOverrides, OverrideField.Model)) {
+        try {
+            finalModel = normalizeModelId(request.model);
+        }
+        catch {
+            finalModel = gateConfig.model;
+        }
+    }
+    // For image generation, we don't merge gate config like we do for chat
+    // The prompt and parameters are specific to the request
+    return {
+        ...request,
+        type: 'video',
+        model: normalizeModelId(finalModel),
+    };
+}
+function getModelsToTry(gateConfig, primaryModel) {
+    const modelsToTry = [primaryModel];
+    if (gateConfig.routingStrategy === 'fallback' && gateConfig.fallbackModels?.length) {
+        modelsToTry.push(...gateConfig.fallbackModels);
+    }
+    return modelsToTry;
+}
+async function executeWithFallback(request, modelsToTry, userId) {
+    let result = null;
+    let lastError = null;
+    let modelUsed = request.model;
+    for (const modelToTry of modelsToTry) {
+        try {
+            const modelRequest = { ...request, model: modelToTry };
+            result = await callAdapter(modelRequest, userId);
+            modelUsed = modelToTry;
+            break;
+        }
+        catch (error) {
+            lastError = error;
+            console.log(`Model ${modelToTry} failed, trying next fallback...`, error instanceof Error ? error.message : error);
+            continue;
+        }
+    }
+    if (!result) {
+        throw lastError || new Error('All models failed');
+    }
+    return { result, modelUsed };
+}
+async function executeWithRoundRobin(gateConfig, request, userId) {
+    if (!gateConfig.fallbackModels?.length) {
+        const result = await callAdapter(request, userId);
+        return { result, modelUsed: request.model };
+    }
+    const allModels = [gateConfig.model, ...gateConfig.fallbackModels];
+    const modelIndex = Math.floor(Math.random() * allModels.length);
+    const selectedModel = allModels[modelIndex];
+    const modelRequest = { ...request, model: selectedModel };
+    const result = await callAdapter(modelRequest, userId);
+    return { result, modelUsed: selectedModel };
+}
+async function executeWithRouting(gateConfig, request, userId) {
+    const modelsToTry = getModelsToTry(gateConfig, request.model);
+    switch (gateConfig.routingStrategy) {
+        case 'fallback':
+            return await executeWithFallback(request, modelsToTry, userId);
+        case 'round-robin':
+            return await executeWithRoundRobin(gateConfig, request, userId);
+        case 'single':
+        default:
+            const result = await callAdapter(request, userId);
+            return { result, modelUsed: request.model };
+    }
+}
+// MARK:- Route Handler
+router.post('/', authenticate, async (req, res) => {
+    const startTime = Date.now();
+    if (!req.userId) {
+        res.status(401).json({ error: 'unauthorized', message: 'Missing user ID' });
+        return;
+    }
+    const userId = req.userId;
+    let gateConfig = null;
+    let request = null;
+    try {
+        const rawRequest = req.body;
+        if (!rawRequest.gateId) {
+            res.status(400).json({ error: 'bad_request', message: 'Missing required field: gateId' });
+            return;
+        }
+        const isUUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(rawRequest.gateId);
+        if (!isUUID) {
+            res.status(400).json({ error: 'bad_request', message: 'gateId must be a valid UUID' });
+            return;
+        }
+        gateConfig = await db.getGateByUserAndId(userId, rawRequest.gateId);
+        if (!gateConfig) {
+            res.status(404).json({ error: 'not_found', message: `Gate with ID "${rawRequest.gateId}" not found` });
+            return;
+        }
+        // Validate video-specific fields
+        if (!rawRequest.data?.prompt || typeof rawRequest.data.prompt !== 'string' || rawRequest.data.prompt.trim().length === 0) {
+            res.status(400).json({ error: 'bad_request', message: 'Missing required field: data.prompt (must be a non-empty string)' });
+            return;
+        }
+        // Warn if gate is configured for a different task type
+        if (gateConfig.taskType && gateConfig.taskType !== 'video') {
+            console.warn(`[Type Mismatch] Gate "${gateConfig.name}" (${gateConfig.id}) configured for taskType="${gateConfig.taskType}" ` +
+                `but received request to /v3/video endpoint. Processing as video request.`);
+        }
+        request = {
+            gateId: rawRequest.gateId,
+            type: 'video',
+            data: rawRequest.data,
+            model: rawRequest.model,
+            metadata: rawRequest.metadata
+        };
+        const finalRequest = resolveFinalRequest(gateConfig, request);
+        const { result, modelUsed } = await executeWithRouting(gateConfig, finalRequest, userId);
+        const latencyMs = Date.now() - startTime;
+        // Log request to database
+        db.logRequest({
+            userId,
+            gateId: gateConfig.id,
+            gateName: gateConfig.name,
+            modelRequested: request.model || gateConfig.model,
+            modelUsed: modelUsed,
+            promptTokens: result.usage?.promptTokens || 0,
+            completionTokens: result.usage?.completionTokens || 0,
+            totalTokens: result.usage?.totalTokens || 0,
+            costUsd: result.cost || 0,
+            latencyMs,
+            success: true,
+            errorMessage: null,
+            userAgent: req.headers['user-agent'] || null,
+            ipAddress: req.ip || null,
+        }).catch(err => console.error('Failed to log request:', err));
+        // Return LayerResponse with additional metadata
+        const response = {
+            ...result,
+            model: modelUsed,
+            latencyMs,
+        };
+        res.json(response);
+    }
+    catch (error) {
+        const latencyMs = Date.now() - startTime;
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        db.logRequest({
+            userId,
+            gateId: gateConfig?.id || null,
+            gateName: req.body?.gate || null,
+            modelRequested: (request?.model || gateConfig?.model) || 'unknown',
+            modelUsed: null,
+            promptTokens: 0,
+            completionTokens: 0,
+            totalTokens: 0,
+            costUsd: 0,
+            latencyMs,
+            success: false,
+            errorMessage,
+            userAgent: req.headers['user-agent'] || null,
+            ipAddress: req.ip || null,
+        }).catch(err => console.error('Failed to log request:', err));
+        console.error('Video generation error:', error);
+        res.status(500).json({ error: 'internal_error', message: errorMessage });
+    }
+});
+export default router;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@layer-ai/core",
-  "version": "2.0.3",
+  "version": "2.0.5",
   "description": "Core API routes and services for Layer AI",
   "type": "module",
   "main": "./dist/index.js",
@@ -36,7 +36,7 @@
     "nanoid": "^5.0.4",
     "openai": "^4.24.0",
     "pg": "^8.11.3",
-    "@layer-ai/sdk": "^2.3.0"
+    "@layer-ai/sdk": "^2.5.0"
   },
   "devDependencies": {
     "@types/bcryptjs": "^2.4.6",