@segha/catalog 4.1.1 → 5.0.0

package/CHANGELOG.md

@@ -5,6 +5,22 @@ All notable changes to @segha/catalog will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [5.0.0] - 2026-02-09
+
+### Spanish (es)
+
+#### Added
+
+- Schema `TVSeriesSchema` was added
+- Optional property `description` was added to `PaintingSchema`
+- Optional property `description` was added to `VideoSchema`
+- Optional property `description` was added to `VimeoSchema`
+- Optional property `description` was added to `YoutubeSchema`
+
+#### Changed
+
+- **BREAKING** `MovieSchema` type changed from `object` to `undefined`
+
 ## [4.1.0] - 2026-02-08
 
 ### Spanish (es)

package/es/Core/Format.ts

@@ -15,6 +15,9 @@ export const Movies = z.literal("[[Películas]]")
 export const Paintings = z.literal("[[Pinturas]]")
   .describe('Pinturas');
 
+export const TVSeries = z.literal("[[Series]]")
+  .describe('Series');
+
 export const Videos = z.literal("[[Vídeos]]")
   .describe('Vídeos');
 
@@ -24,5 +27,6 @@ export const Format = z.enum([
   EncyclopediaEntries.value,
   Movies.value,
   Paintings.value,
+  TVSeries.value,
   Videos.value,
 ]).describe('Formato de nota.');

package/es/Core/Source.ts

@@ -34,4 +34,5 @@ export const SourceSchema = CommonSchema.extend({
   title: z.string()
     .optional()
     .describe('Título de la fuente.'),
+  description: z.string().optional().describe('Descripción de la fuente.'),
 }).describe('Fuentes Bibliográficas');

package/es/DataTypes/ExternalId.ts

@@ -0,0 +1,7 @@
+import z from "zod";
+
+import * as ExternalIds from '../../common/ExternalIds';
+
+export const TVExternalId = z.string()
+  .regex(ExternalIds.TV, "Formato de ID externo inválido");
+

package/es/DataTypes/StreamUrls.ts

@@ -0,0 +1,12 @@
+import z from "zod";
+
+export const StreamUrlsSchema = z.object({
+  hbo_max_url: z.url().optional().describe('URL de HBO Max'),
+  netflix_url: z.url().optional().describe('URL de Netflix'),
+  apple_tv_url: z.url().optional().describe('URL de Apple TV'),
+  amazon_prime_url: z.url().optional().describe('URL de Amazon Prime'),
+  disney_plus_url: z.url().optional().describe('URL de Disney Plus'),
+  hulu_url: z.url().optional().describe('URL de Hulu'),
+  pluto_tv_url: z.url().optional().describe('URL de Pluto TV'),
+  youtube_url: z.url().optional().describe('URL de YouTube'),
+}).describe('URLs de streaming');

package/es/DataTypes/index.ts

@@ -1,7 +1,9 @@
 export * from './Color';
 export * from './Date';
+export * from './ExternalId';
 export * from './Icon';
 export * from './Image';
 export * from './Language';
 export * from './Status';
+export * from './StreamUrls';
 export * from './Wikilink';

package/es/DataTypes/types.ts

@@ -0,0 +1,4 @@
+import type z from "zod";
+import { StreamUrlsSchema } from "./StreamUrls";
+
+export type StreamUrls = z.infer<typeof StreamUrlsSchema>;

package/es/Movie/index.ts

@@ -2,8 +2,8 @@
 import z from "zod";
 
 import { Areas, Creativity, Movies, SourceSchema } from '../Core';
-import { Color, Date, Icon, Image, InProgress, Pending, Watched, Yellow } from "../DataTypes";
-import { MovieExternalId } from "./MovieExternalId";
+import { Color, Date, Icon, Image, InProgress, Pending, StreamUrlsSchema, Watched, Yellow } from "../DataTypes";
+import { TVExternalId } from "../DataTypes";
 
 const MovieStatus = z
   .union([Pending, InProgress, Watched])
@@ -11,21 +11,26 @@ const MovieStatus = z
 
 const MovieIcon = z.literal("movie");
 
