nextjs-cms 0.9.42 → 0.10.1

package/dist/core/fields/date-range.d.ts

@@ -70,13 +70,13 @@ declare const optionsSchema: z.ZodObject<{
     maxDate: z.ZodOptional<z.ZodUnion<readonly [z.ZodDate, z.ZodLiteral<"now">]>>;
     defaultStartValue: z.ZodOptional<z.ZodDate>;
     defaultEndValue: z.ZodOptional<z.ZodDate>;
+    order: z.ZodOptional<z.ZodNumber>;
+    localized: z.ZodOptional<z.ZodBoolean>;
     label: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
     required: z.ZodOptional<z.ZodBoolean>;
     defaultValue: z.ZodOptional<z.ZodAny>;
-    order: z.ZodOptional<z.ZodNumber>;
     conditionalRules: z.ZodOptional<z.ZodUnion<readonly [z.ZodTuple<[z.ZodCustom<import("../types/index.js").ConditionalRule, import("../types/index.js").ConditionalRule>], null>, z.ZodCustom<import("../types/index.js").ConditionalRuleGroup, import("../types/index.js").ConditionalRuleGroup>]>>;
     adminGenerated: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodLiteral<false>, z.ZodLiteral<"readonly">]>>;
-    localized: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
 declare const dateRangeFieldConfigSchema: z.ZodObject<{
     /**
@@ -97,13 +97,13 @@ declare const dateRangeFieldConfigSchema: z.ZodObject<{
     maxDate: z.ZodOptional<z.ZodUnion<readonly [z.ZodDate, z.ZodLiteral<"now">]>>;
     defaultStartValue: z.ZodOptional<z.ZodDate>;
     defaultEndValue: z.ZodOptional<z.ZodDate>;
+    order: z.ZodOptional<z.ZodNumber>;
+    localized: z.ZodOptional<z.ZodBoolean>;
     label: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
     required: z.ZodOptional<z.ZodBoolean>;
     defaultValue: z.ZodOptional<z.ZodAny>;
-    order: z.ZodOptional<z.ZodNumber>;
     conditionalRules: z.ZodOptional<z.ZodUnion<readonly [z.ZodTuple<[z.ZodCustom<import("../types/index.js").ConditionalRule, import("../types/index.js").ConditionalRule>], null>, z.ZodCustom<import("../types/index.js").ConditionalRuleGroup, import("../types/index.js").ConditionalRuleGroup>]>>;
     adminGenerated: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodLiteral<false>, z.ZodLiteral<"readonly">]>>;
-    localized: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
 export type DateRangeFieldConfig = z.infer<typeof dateRangeFieldConfigSchema>;
 /**

package/dist/core/fields/inline-image.d.ts

@@ -0,0 +1,45 @@
+import type sharp from 'sharp';
+import type { Background } from '../helpers/background.js';
+/**
+ * Inline-image sizing shared by the rich-text field, the editor upload route, and the client-side
+ * validator.
+ *
+ * Deliberately a leaf module with type-only imports: the validator runs in the browser, and
+ * reaching these through `core/fields/index.js` would pull the whole field barrel — and with it
+ * the database client, sharp, and fs — into the client bundle.
+ */
+export type InlineImageSize = {
+    width: number;
+    height: number;
+    fit: 'inside';
+} | {
+    width: number;
+    height: number;
+    fit: 'cover';
+} | {
+    width: number;
+    height: number;
+    fit: 'contain';
+    background?: Background;
+};
+export type InlineImageMaxFileSize = {
+    size: number;
+    unit: 'kb' | 'mb';
+};
+/**
+ * Bounds every inline image is fitted into unless the field overrides `size`.
+ * 1200x675 is 16:9 at a width that covers typical article body content, scaled down to fit so a
+ * body image is never cropped or padded unless the field asks for it.
+ */
+export declare const DEFAULT_INLINE_IMAGE_SIZE: InlineImageSize;
+/** Largest accepted inline image unless the field overrides `maxFileSize`. */
+export declare const DEFAULT_MAX_FILE_SIZE: InlineImageMaxFileSize;
+/** Same shape `extractInlineImages` looks for, so every side agrees on what an inline image is. */
+export declare const INLINE_IMAGE_REGEX: RegExp;
+/**
+ * Sharp resize options for an inline image, so every place that writes one — the field on save and
+ * the editor upload route — sizes it identically. `background` is the CMS-config fallback, used
+ * only when the field asks for `contain` without naming its own.
+ */
+export declare function inlineImageResizeOptions(size: InlineImageSize, background: Background): sharp.ResizeOptions;
+//# sourceMappingURL=inline-image.d.ts.map

package/dist/core/fields/inline-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline-image.d.ts","sourceRoot":"","sources":["../../../src/core/fields/inline-image.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAE1D;;;;;;;GAOG;AAEH,MAAM,MAAM,eAAe,GACrB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,QAAQ,CAAA;CAAE,GAChD;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,GAC/C;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,SAAS,CAAC;IAAC,UAAU,CAAC,EAAE,UAAU,CAAA;CAAE,CAAA;AAEhF,MAAM,MAAM,sBAAsB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAA;CAAE,CAAA;AAExE;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,eAIvC,CAAA;AAED,8EAA8E;AAC9E,eAAO,MAAM,qBAAqB,EAAE,sBAAgD,CAAA;AAEpF,mGAAmG;AACnG,eAAO,MAAM,kBAAkB,QAAmD,CAAA;AAElF;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,GAAG,KAAK,CAAC,aAAa,CAU3G"}

package/dist/core/fields/inline-image.js

@@ -0,0 +1,30 @@
+/**
+ * Bounds every inline image is fitted into unless the field overrides `size`.
+ * 1200x675 is 16:9 at a width that covers typical article body content, scaled down to fit so a
+ * body image is never cropped or padded unless the field asks for it.
+ */
+export const DEFAULT_INLINE_IMAGE_SIZE = {
+    width: 1200,
+    height: 675,
+    fit: 'inside',
+};
+/** Largest accepted inline image unless the field overrides `maxFileSize`. */
+export const DEFAULT_MAX_FILE_SIZE = { size: 1, unit: 'mb' };
+/** Same shape `extractInlineImages` looks for, so every side agrees on what an inline image is. */
+export const INLINE_IMAGE_REGEX = /<img.*?src="(data:image\/.*?;base64,.*?)".*?>/g;
+/**
+ * Sharp resize options for an inline image, so every place that writes one — the field on save and
+ * the editor upload route — sizes it identically. `background` is the CMS-config fallback, used
+ * only when the field asks for `contain` without naming its own.
+ */
+export function inlineImageResizeOptions(size, background) {
+    return {
+        width: size.width,
+        height: size.height,
+        fit: size.fit,
+        // `inside` only ever scales down — enlarging a smaller image to fill the box would cost
+        // quality for nothing. `cover` and `contain` produce the exact box, so they may enlarge.
+        withoutEnlargement: size.fit === 'inside',
+        ...(size.fit === 'contain' ? { background: size.background ?? background } : {}),
+    };
+}

package/dist/core/fields/photo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"photo.d.ts","sourceRoot":"","sources":["../../../src/core/fields/photo.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"photo.d.ts","sourceRoot":"","sources":["../../../src/core/fields/photo.ts"],"names":[],"mappings":"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"}

package/dist/core/fields/photo.js

@@ -6,17 +6,9 @@ import * as z from 'zod';
 import getString from '../../translations/index.js';
 import { humanReadableFileSize } from '../../utils/index.js';
 import { getCMSConfig } from '../config/index.js';
-import { entityKind, resolveWatermark, watermarkConfigSchema } from '../helpers/index.js';
+import { backgroundSchema, entityKind, resolveWatermark, watermarkConfigSchema } from '../helpers/index.js';
 import { baseFieldConfigSchema } from './field.js';
 import { FileField } from './fileField.js';
-const backgroundSchema = z
-    .strictObject({
-    r: z.number().min(0).max(255).describe('Red channel (0-255)'),
-    g: z.number().min(0).max(255).describe('Green channel (0-255)'),
-    b: z.number().min(0).max(255).describe('Blue channel (0-255)'),
-    alpha: z.number().min(0).max(1).describe('Alpha channel (0-1)'),
-})
-    .describe('Background color for image padding (used with fit: contain)');
 /**
  * Size schema — discriminated union of three variants:
  * - strict: true — user must upload exact dimensions, no server resize

package/dist/core/fields/richText.d.ts

@@ -1,20 +1,54 @@
+import * as z from 'zod';
 import type { BaseFieldConfig, FieldClientConfig } from './field.js';
-import { Field } from './field.js';
 import { entityKind } from '../helpers/index.js';
-import * as z from 'zod';
+import { Field } from './field.js';
 declare const allowImageUploadsSchema: z.ZodObject<{
     /**
-     * The public URL prefix for inline photos.
+     * The public URL template for inline photos.
      * This url should be handled by the website app, not the NextJS-CMS app
      * This is the URL that will be used to access the photos publicly on the website
-     * The name of the photo will be appended to this URL
+     *
+     * `{name}` marks where the generated filename goes, so it can sit anywhere in the URL —
+     * a path segment (`https://site.com/photos/{name}`) or a query parameter
+     * (`https://site.com/api/photo?folder=posts&name={name}`).
+     */
+    publicURL: z.ZodURL;
+    /**
+     * Bounds applied to each inline image before it is written to disk.
+     * Defaults to {@link DEFAULT_INLINE_IMAGE_SIZE}.
+     *
+     * `fit: 'inside'` scales the image down to fit within the box, keeping its aspect ratio and
+     * never enlarging a smaller image. `fit: 'cover'` fills the box exactly, cropping the overflow.
+     * `fit: 'contain'` pads the image out to the full box with `background`.
      */
-    publicURLPrefix: z.ZodURL;
-    size: z.ZodOptional<z.ZodObject<{
+    size: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         width: z.ZodNumber;
         height: z.ZodNumber;
-        crop: z.ZodDefault<z.ZodBoolean>;
-    }, z.core.$strict>>;
+        fit: z.ZodLiteral<"inside">;
+    }, z.core.$strict>, z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        fit: z.ZodLiteral<"cover">;
+    }, z.core.$strict>, z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        fit: z.ZodLiteral<"contain">;
+        /**
+         * Falls back to `media.images.background` from the CMS config, which is transparent by
+         * default. Transparency needs an alpha-capable `format` (webp or png) — jpeg flattens it
+         * to black, so set an opaque colour when writing jpeg.
+         */
+        background: z.ZodOptional<z.ZodObject<{
+            r: z.ZodNumber;
+            g: z.ZodNumber;
+            b: z.ZodNumber;
+            alpha: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>], "fit">>;
+    /**
+     * Largest accepted inline image, measured on the decoded image rather than the base64 text.
+     * Rejected during submission, before the item is saved. Defaults to {@link DEFAULT_MAX_FILE_SIZE}.
+     */
     maxFileSize: z.ZodOptional<z.ZodObject<{
         size: z.ZodNumber;
         unit: z.ZodEnum<{
@@ -22,10 +56,6 @@ declare const allowImageUploadsSchema: z.ZodObject<{
             mb: "mb";
         }>;
     }, z.core.$strict>>;
-    handleMethod: z.ZodOptional<z.ZodEnum<{
-        base64: "base64";
-        tempSave: "tempSave";
-    }>>;
     /**
      * Omit the extension of the image when saving it to disk
      */
@@ -46,17 +76,51 @@ declare const configSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     allowMedia: z.ZodLiteral<true>;
     allowImageUploads: z.ZodOptional<z.ZodObject<{
         /**
-         * The public URL prefix for inline photos.
+         * The public URL template for inline photos.
          * This url should be handled by the website app, not the NextJS-CMS app
          * This is the URL that will be used to access the photos publicly on the website
-         * The name of the photo will be appended to this URL
+         *
+         * `{name}` marks where the generated filename goes, so it can sit anywhere in the URL —
+         * a path segment (`https://site.com/photos/{name}`) or a query parameter
+         * (`https://site.com/api/photo?folder=posts&name={name}`).
+         */
+        publicURL: z.ZodURL;
+        /**
+         * Bounds applied to each inline image before it is written to disk.
+         * Defaults to {@link DEFAULT_INLINE_IMAGE_SIZE}.
+         *
+         * `fit: 'inside'` scales the image down to fit within the box, keeping its aspect ratio and
+         * never enlarging a smaller image. `fit: 'cover'` fills the box exactly, cropping the overflow.
+         * `fit: 'contain'` pads the image out to the full box with `background`.
          */
-        publicURLPrefix: z.ZodURL;
-        size: z.ZodOptional<z.ZodObject<{
+        size: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
             width: z.ZodNumber;
             height: z.ZodNumber;
-            crop: z.ZodDefault<z.ZodBoolean>;
-        }, z.core.$strict>>;
+            fit: z.ZodLiteral<"inside">;
+        }, z.core.$strict>, z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            fit: z.ZodLiteral<"cover">;
+        }, z.core.$strict>, z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            fit: z.ZodLiteral<"contain">;
+            /**
+             * Falls back to `media.images.background` from the CMS config, which is transparent by
+             * default. Transparency needs an alpha-capable `format` (webp or png) — jpeg flattens it
+             * to black, so set an opaque colour when writing jpeg.
+             */
+            background: z.ZodOptional<z.ZodObject<{
+                r: z.ZodNumber;
+                g: z.ZodNumber;
+                b: z.ZodNumber;
+                alpha: z.ZodNumber;
+            }, z.core.$strict>>;
+        }, z.core.$strict>], "fit">>;
+        /**
+         * Largest accepted inline image, measured on the decoded image rather than the base64 text.
+         * Rejected during submission, before the item is saved. Defaults to {@link DEFAULT_MAX_FILE_SIZE}.
+         */
         maxFileSize: z.ZodOptional<z.ZodObject<{
             size: z.ZodNumber;
             unit: z.ZodEnum<{
@@ -64,10 +128,6 @@ declare const configSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 mb: "mb";
             }>;
         }, z.core.$strict>>;
