@mohasinac/appkit 4.34.1 → 4.35.0

package/dist/features/tester/seed-data/authored/seo__og-images.js

@@ -0,0 +1,91 @@
+/*
+ * WHY: Authored six-part procedures for the seo/og-images checklist page.
+ * WHAT: 5 case(s), keyed by full checklist id.
+ *
+ * A social card is rendered server-side and never appears in the page a visitor
+ * sees, so every failure here is invisible until somebody shares a link. The brand
+ * card's image reader named a field the record does not have — always undefined,
+ * always omitted, and the card still rendered.
+ *
+ * @tag domain:tester
+ * @tag layer:seed
+ * @tag pattern:none
+ * @tag access:server-only
+ * @tag consumers:seed-data/authored/index.ts
+ * @tag sideEffects:none
+ */
+export const authored = {
+    "checklist-seo-og-images-og-image-renders-homepage": {
+        roles: ["guest"],
+        startPage: "/",
+        steps: [
+            "Open the homepage and view the page source.",
+            "Find the og:image tag and copy its URL.",
+            "Open that URL in a fresh tab.",
+            "Read what renders — a real image, an error, or a blank frame.",
+            "Read the response status and content type in the network panel.",
+        ],
+        expectedBehaviour: "The social image URL serves a real image. It is generated rather than a static file, so a failure inside the generator returns an error or an empty frame that nothing on the site would ever reveal.",
+        expectedUiState: "The URL returns 200 with an image content type and renders a card carrying the site's branding. A blank frame or an error page is the finding.",
+        endResult: "Read-only.",
+    },
+    "checklist-seo-og-images-og-image-product": {
+        roles: ["guest"],
+        startPage: "/products/product-beyblade-burst-valkyrie",
+        steps: [
+            "Open /products/product-beyblade-burst-valkyrie and note the product's title and main photo.",
+            "View the source, find the og:image tag and copy its URL.",
+            "Open that URL in a fresh tab.",
+            "Read the title rendered on the card and compare it against the product's.",
+            "Check the product's own photo appears on the card rather than a generic placeholder.",
+        ],
+        inputs: { productId: "product-beyblade-burst-valkyrie" },
+        expectedBehaviour: "A product's card is built from that product. A card that renders correctly but with the site's default artwork is the more likely failure — it looks deliberate, and only comparing it against the product reveals that the record was never read.",
+        expectedUiState: "The card shows the product's own title and its own photo. A generic card is the finding.",
+        endResult: "Read-only.",
+    },
+    "checklist-seo-og-images-og-image-brand-logo-present": {
+        roles: ["guest"],
+        startPage: "/brands/brand-takara-tomy",
+        steps: [
+            "Open /brands/brand-takara-tomy and note the cover image shown in its hero.",
+            "View the source, find the og:image tag and copy its URL.",
+            "Open that URL in a fresh tab.",
+            "Read whether the brand's image is on the card or the slot is empty.",
+            "Repeat with /brands/brand-beyblade.",
+        ],
+        inputs: { brandId: "brand-takara-tomy" },
+        expectedBehaviour: "The card reads the same cover image the brand page's hero uses. It previously read a field that does not exist on a brand record at all, so the value was always undefined and the image was silently omitted — the card still rendered, just without it.",
+        expectedUiState: "The brand's cover image is on the card for both brands. An empty image slot with the rest of the card intact is exactly the failure this case exists for.",
+        endResult: "Read-only.",
+    },
+    "checklist-seo-og-images-og-tags-present-and-absolute": {
+        roles: ["guest"],
+        startPage: "/products/product-beyblade-burst-valkyrie",
+        steps: [
+            "Open /products/product-beyblade-burst-valkyrie and view the source.",
+            "List every og: and twitter: tag present.",
+            "Check og:title, og:description, og:image and og:url are all there.",
+            "Read og:image's and og:url's values and check both are absolute URLs.",
+            "Check their host matches the canonical's host.",
+            "Repeat on a store page and a blog post.",
+        ],
+        expectedBehaviour: "Social tags are present and their URLs are absolute on the canonical host. A relative social image URL is not fetchable by the service rendering the preview — it has no page context to resolve it against — so the card falls back to nothing.",
+        expectedUiState: "All four tags present on all three pages, with absolute URLs on the canonical host. A relative URL, or one on a different host, is the finding.",
+        endResult: "Read-only.",
+    },
+    "checklist-seo-og-images-og-image-missing-media-fallback": {
+        roles: ["guest"],
+        startPage: "/classified/classified-tester-sandbox-1",
+        steps: [
+            "Sign in as tester@letitrip.in / TempPass123!.",
+            "Find a listing with no photo of its own, or note that the sandbox classified has none.",
+            "Open its detail page and view the source.",
+            "Copy the og:image URL and open it in a fresh tab.",
+            "Read what renders.",
+        ],
+        expectedBehaviour: "A record with no image still produces a readable card, falling back to the site's own artwork rather than to a broken image. A card generator that assumes an image exists throws, and the shared link then has no preview at all.",
+        expectedUiState: "The card renders with the listing's title over the site's default artwork. A broken image, an error page or a 500 are all findings.",
+        endResult: "Read-only.",
+    },
+};

