@pagebridge/sanity 0.0.1

package/dist/schemas/gscRefreshTask.js

@@ -0,0 +1,196 @@
+import { defineType, defineField } from "sanity";
+export const createGscRefreshTask = (options = {}) => {
+    const contentTypes = options.contentTypes ?? [];
+    return defineType({
+        name: "gscRefreshTask",
+        title: "Refresh Task",
+        type: "document",
+        fields: [
+            defineField({
+                name: "site",
+                type: "reference",
+                to: [{ type: "gscSite" }],
+                validation: (Rule) => Rule.required(),
+            }),
+            ...(contentTypes.length > 0
+                ? [
+                    defineField({
+                        name: "linkedDocument",
+                        title: "Content to Refresh",
+                        type: "reference",
+                        to: contentTypes.map((type) => ({ type })),
+                        validation: (Rule) => Rule.required(),
+                    }),
+                ]
+                : []),
+            defineField({
+                name: "reason",
+                title: "Reason",
+                type: "string",
+                options: {
+                    list: [
+                        { title: "Position Decay", value: "position_decay" },
+                        { title: "Low CTR", value: "low_ctr" },
+                        { title: "Impressions Drop", value: "impressions_drop" },
+                        { title: "Manual", value: "manual" },
+                    ],
+                },
+            }),
+            defineField({
+                name: "severity",
+                title: "Severity",
+                type: "string",
+                options: {
+                    list: [
+                        { title: "Low", value: "low" },
+                        { title: "Medium", value: "medium" },
+                        { title: "High", value: "high" },
+                    ],
+                },
+            }),
+            defineField({
+                name: "status",
+                title: "Status",
+                type: "string",
+                options: {
+                    list: [
+                        { title: "Open", value: "open" },
+                        { title: "Snoozed", value: "snoozed" },
+                        { title: "In Progress", value: "in_progress" },
+                        { title: "Done", value: "done" },
+                        { title: "Dismissed", value: "dismissed" },
+                    ],
+                },
+                initialValue: "open",
+            }),
+            defineField({
+                name: "snoozedUntil",
+                title: "Snoozed Until",
+                type: "datetime",
+                hidden: ({ parent }) => parent?.status !== "snoozed",
+            }),
+            defineField({
+                name: "metrics",
+                title: "Metrics at Detection",
+                type: "object",
+                fields: [
+                    defineField({
+                        name: "positionBefore",
+                        type: "number",
+                        title: "Position (28 days ago)",
+                    }),
+                    defineField({
+                        name: "positionNow",
+                        type: "number",
+                        title: "Position (current)",
+                    }),
+                    defineField({
+                        name: "positionDelta",
+                        type: "number",
+                        title: "Position Change",
+                    }),
+                    defineField({
+                        name: "ctrBefore",
+                        type: "number",
+                        title: "CTR (28 days ago)",
+                    }),
+                    defineField({
+                        name: "ctrNow",
+                        type: "number",
+                        title: "CTR (current)",
+                    }),
+                    defineField({
+                        name: "impressions",
+                        type: "number",
+                        title: "Impressions (last 28d)",
+                    }),
+                ],
+            }),
+            defineField({
+                name: "queryContext",
+                title: "Top Queries",
+                type: "array",
+                description: "What people searched to find this page",
+                of: [
+                    {
+                        type: "object",
+                        fields: [
+                            defineField({
+                                name: "query",
+                                type: "string",
+                                title: "Query",
+                            }),
+                            defineField({
+                                name: "impressions",
+                                type: "number",
+                                title: "Impressions",
+                            }),
+                            defineField({
+                                name: "clicks",
+                                type: "number",
+                                title: "Clicks",
+                            }),
+                            defineField({
+                                name: "position",
+                                type: "number",
+                                title: "Avg Position",
+                            }),
+                        ],
+                        preview: {
+                            select: {
+                                query: "query",
+                                impressions: "impressions",
+                                position: "position",
+                            },
+                            prepare({ query, impressions, position }) {
+                                return {
+                                    title: query,
+                                    subtitle: `Pos ${position?.toFixed(1)} · ${impressions} impr`,
+                                };
+                            },
+                        },
+                    },
+                ],
+            }),
+            defineField({
+                name: "notes",
+                title: "Notes",
+                type: "text",
+                description: "Why was this snoozed/dismissed?",
+            }),
+            defineField({
+                name: "createdAt",
+                type: "datetime",
+            }),
+            defineField({
+                name: "resolvedAt",
+                type: "datetime",
+            }),
+        ],
+        orderings: [
+            {
+                title: "Severity",
+                name: "severityDesc",
+                by: [
+                    { field: "severity", direction: "desc" },
+                    { field: "createdAt", direction: "desc" },
+                ],
+            },
+        ],
+        preview: {
+            select: {
+                title: "linkedDocument.title",
+                reason: "reason",
+                severity: "severity",
+            },
+            prepare({ title, reason, severity }) {
+                return {
+                    title: title || "Unknown document",
+                    subtitle: `${severity} · ${reason.replace(/_/g, " ")}`,
+                };
+            },
+        },
+    });
+};
+// Default export for backward compatibility (without linkedDocument)
+export const gscRefreshTask = createGscRefreshTask();