-        handleMethod: z.ZodOptional<z.ZodEnum<{
-            base64: "base64";
-            tempSave: "tempSave";
-        }>>;
         /**
          * Omit the extension of the image when saving it to disk
          */
@@ -144,17 +204,51 @@ declare const optionsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     allowMedia: z.ZodLiteral<true>;
     allowImageUploads: z.ZodOptional<z.ZodObject<{
         /**
-         * The public URL prefix for inline photos.
+         * The public URL template for inline photos.
          * This url should be handled by the website app, not the NextJS-CMS app
          * This is the URL that will be used to access the photos publicly on the website
-         * The name of the photo will be appended to this URL
+         *
+         * `{name}` marks where the generated filename goes, so it can sit anywhere in the URL —
+         * a path segment (`https://site.com/photos/{name}`) or a query parameter
+         * (`https://site.com/api/photo?folder=posts&name={name}`).
          */
-        publicURLPrefix: z.ZodURL;
-        size: z.ZodOptional<z.ZodObject<{
+        publicURL: z.ZodURL;
+        /**
+         * Bounds applied to each inline image before it is written to disk.
+         * Defaults to {@link DEFAULT_INLINE_IMAGE_SIZE}.
+         *
+         * `fit: 'inside'` scales the image down to fit within the box, keeping its aspect ratio and
+         * never enlarging a smaller image. `fit: 'cover'` fills the box exactly, cropping the overflow.
+         * `fit: 'contain'` pads the image out to the full box with `background`.
+         */
+        size: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
             width: z.ZodNumber;
             height: z.ZodNumber;
-            crop: z.ZodDefault<z.ZodBoolean>;
-        }, z.core.$strict>>;
+            fit: z.ZodLiteral<"inside">;
+        }, z.core.$strict>, z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            fit: z.ZodLiteral<"cover">;
+        }, z.core.$strict>, z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            fit: z.ZodLiteral<"contain">;
+            /**
+             * Falls back to `media.images.background` from the CMS config, which is transparent by
+             * default. Transparency needs an alpha-capable `format` (webp or png) — jpeg flattens it
+             * to black, so set an opaque colour when writing jpeg.
+             */
+            background: z.ZodOptional<z.ZodObject<{
+                r: z.ZodNumber;
+                g: z.ZodNumber;
+                b: z.ZodNumber;
+                alpha: z.ZodNumber;
+            }, z.core.$strict>>;
+        }, z.core.$strict>], "fit">>;
+        /**
+         * Largest accepted inline image, measured on the decoded image rather than the base64 text.
+         * Rejected during submission, before the item is saved. Defaults to {@link DEFAULT_MAX_FILE_SIZE}.
+         */
         maxFileSize: z.ZodOptional<z.ZodObject<{
             size: z.ZodNumber;
             unit: z.ZodEnum<{
@@ -162,10 +256,6 @@ declare const optionsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 mb: "mb";
             }>;
         }, z.core.$strict>>;
