@nuxtseo/protocol 0.5.1 → 0.5.4

package/dist/v1/performance.js

@@ -225,10 +225,12 @@ export const fieldVitalSummarySchema = defineResponseObject({
     p75: schema.number().nullable(),
     status: fieldVitalRatingSchema.nullable(),
     deltaOverPeriod: schema.number().nullable(),
+    asOf: schema.string().min(1).nullable(),
 }, {
     p75: schema.number().nullable(),
     status: fieldVitalRatingSchema.nullable(),
     deltaOverPeriod: schema.number().nullable(),
+    asOf: schema.string().min(1).nullable(),
 });
 export const fieldVitalPointSchema = defineResponseObject({ date: schema.string().min(1), p75: schema.number().nullable() }, { date: schema.string().min(1), p75: schema.number().nullable() });
 /**
@@ -330,9 +332,9 @@ export const fieldVitalsOperation = defineOperation({
                             available: true,
                             message: null,
                             summary: {
-                                lcp: { p75: 2400, status: 'needs-improvement', deltaOverPeriod: -150 },
-                                inp: { p75: 180, status: 'good', deltaOverPeriod: 10 },
-                                cls: { p75: 0.08, status: 'good', deltaOverPeriod: null },
+                                lcp: { p75: 2400, status: 'needs-improvement', deltaOverPeriod: -150, asOf: '2026-08-24' },
+                                inp: { p75: 180, status: 'good', deltaOverPeriod: 10, asOf: '2026-08-24' },
+                                cls: { p75: 0.08, status: 'good', deltaOverPeriod: null, asOf: '2026-08-24' },
                                 overall: 'ni',
                                 asOf: '2026-08-24',
                             },
@@ -726,6 +728,42 @@ const scanCoverageShape = {
     bestPracticesChecksTotal: schema.number().int().nonnegative(),
     possiblyTruncated: schema.boolean(),
 };
+const scanJavascriptShape = {
+    transferBytes: nullableMetricSchema,
+    decodedBytes: nullableMetricSchema,
+    scriptCount: schema.number().int().nonnegative().nullable(),
+};
+/** Trace timings are separate from the reported metric under simulated throttling. */
+export const lcpObservedTraceSchema = schema.discriminatedUnion('_tag', [
+    schema.strictObject({
+        _tag: schema.literal('available'),
+        basis: schema.literal('observed'),
+        // PSI can omit the method while retaining valid observed trace timings.
+        throttlingMethod: schema.enum(['simulate', 'provided', 'devtools']).nullable(),
+        observedLcpMs: schema.number().positive(),
+        phases: schema.array(schema.strictObject({
+            id: schema.enum(['timeToFirstByte', 'resourceLoadDelay', 'resourceLoadDuration', 'elementRenderDelay']),
+            durationMs: schema.number().nonnegative(),
+        })).min(2).max(4),
+    }),
+    schema.strictObject({
+        _tag: schema.literal('unavailable'),
+        reason: schema.enum(['missing-report-data', 'invalid-report-data', 'legacy-projection', 'projection-missing', 'projection-unavailable']),
+    }),
+]).superRefine((trace, context) => {
+    if (trace._tag !== 'available')
+        return;
+    const ids = new Set(trace.phases.map(phase => phase.id));
+    const totalMs = trace.phases.reduce((total, phase) => total + phase.durationMs, 0);
+    // The metrics audit rounds observed LCP. Allow rounding, never substitute
+    // the separately reported metric as the phase total.
+    if (ids.size !== trace.phases.length
+        || !ids.has('timeToFirstByte') || !ids.has('elementRenderDelay')
+        || ids.has('resourceLoadDelay') !== ids.has('resourceLoadDuration')
+        || Math.abs(totalMs - trace.observedLcpMs) > 2) {
+        context.addIssue({ code: 'custom', message: 'Trace phases must describe the observed LCP' });
+    }
+});
 export const performanceScanDetailDataSchema = defineResponseObject({
     id: schema.string().min(1),
     url: schema.string().min(1),
@@ -739,6 +777,8 @@ export const performanceScanDetailDataSchema = defineResponseObject({
     speedIndex: nullableMetricSchema,
     ttfb: nullableMetricSchema,
     completedAt: schema.string().datetime().nullable(),
+    javascript: schema.strictObject(scanJavascriptShape).nullable(),
+    observedTrace: lcpObservedTraceSchema.optional(),
     performanceIssues: schema.array(scanPerformanceIssueSchema.producer),
     cachePolicy: schema.array(scanCachePolicySchema.producer),
     thirdParties: schema.array(scanThirdPartySchema.producer),
@@ -763,6 +803,8 @@ export const performanceScanDetailDataSchema = defineResponseObject({
     speedIndex: nullableMetricSchema,
     ttfb: nullableMetricSchema,
     completedAt: schema.string().datetime().nullable(),
+    javascript: schema.looseObject(scanJavascriptShape).nullable().optional(),
+    observedTrace: lcpObservedTraceSchema.optional(),
     performanceIssues: schema.array(scanPerformanceIssueSchema.client),
     cachePolicy: schema.array(scanCachePolicySchema.client),
     thirdParties: schema.array(scanThirdPartySchema.client),
@@ -832,6 +874,7 @@ export const performanceScanDetailOperation = defineOperation({
                             speedIndex: 2400,
                             ttfb: 210,
                             completedAt: '2026-08-10T01:00:00.000Z',
+                            javascript: null,
                             performanceIssues: [],
                             cachePolicy: [],
                             thirdParties: [],