@schemasentry/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Schema Sentry
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,358 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Article: () => Article,
+  BlogPosting: () => BlogPosting,
+  BreadcrumbList: () => BreadcrumbList,
+  FAQPage: () => FAQPage,
+  HowTo: () => HowTo,
+  Location: () => Location,
+  Organization: () => Organization,
+  Person: () => Person,
+  Product: () => Product,
+  SCHEMA_CONTEXT: () => SCHEMA_CONTEXT,
+  WebPage: () => WebPage,
+  WebSite: () => WebSite,
+  stableStringify: () => stableStringify,
+  validateSchema: () => validateSchema
+});
+module.exports = __toCommonJS(index_exports);
+var SCHEMA_CONTEXT = "https://schema.org";
+var withBase = (type, input) => {
+  const base = {
+    "@context": SCHEMA_CONTEXT,
+    "@type": type
+  };
+  if (input.id) {
+    base["@id"] = input.id;
+  }
+  return {
+    ...base,
+    ...input
+  };
+};
+var Organization = (input) => withBase("Organization", input);
+var Person = (input) => withBase("Person", input);
+var Location = (input) => withBase("Place", input);
+var WebSite = (input) => withBase("WebSite", input);
+var WebPage = (input) => withBase("WebPage", input);
+var Article = (input) => {
+  const { authorName, ...rest } = input;
+  return withBase("Article", {
+    ...rest,
+    author: {
+      "@type": "Person",
+      name: authorName
+    }
+  });
+};
+var BlogPosting = (input) => {
+  const { authorName, ...rest } = input;
+  return withBase("BlogPosting", {
+    ...rest,
+    author: {
+      "@type": "Person",
+      name: authorName
+    }
+  });
+};
+var Product = (input) => {
+  const { brandName, ...rest } = input;
+  return withBase("Product", {
+    ...rest,
+    ...brandName ? {
+      brand: {
+        "@type": "Brand",
+        name: brandName
+      }
+    } : {}
+  });
+};
+var FAQPage = (input) => withBase("FAQPage", {
+  mainEntity: input.questions.map((item) => ({
+    "@type": "Question",
+    name: item.question,
+    acceptedAnswer: {
+      "@type": "Answer",
+      text: item.answer
+    }
+  }))
+});
+var HowTo = (input) => withBase("HowTo", {
+  name: input.name,
+  step: input.steps.map((step) => ({
+    "@type": "HowToStep",
+    ...step.name ? { name: step.name } : {},
+    text: step.text
+  }))
+});
+var BreadcrumbList = (input) => withBase("BreadcrumbList", {
+  itemListElement: input.items.map((item, index) => ({
+    "@type": "ListItem",
+    position: index + 1,
+    name: item.name,
+    item: item.useItemObject ? { "@id": item.url, name: item.name } : item.url
+  }))
+});
+var validateSchema = (nodes) => {
+  const issues = [];
+  if (!nodes.length) {
+    issues.push({
+      path: "root",
+      message: "No schema blocks provided",
+      severity: "error",
+      ruleId: "schema.empty"
+    });
+  }
+  nodes.forEach((node, index) => {
+    const pathPrefix = `nodes[${index}]`;
+    if (node["@context"] !== SCHEMA_CONTEXT) {
+      issues.push({
+        path: `${pathPrefix}.@context`,
+        message: "Invalid or missing @context",
+        severity: "error",
+        ruleId: "schema.context"
+      });
+    }
+    const type = node["@type"];
+    if (!isSchemaType(type)) {
+      issues.push({
+        path: `${pathPrefix}.@type`,
+        message: "Unknown or missing @type",
+        severity: "error",
+        ruleId: "schema.type"
+      });
+      return;
+    }
+    const requiredFields = REQUIRED_FIELDS[type] ?? [];
+    for (const field of requiredFields) {
+      if (field === "author") {
+        if (!hasAuthor(node)) {
+          issues.push({
+            path: `${pathPrefix}.author`,
+            message: "Missing required field 'author'",
+            severity: "error",
+            ruleId: "schema.required.author"
+          });
+        }
+        continue;
+      }
+      if (field === "mainEntity") {
+        const value2 = node[field];
+        const ok = Array.isArray(value2) && value2.length > 0;
+        if (!ok) {
+          issues.push({
+            path: `${pathPrefix}.mainEntity`,
+            message: "FAQPage must include at least one Question",
+            severity: "error",
+            ruleId: "schema.required.mainEntity"
+          });
+        }
+        continue;
+      }
+      if (field === "step") {
+        const value2 = node[field];
+        const ok = Array.isArray(value2) && value2.length > 0;
+        if (!ok) {
+          issues.push({
+            path: `${pathPrefix}.step`,
+            message: "HowTo must include at least one step",
+            severity: "error",
+            ruleId: "schema.required.step"
+          });
+        }
+        continue;
+      }
+      if (field === "itemListElement") {
+        const value2 = node[field];
+        const ok = Array.isArray(value2) && value2.length > 0;
+        if (!ok) {
+          issues.push({
+            path: `${pathPrefix}.itemListElement`,
+            message: "BreadcrumbList must include at least one breadcrumb item",
+            severity: "error",
+            ruleId: "schema.required.itemListElement"
+          });
+        }
+        continue;
+      }
+      const value = node[field];
+      if (isEmpty(value)) {
+        issues.push({
+          path: `${pathPrefix}.${field}`,
+          message: `Missing required field '${field}'`,
+          severity: "error",
+          ruleId: `schema.required.${field}`
+        });
+      }
+    }
+    if (type === "BreadcrumbList") {
+      validateBreadcrumbList(node, pathPrefix, issues);
+    }
+  });
+  const errorCount = issues.filter((issue) => issue.severity === "error").length;
+  const warnCount = issues.filter((issue) => issue.severity === "warn").length;
+  const score = Math.max(0, 100 - errorCount * 10 - warnCount * 2);
+  return {
+    ok: errorCount === 0,
+    score,
+    issues
+  };
+};
+var REQUIRED_FIELDS = {
+  Organization: ["name"],
+  Person: ["name"],
+  Place: ["name"],
+  WebSite: ["name", "url"],
+  WebPage: ["name", "url"],
+  Article: ["headline", "author", "datePublished", "url"],
+  BlogPosting: ["headline", "author", "datePublished", "url"],
+  Product: ["name", "description", "url"],
+  FAQPage: ["mainEntity"],
+  HowTo: ["name", "step"],
+  BreadcrumbList: ["itemListElement"]
+};
+var isSchemaType = (value) => typeof value === "string" && value in REQUIRED_FIELDS;
+var isEmpty = (value) => {
+  if (value === null || value === void 0) {
+    return true;
+  }
+  if (typeof value === "string") {
+    return value.trim().length === 0;
+  }
+  if (Array.isArray(value)) {
+    return value.length === 0;
+  }
+  return false;
+};
+var hasAuthor = (node) => {
+  const author = node.author;
+  if (!author) {
+    return false;
+  }
+  if (typeof author === "string") {
+    return author.trim().length > 0;
+  }
+  if (typeof author === "object") {
+    const name = author.name;
+    return typeof name === "string" && name.trim().length > 0;
+  }
+  return false;
+};
+var validateBreadcrumbList = (node, pathPrefix, issues) => {
+  const itemListElement = node.itemListElement;
+  if (!Array.isArray(itemListElement)) {
+    return;
+  }
+  itemListElement.forEach((entry, index) => {
+    if (!entry || typeof entry !== "object") {
+      issues.push({
+        path: `${pathPrefix}.itemListElement[${index}]`,
+        message: "BreadcrumbList items must be objects",
+        severity: "error",
+        ruleId: "schema.breadcrumb.item"
+      });
+      return;
+    }
+    const listItem = entry;
+    const position = listItem.position;
+    if (typeof position !== "number" || !Number.isFinite(position) || position <= 0) {
+      issues.push({
+        path: `${pathPrefix}.itemListElement[${index}].position`,
+        message: "ListItem.position must be a positive number",
+        severity: "error",
+        ruleId: "schema.breadcrumb.position"
+      });
+    }
+    const item = listItem.item;
+    if (typeof item === "string") {
+      if (!isValidUrl(item)) {
+        issues.push({
+          path: `${pathPrefix}.itemListElement[${index}].item`,
+          message: "ListItem.item must be a valid URL",
+          severity: "error",
+          ruleId: "schema.breadcrumb.item.url"
+        });
+      }
+      return;
+    }
+    if (item && typeof item === "object") {
+      const itemObject = item;
+      const id = itemObject["@id"] ?? itemObject.url;
+      if (typeof id !== "string" || !isValidUrl(id)) {
+        issues.push({
+          path: `${pathPrefix}.itemListElement[${index}].item`,
+          message: "ListItem.item must include a valid @id or url",
+          severity: "error",
+          ruleId: "schema.breadcrumb.item.url"
+        });
+      }
+      return;
+    }
+    issues.push({
+      path: `${pathPrefix}.itemListElement[${index}].item`,
+      message: "ListItem.item is required",
+      severity: "error",
+      ruleId: "schema.breadcrumb.item"
+    });
+  });
+};
+var isValidUrl = (value) => {
+  try {
+    new URL(value);
+    return true;
+  } catch {
+    return false;
+  }
+};
+var sortKeys = (value) => {
+  if (Array.isArray(value)) {
+    return value.map(sortKeys);
+  }
+  if (value && typeof value === "object") {
+    const obj = value;
+    const sorted = {};
+    for (const key of Object.keys(obj).sort()) {
+      sorted[key] = sortKeys(obj[key]);
+    }
+    return sorted;
+  }
+  return value;
+};
+var stableStringify = (value) => JSON.stringify(sortKeys(value));
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Article,
+  BlogPosting,
+  BreadcrumbList,
+  FAQPage,
+  HowTo,
+  Location,
+  Organization,
+  Person,
+  Product,
+  SCHEMA_CONTEXT,
+  WebPage,
+  WebSite,
+  stableStringify,
+  validateSchema
+});

