@nuxtseo/protocol 0.5.7 → 0.5.9

package/dist/v1/account.d.ts

@@ -396,7 +396,7 @@ export declare const accountUsageOperation: {
         readonly introduced: '1.0.0';
     };
     readonly docs: {
-        readonly summary: 'Read account usage';
+        readonly summary: 'Read Team usage';
         readonly description: 'Returns current Team-scoped public meter readings without spending quota.';
         readonly tags: readonly ["Account"];
         readonly examples: readonly [{
@@ -1193,7 +1193,7 @@ export declare const accountV1Registry: import("./core.js").PublicV1Registry<{
             readonly introduced: '1.0.0';
         };
         readonly docs: {
-            readonly summary: 'Read account usage';
+            readonly summary: 'Read Team usage';
             readonly description: 'Returns current Team-scoped public meter readings without spending quota.';
             readonly tags: readonly ["Account"];
             readonly examples: readonly [{

package/dist/v1/account.js

@@ -85,7 +85,7 @@ export const accountUsageOperation = defineOperation({
     },
     lifecycle: { introduced: '1.0.0' },
     docs: {
-        summary: 'Read account usage',
+        summary: 'Read Team usage',
         description: 'Returns current Team-scoped public meter readings without spending quota.',
         tags: ['Account'],
         examples: [{

package/dist/v1/actions.d.ts

@@ -20,7 +20,7 @@ export declare const actionResolveBodySchema: z.ZodObject<{
 }, z.core.$strict>;
 export declare const actionDismissBodySchema: z.ZodObject<{
     artifactVersion: z.ZodString;
-    note: z.ZodOptional<z.ZodString>;
+    note: z.ZodString;
 }, z.core.$strict>;
 /**
  * `url` is the URL the finding was observed on and stays exactly as observed —
@@ -1054,8 +1054,9 @@ export declare const actionEvidenceItemSchema: z.ZodDiscriminatedUnion<[z.ZodObj
 }, z.core.$strict>, z.ZodObject<{
     _tag: z.ZodLiteral<"element">;
     id: z.ZodString;
-    selector: z.ZodString;
+    selector: z.ZodOptional<z.ZodString>;
     snippet: z.ZodNullable<z.ZodString>;
+    explanation: z.ZodOptional<z.ZodString>;
     page: z.ZodNullable<z.ZodString>;
 }, z.core.$strict>], "_tag">;
 export declare const actionEvidenceItemClientSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -1083,8 +1084,9 @@ export declare const actionEvidenceItemClientSchema: z.ZodDiscriminatedUnion<[z.
 }, z.core.$loose>, z.ZodObject<{
     _tag: z.ZodLiteral<"element">;
     id: z.ZodString;
-    selector: z.ZodString;
+    selector: z.ZodOptional<z.ZodString>;
     snippet: z.ZodNullable<z.ZodString>;
+    explanation: z.ZodOptional<z.ZodString>;
     page: z.ZodNullable<z.ZodString>;
 }, z.core.$loose>], "_tag">;
 export declare const actionVerifierSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -1165,8 +1167,9 @@ export declare const actionEvidenceGroupSchema: import("./core.js").CompatibleRe
     }, z.core.$strict>, z.ZodObject<{
         _tag: z.ZodLiteral<"element">;
         id: z.ZodString;
-        selector: z.ZodString;
+        selector: z.ZodOptional<z.ZodString>;
         snippet: z.ZodNullable<z.ZodString>;
+        explanation: z.ZodOptional<z.ZodString>;
         page: z.ZodNullable<z.ZodString>;
     }, z.core.$strict>], "_tag">>;
     readonly nextCursor: z.ZodNullable<z.ZodString>;
@@ -1224,8 +1227,9 @@ export declare const actionEvidenceGroupSchema: import("./core.js").CompatibleRe
     }, z.core.$loose>, z.ZodObject<{
         _tag: z.ZodLiteral<"element">;
         id: z.ZodString;
-        selector: z.ZodString;
+        selector: z.ZodOptional<z.ZodString>;
         snippet: z.ZodNullable<z.ZodString>;
+        explanation: z.ZodOptional<z.ZodString>;
         page: z.ZodNullable<z.ZodString>;
     }, z.core.$loose>], "_tag">>;
     readonly nextCursor: z.ZodNullable<z.ZodString>;
@@ -1318,8 +1322,9 @@ export declare const actionShowDataSchema: import("./core.js").CompatibleRespons
         }, z.core.$strict>, z.ZodObject<{
             _tag: z.ZodLiteral<"element">;
             id: z.ZodString;
-            selector: z.ZodString;
+            selector: z.ZodOptional<z.ZodString>;
             snippet: z.ZodNullable<z.ZodString>;
+            explanation: z.ZodOptional<z.ZodString>;
             page: z.ZodNullable<z.ZodString>;
         }, z.core.$strict>], "_tag">>;
         readonly nextCursor: z.ZodNullable<z.ZodString>;
@@ -1412,8 +1417,9 @@ export declare const actionShowDataSchema: import("./core.js").CompatibleRespons
         }, z.core.$loose>, z.ZodObject<{
             _tag: z.ZodLiteral<"element">;
             id: z.ZodString;
-            selector: z.ZodString;
+            selector: z.ZodOptional<z.ZodString>;
             snippet: z.ZodNullable<z.ZodString>;
+            explanation: z.ZodOptional<z.ZodString>;
             page: z.ZodNullable<z.ZodString>;
         }, z.core.$loose>], "_tag">>;
         readonly nextCursor: z.ZodNullable<z.ZodString>;
@@ -1508,8 +1514,9 @@ export declare const actionShowResponseSchema: import("./core.js").CompatibleRes
             }, z.core.$strict>, z.ZodObject<{
                 _tag: z.ZodLiteral<"element">;
                 id: z.ZodString;
-                selector: z.ZodString;
+                selector: z.ZodOptional<z.ZodString>;
                 snippet: z.ZodNullable<z.ZodString>;
+                explanation: z.ZodOptional<z.ZodString>;
                 page: z.ZodNullable<z.ZodString>;
             }, z.core.$strict>], "_tag">>;
             readonly nextCursor: z.ZodNullable<z.ZodString>;
@@ -1608,8 +1615,9 @@ export declare const actionShowResponseSchema: import("./core.js").CompatibleRes
             }, z.core.$loose>, z.ZodObject<{
                 _tag: z.ZodLiteral<"element">;
                 id: z.ZodString;
-                selector: z.ZodString;
+                selector: z.ZodOptional<z.ZodString>;
                 snippet: z.ZodNullable<z.ZodString>;
+                explanation: z.ZodOptional<z.ZodString>;
                 page: z.ZodNullable<z.ZodString>;
             }, z.core.$loose>], "_tag">>;
             readonly nextCursor: z.ZodNullable<z.ZodString>;
@@ -2287,8 +2295,9 @@ export declare const actionShowOperation: {
                     }, z.core.$strict>, z.ZodObject<{
                         _tag: z.ZodLiteral<"element">;
                         id: z.ZodString;
-                        selector: z.ZodString;
+                        selector: z.ZodOptional<z.ZodString>;
                         snippet: z.ZodNullable<z.ZodString>;
+                        explanation: z.ZodOptional<z.ZodString>;
                         page: z.ZodNullable<z.ZodString>;
                     }, z.core.$strict>], "_tag">>;
                     readonly nextCursor: z.ZodNullable<z.ZodString>;
@@ -2387,8 +2396,9 @@ export declare const actionShowOperation: {
                     }, z.core.$loose>, z.ZodObject<{
                         _tag: z.ZodLiteral<"element">;
                         id: z.ZodString;
-                        selector: z.ZodString;
+                        selector: z.ZodOptional<z.ZodString>;
                         snippet: z.ZodNullable<z.ZodString>;
+                        explanation: z.ZodOptional<z.ZodString>;
                         page: z.ZodNullable<z.ZodString>;
                     }, z.core.$loose>], "_tag">>;
                     readonly nextCursor: z.ZodNullable<z.ZodString>;
@@ -2728,9 +2738,8 @@ export declare const actionDismissResponseSchema: import("./core.js").Compatible
 }, z.core.$strip>>;
 export type ActionDismiss = z.output<typeof actionDismissDataSchema.client>;
 /**
- * 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.
+ * A required note records the owner's decision to dismiss reviewed work. The
+ * artifactVersion fence still applies, and dismissal never claims a verified fix.
  */
 export declare const actionDismissOperation: {
     readonly id: 'actions.dismiss';
@@ -2758,7 +2767,7 @@ export declare const actionDismissOperation: {
         readonly headers: null;
         readonly body: z.ZodObject<{
             artifactVersion: z.ZodString;
-            note: z.ZodOptional<z.ZodString>;
+            note: z.ZodString;
         }, z.core.$strict>;
     };
     readonly responses: {
@@ -2859,33 +2868,9 @@ export declare const actionDismissOperation: {
     };
     readonly docs: {
         readonly summary: 'Dismiss an action';
-        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 description: 'Records an owner decision to dismiss an action. A note must explain why it is intentional or incorrect. 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: {
-                readonly params: {
-                    readonly siteId: 'site_01JXYZ';
-                    readonly actionId: 'action_01JXYZ';
-                };
-                readonly body: {
-                    readonly artifactVersion: 'te2:action_01JXYZ:scope';
-                };
-            };
-            readonly response: {
-                readonly status: 200;
-                readonly body: {
-                    readonly data: {
-                        readonly actionId: 'action_01JXYZ';
-                        readonly status: 'dismissed';
-                        readonly message: 'Dismissed. This page can stay removed.';
-                    };
-                    readonly meta: {
-                        readonly requestId: 'req_01JXYZ';
-                        readonly version: '1.0';
-                    };
-                };
-            };
-        }, {
             readonly request: {
                 readonly params: {
                     readonly siteId: 'site_01JXYZ';
@@ -3513,8 +3498,9 @@ export declare const actionsV1Registry: import("./core.js").PublicV1Registry<{
                         }, z.core.$strict>, z.ZodObject<{
                             _tag: z.ZodLiteral<"element">;
                             id: z.ZodString;
-                            selector: z.ZodString;
+                            selector: z.ZodOptional<z.ZodString>;
                             snippet: z.ZodNullable<z.ZodString>;
+                            explanation: z.ZodOptional<z.ZodString>;
                             page: z.ZodNullable<z.ZodString>;
                         }, z.core.$strict>], "_tag">>;
                         readonly nextCursor: z.ZodNullable<z.ZodString>;
@@ -3613,8 +3599,9 @@ export declare const actionsV1Registry: import("./core.js").PublicV1Registry<{
                         }, z.core.$loose>, z.ZodObject<{
                             _tag: z.ZodLiteral<"element">;
                             id: z.ZodString;
-                            selector: z.ZodString;
+                            selector: z.ZodOptional<z.ZodString>;
                             snippet: z.ZodNullable<z.ZodString>;
+                            explanation: z.ZodOptional<z.ZodString>;
                             page: z.ZodNullable<z.ZodString>;
                         }, z.core.$loose>], "_tag">>;
                         readonly nextCursor: z.ZodNullable<z.ZodString>;
@@ -3948,7 +3935,7 @@ export declare const actionsV1Registry: import("./core.js").PublicV1Registry<{
             readonly headers: null;
             readonly body: z.ZodObject<{
                 artifactVersion: z.ZodString;
-                note: z.ZodOptional<z.ZodString>;
+                note: z.ZodString;
             }, z.core.$strict>;
         };
         readonly responses: {
@@ -4049,33 +4036,9 @@ export declare const actionsV1Registry: import("./core.js").PublicV1Registry<{
         };
         readonly docs: {
             readonly summary: 'Dismiss an action';
-            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 description: 'Records an owner decision to dismiss an action. A note must explain why it is intentional or incorrect. 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: {
-                    readonly params: {
-                        readonly siteId: 'site_01JXYZ';
-                        readonly actionId: 'action_01JXYZ';
-                    };
-                    readonly body: {
-                        readonly artifactVersion: 'te2:action_01JXYZ:scope';
-                    };
-                };
-                readonly response: {
-                    readonly status: 200;
-                    readonly body: {
-                        readonly data: {
-                            readonly actionId: 'action_01JXYZ';
-                            readonly status: 'dismissed';
-                            readonly message: 'Dismissed. This page can stay removed.';
-                        };
-                        readonly meta: {
-                            readonly requestId: 'req_01JXYZ';
-                            readonly version: '1.0';
-                        };
-                    };
-                };
-            }, {
                 readonly request: {
                     readonly params: {
                         readonly siteId: 'site_01JXYZ';

package/dist/v1/actions.js

@@ -21,7 +21,7 @@ export const actionResolveBodySchema = schema.strictObject({
 });
 export const actionDismissBodySchema = schema.strictObject({
     artifactVersion: schema.string().min(1),
-    note: schema.string().trim().min(1).max(2000).optional(),
+    note: schema.string().trim().min(1).max(2000),
 });
 /**
  * `url` is the URL the finding was observed on and stays exactly as observed —
@@ -216,10 +216,11 @@ export const actionEvidenceItemSchema = schema.discriminatedUnion('_tag', [
     schema.strictObject({
         _tag: schema.literal('element'),
         id: schema.string().min(1),
-        selector: schema.string().min(1),
+        selector: schema.string().min(1).optional(),
         snippet: schema.string().min(1).nullable(),
+        explanation: schema.string().min(1).max(2048).optional(),
         page: schema.string().url().nullable(),
-    }),
+    }).refine(item => Boolean(item.selector || item.snippet || item.explanation)),
 ]);
 export const actionEvidenceItemClientSchema = schema.discriminatedUnion('_tag', [
     schema.looseObject({
@@ -251,10 +252,11 @@ export const actionEvidenceItemClientSchema = schema.discriminatedUnion('_tag',
     schema.looseObject({
         _tag: schema.literal('element'),
         id: schema.string().min(1),
-        selector: schema.string().min(1),
+        selector: schema.string().min(1).optional(),
         snippet: schema.string().min(1).nullable(),
+        explanation: schema.string().min(1).max(2048).optional(),
         page: schema.string().url().nullable(),
-    }),
+    }).refine(item => Boolean(item.selector || item.snippet || item.explanation)),
 ]);
 export const actionVerifierSchema = schema.discriminatedUnion('_tag', [
     schema.strictObject({ _tag: schema.literal('target-healthy'), url: schema.string().url() }),
@@ -533,9 +535,8 @@ export const actionDismissDataSchema = defineResponseObject({
 });
 export const actionDismissResponseSchema = defineSuccessEnvelope(actionDismissDataSchema);
 /**
- * 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.
+ * A required note records the owner's decision to dismiss reviewed work. The
+ * artifactVersion fence still applies, and dismissal never claims a verified fix.
  */
 export const actionDismissOperation = defineOperation({
     id: 'actions.dismiss',
@@ -578,21 +579,9 @@ export const actionDismissOperation = defineOperation({
     lifecycle: { introduced: '1.2.0' },
     docs: {
         summary: 'Dismiss an action',
-        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.',
+        description: 'Records an owner decision to dismiss an action. A note must explain why it is intentional or incorrect. 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: {
-                    params: { siteId: 'site_01JXYZ', actionId: 'action_01JXYZ' },
-                    body: { artifactVersion: 'te2:action_01JXYZ:scope' },
-                },
-                response: {
-                    status: 200,
-                    body: {
-                        data: { actionId: 'action_01JXYZ', status: 'dismissed', message: 'Dismissed. This page can stay removed.' },
-                        meta: { requestId: 'req_01JXYZ', version: '1.0' },
-                    },
-                },
-            }, {
                 request: {
                     params: { siteId: 'site_01JXYZ', actionId: 'action_01JXYZ' },
                     body: {

package/dist/v1/backlinks.d.ts

@@ -1830,7 +1830,7 @@ export declare const referringDomainSchema: import("./core.js").CompatibleRespon
     readonly spamScore: z.ZodNullable<z.ZodNumber>;
     readonly firstSeen: z.ZodNullable<z.ZodString>;
     readonly lostDate: z.ZodNullable<z.ZodString>;
-    /** 90-day referral sessions from this domain, or null when no Web Analytics property is linked. */
+    /** Recorded 90-day referral sessions grouped by this domain, or null when unavailable or omitted from the capped response. */
     readonly sessions: z.ZodNullable<z.ZodNumber>;
     /**
      * The id of the Link Spam Network this domain is a known member of, as in
@@ -1865,7 +1865,7 @@ export declare const referringDomainsDataSchema: import("./core.js").CompatibleR
         readonly spamScore: z.ZodNullable<z.ZodNumber>;
         readonly firstSeen: z.ZodNullable<z.ZodString>;
         readonly lostDate: z.ZodNullable<z.ZodString>;
-        /** 90-day referral sessions from this domain, or null when no Web Analytics property is linked. */
+        /** Recorded 90-day referral sessions grouped by this domain, or null when unavailable or omitted from the capped response. */
         readonly sessions: z.ZodNullable<z.ZodNumber>;
         /**
          * The id of the Link Spam Network this domain is a known member of, as in
@@ -1953,7 +1953,7 @@ export declare const referringDomainsResponseSchema: import("./core.js").Compati
             readonly spamScore: z.ZodNullable<z.ZodNumber>;
             readonly firstSeen: z.ZodNullable<z.ZodString>;
             readonly lostDate: z.ZodNullable<z.ZodString>;
-            /** 90-day referral sessions from this domain, or null when no Web Analytics property is linked. */
+            /** Recorded 90-day referral sessions grouped by this domain, or null when unavailable or omitted from the capped response. */
             readonly sessions: z.ZodNullable<z.ZodNumber>;
             /**
              * The id of the Link Spam Network this domain is a known member of, as in
@@ -2083,7 +2083,7 @@ export declare const referringDomainsOperation: {
                     readonly spamScore: z.ZodNullable<z.ZodNumber>;
                     readonly firstSeen: z.ZodNullable<z.ZodString>;
                     readonly lostDate: z.ZodNullable<z.ZodString>;
-                    /** 90-day referral sessions from this domain, or null when no Web Analytics property is linked. */
+                    /** Recorded 90-day referral sessions grouped by this domain, or null when unavailable or omitted from the capped response. */
                     readonly sessions: z.ZodNullable<z.ZodNumber>;
                     /**
                      * The id of the Link Spam Network this domain is a known member of, as in
@@ -2246,7 +2246,7 @@ export declare const referringDomainsOperation: {
     };
     readonly docs: {
         readonly summary: 'List referring domains';
-        readonly description: 'Returns the domains that link to the Site, highest authority first, with spam score and broken-link counts. When a Web Analytics property is linked, each row also carries its 90-day referral sessions, so a link that sends nobody is visible. A row that is a known member of a link spam network carries its id. Cached reads consume no units.';
+        readonly description: 'Returns the domains that link to the Site, highest authority first, with spam score and broken-link counts. When a Web Analytics property is linked, returned domain rows can carry recorded 90-day referral sessions. Missing or omitted domain counts remain null. These counts do not attribute sessions to individual backlinks. A row that is a known member of a link spam network carries its id. Cached reads consume no units.';
         readonly tags: readonly ["Research"];
         readonly examples: readonly [{
             readonly request: {
@@ -3781,7 +3781,7 @@ export declare const backlinksV1Registry: import("./core.js").PublicV1Registry<{
                         readonly spamScore: z.ZodNullable<z.ZodNumber>;
                         readonly firstSeen: z.ZodNullable<z.ZodString>;
                         readonly lostDate: z.ZodNullable<z.ZodString>;
-                        /** 90-day referral sessions from this domain, or null when no Web Analytics property is linked. */
+                        /** Recorded 90-day referral sessions grouped by this domain, or null when unavailable or omitted from the capped response. */
                         readonly sessions: z.ZodNullable<z.ZodNumber>;
                         /**
                          * The id of the Link Spam Network this domain is a known member of, as in
@@ -3944,7 +3944,7 @@ export declare const backlinksV1Registry: import("./core.js").PublicV1Registry<{
         };
         readonly docs: {
             readonly summary: 'List referring domains';
-            readonly description: 'Returns the domains that link to the Site, highest authority first, with spam score and broken-link counts. When a Web Analytics property is linked, each row also carries its 90-day referral sessions, so a link that sends nobody is visible. A row that is a known member of a link spam network carries its id. Cached reads consume no units.';
+            readonly description: 'Returns the domains that link to the Site, highest authority first, with spam score and broken-link counts. When a Web Analytics property is linked, returned domain rows can carry recorded 90-day referral sessions. Missing or omitted domain counts remain null. These counts do not attribute sessions to individual backlinks. A row that is a known member of a link spam network carries its id. Cached reads consume no units.';
             readonly tags: readonly ["Research"];
             readonly examples: readonly [{
                 readonly request: {

package/dist/v1/backlinks.js

@@ -506,7 +506,7 @@ export const referringDomainSchema = defineResponseObject({
     spamScore: nullableCount,
     firstSeen: schema.string().nullable(),
     lostDate: schema.string().nullable(),
-    /** 90-day referral sessions from this domain, or null when no Web Analytics property is linked. */
+    /** Recorded 90-day referral sessions grouped by this domain, or null when unavailable or omitted from the capped response. */
     sessions: nullableCount,
     /**
      * The id of the Link Spam Network this domain is a known member of, as in
@@ -559,7 +559,7 @@ export const referringDomainsOperation = defineOperation({
     lifecycle: { introduced: '1.2.0' },
     docs: {
         summary: 'List referring domains',
-        description: 'Returns the domains that link to the Site, highest authority first, with spam score and broken-link counts. When a Web Analytics property is linked, each row also carries its 90-day referral sessions, so a link that sends nobody is visible. A row that is a known member of a link spam network carries its id. Cached reads consume no units.',
+        description: 'Returns the domains that link to the Site, highest authority first, with spam score and broken-link counts. When a Web Analytics property is linked, returned domain rows can carry recorded 90-day referral sessions. Missing or omitted domain counts remain null. These counts do not attribute sessions to individual backlinks. A row that is a known member of a link spam network carries its id. Cached reads consume no units.',
         tags: ['Research'],
         examples: [{
                 request: { params: { siteId: 'site_01JXYZ' }, query: { limit: 100 } },