package/dist/schemas/gscSite.d.ts

@@ -0,0 +1,7 @@
+export declare const gscSite: {
+    type: "document";
+    name: "gscSite";
+} & Omit<import("sanity").DocumentDefinition, "preview"> & {
+    preview?: import("sanity").PreviewConfig<Record<string, string>, Record<never, any>> | undefined;
+};
+//# sourceMappingURL=gscSite.d.ts.map

package/dist/schemas/gscSite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gscSite.d.ts","sourceRoot":"","sources":["../../src/schemas/gscSite.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,OAAO;;;;;CAoElB,CAAC"}

package/dist/schemas/gscSite.js

@@ -0,0 +1,68 @@
+import { defineType, defineField } from "sanity";
+export const gscSite = defineType({
+    name: "gscSite",
+    title: "GSC Site",
+    type: "document",
+    fields: [
+        defineField({
+            name: "siteUrl",
+            title: "Site URL",
+            type: "string",
+            description: "Exactly as it appears in GSC (e.g., sc-domain:example.com)",
+            validation: (Rule) => Rule.required(),
+        }),
+        defineField({
+            name: "slug",
+            title: "Slug",
+            type: "slug",
+            options: { source: "siteUrl" },
+            description: "Used for filtering in multi-site setups",
+        }),
+        defineField({
+            name: "defaultLocale",
+            title: "Default Locale",
+            type: "string",
+            initialValue: "en",
+        }),
+        defineField({
+            name: "pathPrefix",
+            title: "Path Prefix",
+            type: "string",
+            description: 'If your blog lives at /blog, enter "/blog"',
+        }),
+        defineField({
+            name: "contentTypes",
+            title: "Content Types",
+            type: "array",
+            of: [{ type: "string" }],
+            initialValue: ["post", "page"],
+            description: "Sanity document types to match URLs against (e.g., post, page, article)",
+        }),
+        defineField({
+            name: "slugField",
+            title: "Slug Field",
+            type: "string",
+            initialValue: "slug",
+            description: "The field name containing the URL slug (default: slug)",
+        }),
+        defineField({
+            name: "lastSyncedAt",
+            title: "Last Synced",
+            type: "datetime",
+            readOnly: true,
+        }),
+        defineField({
+            name: "lastDiagnosticsAt",
+            title: "Last Diagnostics Run",
+            type: "datetime",
+            readOnly: true,
+        }),
+        defineField({
+            name: "unmatchedCount",
+            title: "Unmatched URLs",
+            type: "number",
+            readOnly: true,
+            description: "Number of GSC URLs that could not be matched to Sanity documents",
+        }),
+    ],
+});

package/dist/schemas/gscSnapshot.d.ts

@@ -0,0 +1,22 @@
+export interface GscSnapshotOptions {
+    contentTypes?: string[];
+}
+export declare const createGscSnapshot: (options?: GscSnapshotOptions) => {
+    type: "document";
+    name: "gscSnapshot";
+} & Omit<import("sanity").DocumentDefinition, "preview"> & {
+    preview?: import("sanity").PreviewConfig<{
+        title: string;
+        subtitle: string;
+    }, Record<"title" | "subtitle", any>> | undefined;
+};
+export declare const gscSnapshot: {
+    type: "document";
+    name: "gscSnapshot";
+} & Omit<import("sanity").DocumentDefinition, "preview"> & {
+    preview?: import("sanity").PreviewConfig<{
+        title: string;
+        subtitle: string;
+    }, Record<"title" | "subtitle", any>> | undefined;
+};
+//# sourceMappingURL=gscSnapshot.d.ts.map

package/dist/schemas/gscSnapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gscSnapshot.d.ts","sourceRoot":"","sources":["../../src/schemas/gscSnapshot.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,eAAO,MAAM,iBAAiB,GAAI,UAAS,kBAAuB;;;;;;;;CAyHjE,CAAC;AAGF,eAAO,MAAM,WAAW;;;;;;;;CAAsB,CAAC"}

package/dist/schemas/gscSnapshot.js