package/dist/index.d.cts

@@ -0,0 +1,114 @@
+declare const SCHEMA_CONTEXT: "https://schema.org";
+type JsonLdValue = string | number | boolean | null | JsonLdObject | JsonLdValue[];
+type JsonLdObject = {
+    [key: string]: JsonLdValue;
+};
+type SchemaTypeName = "Organization" | "Person" | "Place" | "WebSite" | "WebPage" | "Article" | "BlogPosting" | "Product" | "FAQPage" | "HowTo" | "BreadcrumbList";
+type SchemaNode = JsonLdObject & {
+    "@context": typeof SCHEMA_CONTEXT;
+    "@type": SchemaTypeName;
+    "@id"?: string;
+};
+type BaseInput = {
+    id?: string;
+};
+type OrganizationInput = BaseInput & {
+    name: string;
+    url?: string;
+    logo?: string;
+    sameAs?: string[];
+    description?: string;
+};
+declare const Organization: (input: OrganizationInput) => SchemaNode;
+type PersonInput = BaseInput & {
+    name: string;
+    url?: string;
+    sameAs?: string[];
+    jobTitle?: string;
+};
+declare const Person: (input: PersonInput) => SchemaNode;
+type LocationInput = BaseInput & {
+    name: string;
+    address?: string;
+    url?: string;
+};
+declare const Location: (input: LocationInput) => SchemaNode;
+type WebSiteInput = BaseInput & {
+    name: string;
+    url: string;
+    description?: string;
+};
+declare const WebSite: (input: WebSiteInput) => SchemaNode;
+type WebPageInput = BaseInput & {
+    name: string;
+    url: string;
+    description?: string;
+    isPartOf?: SchemaNode;
+};
+declare const WebPage: (input: WebPageInput) => SchemaNode;
+type ArticleInput = BaseInput & {
+    headline: string;
+    authorName: string;
+    datePublished: string;
+    url: string;
+    dateModified?: string;
+    description?: string;
+    image?: string;
+};
+declare const Article: (input: ArticleInput) => SchemaNode;
+type BlogPostingInput = ArticleInput;
+declare const BlogPosting: (input: BlogPostingInput) => SchemaNode;
+type ProductInput = BaseInput & {
+    name: string;
+    description: string;
+    url: string;
+    image?: string;
+    brandName?: string;
+    sku?: string;
+};
+declare const Product: (input: ProductInput) => SchemaNode;
+type FAQItem = {
+    question: string;
+    answer: string;
+};
+type FAQPageInput = BaseInput & {
+    questions: FAQItem[];
+};
+declare const FAQPage: (input: FAQPageInput) => SchemaNode;
+type HowToStep = {
+    name?: string;
+    text: string;
+};
+type HowToInput = BaseInput & {
+    name: string;
+    steps: HowToStep[];
+};
+declare const HowTo: (input: HowToInput) => SchemaNode;
+type BreadcrumbItem = {
+    name: string;
+    url: string;
+    useItemObject?: boolean;
+};
+type BreadcrumbListInput = BaseInput & {
+    items: BreadcrumbItem[];
+};
+declare const BreadcrumbList: (input: BreadcrumbListInput) => SchemaNode;
+type Manifest = {
+    routes: Record<string, SchemaTypeName[]>;
+};
+type ValidationSeverity = "error" | "warn";
+type ValidationIssue = {
+    path: string;
+    message: string;
+    severity: ValidationSeverity;
+    ruleId: string;
+};
+type ValidationResult = {
+    ok: boolean;
+    score: number;
+    issues: ValidationIssue[];
+};
+declare const validateSchema: (nodes: SchemaNode[]) => ValidationResult;
+declare const stableStringify: (value: JsonLdValue) => string;
+
+export { Article, type ArticleInput, BlogPosting, type BlogPostingInput, type BreadcrumbItem, BreadcrumbList, type BreadcrumbListInput, type FAQItem, FAQPage, type FAQPageInput, HowTo, type HowToInput, type HowToStep, type JsonLdObject, type JsonLdValue, Location, type LocationInput, type Manifest, Organization, type OrganizationInput, Person, type PersonInput, Product, type ProductInput, SCHEMA_CONTEXT, type SchemaNode, type SchemaTypeName, type ValidationIssue, type ValidationResult, type ValidationSeverity, WebPage, type WebPageInput, WebSite, type WebSiteInput, stableStringify, validateSchema };