-export const MovieSchema = SourceSchema.extend({
-  format: Movies.default(Movies.value),
-  status: MovieStatus.default(Pending.value),
-  areas: Areas.default([Creativity.value]),
-  color: Color.optional().default(Yellow.value).describe('Color de la nota.'),
-  icon: Icon.optional().default(MovieIcon.value).describe('Icono de Lucide.'),
-  cover: Image.nullable().optional().describe('Portada de la película.'),
-  url: z.url().describe('URL de la película en IMDB o similar'),
-  watch_url: z.url().optional().describe('URL de la película en streaming'),
-  external_ids: z.array(MovieExternalId).optional().describe('IDs externos de la película'),
-  title: z.string().describe('Título de la película'),
-  actors: z.array(z.string()).optional().describe('Actores'),
-  published: Date.optional().describe('Año de publicación'),
-  genres: z.array(z.string()).optional().describe('Géneros'),
-  online_rating: z.number().optional().describe('Puntuación en línea'),
-  last_time_watched: Date.optional().describe('Última vez vista'),
-  times_watched: z.number().default(0).optional().describe('Veces vista'),
-}).describe('Película');
+export const MovieSchema = SourceSchema
+  .extend({
+    format: Movies.default(Movies.value),
+    status: MovieStatus.default(Pending.value),
+    areas: Areas.default([Creativity.value]),
+    color: Color.optional().default(Yellow.value).describe('Color de la nota.'),
+    icon: Icon.optional().default(MovieIcon.value).describe('Icono de Lucide.'),
+    cover: Image.nullable().optional().describe('Portada de la película.'),
+    url: z.url().describe('URL de la película en IMDB o similar'),
+    watch_url: z.url().optional().describe('URL de la película en streaming').meta({
+      deprecated: true,
+      replacement: 'hbo_max_url|netflix_url|apple_tv_url|amazon_prime_url|disney_plus_url|hulu_url|pluto_tv_url|youtube_url',
+    }),
+    external_ids: z.array(TVExternalId).optional().describe('IDs externos de la película'),
+    title: z.string().describe('Título de la película'),
+    actors: z.array(z.string()).optional().describe('Actores'),
+    published: Date.optional().describe('Año de publicación'),
+    genres: z.array(z.string()).optional().describe('Géneros'),
+    online_rating: z.number().optional().describe('Puntuación en línea'),
+    last_time_watched: Date.optional().describe('Última vez vista'),
+    times_watched: z.number().default(0).optional().describe('Veces vista'),
+  })
+  .and(StreamUrlsSchema).describe('Película');

package/es/Note.ts

@@ -5,6 +5,7 @@ import { BookSchema } from "./Book";
 import { ClothingSchema } from "./Clothing";
 import { MovieSchema } from "./Movie";
 import { PaintingSchema } from "./Painting";
+import { TVSeriesSchema } from "./TVSeries";
 import { VideoSchema } from "./Video";
 import { EncyclopediaEntrySchema } from "./EncyclopediaEntry";
 
@@ -15,5 +16,6 @@ export const NoteSchema = z.union([
   EncyclopediaEntrySchema,
   MovieSchema,
   PaintingSchema,
+  TVSeriesSchema,
   VideoSchema,
 ]).describe('Nota: Unión de todos los tipos de notas');

package/es/TVSeries/index.ts

@@ -0,0 +1,36 @@
+
+import z from "zod";
+
+import { Areas, Creativity, TVSeries, SourceSchema } from '../Core';
+import { Color, Date, Icon, Image, InProgress, Pending, StreamUrlsSchema, Watched, Yellow } from "../DataTypes";
+import { TVExternalId } from "../DataTypes";
+
+const TVSeriesStatus = z
+  .union([Pending, InProgress, Watched])
+  .describe('Estado de visualización de la serie de TV');
+
+const TVSeriesIcon = z.literal("tv");
+
+export const TVSeriesSchema = SourceSchema
+  .extend({
+    format: TVSeries.default(TVSeries.value),
+    status: TVSeriesStatus.default(Pending.value),
+    areas: Areas.default([Creativity.value]),
+    color: Color.optional().default(Yellow.value).describe('Color de la nota.'),
+    icon: Icon.optional().default(TVSeriesIcon.value).describe('Icono de Lucide.'),
+    cover: Image.nullable().optional().describe('Portada de la serie de TV.'),
+    url: z.url().describe('URL de la serie de TV en IMDB o similar'),
+    watch_url: z.url().optional().describe('URL de la serie de TV en streaming').meta({
+      deprecated: true,
+      replacement: 'hbo_max_url|netflix_url|apple_tv_url|amazon_prime_url|disney_plus_url|hulu_url|pluto_tv_url|youtube_url',
+    }),
+    external_ids: z.array(TVExternalId).optional().describe('IDs externos de la serie de TV'),
+    title: z.string().describe('Título de la serie de TV'),
+    actors: z.array(z.string()).optional().describe('Actores'),
+    published: Date.optional().describe('Año de publicación'),
+    genres: z.array(z.string()).optional().describe('Géneros'),
+    online_rating: z.number().optional().describe('Puntuación en línea'),
+    last_time_watched: Date.optional().describe('Última vez vista'),
+    times_watched: z.number().default(0).optional().describe('Veces vista'),
+  })
+  .and(StreamUrlsSchema).describe('Serie de TV');

