@nuxtseo/protocol 0.1.0

package/dist/v1/sites.d.ts

@@ -0,0 +1,591 @@
+import type { z } from 'zod';
+export declare const siteSearchConsoleStatusSchema: z.ZodEnum<{
+    action_required: "action_required";
+    connected: "connected";
+    disconnected: "disconnected";
+}>;
+export declare const siteMonitoringModeSchema: z.ZodNullable<z.ZodEnum<{
+    full_monitoring: "full_monitoring";
+    search_tracking: "search_tracking";
+}>>;
+export declare const siteMonitoringStatusSchema: z.ZodEnum<{
+    active: "active";
+    archived: "archived";
+    paused: "paused";
+    unconfigured: "unconfigured";
+}>;
+export declare const siteSummaryProducerSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodNullable<z.ZodString>;
+    url: z.ZodNullable<z.ZodURL>;
+    searchConsole: z.ZodObject<{
+        status: z.ZodEnum<{
+            action_required: "action_required";
+            connected: "connected";
+            disconnected: "disconnected";
+        }>;
+    }, z.core.$strict>;
+    monitoring: z.ZodObject<{
+        mode: z.ZodNullable<z.ZodEnum<{
+            full_monitoring: "full_monitoring";
+            search_tracking: "search_tracking";
+        }>>;
+        status: z.ZodEnum<{
+            active: "active";
+            archived: "archived";
+            paused: "paused";
+            unconfigured: "unconfigured";
+        }>;
+        analysisAvailable: z.ZodBoolean;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const siteSummaryClientSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodNullable<z.ZodString>;
+    url: z.ZodNullable<z.ZodURL>;
+    searchConsole: z.ZodObject<{
+        status: z.ZodEnum<{
+            action_required: "action_required";
+            connected: "connected";
+            disconnected: "disconnected";
+        }>;
+    }, z.core.$loose>;
+    monitoring: z.ZodObject<{
+        mode: z.ZodNullable<z.ZodEnum<{
+            full_monitoring: "full_monitoring";
+            search_tracking: "search_tracking";
+        }>>;
+        status: z.ZodEnum<{
+            active: "active";
+            archived: "archived";
+            paused: "paused";
+            unconfigured: "unconfigured";
+        }>;
+        analysisAvailable: z.ZodBoolean;
+    }, z.core.$loose>;
+}, z.core.$loose>;
+export declare const sitesListDataSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    readonly sites: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+        url: z.ZodNullable<z.ZodURL>;
+        searchConsole: z.ZodObject<{
+            status: z.ZodEnum<{
+                action_required: "action_required";
+                connected: "connected";
+                disconnected: "disconnected";
+            }>;
+        }, z.core.$strict>;
+        monitoring: z.ZodObject<{
+            mode: z.ZodNullable<z.ZodEnum<{
+                full_monitoring: "full_monitoring";
+                search_tracking: "search_tracking";
+            }>>;
+            status: z.ZodEnum<{
+                active: "active";
+                archived: "archived";
+                paused: "paused";
+                unconfigured: "unconfigured";
+            }>;
+            analysisAvailable: z.ZodBoolean;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+}, z.core.$strip>, z.ZodObject<{
+    readonly sites: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+        url: z.ZodNullable<z.ZodURL>;
+        searchConsole: z.ZodObject<{
+            status: z.ZodEnum<{
+                action_required: "action_required";
+                connected: "connected";
+                disconnected: "disconnected";
+            }>;
+        }, z.core.$loose>;
+        monitoring: z.ZodObject<{
+            mode: z.ZodNullable<z.ZodEnum<{
+                full_monitoring: "full_monitoring";
+                search_tracking: "search_tracking";
+            }>>;
+            status: z.ZodEnum<{
+                active: "active";
+                archived: "archived";
+                paused: "paused";
+                unconfigured: "unconfigured";
+            }>;
+            analysisAvailable: z.ZodBoolean;
+        }, z.core.$loose>;
+    }, z.core.$loose>>;
+}, z.core.$strip>>;
+export declare const sitesListMetaSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    readonly requestId: z.ZodString;
+    readonly version: z.ZodLiteral<"1.0">;
+    readonly total: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    readonly requestId: z.ZodString;
+    readonly version: z.ZodLiteral<"1.0">;
+    readonly total: z.ZodNumber;
+}, z.core.$strip>>;
+export declare const sitesListResponseSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    data: z.ZodObject<{
+        readonly sites: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodNullable<z.ZodString>;
+            url: z.ZodNullable<z.ZodURL>;
+            searchConsole: z.ZodObject<{
+                status: z.ZodEnum<{
+                    action_required: "action_required";
+                    connected: "connected";
+                    disconnected: "disconnected";
+                }>;
+            }, z.core.$strict>;
+            monitoring: z.ZodObject<{
+                mode: z.ZodNullable<z.ZodEnum<{
+                    full_monitoring: "full_monitoring";
+                    search_tracking: "search_tracking";
+                }>>;
+                status: z.ZodEnum<{
+                    active: "active";
+                    archived: "archived";
+                    paused: "paused";
+                    unconfigured: "unconfigured";
+                }>;
+                analysisAvailable: z.ZodBoolean;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
+    }, z.core.$strip>;
+    meta: z.ZodObject<{
+        readonly requestId: z.ZodString;
+        readonly version: z.ZodLiteral<"1.0">;
+        readonly total: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    data: z.ZodObject<{
+        readonly sites: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodNullable<z.ZodString>;
+            url: z.ZodNullable<z.ZodURL>;
+            searchConsole: z.ZodObject<{
+                status: z.ZodEnum<{
+                    action_required: "action_required";
+                    connected: "connected";
+                    disconnected: "disconnected";
+                }>;
+            }, z.core.$loose>;
+            monitoring: z.ZodObject<{
+                mode: z.ZodNullable<z.ZodEnum<{
+                    full_monitoring: "full_monitoring";
+                    search_tracking: "search_tracking";
+                }>>;
+                status: z.ZodEnum<{
+                    active: "active";
+                    archived: "archived";
+                    paused: "paused";
+                    unconfigured: "unconfigured";
+                }>;
+                analysisAvailable: z.ZodBoolean;
+            }, z.core.$loose>;
+        }, z.core.$loose>>;
+    }, z.core.$strip>;
+    meta: z.ZodObject<{
+        readonly requestId: z.ZodString;
+        readonly version: z.ZodLiteral<"1.0">;
+        readonly total: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>>;
+export type SiteSummary = z.output<typeof siteSummaryClientSchema>;
+export type SitesListResponse = z.output<typeof sitesListResponseSchema.client>;
+export declare const sitesListOperation: {
+    readonly id: 'sites.list';
+    readonly method: 'GET';
+    readonly path: '/api/v1/sites';
+    readonly visibility: 'public';
+    readonly semantics: {
+        readonly kind: 'query';
+        readonly sideEffects: 'none';
+        readonly retry: 'idempotent';
+        readonly readConsistency: 'primary';
+    };
+    readonly auth: {
+        readonly credentials: readonly ["session", "api_token"];
+        readonly scopes: readonly ["sites:read"];
+        readonly minimumRole: 'viewer';
+        readonly ownership: 'team';
+    };
+    readonly request: {
+        readonly params: null;
+        readonly query: null;
+        readonly headers: null;
+        readonly body: null;
+    };
+    readonly responses: {
+        readonly 200: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+            data: z.ZodObject<{
+                readonly sites: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    name: z.ZodNullable<z.ZodString>;
+                    url: z.ZodNullable<z.ZodURL>;
+                    searchConsole: z.ZodObject<{
+                        status: z.ZodEnum<{
+                            action_required: "action_required";
+                            connected: "connected";
+                            disconnected: "disconnected";
+                        }>;
+                    }, z.core.$strict>;
+                    monitoring: z.ZodObject<{
+                        mode: z.ZodNullable<z.ZodEnum<{
+                            full_monitoring: "full_monitoring";
+                            search_tracking: "search_tracking";
+                        }>>;
+                        status: z.ZodEnum<{
+                            active: "active";
+                            archived: "archived";
+                            paused: "paused";
+                            unconfigured: "unconfigured";
+                        }>;
+                        analysisAvailable: z.ZodBoolean;
+                    }, z.core.$strict>;
+                }, z.core.$strict>>;
+            }, z.core.$strip>;
+            meta: z.ZodObject<{
+                readonly requestId: z.ZodString;
+                readonly version: z.ZodLiteral<"1.0">;
+                readonly total: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
+            data: z.ZodObject<{
+                readonly sites: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    name: z.ZodNullable<z.ZodString>;
+                    url: z.ZodNullable<z.ZodURL>;
+                    searchConsole: z.ZodObject<{
+                        status: z.ZodEnum<{
+                            action_required: "action_required";
+                            connected: "connected";
+                            disconnected: "disconnected";
+                        }>;
+                    }, z.core.$loose>;
+                    monitoring: z.ZodObject<{
+                        mode: z.ZodNullable<z.ZodEnum<{
+                            full_monitoring: "full_monitoring";
+                            search_tracking: "search_tracking";
+                        }>>;
+                        status: z.ZodEnum<{
+                            active: "active";
+                            archived: "archived";
+                            paused: "paused";
+                            unconfigured: "unconfigured";
+                        }>;
+                        analysisAvailable: z.ZodBoolean;
+                    }, z.core.$loose>;
+                }, z.core.$loose>>;
+            }, z.core.$strip>;
+            meta: z.ZodObject<{
+                readonly requestId: z.ZodString;
+                readonly version: z.ZodLiteral<"1.0">;
+                readonly total: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+    };
+    readonly errors: readonly ["invalid_request", "unauthorized", "auth_expired", "forbidden", "rate_limited", "contract_violation", "internal_error"];
+    readonly errorResponse: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+        readonly error: z.ZodObject<{
+            code: z.ZodEnum<{
+                auth_expired: "auth_expired";
+                conflict: "conflict";
+                contract_violation: "contract_violation";
+                entitlement_required: "entitlement_required";
+                forbidden: "forbidden";
+                internal_error: "internal_error";
+                invalid_request: "invalid_request";
+                not_found: "not_found";
+                provider_unavailable: "provider_unavailable";
+                quota_exhausted: "quota_exhausted";
+                rate_limited: "rate_limited";
+                site_ambiguous: "site_ambiguous";
+                stale_evidence: "stale_evidence";
+                unauthorized: "unauthorized";
+            }>;
+            message: z.ZodString;
+            requestId: z.ZodString;
+            retryable: z.ZodBoolean;
+            details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strict>;
+    }, z.core.$strip>, z.ZodObject<{
+        readonly error: z.ZodObject<{
+            code: z.ZodEnum<{
+                auth_expired: "auth_expired";
+                conflict: "conflict";
+                contract_violation: "contract_violation";
+                entitlement_required: "entitlement_required";
+                forbidden: "forbidden";
+                internal_error: "internal_error";
+                invalid_request: "invalid_request";
+                not_found: "not_found";
+                provider_unavailable: "provider_unavailable";
+                quota_exhausted: "quota_exhausted";
+                rate_limited: "rate_limited";
+                site_ambiguous: "site_ambiguous";
+                stale_evidence: "stale_evidence";
+                unauthorized: "unauthorized";
+            }>;
+            message: z.ZodString;
+            requestId: z.ZodString;
+            retryable: z.ZodBoolean;
+            details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$loose>;
+    }, z.core.$strip>>;
+    readonly resources: {
+        readonly reads: readonly [{
+            readonly type: 'site.collection';
+            readonly idFrom: 'team.id';
+        }];
+        readonly changes: readonly [];
+    };
+    readonly policy: {
+        readonly rate: {
+            readonly name: 'public-v1-fixed-window';
+            readonly limit: 50;
+            readonly windowSeconds: 60;
+        };
+        readonly idempotency: {
+            readonly _tag: 'none';
+        };
+        readonly entitlement: null;
+        readonly meter: null;
+    };
+    readonly lifecycle: {
+        readonly introduced: '1.0.0';
+    };
+    readonly docs: {
+        readonly summary: 'List accessible sites';
+        readonly description: 'Lists the stable public identity and current integration state of sites owned by the authenticated Team.';
+        readonly tags: readonly ["Sites"];
+        readonly examples: readonly [{
+            readonly request: {};
+            readonly response: {
+                readonly status: 200;
+                readonly body: {
+                    readonly data: {
+                        readonly sites: readonly [{
+                            readonly id: 'site_01JXYZ';
+                            readonly name: 'Example';
+                            readonly url: 'https://example.com/';
+                            readonly searchConsole: {
+                                readonly status: 'connected';
+                            };
+                            readonly monitoring: {
+                                readonly mode: 'full_monitoring';
+                                readonly status: 'active';
+                                readonly analysisAvailable: true;
+                            };
+                        }];
+                    };
+                    readonly meta: {
+                        readonly requestId: 'req_01JXYZ';
+                        readonly version: '1.0';
+                        readonly total: 1;
+                    };
+                };
+            };
+        }];
+    };
+};
+export declare const sitesV1Registry: import("./core.js").PublicV1Registry<{
+    readonly list: {
+        readonly id: 'sites.list';
+        readonly method: 'GET';
+        readonly path: '/api/v1/sites';
+        readonly visibility: 'public';
+        readonly semantics: {
+            readonly kind: 'query';
+            readonly sideEffects: 'none';
+            readonly retry: 'idempotent';
+            readonly readConsistency: 'primary';
+        };
+        readonly auth: {
+            readonly credentials: readonly ["session", "api_token"];
+            readonly scopes: readonly ["sites:read"];
+            readonly minimumRole: 'viewer';
+            readonly ownership: 'team';
+        };
+        readonly request: {
+            readonly params: null;
+            readonly query: null;
+            readonly headers: null;
+            readonly body: null;
+        };
+        readonly responses: {
+            readonly 200: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+                data: z.ZodObject<{
+                    readonly sites: z.ZodArray<z.ZodObject<{
+                        id: z.ZodString;
+                        name: z.ZodNullable<z.ZodString>;
+                        url: z.ZodNullable<z.ZodURL>;
+                        searchConsole: z.ZodObject<{
+                            status: z.ZodEnum<{
+                                action_required: "action_required";
+                                connected: "connected";
+                                disconnected: "disconnected";
+                            }>;
+                        }, z.core.$strict>;
+                        monitoring: z.ZodObject<{
+                            mode: z.ZodNullable<z.ZodEnum<{
+                                full_monitoring: "full_monitoring";
+                                search_tracking: "search_tracking";
+                            }>>;
+                            status: z.ZodEnum<{
+                                active: "active";
+                                archived: "archived";
+                                paused: "paused";
+                                unconfigured: "unconfigured";
+                            }>;
+                            analysisAvailable: z.ZodBoolean;
+                        }, z.core.$strict>;
+                    }, z.core.$strict>>;
+                }, z.core.$strip>;
+                meta: z.ZodObject<{
+                    readonly requestId: z.ZodString;
+                    readonly version: z.ZodLiteral<"1.0">;
+                    readonly total: z.ZodNumber;
+                }, z.core.$strip>;
+            }, z.core.$strip>, z.ZodObject<{
+                data: z.ZodObject<{
+                    readonly sites: z.ZodArray<z.ZodObject<{
+                        id: z.ZodString;
+                        name: z.ZodNullable<z.ZodString>;
+                        url: z.ZodNullable<z.ZodURL>;
+                        searchConsole: z.ZodObject<{
+                            status: z.ZodEnum<{
+                                action_required: "action_required";
+                                connected: "connected";
+                                disconnected: "disconnected";
+                            }>;
+                        }, z.core.$loose>;
+                        monitoring: z.ZodObject<{
+                            mode: z.ZodNullable<z.ZodEnum<{
+                                full_monitoring: "full_monitoring";
+                                search_tracking: "search_tracking";
+                            }>>;
+                            status: z.ZodEnum<{
+                                active: "active";
+                                archived: "archived";
+                                paused: "paused";
+                                unconfigured: "unconfigured";
+                            }>;
+                            analysisAvailable: z.ZodBoolean;
+                        }, z.core.$loose>;
+                    }, z.core.$loose>>;
+                }, z.core.$strip>;
+                meta: z.ZodObject<{
+                    readonly requestId: z.ZodString;
+                    readonly version: z.ZodLiteral<"1.0">;
+                    readonly total: z.ZodNumber;
+                }, z.core.$strip>;
+            }, z.core.$strip>>;
+        };
+        readonly errors: readonly ["invalid_request", "unauthorized", "auth_expired", "forbidden", "rate_limited", "contract_violation", "internal_error"];
+        readonly errorResponse: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+            readonly error: z.ZodObject<{
+                code: z.ZodEnum<{
+                    auth_expired: "auth_expired";
+                    conflict: "conflict";
+                    contract_violation: "contract_violation";
+                    entitlement_required: "entitlement_required";
+                    forbidden: "forbidden";
+                    internal_error: "internal_error";
+                    invalid_request: "invalid_request";
+                    not_found: "not_found";
+                    provider_unavailable: "provider_unavailable";
+                    quota_exhausted: "quota_exhausted";
+                    rate_limited: "rate_limited";
+                    site_ambiguous: "site_ambiguous";
+                    stale_evidence: "stale_evidence";
+                    unauthorized: "unauthorized";
+                }>;
+                message: z.ZodString;
+                requestId: z.ZodString;
+                retryable: z.ZodBoolean;
+                details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$strict>;
+        }, z.core.$strip>, z.ZodObject<{
+            readonly error: z.ZodObject<{
+                code: z.ZodEnum<{
+                    auth_expired: "auth_expired";
+                    conflict: "conflict";
+                    contract_violation: "contract_violation";
+                    entitlement_required: "entitlement_required";
+                    forbidden: "forbidden";
+                    internal_error: "internal_error";
+                    invalid_request: "invalid_request";
+                    not_found: "not_found";
+                    provider_unavailable: "provider_unavailable";
+                    quota_exhausted: "quota_exhausted";
+                    rate_limited: "rate_limited";
+                    site_ambiguous: "site_ambiguous";
+                    stale_evidence: "stale_evidence";
+                    unauthorized: "unauthorized";
+                }>;
+                message: z.ZodString;
+                requestId: z.ZodString;
+                retryable: z.ZodBoolean;
+                details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$loose>;
+        }, z.core.$strip>>;
+        readonly resources: {
+            readonly reads: readonly [{
+                readonly type: 'site.collection';
+                readonly idFrom: 'team.id';
+            }];
+            readonly changes: readonly [];
+        };
+        readonly policy: {
+            readonly rate: {
+                readonly name: 'public-v1-fixed-window';
+                readonly limit: 50;
+                readonly windowSeconds: 60;
+            };
+            readonly idempotency: {
+                readonly _tag: 'none';
+            };
+            readonly entitlement: null;
+            readonly meter: null;
+        };
+        readonly lifecycle: {
+            readonly introduced: '1.0.0';
+        };
+        readonly docs: {
+            readonly summary: 'List accessible sites';
+            readonly description: 'Lists the stable public identity and current integration state of sites owned by the authenticated Team.';
+            readonly tags: readonly ["Sites"];
+            readonly examples: readonly [{
+                readonly request: {};
+                readonly response: {
+                    readonly status: 200;
+                    readonly body: {
+                        readonly data: {
+                            readonly sites: readonly [{
+                                readonly id: 'site_01JXYZ';
+                                readonly name: 'Example';
+                                readonly url: 'https://example.com/';
+                                readonly searchConsole: {
+                                    readonly status: 'connected';
+                                };
+                                readonly monitoring: {
+                                    readonly mode: 'full_monitoring';
+                                    readonly status: 'active';
+                                    readonly analysisAvailable: true;
+                                };
+                            }];
+                        };
+                        readonly meta: {
+                            readonly requestId: 'req_01JXYZ';
+                            readonly version: '1.0';
+                            readonly total: 1;
+                        };
+                    };
+                };
+            }];
+        };
+    };
+}>;

package/dist/v1/sites.js

@@ -0,0 +1,101 @@
+import { z as schema } from 'zod';
+import { defineOperation, defineRegistry, defineResponseObject, defineSuccessEnvelope, publicV1ErrorEnvelope, publicV1MetaClientSchema, publicV1MetaProducerSchema, publicV1StandardRatePolicy, } from './core.js';
+export const siteSearchConsoleStatusSchema = schema.enum(['connected', 'disconnected', 'action_required']);
+export const siteMonitoringModeSchema = schema.enum(['search_tracking', 'full_monitoring']).nullable();
+export const siteMonitoringStatusSchema = schema.enum(['active', 'paused', 'archived', 'unconfigured']);
+export const siteSummaryProducerSchema = schema.strictObject({
+    id: schema.string().min(1),
+    name: schema.string().min(1).nullable(),
+    url: schema.url().nullable(),
+    searchConsole: schema.strictObject({
+        status: siteSearchConsoleStatusSchema,
+    }),
+    monitoring: schema.strictObject({
+        mode: siteMonitoringModeSchema,
+        status: siteMonitoringStatusSchema,
+        analysisAvailable: schema.boolean(),
+    }),
+});
+export const siteSummaryClientSchema = schema.looseObject({
+    id: schema.string().min(1),
+    name: schema.string().min(1).nullable(),
+    url: schema.url().nullable(),
+    searchConsole: schema.looseObject({
+        status: siteSearchConsoleStatusSchema,
+    }),
+    monitoring: schema.looseObject({
+        mode: siteMonitoringModeSchema,
+        status: siteMonitoringStatusSchema,
+        analysisAvailable: schema.boolean(),
+    }),
+});
+export const sitesListDataSchema = defineResponseObject({ sites: schema.array(siteSummaryProducerSchema) }, { sites: schema.array(siteSummaryClientSchema) });
+export const sitesListMetaSchema = defineResponseObject({ ...publicV1MetaProducerSchema.shape, total: schema.number().int().nonnegative() }, { ...publicV1MetaClientSchema.shape, total: schema.number().int().nonnegative() });
+export const sitesListResponseSchema = defineSuccessEnvelope(sitesListDataSchema, sitesListMetaSchema);
+export const sitesListOperation = defineOperation({
+    id: 'sites.list',
+    method: 'GET',
+    path: '/api/v1/sites',
+    visibility: 'public',
+    semantics: {
+        kind: 'query',
+        sideEffects: 'none',
+        retry: 'idempotent',
+        readConsistency: 'primary',
+    },
+    auth: {
+        credentials: ['session', 'api_token'],
+        scopes: ['sites:read'],
+        minimumRole: 'viewer',
+        ownership: 'team',
+    },
+    request: {
+        params: null,
+        query: null,
+        headers: null,
+        body: null,
+    },
+    responses: { 200: sitesListResponseSchema },
+    errors: ['invalid_request', 'unauthorized', 'auth_expired', 'forbidden', 'rate_limited', 'contract_violation', 'internal_error'],
+    errorResponse: publicV1ErrorEnvelope,
+    resources: {
+        reads: [{ type: 'site.collection', idFrom: 'team.id' }],
+        changes: [],
+    },
+    policy: {
+        rate: publicV1StandardRatePolicy,
+        idempotency: { _tag: 'none' },
+        entitlement: null,
+        meter: null,
+    },
+    lifecycle: { introduced: '1.0.0' },
+    docs: {
+        summary: 'List accessible sites',
+        description: 'Lists the stable public identity and current integration state of sites owned by the authenticated Team.',
+        tags: ['Sites'],
+        examples: [{
+                request: {},
+                response: {
+                    status: 200,
+                    body: {
+                        data: {
+                            sites: [{
+                                    id: 'site_01JXYZ',
+                                    name: 'Example',
+                                    url: 'https://example.com/',
+                                    searchConsole: { status: 'connected' },
+                                    monitoring: { mode: 'full_monitoring', status: 'active', analysisAvailable: true },
+                                }],
+                        },
+                        meta: { requestId: 'req_01JXYZ', version: '1.0', total: 1 },
+                    },
+                },
+            }],
+    },
+});
+export const sitesV1Registry = defineRegistry({
+    feature: 'sites',
+    operations: {
+        list: sitesListOperation,
+    },
+});