@pramen/cms 0.0.15 → 0.0.17

package/dist/index.d.ts

@@ -4,7 +4,7 @@ import type { HandlerContext, Policy, FileRef } from "@pramen/server";
 export interface FieldDefinition {
     name: string;
     label?: string;
-    type: "text" | "textarea" | "richtext" | "url" | "number" | "boolean" | "media" | "select" | "repeater" | "group";
+    type: "text" | "textarea" | "richtext" | "url" | "number" | "boolean" | "date" | "datetime" | "media" | "select" | "repeater" | "group";
     required?: boolean;
     default?: unknown;
     /** repeater/group only — the nested fields. */
@@ -35,7 +35,7 @@ export type RichText = string | {
 };
 /** Map one FieldDefinition (as a const literal) to the TS type of its RENDERED value.
  * Media resolves to `ResolvedMedia` (the assemble-time shape a component receives). */
-export type FieldTsType<D extends FieldDefinition> = D["type"] extends "text" | "textarea" | "url" | "select" ? string : D["type"] extends "richtext" ? RichText : D["type"] extends "number" ? number : D["type"] extends "boolean" ? boolean : D["type"] extends "media" ? ResolvedMedia | null : D["type"] extends "group" ? InferBlockFields<NonNullable<D["fields"]>> : D["type"] extends "repeater" ? InferBlockFields<NonNullable<D["fields"]>>[] : unknown;
+export type FieldTsType<D extends FieldDefinition> = D["type"] extends "text" | "textarea" | "url" | "select" | "date" | "datetime" ? string : D["type"] extends "richtext" ? RichText : D["type"] extends "number" ? number : D["type"] extends "boolean" ? boolean : D["type"] extends "media" ? ResolvedMedia | null : D["type"] extends "group" ? InferBlockFields<NonNullable<D["fields"]>> : D["type"] extends "repeater" ? InferBlockFields<NonNullable<D["fields"]>>[] : unknown;
 /** Infer the `fields` object type from a const `FieldDefinition[]`. Required fields are
  * present; optional ones are `| undefined`. */
 export type InferBlockFields<T extends readonly FieldDefinition[]> = {
@@ -459,8 +459,6 @@ export interface ValidateOpts {
      * required is only mandatory when publishing. Type checks always run. */
     requireRequired?: boolean;
 }
-/** Validate a block/page's `fields` payload against a field schema, throwing a 400 on
- * the first violation. Recursive (repeater/group). Lenient on unknown field types. */
 export declare function validateFields(schema: FieldDefinition[] | undefined | null, values: unknown, path?: string, opts?: ValidateOpts): void;
 export interface RenderedBlock {
     /** The placement id (cms_page_blocks) — stable per position; used for reorder/remove. */
@@ -559,6 +557,28 @@ export declare function createCmsHandlers(opts?: CmsHandlerOpts): {
         fieldsSchema?: FieldDefinition[];
         defaultBlocks?: DefaultBlockDefinition[];
     }, Record<string, unknown>>;
+    /** Update a block type (found by `id` or `slug`). `slug` is the stable key and is
+     * NOT mutable; only the metadata + `fieldsSchema` are patched. Editor-gated. This is
+     * what lets a schema evolve (e.g. a field text → date) without recreating the type. */
+    updateBlockType: import("@pramen/server").Handler<{
+        id?: string;
+        slug?: string;
+        name?: string;
+        fieldsSchema?: FieldDefinition[];
+        icon?: string | null;
+        category?: string | null;
+        description?: string | null;
+    }, Record<string, unknown> | undefined>;
+    /** Update a content type (found by `id` or `slug`). `slug` is the stable key and is
+     * NOT mutable; `name`/`regions`/`fieldsSchema`/`defaultBlocks` are patched. Editor-gated. */
+    updateContentType: import("@pramen/server").Handler<{
+        id?: string;
+        slug?: string;
+        name?: string;
+        regions?: RegionDefinition[];
+        fieldsSchema?: FieldDefinition[];
+        defaultBlocks?: DefaultBlockDefinition[];
+    }, Record<string, unknown> | undefined>;
     /** Mint a signed upload URL for a media blob (keyed under the tenant's `media/`
      * prefix so the public /media route can serve it). The client PUTs the bytes to
      * `url`, then calls `createMedia` with the returned `ref`. */
@@ -790,6 +810,28 @@ export declare const cmsHandlers: {
         fieldsSchema?: FieldDefinition[];
         defaultBlocks?: DefaultBlockDefinition[];
     }, Record<string, unknown>>;
+    /** Update a block type (found by `id` or `slug`). `slug` is the stable key and is
+     * NOT mutable; only the metadata + `fieldsSchema` are patched. Editor-gated. This is
+     * what lets a schema evolve (e.g. a field text → date) without recreating the type. */
+    updateBlockType: import("@pramen/server").Handler<{
+        id?: string;
+        slug?: string;
+        name?: string;
+        fieldsSchema?: FieldDefinition[];
+        icon?: string | null;
+        category?: string | null;
+        description?: string | null;
+    }, Record<string, unknown> | undefined>;
+    /** Update a content type (found by `id` or `slug`). `slug` is the stable key and is
+     * NOT mutable; `name`/`regions`/`fieldsSchema`/`defaultBlocks` are patched. Editor-gated. */
+    updateContentType: import("@pramen/server").Handler<{
+        id?: string;
+        slug?: string;
+        name?: string;
+        regions?: RegionDefinition[];
+        fieldsSchema?: FieldDefinition[];
+        defaultBlocks?: DefaultBlockDefinition[];
+    }, Record<string, unknown> | undefined>;
     /** Mint a signed upload URL for a media blob (keyed under the tenant's `media/`
      * prefix so the public /media route can serve it). The client PUTs the bytes to
      * `url`, then calls `createMedia` with the returned `ref`. */

package/dist/index.js

@@ -52,6 +52,8 @@ function tsTypeOf(f) {
         case "textarea":
         case "url":
         case "select":
+        case "date":
+        case "datetime":
             return "string";
         case "richtext":
             return "RichText";
@@ -203,6 +205,14 @@ export const cmsSchema = {
 };
 /** Validate a block/page's `fields` payload against a field schema, throwing a 400 on
  * the first violation. Recursive (repeater/group). Lenient on unknown field types. */
+/** A calendar date, `YYYY-MM-DD` (what an <input type="date"> emits) — must also parse. */
+function isDateString(v) {
+    return /^\d{4}-\d{2}-\d{2}$/.test(v) && Number.isFinite(Date.parse(v));
+}
+/** A date-time: `YYYY-MM-DDTHH:MM[:SS[.sss]][Z|±HH:MM]` (ISO 8601 / datetime-local). */
+function isDateTimeString(v) {
+    return /^\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}(:\d{2})?(\.\d+)?(Z|[+-]\d{2}:\d{2})?$/.test(v) && Number.isFinite(Date.parse(v));
+}
 export function validateFields(schema, values, path = "", opts = {}) {
     const requireRequired = opts.requireRequired !== false;
     const defs = Array.isArray(schema) ? schema : [];
@@ -241,6 +251,14 @@ export function validateFields(schema, values, path = "", opts = {}) {
                 if (typeof v !== "boolean")
                     throw new BadRequest(`field '${at}' must be a boolean`);
                 break;
+            case "date":
+                if (typeof v !== "string" || !isDateString(v))
+                    throw new BadRequest(`field '${at}' must be a date (YYYY-MM-DD)`);
+                break;
+            case "datetime":
+                if (typeof v !== "string" || !isDateTimeString(v))
+                    throw new BadRequest(`field '${at}' must be a date-time (ISO 8601)`);
+                break;
             case "media":
                 // Media ids are uuids (strings) — reject numbers so the value always resolves
                 // (collectMediaIds/resolveMediaFields only handle string ids).
@@ -553,6 +571,55 @@ export function createCmsHandlers(opts = {}) {
                 return o;
             },
         }),
+        /** Update a block type (found by `id` or `slug`). `slug` is the stable key and is
+         * NOT mutable; only the metadata + `fieldsSchema` are patched. Editor-gated. This is
+         * what lets a schema evolve (e.g. a field text → date) without recreating the type. */
+        updateBlockType: mutation(async (ctx, input) => {
+            const db = cdb(ctx);
+            const rows = await db.find({ from: "cms_block_types", where: input.id ? { id: input.id } : { slug: input.slug }, limit: 1 });
+            const row = rows[0];
+            if (!row)
+                throw notFound("block type");
+            const patch = {};
+            for (const k of ["name", "fieldsSchema", "icon", "category", "description"]) {
+                if (k in input)
+                    patch[k] = input[k];
+            }
+            return db.update("cms_block_types", String(row.id), patch);
+        }, {
+            ...editor,
+            input: (raw) => {
+                const o = asObj(raw);
+                if (typeof o.id !== "string" && typeof o.slug !== "string")
+                    throw new BadRequest("id or slug is required");
+                return o;
+            },
+        }),
+        /** Update a content type (found by `id` or `slug`). `slug` is the stable key and is
+         * NOT mutable; `name`/`regions`/`fieldsSchema`/`defaultBlocks` are patched. Editor-gated. */
+        updateContentType: mutation(async (ctx, input) => {
+            const db = cdb(ctx);
+            if ("regions" in input && (!Array.isArray(input.regions) || input.regions.length === 0))
+                throw new BadRequest("at least one region is required");
+            const rows = await db.find({ from: "cms_content_types", where: input.id ? { id: input.id } : { slug: input.slug }, limit: 1 });
+            const row = rows[0];
+            if (!row)
+                throw notFound("content type");
+            const patch = {};
+            for (const k of ["name", "regions", "fieldsSchema", "defaultBlocks"]) {
+                if (k in input)
+                    patch[k] = input[k];
+            }
+            return db.update("cms_content_types", String(row.id), patch);
+        }, {
+            ...editor,
+            input: (raw) => {
+                const o = asObj(raw);
+                if (typeof o.id !== "string" && typeof o.slug !== "string")
+                    throw new BadRequest("id or slug is required");
+                return o;
+            },
+        }),
         // ---- media library ----
         /** Mint a signed upload URL for a media blob (keyed under the tenant's `media/`
          * prefix so the public /media route can serve it). The client PUTs the bytes to

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pramen/cms",
-  "version": "0.0.15",
+  "version": "0.0.17",
   "description": "Optional block/page builder for pramen — Drupal-Paragraphs-style typed blocks in named regions, reusable blocks, scheduled publishing, built entirely from pramen primitives.",
   "license": "MIT",
   "repository": {
@@ -41,7 +41,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pramen/server": "0.0.15"
+    "@pramen/server": "0.0.17"
   },
   "peerDependencies": {
     "react": ">=18"

package/src/index.ts

@@ -58,6 +58,8 @@ export interface FieldDefinition {
     | "url"
     | "number"
     | "boolean"
+    | "date"
+    | "datetime"
     | "media"
     | "select"
     | "repeater"
@@ -101,7 +103,7 @@ export type RichText = string | { type: string; content?: unknown[] };
 
 /** Map one FieldDefinition (as a const literal) to the TS type of its RENDERED value.
  * Media resolves to `ResolvedMedia` (the assemble-time shape a component receives). */
-export type FieldTsType<D extends FieldDefinition> = D["type"] extends "text" | "textarea" | "url" | "select"
+export type FieldTsType<D extends FieldDefinition> = D["type"] extends "text" | "textarea" | "url" | "select" | "date" | "datetime"
   ? string
   : D["type"] extends "richtext"
     ? RichText
@@ -171,6 +173,8 @@ function tsTypeOf(f: FieldDefinition): string {
     case "textarea":
     case "url":
     case "select":
+    case "date":
+    case "datetime":
       return "string";
     case "richtext":
       return "RichText";
@@ -356,6 +360,15 @@ export interface ValidateOpts {
 
 /** Validate a block/page's `fields` payload against a field schema, throwing a 400 on
  * the first violation. Recursive (repeater/group). Lenient on unknown field types. */
+/** A calendar date, `YYYY-MM-DD` (what an <input type="date"> emits) — must also parse. */
+function isDateString(v: string): boolean {
+  return /^\d{4}-\d{2}-\d{2}$/.test(v) && Number.isFinite(Date.parse(v));
+}
+/** A date-time: `YYYY-MM-DDTHH:MM[:SS[.sss]][Z|±HH:MM]` (ISO 8601 / datetime-local). */
+function isDateTimeString(v: string): boolean {
+  return /^\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}(:\d{2})?(\.\d+)?(Z|[+-]\d{2}:\d{2})?$/.test(v) && Number.isFinite(Date.parse(v));
+}
+
 export function validateFields(schema: FieldDefinition[] | undefined | null, values: unknown, path = "", opts: ValidateOpts = {}): void {
   const requireRequired = opts.requireRequired !== false;
   const defs = Array.isArray(schema) ? schema : [];
@@ -388,6 +401,12 @@ export function validateFields(schema: FieldDefinition[] | undefined | null, val
       case "boolean":
         if (typeof v !== "boolean") throw new BadRequest(`field '${at}' must be a boolean`);
         break;
+      case "date":
+        if (typeof v !== "string" || !isDateString(v)) throw new BadRequest(`field '${at}' must be a date (YYYY-MM-DD)`);
+        break;
+      case "datetime":
+        if (typeof v !== "string" || !isDateTimeString(v)) throw new BadRequest(`field '${at}' must be a date-time (ISO 8601)`);
+        break;
       case "media":
         // Media ids are uuids (strings) — reject numbers so the value always resolves
         // (collectMediaIds/resolveMediaFields only handle string ids).
@@ -808,6 +827,50 @@ export function createCmsHandlers(opts: CmsHandlerOpts = {}) {
       },
     }),
 
+    /** Update a block type (found by `id` or `slug`). `slug` is the stable key and is
+     * NOT mutable; only the metadata + `fieldsSchema` are patched. Editor-gated. This is
+     * what lets a schema evolve (e.g. a field text → date) without recreating the type. */
+    updateBlockType: mutation(async (ctx, input: { id?: string; slug?: string; name?: string; fieldsSchema?: FieldDefinition[]; icon?: string | null; category?: string | null; description?: string | null }) => {
+      const db = cdb(ctx);
+      const rows = await db.find({ from: "cms_block_types", where: input.id ? { id: input.id } : { slug: input.slug }, limit: 1 });
+      const row = rows[0];
+      if (!row) throw notFound("block type");
+      const patch: Record<string, unknown> = {};
+      for (const k of ["name", "fieldsSchema", "icon", "category", "description"] as const) {
+        if (k in input) patch[k] = (input as Record<string, unknown>)[k];
+      }
+      return db.update("cms_block_types", String(row.id), patch);
+    }, {
+      ...editor,
+      input: (raw): { id?: string; slug?: string; name?: string; fieldsSchema?: FieldDefinition[]; icon?: string | null; category?: string | null; description?: string | null } => {
+        const o = asObj(raw);
+        if (typeof o.id !== "string" && typeof o.slug !== "string") throw new BadRequest("id or slug is required");
+        return o as never;
+      },
+    }),
+
+    /** Update a content type (found by `id` or `slug`). `slug` is the stable key and is
+     * NOT mutable; `name`/`regions`/`fieldsSchema`/`defaultBlocks` are patched. Editor-gated. */
+    updateContentType: mutation(async (ctx, input: { id?: string; slug?: string; name?: string; regions?: RegionDefinition[]; fieldsSchema?: FieldDefinition[]; defaultBlocks?: DefaultBlockDefinition[] }) => {
+      const db = cdb(ctx);
+      if ("regions" in input && (!Array.isArray(input.regions) || input.regions.length === 0)) throw new BadRequest("at least one region is required");
+      const rows = await db.find({ from: "cms_content_types", where: input.id ? { id: input.id } : { slug: input.slug }, limit: 1 });
+      const row = rows[0];
+      if (!row) throw notFound("content type");
+      const patch: Record<string, unknown> = {};
+      for (const k of ["name", "regions", "fieldsSchema", "defaultBlocks"] as const) {
+        if (k in input) patch[k] = (input as Record<string, unknown>)[k];
+      }
+      return db.update("cms_content_types", String(row.id), patch);
+    }, {
+      ...editor,
+      input: (raw): { id?: string; slug?: string; name?: string; regions?: RegionDefinition[]; fieldsSchema?: FieldDefinition[]; defaultBlocks?: DefaultBlockDefinition[] } => {
+        const o = asObj(raw);
+        if (typeof o.id !== "string" && typeof o.slug !== "string") throw new BadRequest("id or slug is required");
+        return o as never;
+      },
+    }),
+
     // ---- media library ----
     /** Mint a signed upload URL for a media blob (keyed under the tenant's `media/`
      * prefix so the public /media route can serve it). The client PUTs the bytes to