Gerador de Schema.org LocalBusiness

1// schema-generator.js
2// Pure, framework-agnostic builder for Schema.org LocalBusiness JSON-LD.
3// Same function powers the live tool at eduardomendes.com.br/repo/schema and
4// this downloadable module — no divergence.
5//
6// Usage:
7//   import { buildSchema } from "./schema-generator.js";
8//   const jsonld = buildSchema({ type: "Dentist", name: "...", ... });
9//   console.log(JSON.stringify(jsonld, null, 2));
10
11/** Specific @type values that all inherit from LocalBusiness. */
12export const BUSINESS_TYPES = [
13  "LocalBusiness",
14  "Dentist",
15  "LegalService",
16  "Restaurant",
17  "HomeAndConstructionBusiness",
18];
19
20/** Drop empty strings / empty arrays so the output stays clean. */
21function clean(value) {
22  if (Array.isArray(value)) {
23    const arr = value.map(clean).filter((v) => v !== undefined && v !== "" && !(Array.isArray(v) && v.length === 0));
24    return arr.length ? arr : undefined;
25  }
26  if (value && typeof value === "object") {
27    const out = {};
28    for (const [k, v] of Object.entries(value)) {
29      const c = clean(v);
30      if (c !== undefined && c !== "") out[k] = c;
31    }
32    return Object.keys(out).length ? out : undefined;
33  }
34  if (typeof value === "string") return value.trim() || undefined;
35  return value;
36}
37
38/**
39 * @param {object} data
40 * @param {string} data.type          One of BUSINESS_TYPES
41 * @param {string} data.name          Business name (required)
42 * @param {string} [data.description]
43 * @param {string} [data.url]
44 * @param {string} [data.telephone]
45 * @param {string} [data.priceRange]
46 * @param {object} [data.address]     { street, locality, region, postalCode, country }
47 * @param {object} [data.geo]         { lat, lng }
48 * @param {string[]} [data.areaServed]
49 * @param {string[]} [data.sameAs]
50 * @param {string[]} [data.services]  Service names offered
51 * @returns {object} JSON-LD object
52 */
53export function buildSchema(data = {}) {
54  const type = BUSINESS_TYPES.includes(data.type) ? data.type : "LocalBusiness";
55
56  const address = data.address
57    ? {
58        "@type": "PostalAddress",
59        streetAddress: data.address.street,
60        addressLocality: data.address.locality,
61        addressRegion: data.address.region,
62        postalCode: data.address.postalCode,
63        addressCountry: data.address.country,
64      }
65    : undefined;
66
67  const geo =
68    data.geo && (data.geo.lat || data.geo.lng)
69      ? { "@type": "GeoCoordinates", latitude: data.geo.lat, longitude: data.geo.lng }
70      : undefined;
71
72  const services = Array.isArray(data.services)
73    ? data.services
74        .map((s) => (typeof s === "string" ? s.trim() : ""))
75        .filter(Boolean)
76        .map((name) => ({ "@type": "Offer", itemOffered: { "@type": "Service", name } }))
77    : undefined;
78
79  const schema = {
80    "@context": "https://schema.org",
81    "@type": type,
82    name: data.name,
83    description: data.description,
84    url: data.url,
85    telephone: data.telephone,
86    priceRange: data.priceRange,
87    address,
88    geo,
89    areaServed: Array.isArray(data.areaServed)
90      ? data.areaServed.map((a) => (typeof a === "string" ? a.trim() : "")).filter(Boolean)
91      : undefined,
92    sameAs: Array.isArray(data.sameAs)
93      ? data.sameAs.map((s) => (typeof s === "string" ? s.trim() : "")).filter(Boolean)
94      : undefined,
95    makesOffer: services,
96  };
97
98  return clean(schema) || { "@context": "https://schema.org", "@type": type };
99}
100
101/** Which fields are required for a valid, useful result. */
102export function validate(data = {}) {
103  const errors = {};
104  if (!data.name || !data.name.trim()) errors.name = "required";
105  if (!data.url || !data.url.trim()) errors.url = "required";
106  if (data.url && data.url.trim() && !/^https?:\/\//i.test(data.url.trim())) errors.url = "must start with http(s)://";
107  return errors;
108}