-        handleMethod: z.ZodOptional<z.ZodEnum<{
-            base64: "base64";
-            tempSave: "tempSave";
-        }>>;
         /**
          * Omit the extension of the image when saving it to disk
          */
@@ -210,17 +300,51 @@ declare const richTextFieldConfigSchema: z.ZodIntersection<z.ZodDiscriminatedUni
     allowMedia: z.ZodLiteral<true>;
     allowImageUploads: z.ZodOptional<z.ZodObject<{
         /**
-         * The public URL prefix for inline photos.
+         * The public URL template for inline photos.
          * This url should be handled by the website app, not the NextJS-CMS app
          * This is the URL that will be used to access the photos publicly on the website
-         * The name of the photo will be appended to this URL
+         *
+         * `{name}` marks where the generated filename goes, so it can sit anywhere in the URL —
+         * a path segment (`https://site.com/photos/{name}`) or a query parameter
+         * (`https://site.com/api/photo?folder=posts&name={name}`).
+         */
+        publicURL: z.ZodURL;
+        /**
+         * Bounds applied to each inline image before it is written to disk.
+         * Defaults to {@link DEFAULT_INLINE_IMAGE_SIZE}.
+         *
+         * `fit: 'inside'` scales the image down to fit within the box, keeping its aspect ratio and
+         * never enlarging a smaller image. `fit: 'cover'` fills the box exactly, cropping the overflow.
+         * `fit: 'contain'` pads the image out to the full box with `background`.
          */
-        publicURLPrefix: z.ZodURL;
-        size: z.ZodOptional<z.ZodObject<{
+        size: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
             width: z.ZodNumber;
             height: z.ZodNumber;
-            crop: z.ZodDefault<z.ZodBoolean>;
-        }, z.core.$strict>>;
+            fit: z.ZodLiteral<"inside">;
+        }, z.core.$strict>, z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            fit: z.ZodLiteral<"cover">;
+        }, z.core.$strict>, z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            fit: z.ZodLiteral<"contain">;
+            /**
+             * Falls back to `media.images.background` from the CMS config, which is transparent by
+             * default. Transparency needs an alpha-capable `format` (webp or png) — jpeg flattens it
+             * to black, so set an opaque colour when writing jpeg.
+             */
+            background: z.ZodOptional<z.ZodObject<{
+                r: z.ZodNumber;
+                g: z.ZodNumber;
+                b: z.ZodNumber;
+                alpha: z.ZodNumber;
+            }, z.core.$strict>>;
+        }, z.core.$strict>], "fit">>;
+        /**
+         * Largest accepted inline image, measured on the decoded image rather than the base64 text.
+         * Rejected during submission, before the item is saved. Defaults to {@link DEFAULT_MAX_FILE_SIZE}.
+         */
         maxFileSize: z.ZodOptional<z.ZodObject<{
             size: z.ZodNumber;
             unit: z.ZodEnum<{
@@ -228,10 +352,6 @@ declare const richTextFieldConfigSchema: z.ZodIntersection<z.ZodDiscriminatedUni
                 mb: "mb";
             }>;
         }, z.core.$strict>>;
-        handleMethod: z.ZodOptional<z.ZodEnum<{
-            base64: "base64";
-            tempSave: "tempSave";
-        }>>;
         /**
          * Omit the extension of the image when saving it to disk
          */

package/dist/core/fields/richText.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"richText.d.ts","sourceRoot":"","sources":["../../../src/core/fields/richText.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"richText.d.ts","sourceRoot":"","sources":["../../../src/core/fields/richText.ts"],"names":[],"mappings":"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"}