@nuxtseo/protocol 0.5.0 → 0.5.1

package/dist/v1/actions.d.ts

@@ -18,6 +18,10 @@ export declare const actionShowQuerySchema: z.ZodObject<{
 export declare const actionResolveBodySchema: z.ZodObject<{
     artifactVersion: z.ZodString;
 }, z.core.$strict>;
+export declare const actionDismissBodySchema: z.ZodObject<{
+    artifactVersion: z.ZodString;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
 /**
  * `url` is the URL the finding was observed on and stays exactly as observed —
  * it is what verification re-checks. `redirectsTo` is the read-time answer to
@@ -2724,11 +2728,9 @@ export declare const actionDismissResponseSchema: import("./core.js").Compatible
 }, z.core.$strip>>;
 export type ActionDismiss = z.output<typeof actionDismissDataSchema.client>;
 /**
- * Dismissing is the opposite decision from resolving: the page stays gone.
- * It is admitted only for a broken-page Action whose evidence is complete and
- * shows no internal referrer, so a caller cannot use it to hide work. The same
- * `artifactVersion` fence as resolve applies, so a decision made against stale
- * evidence is rejected rather than applied.
+ * An explicit note records the owner's decision to dismiss reviewed work.
+ * Without a note, only complete, unlinked 404/410 evidence admits dismissal.
+ * Both paths retain the artifactVersion fence and never claim a verified fix.
  */
 export declare const actionDismissOperation: {
     readonly id: 'actions.dismiss';
@@ -2756,6 +2758,7 @@ export declare const actionDismissOperation: {
         readonly headers: null;
         readonly body: z.ZodObject<{
             artifactVersion: z.ZodString;
+            note: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>;
     };
     readonly responses: {
@@ -2856,7 +2859,7 @@ export declare const actionDismissOperation: {
     };
     readonly docs: {
         readonly summary: 'Dismiss an action';
-        readonly description: 'Dismisses a broken-page action when its evidence is complete and shows no internal referrers, so the removed page stays removed. It is rejected when the action has other evidence, when it is already decided, or when the artifactVersion no longer matches. The action stays dismissed until a person restores it.';
+        readonly description: 'Records an owner decision to dismiss an action when a note explains why it is intentional or incorrect. Without a note, only complete 404 or 410 evidence with no internal referrers is accepted. Stale details and decided actions are rejected. Dismissal preserves observations and does not verify a fix. The action stays dismissed until a person restores it.';
         readonly tags: readonly ["Actions"];
         readonly examples: readonly [{
             readonly request: {
@@ -2882,6 +2885,31 @@ export declare const actionDismissOperation: {
                     };
                 };
             };
+        }, {
+            readonly request: {
+                readonly params: {
+                    readonly siteId: 'site_01JXYZ';
+                    readonly actionId: 'action_01JXYZ';
+                };
+                readonly body: {
+                    readonly artifactVersion: 'te2:action_01JXYZ:scope';
+                    readonly note: 'Temporary retired sitemap. Review after the recovery gate.';
+                };
+            };
+            readonly response: {
+                readonly status: 200;
+                readonly body: {
+                    readonly data: {
+                        readonly actionId: 'action_01JXYZ';
+                        readonly status: 'dismissed';
+                        readonly message: 'Dismissed. Your note is saved. No fix was verified.';
+                    };
+                    readonly meta: {
+                        readonly requestId: 'req_01JXYZ';
+                        readonly version: '1.0';
+                    };
+                };
+            };
         }];
     };
 };
@@ -3920,6 +3948,7 @@ export declare const actionsV1Registry: import("./core.js").PublicV1Registry<{
             readonly headers: null;
             readonly body: z.ZodObject<{
                 artifactVersion: z.ZodString;
+                note: z.ZodOptional<z.ZodString>;
             }, z.core.$strict>;
         };
         readonly responses: {
@@ -4020,7 +4049,7 @@ export declare const actionsV1Registry: import("./core.js").PublicV1Registry<{
         };
         readonly docs: {
             readonly summary: 'Dismiss an action';
-            readonly description: 'Dismisses a broken-page action when its evidence is complete and shows no internal referrers, so the removed page stays removed. It is rejected when the action has other evidence, when it is already decided, or when the artifactVersion no longer matches. The action stays dismissed until a person restores it.';
+            readonly description: 'Records an owner decision to dismiss an action when a note explains why it is intentional or incorrect. Without a note, only complete 404 or 410 evidence with no internal referrers is accepted. Stale details and decided actions are rejected. Dismissal preserves observations and does not verify a fix. The action stays dismissed until a person restores it.';
             readonly tags: readonly ["Actions"];
             readonly examples: readonly [{
                 readonly request: {
@@ -4046,6 +4075,31 @@ export declare const actionsV1Registry: import("./core.js").PublicV1Registry<{
                         };
                     };
                 };
+            }, {
+                readonly request: {
+                    readonly params: {
+                        readonly siteId: 'site_01JXYZ';
+                        readonly actionId: 'action_01JXYZ';
+                    };
+                    readonly body: {
+                        readonly artifactVersion: 'te2:action_01JXYZ:scope';
+                        readonly note: 'Temporary retired sitemap. Review after the recovery gate.';
+                    };
+                };
+                readonly response: {
+                    readonly status: 200;
+                    readonly body: {
+                        readonly data: {
+                            readonly actionId: 'action_01JXYZ';
+                            readonly status: 'dismissed';
+                            readonly message: 'Dismissed. Your note is saved. No fix was verified.';
+                        };
+                        readonly meta: {
+                            readonly requestId: 'req_01JXYZ';
+                            readonly version: '1.0';
+                        };
+                    };
+                };
             }];
         };
     };

package/dist/v1/actions.js

@@ -19,6 +19,10 @@ export const actionShowQuerySchema = schema.strictObject({
 export const actionResolveBodySchema = schema.strictObject({
     artifactVersion: schema.string().min(1),
 });
+export const actionDismissBodySchema = schema.strictObject({
+    artifactVersion: schema.string().min(1),
+    note: schema.string().trim().min(1).max(2000).optional(),
+});
 /**
  * `url` is the URL the finding was observed on and stays exactly as observed —
  * it is what verification re-checks. `redirectsTo` is the read-time answer to
@@ -529,11 +533,9 @@ export const actionDismissDataSchema = defineResponseObject({
 });
 export const actionDismissResponseSchema = defineSuccessEnvelope(actionDismissDataSchema);
 /**
- * Dismissing is the opposite decision from resolving: the page stays gone.
- * It is admitted only for a broken-page Action whose evidence is complete and
- * shows no internal referrer, so a caller cannot use it to hide work. The same
- * `artifactVersion` fence as resolve applies, so a decision made against stale
- * evidence is rejected rather than applied.
+ * An explicit note records the owner's decision to dismiss reviewed work.
+ * Without a note, only complete, unlinked 404/410 evidence admits dismissal.
+ * Both paths retain the artifactVersion fence and never claim a verified fix.
  */
 export const actionDismissOperation = defineOperation({
     id: 'actions.dismiss',
@@ -547,7 +549,7 @@ export const actionDismissOperation = defineOperation({
         minimumRole: 'member',
         ownership: 'site',
     },
-    request: { params: actionParamsSchema, query: null, headers: null, body: actionResolveBodySchema },
+    request: { params: actionParamsSchema, query: null, headers: null, body: actionDismissBodySchema },
     responses: { 200: actionDismissResponseSchema },
     errors: [
         'invalid_request',
@@ -576,7 +578,7 @@ export const actionDismissOperation = defineOperation({
     lifecycle: { introduced: '1.2.0' },
     docs: {
         summary: 'Dismiss an action',
-        description: 'Dismisses a broken-page action when its evidence is complete and shows no internal referrers, so the removed page stays removed. It is rejected when the action has other evidence, when it is already decided, or when the artifactVersion no longer matches. The action stays dismissed until a person restores it.',
+        description: 'Records an owner decision to dismiss an action when a note explains why it is intentional or incorrect. Without a note, only complete 404 or 410 evidence with no internal referrers is accepted. Stale details and decided actions are rejected. Dismissal preserves observations and does not verify a fix. The action stays dismissed until a person restores it.',
         tags: ['Actions'],
         examples: [{
                 request: {
@@ -590,6 +592,21 @@ export const actionDismissOperation = defineOperation({
                         meta: { requestId: 'req_01JXYZ', version: '1.0' },
                     },
                 },
+            }, {
+                request: {
+                    params: { siteId: 'site_01JXYZ', actionId: 'action_01JXYZ' },
+                    body: {
+                        artifactVersion: 'te2:action_01JXYZ:scope',
+                        note: 'Temporary retired sitemap. Review after the recovery gate.',
+                    },
+                },
+                response: {
+                    status: 200,
+                    body: {
+                        data: { actionId: 'action_01JXYZ', status: 'dismissed', message: 'Dismissed. Your note is saved. No fix was verified.' },
+                        meta: { requestId: 'req_01JXYZ', version: '1.0' },
+                    },
+                },
             }],
     },
 });

package/dist/v1/gsc.d.ts

@@ -1699,6 +1699,12 @@ export declare const indexingDiagnosticsDataSchema: {
     }, z.core.$strip>, z.ZodObject<{
         readonly view: z.ZodLiteral<"urls">;
         readonly total: z.ZodNumber;
+        /** Lookahead reports a floor until the terminal page; it does not count every matching URL. */
+        readonly totalSemantics: z.ZodEnum<{
+            exact: "exact";
+            "lower-bound": "lower-bound";
+            unknown: "unknown";
+        }>;
         readonly limit: z.ZodNumber;
         readonly offset: z.ZodNumber;
         readonly hasMore: z.ZodBoolean;
@@ -1746,6 +1752,11 @@ export declare const indexingDiagnosticsDataSchema: {
     }, z.core.$strip>, z.ZodObject<{
         readonly view: z.ZodLiteral<"urls">;
         readonly total: z.ZodNumber;
+        readonly totalSemantics: z.ZodEnum<{
+            exact: "exact";
+            "lower-bound": "lower-bound";
+            unknown: "unknown";
+        }>;
         readonly limit: z.ZodNumber;
         readonly offset: z.ZodNumber;
         readonly hasMore: z.ZodBoolean;
@@ -1795,6 +1806,12 @@ export declare const indexingDiagnosticsResponseSchema: import("./core.js").Comp
     }, z.core.$strip>, z.ZodObject<{
         readonly view: z.ZodLiteral<"urls">;
         readonly total: z.ZodNumber;
+        /** Lookahead reports a floor until the terminal page; it does not count every matching URL. */
+        readonly totalSemantics: z.ZodEnum<{
+            exact: "exact";
+            "lower-bound": "lower-bound";
+            unknown: "unknown";
+        }>;
         readonly limit: z.ZodNumber;
         readonly offset: z.ZodNumber;
         readonly hasMore: z.ZodBoolean;
@@ -1847,6 +1864,11 @@ export declare const indexingDiagnosticsResponseSchema: import("./core.js").Comp
     }, z.core.$strip>, z.ZodObject<{
         readonly view: z.ZodLiteral<"urls">;
         readonly total: z.ZodNumber;
+        readonly totalSemantics: z.ZodEnum<{
+            exact: "exact";
+            "lower-bound": "lower-bound";
+            unknown: "unknown";
+        }>;
         readonly limit: z.ZodNumber;
         readonly offset: z.ZodNumber;
         readonly hasMore: z.ZodBoolean;
@@ -3599,6 +3621,12 @@ export declare const indexingDiagnosticsReadOperation: {
             }, z.core.$strip>, z.ZodObject<{
                 readonly view: z.ZodLiteral<"urls">;
                 readonly total: z.ZodNumber;
+                /** Lookahead reports a floor until the terminal page; it does not count every matching URL. */
+                readonly totalSemantics: z.ZodEnum<{
+                    exact: "exact";
+                    "lower-bound": "lower-bound";
+                    unknown: "unknown";
+                }>;
                 readonly limit: z.ZodNumber;
                 readonly offset: z.ZodNumber;
                 readonly hasMore: z.ZodBoolean;
@@ -3651,6 +3679,11 @@ export declare const indexingDiagnosticsReadOperation: {
             }, z.core.$strip>, z.ZodObject<{
                 readonly view: z.ZodLiteral<"urls">;
                 readonly total: z.ZodNumber;
+                readonly totalSemantics: z.ZodEnum<{
+                    exact: "exact";
+                    "lower-bound": "lower-bound";
+                    unknown: "unknown";
+                }>;
                 readonly limit: z.ZodNumber;
                 readonly offset: z.ZodNumber;
                 readonly hasMore: z.ZodBoolean;
@@ -6018,6 +6051,12 @@ export declare const searchV1Registry: import("./core.js").PublicV1Registry<{
                 }, z.core.$strip>, z.ZodObject<{
                     readonly view: z.ZodLiteral<"urls">;
                     readonly total: z.ZodNumber;
+                    /** Lookahead reports a floor until the terminal page; it does not count every matching URL. */
+                    readonly totalSemantics: z.ZodEnum<{
+                        exact: "exact";
+                        "lower-bound": "lower-bound";
+                        unknown: "unknown";
+                    }>;
                     readonly limit: z.ZodNumber;
                     readonly offset: z.ZodNumber;
                     readonly hasMore: z.ZodBoolean;
@@ -6070,6 +6109,11 @@ export declare const searchV1Registry: import("./core.js").PublicV1Registry<{
                 }, z.core.$strip>, z.ZodObject<{
                     readonly view: z.ZodLiteral<"urls">;
                     readonly total: z.ZodNumber;
+                    readonly totalSemantics: z.ZodEnum<{
+                        exact: "exact";
+                        "lower-bound": "lower-bound";
+                        unknown: "unknown";
+                    }>;
                     readonly limit: z.ZodNumber;
                     readonly offset: z.ZodNumber;
                     readonly hasMore: z.ZodBoolean;

package/dist/v1/gsc.js

@@ -375,6 +375,8 @@ const diagnosticsUrlSchema = defineResponseObject({
 const diagnosticsUrlsDataSchema = defineResponseObject({
     view: schema.literal('urls'),
     total: schema.number().int().nonnegative(),
+    /** Lookahead reports a floor until the terminal page; it does not count every matching URL. */
+    totalSemantics: schema.enum(['exact', 'lower-bound', 'unknown']),
     limit: schema.number().int().positive(),
     offset: schema.number().int().nonnegative(),
     hasMore: schema.boolean(),
@@ -382,6 +384,7 @@ const diagnosticsUrlsDataSchema = defineResponseObject({
 }, {
     view: schema.literal('urls'),
     total: schema.number().int().nonnegative(),
+    totalSemantics: schema.enum(['exact', 'lower-bound', 'unknown']),
     limit: schema.number().int().positive(),
     offset: schema.number().int().nonnegative(),
     hasMore: schema.boolean(),