specweave 0.21.2 → 0.22.0

package/dist/src/core/serverless/cost-estimator.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Serverless Cost Estimator
+ *
+ * Calculates accurate costs for serverless platforms including:
+ * - Compute costs (GB-seconds)
+ * - Request costs
+ * - Data transfer costs
+ * - Free tier deductions
+ */
+import type { ServerlessPlatform } from './types.js';
+/**
+ * Input parameters for cost estimation
+ */
+export interface CostEstimationInput {
+    requestsPerMonth: number;
+    avgExecutionTimeMs: number;
+    memoryMb: number;
+    dataTransferGb: number;
+}
+/**
+ * Detailed cost breakdown by category
+ */
+export interface CostBreakdown {
+    compute: number;
+    requests: number;
+    dataTransfer: number;
+    total: number;
+    freeTierDeduction: number;
+    billableAmount: number;
+}
+/**
+ * Complete cost estimation result for a platform
+ */
+export interface CostEstimationResult {
+    platform: ServerlessPlatform;
+    input: CostEstimationInput;
+    breakdown: CostBreakdown;
+    withinFreeTier: boolean;
+    monthlyEstimate: number;
+}
+/**
+ * Estimate costs for a serverless platform
+ *
+ * @param platform - The serverless platform to estimate costs for
+ * @param input - Usage parameters
+ * @returns Detailed cost estimation with breakdown
+ *
+ * @example
+ * ```typescript
+ * const input = {
+ *   requestsPerMonth: 1000000,
+ *   avgExecutionTimeMs: 200,
+ *   memoryMb: 512,
+ *   dataTransferGb: 5
+ * };
+ * const result = estimateCost(platform, input);
+ * console.log(`Monthly cost: $${result.monthlyEstimate}`);
+ * ```
+ */
+export declare function estimateCost(platform: ServerlessPlatform, input: CostEstimationInput): CostEstimationResult;
+/**
+ * Estimate costs by platform ID
+ *
+ * @param platformId - Platform identifier (e.g., 'aws-lambda', 'firebase')
+ * @param input - Usage parameters
+ * @returns Cost estimation result
+ */
+export declare function estimateCostById(platformId: string, input: CostEstimationInput): Promise<CostEstimationResult>;
+//# sourceMappingURL=cost-estimator.d.ts.map

package/dist/src/core/serverless/cost-estimator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-estimator.d.ts","sourceRoot":"","sources":["../../../../src/core/serverless/cost-estimator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGrD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,KAAK,EAAE,mBAAmB,CAAC;IAC3B,SAAS,EAAE,aAAa,CAAC;IACzB,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,EAAE,mBAAmB,GACzB,oBAAoB,CAyDtB;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,oBAAoB,CAAC,CAS/B"}

package/dist/src/core/serverless/cost-estimator.js