package/es/TVSeries/types.ts

@@ -0,0 +1,6 @@
+
+import type { z } from 'zod';
+
+import type { TVSeriesSchema } from ".";
+
+export type TVSeries = z.infer<typeof TVSeriesSchema>;

package/es/index.ts

@@ -5,6 +5,7 @@ export * from './EncyclopediaEntry';
 export * from './Movie';
 export * from './Note';
 export * from './Painting';
+export * from './TVSeries';
 export * from './Video';
 
 export * from './types';

package/es/types.ts

@@ -4,9 +4,11 @@ import { NoteSchema } from './Note';
 export * from './Article/types';
 export * from './Book/types';
 export * from './Clothing/types';
+export * from './DataTypes/types';
 export * from './EncyclopediaEntry/types';
 export * from './Movie/types';
 export * from './Painting/types';
+export * from './TVSeries/types';
 export * from './Video/types';
 
 export type Note = z.infer<typeof NoteSchema>;

package/json-schemas/es/Book/BookSchema.json

@@ -219,15 +219,6 @@
       "type": "string",
       "description": "Título del libro"
     },
-    "read_url": {
-      "description": "URL de la lectura del libro",
-      "type": "string",
-      "format": "uri"
-    },
-    "subtitle": {
-      "description": "Subtítulo del libro",
-      "type": "string"
-    },
     "description": {
       "description": "Descripción",
       "anyOf": [
@@ -239,6 +230,15 @@
         }
       ]
     },
+    "read_url": {
+      "description": "URL de la lectura del libro",
+      "type": "string",
+      "format": "uri"
+    },
+    "subtitle": {
+      "description": "Subtítulo del libro",
+      "type": "string"
+    },
     "categories": {
       "description": "Géneros",
       "type": "array",

package/json-schemas/es/Book/index.json

@@ -224,15 +224,6 @@
           "type": "string",
           "description": "Título del libro"
         },
-        "read_url": {
-          "description": "URL de la lectura del libro",
-          "type": "string",
-          "format": "uri"
-        },
-        "subtitle": {
-          "description": "Subtítulo del libro",
-          "type": "string"
-        },
         "description": {
           "description": "Descripción",
           "anyOf": [
@@ -244,6 +235,15 @@
             }
           ]
         },
+        "read_url": {
+          "description": "URL de la lectura del libro",
+          "type": "string",
+          "format": "uri"
+        },
+        "subtitle": {
+          "description": "Subtítulo del libro",
+          "type": "string"
+        },
         "categories": {
           "description": "Géneros",
           "type": "array",

package/json-schemas/es/BookSchema.json

@@ -219,15 +219,6 @@
       "type": "string",
       "description": "Título del libro"
     },
-    "read_url": {
-      "description": "URL de la lectura del libro",
-      "type": "string",
-      "format": "uri"
-    },
-    "subtitle": {
-      "description": "Subtítulo del libro",
-      "type": "string"
-    },
     "description": {
       "description": "Descripción",
       "anyOf": [
@@ -239,6 +230,15 @@
         }
       ]
     },
+    "read_url": {
+      "description": "URL de la lectura del libro",
+      "type": "string",
+      "format": "uri"
+    },
+    "subtitle": {
+      "description": "Subtítulo del libro",
+      "type": "string"
+    },
     "categories": {
       "description": "Géneros",
       "type": "array",

package/json-schemas/es/Core/Format.json

@@ -7,6 +7,7 @@
     "[[Entradas de Enciclopedia]]",
     "[[Películas]]",
     "[[Pinturas]]",
+    "[[Series]]",
     "[[Vídeos]]"
   ],
   "description": "Formato de nota."

