Book builder

Creates a Book with author, publication, rating, and review metadata. The Book builder injects @type, validates synchronously, and rejects unknown properties.

Import

// Astro — shown first when Astro is selected
import { Book } from '@unschema-graph/astro';

// Svelte 5
import { Book } from '@unschema-graph/svelte';

// Core / Node.js
import { Book } from '@unschema-graph/core';
import { BookSchema } from '@unschema-graph/core';

The BookSchema Zod schema is also exported for composition and advanced validation.

TypeScript types

import {
  BookSchema,
  type SchemaInput,
  type SchemaOutput,
} from '@unschema-graph/core';

type BookInput = SchemaInput<typeof BookSchema>;
type BookOutput = SchemaOutput<typeof BookSchema, 'Book'>;

Input properties

Property	Input type	Required	Default / constraints
@id	string	No	non-empty
name	string	Yes	non-empty
author	string | Person | Organization | EntityReference | Array<string | Person | Organization | EntityReference>	Yes	—
isbn	string	No	—
bookFormat	string	No	—
datePublished	string | number | Date	No	non-empty
publisher	string | Organization | EntityReference	No	—
inLanguage	string	No	—
numberOfPages	number	No	integer; greater than 0; maximum: 9007199254740991
description	string	No	—
aggregateRating	AggregateRating	No	—
review	Review | Array<Review>	No	—

The aliases above remain the exact authority for nested object types. The builder also accepts a validation configuration as its second argument and always returns @type: 'Book'.

Minimal example

import { Book } from '@unschema-graph/core';

const entity = Book({
  "name": "The Astro Handbook",
  "author": "Ada Lovelace"
});

Output

{
  "@type": "Book",
  "name": "The Astro Handbook",
  "author": "Ada Lovelace"
}

Relationships and recipes

• Related builders: Article, BlogPosting, NewsArticle, Recipe
• Used by: no dedicated recipe
• External sources: Schema.org Book

Common errors

• Passing an unknown property to the strict builder.
• Using source data that is missing a required property.
• Assuming valid Schema.org guarantees a search appearance.

Validation

Use Book.safeParse(input) for external data. If Schema.org supports a property that is not modeled yet, validate the entity first and then use withAdditionalProperties(). Never pass invented properties to the strict builder.