@@ -0,0 +1,127 @@
+/**
+ * Serverless Cost Estimator
+ *
+ * Calculates accurate costs for serverless platforms including:
+ * - Compute costs (GB-seconds)
+ * - Request costs
+ * - Data transfer costs
+ * - Free tier deductions
+ */
+import { PlatformDataLoader } from './platform-data-loader.js';
+/**
+ * Estimate costs for a serverless platform
+ *
+ * @param platform - The serverless platform to estimate costs for
+ * @param input - Usage parameters
+ * @returns Detailed cost estimation with breakdown
+ *
+ * @example
+ * ```typescript
+ * const input = {
+ *   requestsPerMonth: 1000000,
+ *   avgExecutionTimeMs: 200,
+ *   memoryMb: 512,
+ *   dataTransferGb: 5
+ * };
+ * const result = estimateCost(platform, input);
+ * console.log(`Monthly cost: $${result.monthlyEstimate}`);
+ * ```
+ */
+export function estimateCost(platform, input) {
+    // Validate input
+    validateInput(input);
+    const { pricing } = platform;
+    // Calculate GB-seconds
+    // Formula: (requests × execution_time_ms × memory_MB) / (1000 × 1024)
+    const gbSeconds = (input.requestsPerMonth * input.avgExecutionTimeMs * input.memoryMb) / (1000 * 1024);
+    // Calculate raw costs before free tier
+    const computeCostRaw = gbSeconds * pricing.payAsYouGo.computePerGbSecond;
+    const requestCostRaw = (input.requestsPerMonth / 1000000) * pricing.payAsYouGo.requestsPer1M;
+    const dataTransferCostRaw = input.dataTransferGb * pricing.payAsYouGo.dataTransferPerGb;
+    // Calculate free tier deductions
+    const freeTierDeduction = calculateFreeTierDeduction({
+        compute: computeCostRaw,
+        requests: requestCostRaw,
+        dataTransfer: dataTransferCostRaw,
+    }, {
+        gbSeconds,
+        requests: input.requestsPerMonth,
+        dataTransferGb: input.dataTransferGb,
+    }, platform);
+    // Calculate billable amounts
+    const computeCost = Math.max(0, computeCostRaw - freeTierDeduction.compute);
+    const requestCost = Math.max(0, requestCostRaw - freeTierDeduction.requests);
+    const dataTransferCost = Math.max(0, dataTransferCostRaw - freeTierDeduction.dataTransfer);
+    const total = computeCostRaw + requestCostRaw + dataTransferCostRaw;
+    const totalFreeTierDeduction = freeTierDeduction.compute + freeTierDeduction.requests + freeTierDeduction.dataTransfer;
+    const billableAmount = computeCost + requestCost + dataTransferCost;
+    const breakdown = {
+        compute: computeCost,
+        requests: requestCost,
+        dataTransfer: dataTransferCost,
+        total,
+        freeTierDeduction: totalFreeTierDeduction,
+        billableAmount,
+    };
+    return {
+        platform,
+        input,
+        breakdown,
+        withinFreeTier: billableAmount === 0,
+        monthlyEstimate: billableAmount,
+    };
+}
+/**
+ * Estimate costs by platform ID
+ *
+ * @param platformId - Platform identifier (e.g., 'aws-lambda', 'firebase')
+ * @param input - Usage parameters
+ * @returns Cost estimation result
+ */
+export async function estimateCostById(platformId, input) {
+    const loader = new PlatformDataLoader();
+    const platform = await loader.loadById(platformId);
+    if (!platform) {
+        throw new Error(`Platform not found: ${platformId}`);
+    }
+    return estimateCost(platform, input);
+}
+/**
+ * Calculate free tier deductions
+ */
+function calculateFreeTierDeduction(costs, usage, platform) {
+    const { freeTier, payAsYouGo } = platform.pricing;
+    // Calculate how much of each resource is covered by free tier
+    const freeComputeGbSeconds = Math.min(usage.gbSeconds, freeTier.computeGbSeconds);
+    const freeRequests = Math.min(usage.requests, freeTier.requests);
+    const freeDataTransferGb = Math.min(usage.dataTransferGb, freeTier.dataTransferGb);
+    // Calculate the monetary value of free tier coverage
+    const computeDeduction = freeComputeGbSeconds * payAsYouGo.computePerGbSecond;
+    const requestsDeduction = (freeRequests / 1000000) * payAsYouGo.requestsPer1M;
+    const dataTransferDeduction = freeDataTransferGb * payAsYouGo.dataTransferPerGb;
+    return {
+        compute: Math.min(computeDeduction, costs.compute),
+        requests: Math.min(requestsDeduction, costs.requests),
+        dataTransfer: Math.min(dataTransferDeduction, costs.dataTransfer),
+    };
+}
+/**
+ * Validate cost estimation input
+ */
+function validateInput(input) {
+    if (input.requestsPerMonth < 0) {
+        throw new Error('Requests per month cannot be negative');
+    }
+    if (input.avgExecutionTimeMs < 0) {
+        throw new Error('Average execution time cannot be negative');
+    }
+    if (input.memoryMb < 0) {
+        throw new Error('Memory cannot be negative');
+    }
+    if (input.dataTransferGb < 0) {
+        throw new Error('Data transfer cannot be negative');
+    }
+    // Zero requests is valid (e.g., for testing or estimation purposes)
+    // No warning needed as it's a valid scenario
+}
+//# sourceMappingURL=cost-estimator.js.map