package/dist/features/tester/seed-data/authored/seo__page-metadata.d.ts

@@ -0,0 +1,2 @@
+import type { AuthoredCase } from "./_types";
+export declare const authored: Record<string, AuthoredCase>;

package/dist/features/tester/seed-data/authored/seo__page-metadata.js

@@ -0,0 +1,122 @@
+/*
+ * WHY: Authored six-part procedures for the seo/page-metadata checklist page.
+ * WHAT: 7 case(s), keyed by full checklist id.
+ *
+ * Metadata failures are all silent by construction — a missing canonical, a title
+ * built from a slug and a 200 on a page that does not exist all render a page that
+ * looks entirely normal. The procedures read the source rather than the screen.
+ *
+ * @tag domain:tester
+ * @tag layer:seed
+ * @tag pattern:none
+ * @tag access:server-only
+ * @tag consumers:seed-data/authored/index.ts
+ * @tag sideEffects:none
+ */
+export const authored = {
+    "checklist-seo-page-metadata-listing-pages-distinct-titles": {
+        roles: ["guest"],
+        startPage: "/products",
+        steps: [
+            "Open /products and read the browser tab's title and the page's meta description.",
+            "Open /auctions and read both.",
+            "Open /pre-orders, /bundles and /categories and read each.",
+            "Compare all five titles against one another.",
+            "Compare all five descriptions.",
+        ],
+        expectedBehaviour: "Each listing page states what it lists. Five pages sharing one site-wide default makes them indistinguishable in a result list, and a shared description is the more common half of the failure because nothing on screen shows it.",
+        expectedUiState: "Five distinct titles and five distinct descriptions, each naming its own section. Any repeat is a finding, named by the pages that share it.",
+        expectedData: { distinctTitles: 5 },
+        endResult: "Read-only.",
+    },
+    "checklist-seo-page-metadata-detail-page-title-from-record": {
+        roles: ["guest"],
+        startPage: "/products/product-beyblade-burst-valkyrie",
+        steps: [
+            "Open /products/product-beyblade-burst-valkyrie.",
+            "Read the product's name as shown on the page.",
+            "Read the browser tab's title.",
+            "Compare the two.",
+            "Read the meta description and check it draws on the product's own description.",
+            "Repeat on a prize-draw detail page and read its title.",
+        ],
+        inputs: { productId: "product-beyblade-burst-valkyrie" },
+        expectedBehaviour: "A detail page's title is the record's name. One listing type interpolated the raw slug instead, so its tab read a hyphenated identifier — which is legible enough to pass a glance and wrong in every search result.",
+        expectedUiState: "The tab title contains the product's readable name, not its hyphenated id. The prize-draw page is checked separately because that is where the slug leak was.",
+        endResult: "Read-only.",
+    },
+    "checklist-seo-page-metadata-detail-pages-have-canonical": {
+        roles: ["guest"],
+        startPage: "/classified/classified-tester-sandbox-1",
+        steps: [
+            "Sign in as tester@letitrip.in / TempPass123! so sandbox fixtures are visible.",
+            "Open /classified/classified-tester-sandbox-1 and view the page source.",
+            "Search the source for a canonical link element and read its href, or record that there is none.",
+            "Do the same on /digital-codes/digitalcode-tester-sandbox-1.",
+            "Do the same on /live/live-tester-sandbox-1.",
+            "Do the same on an ordinary product page as a control.",
+        ],
+        expectedBehaviour: "Every listing type declares a canonical. Three types had their metadata builder called without the site URL, so it returned nothing for them and those pages shipped with none at all — while the standard product page, the one anybody would spot-check, was fine.",
+        expectedUiState: "All four pages carry a canonical link element with an absolute URL. A page with none is the finding, named by listing type.",
+        expectedData: { pagesWithoutCanonical: 0 },
+        endResult: "Read-only.",
+    },
+    "checklist-seo-page-metadata-detail-canonical-uses-slug-not-id": {
+        roles: ["guest"],
+        startPage: "/classified/classified-tester-sandbox-1",
+        steps: [
+            "Sign in as tester@letitrip.in / TempPass123!.",
+            "Open /classified/classified-tester-sandbox-1 and note the exact path in the address bar.",
+            "View the source and read the canonical's path.",
+            "Compare the two paths character for character.",
+            "Copy the canonical's URL into a fresh tab and read what loads.",
+        ],
+        expectedBehaviour: "The canonical names the URL the route actually serves. A canonical built from the record's internal id while the route is keyed on its slug names an address that does not exist — so the page tells crawlers its real home is a 404.",
+        expectedUiState: "The canonical's path equals the address bar's path, and opening it loads the same page. A canonical that 404s is the failure.",
+        endResult: "Read-only.",
+    },
+    "checklist-seo-page-metadata-single-h1-per-page": {
+        roles: ["guest"],
+        startPage: "/products",
+        steps: [
+            "Open /products and use the browser's element inspector to count top-level headings.",
+            "Do the same on the homepage.",
+            "Do the same on a product detail page.",
+            "Do the same on a store page and on a blog post.",
+            "Record the count for each.",
+        ],
+        expectedBehaviour: "One top-level heading per page states what the page is. Several compete to be that statement, and none makes it clear which describes the page.",
+        expectedUiState: "Exactly one on each of the five pages. Any page with zero or with more than one is a finding, named with its count.",
+        expectedData: { headingsPerPage: 1 },
+        endResult: "Read-only.",
+    },
+    "checklist-seo-page-metadata-404-page-not-indexable": {
+        roles: ["guest"],
+        startPage: "/products",
+        steps: [
+            "Open the network panel and navigate to a product path whose trailing segment is a nonsense word no listing uses.",
+            "Read the status code of the document response.",
+            "Read what the page shows.",
+            "View the source and look for a robots meta tag.",
+            "Repeat with a nonsense store path and a nonsense category path.",
+        ],
+        expectedBehaviour: "A missing page returns 404 and marks itself not-indexable. A 200 carrying a 'not found' message is a soft 404 — the URL stays in the index indefinitely, and every mistyped link a crawler follows adds another.",
+        expectedUiState: "The document response is 404 on all three paths, the page shows a readable not-found state with a route onward, and it is marked not-indexable. A 200 status is the finding regardless of what the body says.",
+        expectedData: { statusCode: 404 },
+        endResult: "Read-only.",
+    },
+    "checklist-seo-page-metadata-title-length-reasonable": {
+        roles: ["guest"],
+        startPage: "/products",
+        steps: [
+            "Open a product with a long name and read the full tab title including any site-name suffix.",
+            "Count its characters.",
+            "Check the product's own name is not the part being cut off by the suffix.",
+            "Repeat on a blog post with a long headline.",
+            "Repeat on a category page.",
+        ],
+        expectedBehaviour: "A title stays short enough to be shown whole, and where it cannot, the record's own name survives and the brand suffix is what gives way. A title truncated mid-word in the record's name is worse than one with no suffix.",
+        expectedUiState: "Each title reads as a complete phrase with the record's name intact, roughly sixty characters or fewer. A title cut mid-word is the finding, quoted in full.",
+        endResult: "Read-only.",
+    },
+};