package/json-schemas/es/Core/SourceSchema.json

@@ -198,6 +198,10 @@
     "title": {
       "description": "Título de la fuente.",
       "type": "string"
+    },
+    "description": {
+      "description": "Descripción de la fuente.",
+      "type": "string"
     }
   },
   "required": [

package/json-schemas/es/Core/TVSeries.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "string",
+  "const": "[[Series]]",
+  "description": "Series"
+}

package/json-schemas/es/Core/index.json

@@ -345,6 +345,7 @@
         "[[Entradas de Enciclopedia]]",
         "[[Películas]]",
         "[[Pinturas]]",
+        "[[Series]]",
         "[[Vídeos]]"
       ],
       "description": "Formato de nota."
@@ -361,6 +362,12 @@
       "const": "[[Pinturas]]",
       "description": "Pinturas"
     },
+    "TVSeries": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "type": "string",
+      "const": "[[Series]]",
+      "description": "Series"
+    },
     "Videos": {
       "$schema": "https://json-schema.org/draft/2020-12/schema",
       "type": "string",
@@ -831,6 +838,10 @@
         "title": {
           "description": "Título de la fuente.",
           "type": "string"
+        },
+        "description": {
+          "description": "Descripción de la fuente.",
+          "type": "string"
         }
       },
       "required": [

package/json-schemas/es/DataTypes/StreamUrlsSchema.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "hbo_max_url": {
+      "description": "URL de HBO Max",
+      "type": "string",
+      "format": "uri"
+    },
+    "netflix_url": {
+      "description": "URL de Netflix",
+      "type": "string",
+      "format": "uri"
+    },
+    "apple_tv_url": {
+      "description": "URL de Apple TV",
+      "type": "string",
+      "format": "uri"
+    },
+    "amazon_prime_url": {
+      "description": "URL de Amazon Prime",
+      "type": "string",
+      "format": "uri"
+    },
+    "disney_plus_url": {
+      "description": "URL de Disney Plus",
+      "type": "string",
+      "format": "uri"
+    },
+    "hulu_url": {
+      "description": "URL de Hulu",
+      "type": "string",
+      "format": "uri"
+    },
+    "pluto_tv_url": {
+      "description": "URL de Pluto TV",
+      "type": "string",
+      "format": "uri"
+    },
+    "youtube_url": {
+      "description": "URL de YouTube",
+      "type": "string",
+      "format": "uri"
+    }
+  },
+  "description": "URLs de streaming"
+}

package/json-schemas/es/DataTypes/index.json

@@ -108,6 +108,11 @@
       "pattern": "^[0-9]{4}$",
       "description": "Año: YYYY"
     },
+    "TVExternalId": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "type": "string",
+      "pattern": "^(tmdb|imdb|watchmode|tvmaze|tvdb):.+$"
+    },
     "Icon": {
       "$schema": "https://json-schema.org/draft/2020-12/schema",
       "type": "string",
@@ -171,6 +176,53 @@
       "type": "string",
       "const": "Visto"
     },
+    "StreamUrlsSchema": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "type": "object",
+      "properties": {
+        "hbo_max_url": {
+          "description": "URL de HBO Max",
+          "type": "string",
+          "format": "uri"
+        },
+        "netflix_url": {
+          "description": "URL de Netflix",
+          "type": "string",
+          "format": "uri"
+        },
+        "apple_tv_url": {
+          "description": "URL de Apple TV",
+          "type": "string",
+          "format": "uri"
+        },
+        "amazon_prime_url": {
+          "description": "URL de Amazon Prime",
+          "type": "string",
+          "format": "uri"
+        },
+        "disney_plus_url": {
+          "description": "URL de Disney Plus",
+          "type": "string",
+          "format": "uri"
+        },
+        "hulu_url": {
+          "description": "URL de Hulu",
+          "type": "string",
+          "format": "uri"
+        },
+        "pluto_tv_url": {
+          "description": "URL de Pluto TV",
+          "type": "string",
+          "format": "uri"
+        },
+        "youtube_url": {
+          "description": "URL de YouTube",
+          "type": "string",
+          "format": "uri"
+        }
+      },
+      "description": "URLs de streaming"
+    },
     "Embedding": {
       "$schema": "https://json-schema.org/draft/2020-12/schema",
       "type": "string",