package/dist/src/core/serverless/cost-estimator.js.map

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

package/dist/src/core/serverless/cost-optimizer.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Serverless Cost Optimizer
+ *
+ * Analyzes usage patterns and provides optimization recommendations to reduce costs:
+ * - Memory right-sizing
+ * - Caching strategies
+ * - Batching recommendations
+ * - Reserved capacity
+ * - Compression
+ * - CDN usage
+ */
+import type { ServerlessPlatform } from './types.js';
+import type { CostEstimationInput } from './cost-estimator.js';
+/**
+ * Types of optimization recommendations
+ */
+export type OptimizationType = 'memory' | 'caching' | 'batching' | 'reserved-capacity' | 'compression' | 'cdn';
+/**
+ * Individual optimization recommendation
+ */
+export interface OptimizationRecommendation {
+    type: OptimizationType;
+    description: string;
+    estimatedSavings: number;
+    implementationComplexity: 'low' | 'medium' | 'high';
+    priority: 'high' | 'medium' | 'low';
+}
+/**
+ * Complete cost optimization analysis result
+ */
+export interface CostOptimizationResult {
+    currentCost: number;
+    optimizedCost: number;
+    potentialSavings: number;
+    recommendations: OptimizationRecommendation[];
+}
+/**
+ * Analyze usage and generate cost optimization recommendations
+ *
+ * @param platform - The serverless platform
+ * @param input - Current usage parameters
+ * @returns Optimization analysis with recommendations
+ *
+ * @example
+ * ```typescript
+ * const input = {
+ *   requestsPerMonth: 5000000,
+ *   avgExecutionTimeMs: 500,
+ *   memoryMb: 1024,
+ *   dataTransferGb: 50
+ * };
+ * const result = optimizeCost(platform, input);
+ * console.log(`Potential savings: $${result.potentialSavings}/month`);
+ * ```
+ */
+export declare function optimizeCost(platform: ServerlessPlatform, input: CostEstimationInput): CostOptimizationResult;
+//# sourceMappingURL=cost-optimizer.d.ts.map

package/dist/src/core/serverless/cost-optimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-optimizer.d.ts","sourceRoot":"","sources":["../../../../src/core/serverless/cost-optimizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG/D;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,QAAQ,GACR,SAAS,GACT,UAAU,GACV,mBAAmB,GACnB,aAAa,GACb,KAAK,CAAC;AAEV;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,gBAAgB,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,wBAAwB,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpD,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,0BAA0B,EAAE,CAAC;CAC/C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,EAAE,mBAAmB,GACzB,sBAAsB,CA+DxB"}

package/dist/src/core/serverless/cost-optimizer.js

