@thejob/schema 2.0.4 → 2.0.5

package/src/post/post.schema.ts

@@ -0,0 +1,68 @@
+import { array, boolean, number, object, string } from "yup";
+import type { InferType } from "yup";
+import { DbDefaultSchema } from "../common/common.schema.js";
+import { PostStatus, SupportedPostStatuses } from "./post.constant.js";
+
+export const PostSchema = object({
+  /** Headline shown in listings and at the top of the post. */
+  title: string().required().min(5).max(200).label("Title"),
+
+  /** User-friendly, unique URL identifier. */
+  slug: string().required().max(250).label("Slug"),
+
+  /** Short summary used in listings and meta description fallback. */
+  excerpt: string().max(500).optional().label("Excerpt"),
+
+  /** Rendered HTML source of truth for the post body (sanitized on write/render).
+   *  Supports rich formatting markdown can't express (image size/alignment, etc). */
+  bodyHTML: string().required().min(1).label("Body (HTML)"),
+
+  /** Optional Markdown mirror of the body (portable text / search fallback).
+   *  Kept for back-compat and plain-text derivation; bodyHTML is authoritative. */
+  bodyMarkdown: string().optional().label("Body (Markdown)"),
+
+  /** Cover/hero image URL. Not `.url()`-validated: the value is either an
+   *  uploaded file URL served by this platform (which may be a bare host like
+   *  `http://localhost:3082/...` in dev, that yup's `.url()` wrongly rejects) or
+   *  an admin-pasted link. Kept as a plain string; empty ⇒ null. */
+  coverImage: string().nullable().optional().label("Cover image"),
+
+  /** Author (user id). */
+  authorId: string().required().label("Author ID"),
+
+  /** Free-form tags for filtering and related-posts. */
+  tags: array().of(string().trim().required()).default([]).label("Tags"),
+
+  /** Estimated reading time in minutes (server-derived from body length). */
+  readingTimeMinutes: number()
+    .min(0)
+    .optional()
+    .label("Reading time (minutes)"),
+
+  /** SEO overrides. */
+  seoTags: object({
+    description: string().optional().label("Description"),
+    keywords: array().of(string().required()).optional().label("Keywords"),
+  })
+    .nullable()
+    .optional()
+    .label("SEO Tags"),
+
+  /** When the post was first published (epoch ms). Server-owned. */
+  publishedAt: number().nullable().optional().label("Published at"),
+
+  /** Whether the post is featured in the blog listing. */
+  isFeatured: boolean().default(false).optional().label("Is featured"),
+
+  /** Publication state. */
+  status: string()
+    .oneOf(SupportedPostStatuses)
+    .default(PostStatus.Draft)
+    .required()
+    .label("Status"),
+})
+  .concat(DbDefaultSchema)
+  .noUnknown()
+  .label("Post");
+
+export type TPostSchema = InferType<typeof PostSchema>;