recipe-scrapers-js 1.0.0-rc.2 → 1.0.0-rc.3

package/CHANGELOG.md

@@ -6,6 +6,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.0-rc.3] - 2025-12-21
+
+### Changed
+
+- Enforce positive integer values for recipe time fields (`totalTime`, `cookTime`, `prepTime`)
+- Rename schema helper `zPositiveNumber` to `zPositiveInteger`
+- Stop defaulting nullable schema fields to `null`
+
 ## [1.0.0-rc.2] - 2025-12-20
 
 ### Added
@@ -14,8 +22,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 
-- Make `links` field optional, and thus `undefined` in the recipe object, unless link parsing is enabled
-- Move schema transform & refinement validations into a helper function `applyRecipeValidations`
+- Make `links` optional; it stays `undefined` unless link parsing is enabled
+- Extract schema transform/refinement validations into `applyRecipeValidations`
 
 ## [1.0.0-rc.1] - 2025-12-20
 
@@ -25,18 +33,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Fixed
 
-- Fix main/module/type entriess in package.json; add exports field
+- Fix `main`/`module`/`types` entries in `package.json`; add `exports`
 
 ## [1.0.0-rc.0] - 2025-12-20
 
 ### Added
 
 - Optional ingredient parsing via [parse-ingredient](https://github.com/jakeboone02/parse-ingredient)
-- `parse()` and `safeParse()` methods for Zod schema validated recipe extraction
+- `parse()` and `safeParse()` methods for Zod-validated recipe extraction
 
 ### Changed
 
-- **BREAKING**: Renamed `toObject()` method to `toRecipeObject()` for clarity
+- **BREAKING**: Rename `toObject()` method to `toRecipeObject()` for clarity
 - **BREAKING**: Ingredients and instructions now require grouped structures (each group has `name` and `items`) instead of flat arrays
 
 ---

package/dist/index.d.mts

@@ -73,7 +73,7 @@ declare const IngredientItemSchema: z.ZodObject<{
  * Schema for a group of ingredients
  */
 declare const IngredientGroupSchema: z.ZodObject<{
-  name: z.ZodDefault<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>>;
+  name: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
   items: z.ZodArray<z.core.$ZodType<{
     value: string;
     parsed?: {
@@ -101,7 +101,7 @@ declare const IngredientGroupSchema: z.ZodObject<{
  * Must have at least one group with at least one ingredient
  */
 declare const IngredientsSchema: z.ZodArray<z.ZodObject<{
-  name: z.ZodDefault<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>>;
+  name: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
   items: z.ZodArray<z.core.$ZodType<{
     value: string;
     parsed?: {
@@ -134,7 +134,7 @@ declare const InstructionItemSchema: z.ZodObject<{
  * Schema for a group of instruction steps
  */
 declare const InstructionGroupSchema: z.ZodObject<{
-  name: z.ZodDefault<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>>;
+  name: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
   items: z.ZodArray<z.core.$ZodType<{
     value: string;
   }, unknown, z.core.$ZodTypeInternals<{
@@ -146,7 +146,7 @@ declare const InstructionGroupSchema: z.ZodObject<{
  * Must have at least one group with at least one step
  */
 declare const InstructionsSchema: z.ZodArray<z.ZodObject<{
-  name: z.ZodDefault<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>>;
+  name: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
   items: z.ZodArray<z.core.$ZodType<{
     value: string;
   }, unknown, z.core.$ZodTypeInternals<{
@@ -182,7 +182,7 @@ declare const RecipeObjectBaseSchema: z.ZodObject<{
   title: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
   author: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
   ingredients: z.ZodArray<z.ZodObject<{
-    name: z.ZodDefault<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>>;
+    name: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
     items: z.ZodArray<z.core.$ZodType<{
       value: string;
       parsed?: {
@@ -206,7 +206,7 @@ declare const RecipeObjectBaseSchema: z.ZodObject<{
     }, unknown>>>;
   }, z.core.$strip>>;
   instructions: z.ZodArray<z.ZodObject<{
-    name: z.ZodDefault<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>>;
+    name: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
     items: z.ZodArray<z.core.$ZodType<{
       value: string;
     }, unknown, z.core.$ZodTypeInternals<{
@@ -215,16 +215,16 @@ declare const RecipeObjectBaseSchema: z.ZodObject<{
   }, z.core.$strip>>;
   canonicalUrl: z.ZodURL;
   image: z.ZodURL;
-  totalTime: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
-  cookTime: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
-  prepTime: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+  totalTime: z.ZodNullable<z.ZodInt>;
+  cookTime: z.ZodNullable<z.ZodInt>;
+  prepTime: z.ZodNullable<z.ZodInt>;
   ratings: z.ZodDefault<z.ZodNumber>;
   ratingsCount: z.ZodDefault<z.ZodInt>;
   yields: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
   description: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
   language: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>>;
-  siteName: z.ZodDefault<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>>;
-  cookingMethod: z.ZodDefault<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>>;
+  siteName: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+  cookingMethod: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
   category: z.ZodDefault<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>>;
   cuisine: z.ZodDefault<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>>;
   keywords: z.ZodDefault<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>>;

package/dist/index.mjs

@@ -48,9 +48,9 @@ const zString = (fieldName, { min = 1, max = 0 } = {}) => z.string(`${fieldName}
 */
 const zHttpUrl = (fieldName) => z.httpUrl(`${fieldName} must be a valid URL`);
 /**
-* Helper to create a positive number field
+* Helper to create a positive integer field
 */
-const zPositiveNumber = (fieldName) => z.number(`${fieldName} must be a number`).positive(`${fieldName} must be positive`).nullable().default(null);
+const zPositiveInteger = (fieldName) => z.int(`${fieldName} must be an integer`).positive(`${fieldName} must be positive`).nullable();
 const zNonEmptyArray = (schema, fieldName) => z.array(schema, `${fieldName} items must be an array`).min(1, `${fieldName} group must have at least one item`);
 
 //#endregion
@@ -87,7 +87,7 @@ const IngredientItemSchema = z.object({
 * Schema for a group of ingredients
 */
 const IngredientGroupSchema = z.object({
-	name: zString("Ingredient group name").nullable().default(null),
+	name: zString("Ingredient group name").nullable(),
 	items: zNonEmptyArray(IngredientItemSchema, "Ingredient")
 });
 /**
@@ -103,7 +103,7 @@ const InstructionItemSchema = z.object({ value: zString("Instruction value") });
 * Schema for a group of instruction steps
 */
 const InstructionGroupSchema = z.object({
-	name: zString("Instruction group name").nullable().default(null),
+	name: zString("Instruction group name").nullable(),
 	items: zNonEmptyArray(InstructionItemSchema, "Instruction")
 });
 /**
@@ -143,16 +143,16 @@ const RecipeObjectBaseSchema = z.object({
 	instructions: InstructionsSchema,
 	canonicalUrl: zHttpUrl("Canonical URL"),
 	image: zHttpUrl("Image"),
-	totalTime: zPositiveNumber("Total time"),
-	cookTime: zPositiveNumber("Cook time"),
-	prepTime: zPositiveNumber("Prep time"),
+	totalTime: zPositiveInteger("Total time"),
+	cookTime: zPositiveInteger("Cook time"),
+	prepTime: zPositiveInteger("Prep time"),
 	ratings: z.number("Ratings must be a number").min(0, "Ratings must be at least 0").max(5, "Ratings must be at most 5").default(0),
 	ratingsCount: z.int("Ratings count must be an integer").nonnegative("Ratings count must be non-negative").default(0),
 	yields: zString("Yields"),
 	description: zString("Description"),
 	language: zString("Language", { min: 2 }).optional().default("en"),
-	siteName: zString("Site name").nullable().default(null),
-	cookingMethod: zString("Cooking method").nullable().default(null),
+	siteName: zString("Site name").nullable(),
+	cookingMethod: zString("Cooking method").nullable(),
 	category: z.array(zString("Category item"), "Category must be an array").default([]),
 	cuisine: z.array(zString("Cuisine item"), "Cuisine must be an array").default([]),
 	keywords: z.array(zString("Keyword item"), "Keywords must be an array").default([]),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "recipe-scrapers-js",
-  "version": "1.0.0-rc.2",
+  "version": "1.0.0-rc.3",
   "license": "MIT",
   "description": "A recipe scrapers library",
   "author": {