@@ -0,0 +1,221 @@
+/**
+ * Serverless Cost Optimizer
+ *
+ * Analyzes usage patterns and provides optimization recommendations to reduce costs:
+ * - Memory right-sizing
+ * - Caching strategies
+ * - Batching recommendations
+ * - Reserved capacity
+ * - Compression
+ * - CDN usage
+ */
+import { estimateCost } from './cost-estimator.js';
+/**
+ * Analyze usage and generate cost optimization recommendations
+ *
+ * @param platform - The serverless platform
+ * @param input - Current usage parameters
+ * @returns Optimization analysis with recommendations
+ *
+ * @example
+ * ```typescript
+ * const input = {
+ *   requestsPerMonth: 5000000,
+ *   avgExecutionTimeMs: 500,
+ *   memoryMb: 1024,
+ *   dataTransferGb: 50
+ * };
+ * const result = optimizeCost(platform, input);
+ * console.log(`Potential savings: $${result.potentialSavings}/month`);
+ * ```
+ */
+export function optimizeCost(platform, input) {
+    const currentEstimation = estimateCost(platform, input);
+    const currentCost = currentEstimation.monthlyEstimate;
+    const recommendations = [];
+    let optimizedCost = currentCost;
+    // 1. Memory right-sizing
+    const memoryOptimization = analyzeMemoryOptimization(platform, input, currentCost);
+    if (memoryOptimization) {
+        recommendations.push(memoryOptimization);
+        optimizedCost -= memoryOptimization.estimatedSavings;
+    }
+    // 2. Caching recommendations
+    const cachingOptimization = analyzeCachingOpportunity(input, currentCost);
+    if (cachingOptimization) {
+        recommendations.push(cachingOptimization);
+        optimizedCost -= cachingOptimization.estimatedSavings;
+    }
+    // 3. Batching recommendations
+    const batchingOptimization = analyzeBatchingOpportunity(input, currentCost);
+    if (batchingOptimization) {
+        recommendations.push(batchingOptimization);
+        optimizedCost -= batchingOptimization.estimatedSavings;
+    }
+    // 4. Reserved capacity
+    const reservedCapacityOptimization = analyzeReservedCapacity(input, currentCost);
+    if (reservedCapacityOptimization) {
+        recommendations.push(reservedCapacityOptimization);
+        optimizedCost -= reservedCapacityOptimization.estimatedSavings;
+    }
+    // 5. Compression
+    const compressionOptimization = analyzeCompression(input, currentCost);
+    if (compressionOptimization) {
+        recommendations.push(compressionOptimization);
+        optimizedCost -= compressionOptimization.estimatedSavings;
+    }
+    // 6. CDN recommendations
+    const cdnOptimization = analyzeCdnOpportunity(input, currentCost);
+    if (cdnOptimization) {
+        recommendations.push(cdnOptimization);
+        optimizedCost -= cdnOptimization.estimatedSavings;
+    }
+    // Sort recommendations by priority and savings
+    recommendations.sort((a, b) => {
+        const priorityOrder = { high: 3, medium: 2, low: 1 };
+        const priorityDiff = priorityOrder[b.priority] - priorityOrder[a.priority];
+        if (priorityDiff !== 0)
+            return priorityDiff;
+        return b.estimatedSavings - a.estimatedSavings;
+    });
+    return {
+        currentCost,
+        optimizedCost: Math.max(0, optimizedCost),
+        potentialSavings: currentCost - Math.max(0, optimizedCost),
+        recommendations,
+    };
+}
+/**
+ * Analyze memory right-sizing opportunities
+ */
+function analyzeMemoryOptimization(platform, input, currentCost) {
+    // Test different memory configurations
+    const memoryOptions = [128, 256, 512, 1024, 2048];
+    const currentMemory = input.memoryMb;
+    // Only recommend if current memory is not already minimal
+    if (currentMemory <= 128) {
+        return null;
+    }
+    // Find optimal memory (assuming execution time might improve with more memory)
+    let bestMemory = currentMemory;
+    let bestCost = currentCost;
+    for (const memory of memoryOptions) {
+        if (memory >= currentMemory)
+            continue; // Only test smaller sizes
+        const testInput = { ...input, memoryMb: memory };
+        const estimation = estimateCost(platform, testInput);
+        if (estimation.monthlyEstimate < bestCost) {
+            bestCost = estimation.monthlyEstimate;
+            bestMemory = memory;
+        }
+    }
+    if (bestMemory < currentMemory) {
+        const savings = currentCost - bestCost;
+        const savingsPercent = ((savings / currentCost) * 100).toFixed(1);
+        return {
+            type: 'memory',
+            description: `Reduce memory from ${currentMemory}MB to ${bestMemory}MB. This could save ${savingsPercent}% on compute costs. Test thoroughly to ensure performance is acceptable.`,
+            estimatedSavings: savings,
+            implementationComplexity: 'low',
+            priority: savings > currentCost * 0.2 ? 'high' : 'medium',
+        };
+    }
+    return null;
+}
+/**
+ * Analyze caching opportunities
+ */
+function analyzeCachingOpportunity(input, currentCost) {
+    // High request rate with potential for repetitive queries
+    const requestsPerSecond = input.requestsPerMonth / (30 * 24 * 60 * 60);
+    if (requestsPerSecond > 10) {
+        // Assume 30-50% of requests could be cached
+        const cacheHitRate = 0.4;
+        const estimatedSavings = currentCost * cacheHitRate * 0.9; // 90% reduction for cached requests
+        return {
+            type: 'caching',
+            description: `Implement caching (Redis, CloudFront, or API Gateway caching) to reduce function invocations. With ~${requestsPerSecond.toFixed(1)} requests/second, caching could eliminate 30-50% of function calls.`,
+            estimatedSavings,
+            implementationComplexity: 'medium',
+            priority: estimatedSavings > currentCost * 0.2 ? 'high' : 'medium',
+        };
+    }
+    return null;
+}
+/**
+ * Analyze batching opportunities
+ */
+function analyzeBatchingOpportunity(input, currentCost) {
+    // Many small invocations that could be batched
+    if (input.requestsPerMonth > 1000000 && input.avgExecutionTimeMs < 100) {
+        // Batching could reduce invocations by 80%
+        const estimatedSavings = currentCost * 0.5; // Conservative 50% savings
+        return {
+            type: 'batching',
+            description: `Batch multiple operations together to reduce invocation count. With ${(input.requestsPerMonth / 1000000).toFixed(1)}M short invocations, batching could significantly reduce request costs.`,
+            estimatedSavings,
+            implementationComplexity: 'high',
+            priority: estimatedSavings > currentCost * 0.3 ? 'high' : 'medium',
+        };
+    }
+    return null;
+}
+/**
+ * Analyze reserved capacity opportunities
+ */
+function analyzeReservedCapacity(input, currentCost) {
+    // High consistent traffic (AWS Lambda offers provisioned concurrency)
+    const requestsPerSecond = input.requestsPerMonth / (30 * 24 * 60 * 60);
+    if (requestsPerSecond > 100 && currentCost > 500) {
+        // Reserved capacity typically saves 20-40%
+        const estimatedSavings = currentCost * 0.3;
+        return {
+            type: 'reserved-capacity',
+            description: `Consider provisioned concurrency (AWS Lambda) or reserved capacity. With high consistent traffic (~${requestsPerSecond.toFixed(0)} req/s), reserved capacity could save 20-40% and eliminate cold starts.`,
+            estimatedSavings,
+            implementationComplexity: 'low',
+            priority: 'high',
+        };
+    }
+    return null;
+}
+/**
+ * Analyze compression opportunities
+ */
+function analyzeCompression(input, currentCost) {
+    // High data transfer
+    if (input.dataTransferGb > 100) {
+        // Compression can reduce transfer by 60-80%
+        const compressionRatio = 0.7;
+        const dataTransferCostRatio = 0.2; // Assume ~20% of total cost is data transfer
+        const estimatedSavings = currentCost * dataTransferCostRatio * compressionRatio;
+        return {
+            type: 'compression',
+            description: `Enable response compression (gzip/brotli) to reduce data transfer costs. With ${input.dataTransferGb.toFixed(0)}GB/month, compression could reduce transfer by 60-80%.`,
+            estimatedSavings,
+            implementationComplexity: 'low',
+            priority: estimatedSavings > 50 ? 'high' : 'medium',
+        };
+    }
+    return null;
+}
+/**
+ * Analyze CDN opportunities
+ */
+function analyzeCdnOpportunity(input, currentCost) {
+    // High read traffic that could benefit from edge caching
+    if (input.requestsPerMonth > 10000000 && input.dataTransferGb > 50) {
+        // CDN can reduce origin requests by 70-90%
+        const cdnCacheRate = 0.8;
+        const estimatedSavings = currentCost * cdnCacheRate * 0.6;
+        return {
+            type: 'cdn',
+            description: `Use a CDN (CloudFront, Cloudflare, Fastly) to cache static content and reduce origin requests. With ${(input.requestsPerMonth / 1000000).toFixed(1)}M requests, a CDN could cache 70-90% of traffic.`,
+            estimatedSavings,
+            implementationComplexity: 'medium',
+            priority: estimatedSavings > currentCost * 0.4 ? 'high' : 'medium',
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=cost-optimizer.js.map

package/dist/src/core/serverless/cost-optimizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-optimizer.js","sourceRoot":"","sources":["../../../../src/core/serverless/cost-optimizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAkCnD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,YAAY,CAC1B,QAA4B,EAC5B,KAA0B;IAE1B,MAAM,iBAAiB,GAAG,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACxD,MAAM,WAAW,GAAG,iBAAiB,CAAC,eAAe,CAAC;IAEtD,MAAM,eAAe,GAAiC,EAAE,CAAC;IACzD,IAAI,aAAa,GAAG,WAAW,CAAC;IAEhC,yBAAyB;IACzB,MAAM,kBAAkB,GAAG,yBAAyB,CAAC,QAAQ,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;IACnF,IAAI,kBAAkB,EAAE,CAAC;QACvB,eAAe,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACzC,aAAa,IAAI,kBAAkB,CAAC,gBAAgB,CAAC;IACvD,CAAC;IAED,6BAA6B;IAC7B,MAAM,mBAAmB,GAAG,yBAAyB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IAC1E,IAAI,mBAAmB,EAAE,CAAC;QACxB,eAAe,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAC1C,aAAa,IAAI,mBAAmB,CAAC,gBAAgB,CAAC;IACxD,CAAC;IAED,8BAA8B;IAC9B,MAAM,oBAAoB,GAAG,0BAA0B,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IAC5E,IAAI,oBAAoB,EAAE,CAAC;QACzB,eAAe,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAC3C,aAAa,IAAI,oBAAoB,CAAC,gBAAgB,CAAC;IACzD,CAAC;IAED,uBAAuB;IACvB,MAAM,4BAA4B,GAAG,uBAAuB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IACjF,IAAI,4BAA4B,EAAE,CAAC;QACjC,eAAe,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QACnD,aAAa,IAAI,4BAA4B,CAAC,gBAAgB,CAAC;IACjE,CAAC;IAED,iBAAiB;IACjB,MAAM,uBAAuB,GAAG,kBAAkB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IACvE,IAAI,uBAAuB,EAAE,CAAC;QAC5B,eAAe,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QAC9C,aAAa,IAAI,uBAAuB,CAAC,gBAAgB,CAAC;IAC5D,CAAC;IAED,yBAAyB;IACzB,MAAM,eAAe,GAAG,qBAAqB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IAClE,IAAI,eAAe,EAAE,CAAC;QACpB,eAAe,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACtC,aAAa,IAAI,eAAe,CAAC,gBAAgB,CAAC;IACpD,CAAC;IAED,+CAA+C;IAC/C,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC5B,MAAM,aAAa,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;QACrD,MAAM,YAAY,GAAG,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC3E,IAAI,YAAY,KAAK,CAAC;YAAE,OAAO,YAAY,CAAC;QAC5C,OAAO,CAAC,CAAC,gBAAgB,GAAG,CAAC,CAAC,gBAAgB,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,WAAW;QACX,aAAa,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,CAAC;QACzC,gBAAgB,EAAE,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,CAAC;QAC1D,eAAe;KAChB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,yBAAyB,CAChC,QAA4B,EAC5B,KAA0B,EAC1B,WAAmB;IAEnB,uCAAuC;IACvC,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAClD,MAAM,aAAa,GAAG,KAAK,CAAC,QAAQ,CAAC;IAErC,0DAA0D;IAC1D,IAAI,aAAa,IAAI,GAAG,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,+EAA+E;IAC/E,IAAI,UAAU,GAAG,aAAa,CAAC;IAC/B,IAAI,QAAQ,GAAG,WAAW,CAAC;IAE3B,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;QACnC,IAAI,MAAM,IAAI,aAAa;YAAE,SAAS,CAAC,0BAA0B;QAEjE,MAAM,SAAS,GAAG,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QACjD,MAAM,UAAU,GAAG,YAAY,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAErD,IAAI,UAAU,CAAC,eAAe,GAAG,QAAQ,EAAE,CAAC;YAC1C,QAAQ,GAAG,UAAU,CAAC,eAAe,CAAC;YACtC,UAAU,GAAG,MAAM,CAAC;QACtB,CAAC;IACH,CAAC;IAED,IAAI,UAAU,GAAG,aAAa,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,WAAW,GAAG,QAAQ,CAAC;QACvC,MAAM,cAAc,GAAG,CAAC,CAAC,OAAO,GAAG,WAAW,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAElE,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,sBAAsB,aAAa,SAAS,UAAU,uBAAuB,cAAc,0EAA0E;YAClL,gBAAgB,EAAE,OAAO;YACzB,wBAAwB,EAAE,KAAK;YAC/B,QAAQ,EAAE,OAAO,GAAG,WAAW,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;SAC1D,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAS,yBAAyB,CAChC,KAA0B,EAC1B,WAAmB;IAEnB,0DAA0D;IAC1D,MAAM,iBAAiB,GAAG,KAAK,CAAC,gBAAgB,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IAEvE,IAAI,iBAAiB,GAAG,EAAE,EAAE,CAAC;QAC3B,4CAA4C;QAC5C,MAAM,YAAY,GAAG,GAAG,CAAC;QACzB,MAAM,gBAAgB,GAAG,WAAW,GAAG,YAAY,GAAG,GAAG,CAAC,CAAC,oCAAoC;QAE/F,OAAO;YACL,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,uGAAuG,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,qEAAqE;YACrN,gBAAgB;YAChB,wBAAwB,EAAE,QAAQ;YAClC,QAAQ,EAAE,gBAAgB,GAAG,WAAW,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;SACnE,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAS,0BAA0B,CACjC,KAA0B,EAC1B,WAAmB;IAEnB,+CAA+C;IAC/C,IAAI,KAAK,CAAC,gBAAgB,GAAG,OAAS,IAAI,KAAK,CAAC,kBAAkB,GAAG,GAAG,EAAE,CAAC;QACzE,2CAA2C;QAC3C,MAAM,gBAAgB,GAAG,WAAW,GAAG,GAAG,CAAC,CAAC,2BAA2B;QAEvE,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,uEAAuE,CAAC,KAAK,CAAC,gBAAgB,GAAG,OAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,yEAAyE;YAC5M,gBAAgB;YAChB,wBAAwB,EAAE,MAAM;YAChC,QAAQ,EAAE,gBAAgB,GAAG,WAAW,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;SACnE,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAS,uBAAuB,CAC9B,KAA0B,EAC1B,WAAmB;IAEnB,sEAAsE;IACtE,MAAM,iBAAiB,GAAG,KAAK,CAAC,gBAAgB,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IAEvE,IAAI,iBAAiB,GAAG,GAAG,IAAI,WAAW,GAAG,GAAG,EAAE,CAAC;QACjD,2CAA2C;QAC3C,MAAM,gBAAgB,GAAG,WAAW,GAAG,GAAG,CAAC;QAE3C,OAAO;YACL,IAAI,EAAE,mBAAmB;YACzB,WAAW,EAAE,sGAAsG,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,yEAAyE;YACxN,gBAAgB;YAChB,wBAAwB,EAAE,KAAK;YAC/B,QAAQ,EAAE,MAAM;SACjB,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CACzB,KAA0B,EAC1B,WAAmB;IAEnB,qBAAqB;IACrB,IAAI,KAAK,CAAC,cAAc,GAAG,GAAG,EAAE,CAAC;QAC/B,4CAA4C;QAC5C,MAAM,gBAAgB,GAAG,GAAG,CAAC;QAC7B,MAAM,qBAAqB,GAAG,GAAG,CAAC,CAAC,6CAA6C;QAChF,MAAM,gBAAgB,GAAG,WAAW,GAAG,qBAAqB,GAAG,gBAAgB,CAAC;QAEhF,OAAO;YACL,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,iFAAiF,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,wDAAwD;YACrL,gBAAgB;YAChB,wBAAwB,EAAE,KAAK;YAC/B,QAAQ,EAAE,gBAAgB,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;SACpD,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAC5B,KAA0B,EAC1B,WAAmB;IAEnB,yDAAyD;IACzD,IAAI,KAAK,CAAC,gBAAgB,GAAG,QAAU,IAAI,KAAK,CAAC,cAAc,GAAG,EAAE,EAAE,CAAC;QACrE,2CAA2C;QAC3C,MAAM,YAAY,GAAG,GAAG,CAAC;QACzB,MAAM,gBAAgB,GAAG,WAAW,GAAG,YAAY,GAAG,GAAG,CAAC;QAE1D,OAAO;YACL,IAAI,EAAE,KAAK;YACX,WAAW,EAAE,uGAAuG,CAAC,KAAK,CAAC,gBAAgB,GAAG,OAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,kDAAkD;YACrN,gBAAgB;YAChB,wBAAwB,EAAE,QAAQ;YAClC,QAAQ,EAAE,gBAAgB,GAAG,WAAW,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;SACnE,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/src/core/serverless/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Serverless Architecture Intelligence - Barrel Exports
+ *
+ * This module provides comprehensive serverless platform intelligence including:
+ * - Context detection (pet-project, startup, enterprise)
+ * - Workload suitability analysis
+ * - Platform selection and ranking
+ * - Cost estimation and optimization
+ * - Learning path recommendations
+ */
+export * from './types.js';
+export * from './platform-data-loader.js';
+export * from './context-detector.js';
+export * from './suitability-analyzer.js';
+export * from './platform-selector.js';
+export * from './cost-estimator.js';
+export * from './cost-optimizer.js';
+export * from './cost-comparison.js';
+export * from './learning-path-recommender.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/serverless/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/serverless/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,cAAc,YAAY,CAAC;AAG3B,cAAc,2BAA2B,CAAC;AAG1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAG1C,cAAc,wBAAwB,CAAC;AAGvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,gCAAgC,CAAC"}

package/dist/src/core/serverless/index.js

@@ -0,0 +1,26 @@
+/**
+ * Serverless Architecture Intelligence - Barrel Exports
+ *
+ * This module provides comprehensive serverless platform intelligence including:
+ * - Context detection (pet-project, startup, enterprise)
+ * - Workload suitability analysis
+ * - Platform selection and ranking
+ * - Cost estimation and optimization
+ * - Learning path recommendations
+ */
+// Core types and interfaces
+export * from './types.js';
+// Platform data and loading
+export * from './platform-data-loader.js';
+// Context and suitability analysis
+export * from './context-detector.js';
+export * from './suitability-analyzer.js';
+// Platform selection
+export * from './platform-selector.js';
+// Cost analysis modules
+export * from './cost-estimator.js';
+export * from './cost-optimizer.js';
+export * from './cost-comparison.js';
+// Learning and education
+export * from './learning-path-recommender.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/serverless/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/serverless/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,4BAA4B;AAC5B,cAAc,YAAY,CAAC;AAE3B,4BAA4B;AAC5B,cAAc,2BAA2B,CAAC;AAE1C,mCAAmC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAE1C,qBAAqB;AACrB,cAAc,wBAAwB,CAAC;AAEvC,wBAAwB;AACxB,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AAErC,yBAAyB;AACzB,cAAc,gCAAgC,CAAC"}