package/dist/index.d.ts

@@ -0,0 +1,114 @@
+declare const SCHEMA_CONTEXT: "https://schema.org";
+type JsonLdValue = string | number | boolean | null | JsonLdObject | JsonLdValue[];
+type JsonLdObject = {
+    [key: string]: JsonLdValue;
+};
+type SchemaTypeName = "Organization" | "Person" | "Place" | "WebSite" | "WebPage" | "Article" | "BlogPosting" | "Product" | "FAQPage" | "HowTo" | "BreadcrumbList";
+type SchemaNode = JsonLdObject & {
+    "@context": typeof SCHEMA_CONTEXT;
+    "@type": SchemaTypeName;
+    "@id"?: string;
+};
+type BaseInput = {
+    id?: string;
+};
+type OrganizationInput = BaseInput & {
+    name: string;
+    url?: string;
+    logo?: string;
+    sameAs?: string[];
+    description?: string;
+};
+declare const Organization: (input: OrganizationInput) => SchemaNode;
+type PersonInput = BaseInput & {
+    name: string;
+    url?: string;
+    sameAs?: string[];
+    jobTitle?: string;
+};
+declare const Person: (input: PersonInput) => SchemaNode;
+type LocationInput = BaseInput & {
+    name: string;
+    address?: string;
+    url?: string;
+};
+declare const Location: (input: LocationInput) => SchemaNode;
+type WebSiteInput = BaseInput & {
+    name: string;
+    url: string;
+    description?: string;
+};
+declare const WebSite: (input: WebSiteInput) => SchemaNode;
+type WebPageInput = BaseInput & {
+    name: string;
+    url: string;
+    description?: string;
+    isPartOf?: SchemaNode;
+};
+declare const WebPage: (input: WebPageInput) => SchemaNode;
+type ArticleInput = BaseInput & {
+    headline: string;
+    authorName: string;
+    datePublished: string;
+    url: string;
+    dateModified?: string;
+    description?: string;
+    image?: string;
+};
+declare const Article: (input: ArticleInput) => SchemaNode;
+type BlogPostingInput = ArticleInput;
+declare const BlogPosting: (input: BlogPostingInput) => SchemaNode;
+type ProductInput = BaseInput & {
+    name: string;
+    description: string;
+    url: string;
+    image?: string;
+    brandName?: string;
+    sku?: string;
+};
+declare const Product: (input: ProductInput) => SchemaNode;
+type FAQItem = {
+    question: string;
+    answer: string;
+};
+type FAQPageInput = BaseInput & {
+    questions: FAQItem[];
+};
+declare const FAQPage: (input: FAQPageInput) => SchemaNode;
+type HowToStep = {
+    name?: string;
+    text: string;
+};
+type HowToInput = BaseInput & {
+    name: string;
+    steps: HowToStep[];
+};
+declare const HowTo: (input: HowToInput) => SchemaNode;
+type BreadcrumbItem = {
+    name: string;
+    url: string;
+    useItemObject?: boolean;
+};
+type BreadcrumbListInput = BaseInput & {
+    items: BreadcrumbItem[];
+};
+declare const BreadcrumbList: (input: BreadcrumbListInput) => SchemaNode;
+type Manifest = {
+    routes: Record<string, SchemaTypeName[]>;
+};
+type ValidationSeverity = "error" | "warn";
+type ValidationIssue = {
+    path: string;
+    message: string;
+    severity: ValidationSeverity;
+    ruleId: string;
+};
+type ValidationResult = {
+    ok: boolean;
+    score: number;
+    issues: ValidationIssue[];
+};
+declare const validateSchema: (nodes: SchemaNode[]) => ValidationResult;
+declare const stableStringify: (value: JsonLdValue) => string;
+
+export { Article, type ArticleInput, BlogPosting, type BlogPostingInput, type BreadcrumbItem, BreadcrumbList, type BreadcrumbListInput, type FAQItem, FAQPage, type FAQPageInput, HowTo, type HowToInput, type HowToStep, type JsonLdObject, type JsonLdValue, Location, type LocationInput, type Manifest, Organization, type OrganizationInput, Person, type PersonInput, Product, type ProductInput, SCHEMA_CONTEXT, type SchemaNode, type SchemaTypeName, type ValidationIssue, type ValidationResult, type ValidationSeverity, WebPage, type WebPageInput, WebSite, type WebSiteInput, stableStringify, validateSchema };