@@ -0,0 +1,124 @@
+import { defineType, defineField } from "sanity";
+export const createGscSnapshot = (options = {}) => {
+    const contentTypes = options.contentTypes ?? [];
+    return defineType({
+        name: "gscSnapshot",
+        title: "GSC Snapshot",
+        type: "document",
+        fields: [
+            defineField({
+                name: "site",
+                title: "Site",
+                type: "reference",
+                to: [{ type: "gscSite" }],
+                validation: (Rule) => Rule.required(),
+            }),
+            defineField({
+                name: "page",
+                title: "Page URL",
+                type: "string",
+                validation: (Rule) => Rule.required(),
+            }),
+            ...(contentTypes.length > 0
+                ? [
+                    defineField({
+                        name: "linkedDocument",
+                        title: "Linked Document",
+                        type: "reference",
+                        to: contentTypes.map((type) => ({ type })),
+                        description: "Auto-matched Sanity document",
+                    }),
+                ]
+                : []),
+            defineField({
+                name: "period",
+                title: "Period",
+                type: "string",
+                options: {
+                    list: ["last7", "last28", "last90"],
+                },
+            }),
+            defineField({
+                name: "clicks",
+                type: "number",
+            }),
+            defineField({
+                name: "impressions",
+                type: "number",
+            }),
+            defineField({
+                name: "ctr",
+                title: "CTR",
+                type: "number",
+                description: "Stored as decimal (0.05 = 5%)",
+            }),
+            defineField({
+                name: "position",
+                title: "Average Position",
+                type: "number",
+            }),
+            defineField({
+                name: "topQueries",
+                title: "Top Queries",
+                type: "array",
+                of: [
+                    {
+                        type: "object",
+                        fields: [
+                            defineField({ name: "query", type: "string" }),
+                            defineField({ name: "clicks", type: "number" }),
+                            defineField({ name: "impressions", type: "number" }),
+                            defineField({ name: "position", type: "number" }),
+                        ],
+                    },
+                ],
+            }),
+            defineField({
+                name: "fetchedAt",
+                title: "Fetched At",
+                type: "datetime",
+            }),
+            defineField({
+                name: "indexStatus",
+                title: "Index Status",
+                type: "object",
+                fields: [
+                    defineField({
+                        name: "verdict",
+                        title: "Verdict",
+                        type: "string",
+                        options: {
+                            list: ["indexed", "not_indexed", "excluded"],
+                        },
+                    }),
+                    defineField({
+                        name: "coverageState",
+                        title: "Coverage State",
+                        type: "string",
+                        description: "Human-readable index status from Google",
+                    }),
+                    defineField({
+                        name: "lastCrawlTime",
+                        title: "Last Crawl Time",
+                        type: "datetime",
+                    }),
+                    defineField({
+                        name: "robotsTxtState",
+                        title: "Robots.txt State",
+                        type: "string",
+                    }),
+                    defineField({
+                        name: "pageFetchState",
+                        title: "Page Fetch State",
+                        type: "string",
+                    }),
+                ],
+            }),
+        ],
+        preview: {
+            select: { title: "page", subtitle: "period" },
+        },
+    });
+};
+// Default export for backward compatibility (without linkedDocument)
+export const gscSnapshot = createGscSnapshot();

package/dist/schemas/index.d.ts

@@ -0,0 +1,4 @@
+export { gscSite } from "./gscSite";
+export { gscSnapshot, createGscSnapshot, type GscSnapshotOptions, } from "./gscSnapshot";
+export { gscRefreshTask, createGscRefreshTask, type GscRefreshTaskOptions, } from "./gscRefreshTask";
+//# sourceMappingURL=index.d.ts.map

package/dist/schemas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,KAAK,kBAAkB,GACxB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,KAAK,qBAAqB,GAC3B,MAAM,kBAAkB,CAAC"}

package/dist/schemas/index.js

@@ -0,0 +1,3 @@
+export { gscSite } from "./gscSite";
+export { gscSnapshot, createGscSnapshot, } from "./gscSnapshot";
+export { gscRefreshTask, createGscRefreshTask, } from "./gscRefreshTask";

package/eslint.config.js

@@ -0,0 +1,3 @@
+import { config } from "@pagebridge/eslint-config/react-internal";
+
+export default [...config];

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@pagebridge/sanity",
+  "version": "0.0.1",
+  "private": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./schemas": {
+      "types": "./dist/schemas/index.d.ts",
+      "import": "./dist/schemas/index.js",
+      "require": "./dist/schemas/index.js",
+      "default": "./dist/schemas/index.js"
+    }
+  },
+  "peerDependencies": {
+    "sanity": "^5.0.0",
+    "@sanity/ui": "^3.0.0",
+    "@sanity/icons": "^3.0.0",
+    "react": "^18 || ^19",
+    "react-dom": "^18 || ^19"
+  },
+  "dependencies": {
+    "@swc/helpers": "^0.5.18"
+  },
+  "devDependencies": {
+    "sanity": "^5.7.0",
+    "@sanity/ui": "^3.1.11",
+    "@sanity/icons": "^3.7.4",
+    "react": "^19.2.3",
+    "react-dom": "^19.2.3",
+    "@types/node": "^22.15.3",
+    "@types/react": "19.2.3",
+    "@types/react-dom": "19.2.3",
+    "eslint": "^9.39.1",
+    "typescript": "^5.9.3",
+    "@pagebridge/eslint-config": "^0.0.0",
+    "@pagebridge/typescript-config": "^0.0.0"
+  },
+  "scripts": {
+    "build": "pnpm exec tsc",
+    "dev": "pnpm exec tsc --watch",
+    "check-types": "pnpm exec tsc --noEmit",
+    "lint": "eslint ."
+  }
+}