package/dist/features/tester/seed-data/authored/seo__sitemap-and-robots.d.ts

@@ -0,0 +1,2 @@
+import type { AuthoredCase } from "./_types";
+export declare const authored: Record<string, AuthoredCase>;

package/dist/features/tester/seed-data/authored/seo__sitemap-and-robots.js

@@ -0,0 +1,105 @@
+/*
+ * WHY: Authored six-part procedures for the seo/sitemap-and-robots checklist page.
+ * WHAT: 6 case(s), keyed by full checklist id.
+ *
+ * Two of these are the ones that would have caught the de-indexing directly: a
+ * sitemap whose URLs all redirect, and a robots.txt naming a different host from
+ * the pages. Neither errors, neither is visible in a browser, and both are one
+ * request away from being provable.
+ *
+ * @tag domain:tester
+ * @tag layer:seed
+ * @tag pattern:none
+ * @tag access:server-only
+ * @tag consumers:seed-data/authored/index.ts
+ * @tag sideEffects:none
+ */
+export const authored = {
+    "checklist-seo-sitemap-and-robots-sitemap-loads-and-parses": {
+        roles: ["guest"],
+        startPage: "/sitemap.xml",
+        steps: [
+            "Open /sitemap.xml directly in the browser.",
+            "Read the status shown in the network panel.",
+            "Read whether the browser rendered it as XML or as raw text with a parse error.",
+            "Count the URL entries, or read the count the browser reports.",
+            "Scan the entries for the main sections — products, categories, brands, stores, blog, events.",
+        ],
+        expectedBehaviour: "The sitemap is served as valid XML with a real inventory of public URLs. A sitemap that 404s or fails to parse is silently ignored by every crawler, and there is no report anywhere that says so.",
+        expectedUiState: "The document renders as XML with no parse error, returns 200, and holds well over a hundred entries covering each public section. A handful of entries, or only the homepage, is the finding.",
+        endResult: "Read-only.",
+    },
+    "checklist-seo-sitemap-and-robots-sitemap-urls-do-not-redirect": {
+        roles: ["guest"],
+        startPage: "/sitemap.xml",
+        steps: [
+            "Open /sitemap.xml and copy the first entry's URL exactly as written.",
+            "Paste it into a fresh tab with the network panel open.",
+            "Read the first response's status code before any redirect is followed.",
+            "Repeat with one entry from each section — a product, a category, a store, a blog post.",
+            "Note the host each entry uses and compare it against the host they land on.",
+        ],
+        expectedBehaviour: "A sitemap entry resolves directly. Every one of them redirecting means the sitemap names one host while the pages canonicalise to another — the exact shape that removed this site from search results, and it produces no error at any layer.",
+        expectedUiState: "Each sampled URL returns 200 on its first response, with no redirect step in the network panel. Any redirect is the finding, reported with the host it came from and the host it went to.",
+        expectedData: { redirectingSitemapUrls: 0 },
+        endResult: "Read-only.",
+    },
+    "checklist-seo-sitemap-and-robots-robots-loads-and-allows": {
+        roles: ["guest"],
+        startPage: "/robots.txt",
+        steps: [
+            "Open /robots.txt directly and read the whole file.",
+            "Read every Disallow line.",
+            "Check no rule disallows the site root for all user agents.",
+            "Read the Host line, if present, and note the hostname.",
+            "Compare that hostname against the address bar and against the sitemap's entries.",
+        ],
+        expectedBehaviour: "robots.txt loads, permits the public site and names the same host as everything else. A sustained failure on this file is worse than a wrong rule inside it — a crawler that cannot fetch robots.txt stops crawling the whole host, and the file was among the routes taken down by a past module-load failure.",
+        expectedUiState: "The file returns 200 with readable content, has no blanket disallow, and its host matches the sitemap's. A different host here is the same two-owners failure seen from another angle.",
+        endResult: "Read-only.",
+    },
+    "checklist-seo-sitemap-and-robots-robots-sitemap-line-correct": {
+        roles: ["guest"],
+        startPage: "/robots.txt",
+        steps: [
+            "Open /robots.txt and find the Sitemap: line.",
+            "Copy the URL it names exactly.",
+            "Open it in a fresh tab with the network panel open.",
+            "Read the status of the first response.",
+            "Check it is the same sitemap /sitemap.xml serves.",
+        ],
+        expectedBehaviour: "The Sitemap: line names a URL that loads on its first request. A line pointing at a redirecting or missing host means the sitemap is never read, while both files individually look fine.",
+        expectedUiState: "The named URL returns 200 directly and serves the sitemap. A redirect or a 404 is the finding.",
+        endResult: "Read-only.",
+    },
+    "checklist-seo-sitemap-and-robots-sitemap-excludes-private-routes": {
+        roles: ["guest"],
+        startPage: "/sitemap.xml",
+        steps: [
+            "Open /sitemap.xml and use the browser's find to search for '/admin'.",
+            "Search for '/store/' and for '/user/'.",
+            "Search for '/checkout' and for '/cart'.",
+            "Search for '/auth/'.",
+            "Record any match, with the full URL.",
+        ],
+        expectedBehaviour: "Only pages a signed-out visitor can actually read belong in the sitemap. A dashboard or checkout route there spends crawl budget on a redirect or an empty shell, and the shell is what gets indexed if anything is.",
+        expectedUiState: "None of those searches matches. Every match is a finding, listed with its URL.",
+        expectedData: { privateRoutesInSitemap: 0 },
+        endResult: "Read-only.",
+    },
+    "checklist-seo-sitemap-and-robots-sitemap-excludes-test-data": {
+        roles: ["guest"],
+        startPage: "/sitemap.xml",
+        steps: [
+            "Open /sitemap.xml and search for 'tester-sandbox'.",
+            "Search for 'tester-qa'.",
+            "Search for 'test-' as a looser check.",
+            "Record any match with its full URL.",
+            "Open one matched URL, if any, and read what it serves.",
+        ],
+        expectedBehaviour: "Sandbox fixtures are wiped and re-seeded on every tester run, so a sitemap entry for one is a URL that repeatedly disappears. Test data is filtered out of every public read for the same reason it must be filtered here.",
+        expectedUiState: "No sandbox id appears in the sitemap. A match is a finding, and if the URL currently loads that makes it worse rather than better — it means sandbox content is publicly indexable.",
+        expectedData: { sandboxUrlsInSitemap: 0 },
+        endResult: "Read-only.",
+    },
+};