package/dist/index.js

@@ -0,0 +1,320 @@
+// src/index.ts
+var SCHEMA_CONTEXT = "https://schema.org";
+var withBase = (type, input) => {
+  const base = {
+    "@context": SCHEMA_CONTEXT,
+    "@type": type
+  };
+  if (input.id) {
+    base["@id"] = input.id;
+  }
+  return {
+    ...base,
+    ...input
+  };
+};
+var Organization = (input) => withBase("Organization", input);
+var Person = (input) => withBase("Person", input);
+var Location = (input) => withBase("Place", input);
+var WebSite = (input) => withBase("WebSite", input);
+var WebPage = (input) => withBase("WebPage", input);
+var Article = (input) => {
+  const { authorName, ...rest } = input;
+  return withBase("Article", {
+    ...rest,
+    author: {
+      "@type": "Person",
+      name: authorName
+    }
+  });
+};
+var BlogPosting = (input) => {
+  const { authorName, ...rest } = input;
+  return withBase("BlogPosting", {
+    ...rest,
+    author: {
+      "@type": "Person",
+      name: authorName
+    }
+  });
+};
+var Product = (input) => {
+  const { brandName, ...rest } = input;
+  return withBase("Product", {
+    ...rest,
+    ...brandName ? {
+      brand: {
+        "@type": "Brand",
+        name: brandName
+      }
+    } : {}
+  });
+};
+var FAQPage = (input) => withBase("FAQPage", {
+  mainEntity: input.questions.map((item) => ({
+    "@type": "Question",
+    name: item.question,
+    acceptedAnswer: {
+      "@type": "Answer",
+      text: item.answer
+    }
+  }))
+});
+var HowTo = (input) => withBase("HowTo", {
+  name: input.name,
+  step: input.steps.map((step) => ({
+    "@type": "HowToStep",
+    ...step.name ? { name: step.name } : {},
+    text: step.text
+  }))
+});
+var BreadcrumbList = (input) => withBase("BreadcrumbList", {
+  itemListElement: input.items.map((item, index) => ({
+    "@type": "ListItem",
+    position: index + 1,
+    name: item.name,
+    item: item.useItemObject ? { "@id": item.url, name: item.name } : item.url
+  }))
+});
+var validateSchema = (nodes) => {
+  const issues = [];
+  if (!nodes.length) {
+    issues.push({
+      path: "root",
+      message: "No schema blocks provided",
+      severity: "error",
+      ruleId: "schema.empty"
+    });
+  }
+  nodes.forEach((node, index) => {
+    const pathPrefix = `nodes[${index}]`;
+    if (node["@context"] !== SCHEMA_CONTEXT) {
+      issues.push({
+        path: `${pathPrefix}.@context`,
+        message: "Invalid or missing @context",
+        severity: "error",
+        ruleId: "schema.context"
+      });
+    }
+    const type = node["@type"];
+    if (!isSchemaType(type)) {
+      issues.push({
+        path: `${pathPrefix}.@type`,
+        message: "Unknown or missing @type",
+        severity: "error",
+        ruleId: "schema.type"
+      });
+      return;
+    }
+    const requiredFields = REQUIRED_FIELDS[type] ?? [];
+    for (const field of requiredFields) {
+      if (field === "author") {
+        if (!hasAuthor(node)) {
+          issues.push({
+            path: `${pathPrefix}.author`,
+            message: "Missing required field 'author'",
+            severity: "error",
+            ruleId: "schema.required.author"
+          });
+        }
+        continue;
+      }
+      if (field === "mainEntity") {
+        const value2 = node[field];
+        const ok = Array.isArray(value2) && value2.length > 0;
+        if (!ok) {
+          issues.push({
+            path: `${pathPrefix}.mainEntity`,
+            message: "FAQPage must include at least one Question",
+            severity: "error",
+            ruleId: "schema.required.mainEntity"
+          });
+        }
+        continue;
+      }
+      if (field === "step") {
+        const value2 = node[field];
+        const ok = Array.isArray(value2) && value2.length > 0;
+        if (!ok) {
+          issues.push({
+            path: `${pathPrefix}.step`,
+            message: "HowTo must include at least one step",
+            severity: "error",
+            ruleId: "schema.required.step"
+          });
+        }
+        continue;
+      }
+      if (field === "itemListElement") {
+        const value2 = node[field];
+        const ok = Array.isArray(value2) && value2.length > 0;
+        if (!ok) {
+          issues.push({
+            path: `${pathPrefix}.itemListElement`,
+            message: "BreadcrumbList must include at least one breadcrumb item",
+            severity: "error",
+            ruleId: "schema.required.itemListElement"
+          });
+        }
+        continue;
+      }
+      const value = node[field];
+      if (isEmpty(value)) {
+        issues.push({
+          path: `${pathPrefix}.${field}`,
+          message: `Missing required field '${field}'`,
+          severity: "error",
+          ruleId: `schema.required.${field}`
+        });
+      }
+    }
+    if (type === "BreadcrumbList") {
+      validateBreadcrumbList(node, pathPrefix, issues);
+    }
+  });
+  const errorCount = issues.filter((issue) => issue.severity === "error").length;
+  const warnCount = issues.filter((issue) => issue.severity === "warn").length;
+  const score = Math.max(0, 100 - errorCount * 10 - warnCount * 2);
+  return {
+    ok: errorCount === 0,
+    score,
+    issues
+  };
+};
+var REQUIRED_FIELDS = {
+  Organization: ["name"],
+  Person: ["name"],
+  Place: ["name"],
+  WebSite: ["name", "url"],
+  WebPage: ["name", "url"],
+  Article: ["headline", "author", "datePublished", "url"],
+  BlogPosting: ["headline", "author", "datePublished", "url"],
+  Product: ["name", "description", "url"],
+  FAQPage: ["mainEntity"],
+  HowTo: ["name", "step"],
+  BreadcrumbList: ["itemListElement"]
+};
+var isSchemaType = (value) => typeof value === "string" && value in REQUIRED_FIELDS;
+var isEmpty = (value) => {
+  if (value === null || value === void 0) {
+    return true;
+  }
+  if (typeof value === "string") {
+    return value.trim().length === 0;
+  }
+  if (Array.isArray(value)) {
+    return value.length === 0;
+  }
+  return false;
+};
+var hasAuthor = (node) => {
+  const author = node.author;
+  if (!author) {
+    return false;
+  }
+  if (typeof author === "string") {
+    return author.trim().length > 0;
+  }
+  if (typeof author === "object") {
+    const name = author.name;
+    return typeof name === "string" && name.trim().length > 0;
+  }
+  return false;
+};
+var validateBreadcrumbList = (node, pathPrefix, issues) => {
+  const itemListElement = node.itemListElement;
+  if (!Array.isArray(itemListElement)) {
+    return;
+  }
+  itemListElement.forEach((entry, index) => {
+    if (!entry || typeof entry !== "object") {
+      issues.push({
+        path: `${pathPrefix}.itemListElement[${index}]`,
+        message: "BreadcrumbList items must be objects",
+        severity: "error",
+        ruleId: "schema.breadcrumb.item"
+      });
+      return;
+    }
+    const listItem = entry;
+    const position = listItem.position;
+    if (typeof position !== "number" || !Number.isFinite(position) || position <= 0) {
+      issues.push({
+        path: `${pathPrefix}.itemListElement[${index}].position`,
+        message: "ListItem.position must be a positive number",
+        severity: "error",
+        ruleId: "schema.breadcrumb.position"
+      });
+    }
+    const item = listItem.item;
+    if (typeof item === "string") {
+      if (!isValidUrl(item)) {
+        issues.push({
+          path: `${pathPrefix}.itemListElement[${index}].item`,
+          message: "ListItem.item must be a valid URL",
+          severity: "error",
+          ruleId: "schema.breadcrumb.item.url"
+        });
+      }
+      return;
+    }
+    if (item && typeof item === "object") {
+      const itemObject = item;
+      const id = itemObject["@id"] ?? itemObject.url;
+      if (typeof id !== "string" || !isValidUrl(id)) {
+        issues.push({
+          path: `${pathPrefix}.itemListElement[${index}].item`,
+          message: "ListItem.item must include a valid @id or url",
+          severity: "error",
+          ruleId: "schema.breadcrumb.item.url"
+        });
+      }
+      return;
+    }
+    issues.push({
+      path: `${pathPrefix}.itemListElement[${index}].item`,
+      message: "ListItem.item is required",
+      severity: "error",
+      ruleId: "schema.breadcrumb.item"
+    });
+  });
+};
+var isValidUrl = (value) => {
+  try {
+    new URL(value);
+    return true;
+  } catch {
+    return false;
+  }
+};
+var sortKeys = (value) => {
+  if (Array.isArray(value)) {
+    return value.map(sortKeys);
+  }
+  if (value && typeof value === "object") {
+    const obj = value;
+    const sorted = {};
+    for (const key of Object.keys(obj).sort()) {
+      sorted[key] = sortKeys(obj[key]);
+    }
+    return sorted;
+  }
+  return value;
+};
+var stableStringify = (value) => JSON.stringify(sortKeys(value));
+export {
+  Article,
+  BlogPosting,
+  BreadcrumbList,
+  FAQPage,
+  HowTo,
+  Location,
+  Organization,
+  Person,
+  Product,
+  SCHEMA_CONTEXT,
+  WebPage,
+  WebSite,
+  stableStringify,
+  validateSchema
+};

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@schemasentry/core",
+  "version": "0.1.0",
+  "description": "Typed schema builders and validation primitives for Schema Sentry.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/arindamdawn/schema-sentry.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/arindamdawn/schema-sentry#readme",
+  "bugs": {
+    "url": "https://github.com/arindamdawn/schema-sentry/issues"
+  },
+  "keywords": [
+    "schema",
+    "json-ld",
+    "structured-data",
+    "seo",
+    "nextjs",
+    "typescript"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --clean --tsconfig tsconfig.build.json",
+    "lint": "echo \"lint not configured\" && exit 0",
+    "test": "vitest run"
+  }
+}