nextjs-cms 0.9.41 → 0.10.0

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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"}

package/dist/core/fields/richText.js

@@ -1,39 +1,113 @@
-import { Field, baseFieldConfigSchema } from './field.js';
-import { entityKind } from '../helpers/index.js';
-import * as z from 'zod';
+import fs from 'fs';
+import path from 'path';
+import { and, eq, sql } from 'drizzle-orm';
 import { customAlphabet } from 'nanoid';
 import sharp from 'sharp';
-import path from 'path';
+import * as z from 'zod';
 import { db } from '../../db/client.js';
 import { EditorPhotosTable } from '../../db/schema.js';
-import fs from 'fs';
-import { and, eq, sql } from 'drizzle-orm';
+import getString from '../../translations/index.js';
+import { humanReadableFileSize } from '../../utils/index.js';
 import { getCMSConfig } from '../config/index.js';
+import { backgroundSchema, entityKind } from '../helpers/index.js';
 import { sanitizeRichText } from '../security/dom.js';
+import { baseFieldConfigSchema, Field } from './field.js';
 const positiveInt = z.number().int().positive();
 const nonNegativeInt = z.number().int().nonnegative();
+/**
+ * Bounds each inline image is fitted into, discriminated on `fit` so `background` only exists
+ * where it means something. Mirrors the `fit` vocabulary of the photo field, using sharp's own
+ * names so the behaviour is not renamed in translation.
+ */
+const inlineImageSizeSchema = z.discriminatedUnion('fit', [
+    z.strictObject({
+        width: positiveInt,
+        height: positiveInt,
+        fit: z.literal('inside').describe('Scale down to fit within the box, keeping aspect ratio (sharp fit: inside)'),
+    }),
+    z.strictObject({
+        width: positiveInt,
+        height: positiveInt,
+        fit: z.literal('cover').describe('Crop to fill dimensions (sharp fit: cover)'),
+    }),
+    z.strictObject({
+        width: positiveInt,
+        height: positiveInt,
+        fit: z.literal('contain').describe('Pad with background to fill dimensions (sharp fit: 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: backgroundSchema.optional().describe('Background color for padding'),
+    }),
+]);
+/**
+ * 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.
+ */
+const DEFAULT_INLINE_IMAGE_SIZE = {
+    width: 1200,
+    height: 675,
+    fit: 'inside',
+};
+/** Largest accepted inline image unless the field overrides `maxFileSize`. */
+const DEFAULT_MAX_FILE_SIZE = { size: 1, unit: 'mb' };
+const BYTES_PER_UNIT = { kb: 1024, mb: 1024 * 1024 };
+/**
+ * Decoded byte length of a base64 payload, without allocating the buffer — inline images are
+ * rejected before anything is decoded or written.
+ */
+function base64ByteLength(base64) {
+    const padding = base64.endsWith('==') ? 2 : base64.endsWith('=') ? 1 : 0;
+    return Math.floor((base64.length * 3) / 4) - padding;
+}
+/**
+ * Matches the `{name}` placeholder (whitespace tolerated: `{ name }`).
+ *
+ * Built on demand rather than shared as a single global regex: a `/g` regex is stateful via
+ * `lastIndex`, so reusing one instance across `test()` calls silently alternates its result.
+ */
+const NAME_PLACEHOLDER = String.raw `\{\s*name\s*\}`;
+const hasNamePlaceholder = (value) => new RegExp(NAME_PLACEHOLDER).test(value);
+const resolvePublicURL = (template, name) => template.replace(new RegExp(NAME_PLACEHOLDER, 'g'), name);
 const allowImageUploadsSchema = z.strictObject({
     /**
-     * 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.url().describe('The public URL prefix for inline photos'),
-    size: z
-        .strictObject({
-        width: positiveInt,
-        height: positiveInt,
-        crop: z.boolean().default(false),
+    publicURL: z
+        .url()
+        .refine(hasNamePlaceholder, {
+        message: 'publicURL must contain the {name} placeholder, e.g. https://site.com/photos/{name}',
     })
-        .optional(),
+        .describe('The public URL template for inline photos; {name} is replaced with the generated filename'),
+    /**
+     * 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: inlineImageSizeSchema.optional(),
+    /**
+     * 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
         .strictObject({
         size: positiveInt,
         unit: z.enum(['kb', 'mb']),
     })
         .optional(),
-    handleMethod: z.enum(['base64', 'tempSave']).optional(),
+    // handleMethod: z.enum(['base64', 'tempSave']).optional(),
     /**
      * Omit the extension of the image when saving it to disk
      */
@@ -96,13 +170,13 @@ export class RichTextField extends Field {
         this.placeholder = config.placeholder;
         this.sanitize = config.sanitize ?? true;
         this.rtl = config.rtl;
-        if (config.allowMedia && config.allowImageUploads?.publicURLPrefix) {
+        if (config.allowMedia && config.allowImageUploads?.publicURL) {
             this.allowMedia = true;
             this.allowImageUploads = {
-                publicURLPrefix: config.allowImageUploads.publicURLPrefix,
-                size: config.allowImageUploads.size ?? { width: 400, height: 400, crop: false },
-                maxFileSize: config.allowImageUploads.maxFileSize ?? { size: 1, unit: 'mb' },
-                handleMethod: config.allowImageUploads.handleMethod ?? 'base64',
+                // handleMethod: config.allowImageUploads.handleMethod ?? 'base64',
+                publicURL: config.allowImageUploads.publicURL,
+                size: config.allowImageUploads.size ?? DEFAULT_INLINE_IMAGE_SIZE,
+                maxFileSize: config.allowImageUploads.maxFileSize ?? DEFAULT_MAX_FILE_SIZE,
                 omitExtension: config.allowImageUploads.omitExtension ?? true,
                 format: config.allowImageUploads.format ?? 'webp',
             };
@@ -164,9 +238,24 @@ export class RichTextField extends Field {
             return;
         const regex = /<img.*?src="(data:image\/.*?;base64,.*?)".*?>/g;
         const matches = this.value.matchAll(regex);
+        const maxFileSize = this.allowImageUploads.maxFileSize ?? DEFAULT_MAX_FILE_SIZE;
+        const maxBytes = maxFileSize.size * BYTES_PER_UNIT[maxFileSize.unit];
         for (const match of matches) {
             const base64String = match[1];
             const extension = base64String.split(';')[0].split('/')[1];
+            /**
+             * Reject oversized images here rather than in `writeInlineImages`: extraction runs
+             * during submission, so throwing prevents the item from being saved at all, whereas
+             * the write step runs afterwards and the row would already exist.
+             */
+            const byteLength = base64ByteLength(base64String.split(',')[1] ?? '');
+            if (byteLength > maxBytes) {
+                throw new Error(getString('fileSizeExceedsMax', this.language, {
+                    field: this.getLocalizedLabel(),
+                    actual: humanReadableFileSize(byteLength),
+                    max: `${maxFileSize.size} ${maxFileSize.unit}`,
+                }));
+            }
             const randomString = customAlphabet('1234567890abcdef', 21)();
             const name = `${randomString}${this.allowImageUploads.omitExtension ? '' : `.${extension}`}`;
             this._inlinePhotos.push({
@@ -175,9 +264,9 @@ export class RichTextField extends Field {
                 name: name,
             });
             /**
-             * Replace the inline image src with the name of the image
+             * Replace the inline image src with the public URL of the image
              */
-            this.value = this.value.replace(base64String, `${this.allowImageUploads?.publicURLPrefix}/${name}`);
+            this.value = this.value.replace(base64String, resolvePublicURL(this.allowImageUploads.publicURL, name));
         }
     }
     async writeInlineImages(sectionName, itemId, locale) {
@@ -203,7 +292,20 @@ export class RichTextField extends Field {
             sharp.cache({ files: 0 });
             sharp.cache(false);
             const image = sharp(buffer);
+            const size = this.allowImageUploads.size ?? DEFAULT_INLINE_IMAGE_SIZE;
             await image
+                .resize({
+                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 are allowed to enlarge.
+                withoutEnlargement: size.fit === 'inside',
+                ...(size.fit === 'contain'
+                    ? { background: size.background ?? cmsConfig.media.images.background }
+                    : {}),
+            })
                 .toFormat(this.allowImageUploads.format ?? 'webp')
                 .toFile(path.join(uploadsFolder, '.photos', sectionName, photo.name));
             /**
@@ -237,7 +339,7 @@ export class RichTextField extends Field {
         /**
          * Sanitize the value
          */
-        this.sanitizeValue();
+        await this.sanitizeValue();
         if (!this.value)
             return;
         /**
@@ -291,19 +393,17 @@ export class RichTextField extends Field {
         if (tablePhotos.length === 0)
             return;
         /**
-         * Extract the photos from the value (only photos that has the publicURLPrefix)
-         */
-        const regex = new RegExp(`${this.allowImageUploads.publicURLPrefix}/(.*?)`, 'g');
-        const matches = this.value.matchAll(regex);
-        const photosInValue = [];
-        for (const match of matches) {
-            photosInValue.push(match[1]);
-        }
-        /**
-         * Check if the photos in the database are still present in the value
+         * Check if the photos in the database are still present in the value.
+         *
+         * Matched on the generated filename rather than the full public URL: the name is a unique
+         * random token, while the URL is presentation. It can be re-encoded by the sanitizer
+         * (`&` -> `&amp;`), or change wholesale when `publicURL` or the site's domain changes —
+         * none of which mean the admin removed the image. A stale match here deletes a file that
+         * is still in use, so the check errs towards keeping (an orphan file is recoverable, a
+         * deleted one is not).
          */
         for (const tablePhoto of tablePhotos) {
-            if (!photosInValue.includes(tablePhoto.name)) {
+            if (!this.value.includes(tablePhoto.name)) {
                 /**
                  * Delete the photo from the database
                  */

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

@@ -379,8 +379,8 @@ declare const selectFieldConfigSchema: z.ZodIntersection<z.ZodUnion<readonly [z.
 }, z.core.$strict>]>, z.ZodObject<{
     type: z.ZodLiteral<"select">;
     optionsType: z.ZodEnum<{
-        section: "section";
         db: "db";
+        section: "section";
         static: "static";
     }>;
     build: z.ZodFunction<z.core.$ZodFunctionArgs, z.ZodCustom<SelectField, SelectField>>;

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

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

package/dist/core/fields/select.js

@@ -144,9 +144,14 @@ export class SelectField extends Field {
              */
             if (typeof value === 'string' || typeof value === 'number') {
                 /**
-                 * Split the values by comma and set the value as an array of objects
+                 * Split the values by comma and set the value as an array of objects.
+                 * Empty segments are dropped — '' is never a valid option value, and
+                 * an unset select posts exactly that.
                  */
-                const values = value.toString().split(',');
+                const values = value
+                    .toString()
+                    .split(',')
+                    .filter((value) => value !== '');
                 this.value = [];
                 values.map((value) => {
                     if (this.checkValueExists) {
@@ -176,6 +181,17 @@ export class SelectField extends Field {
         else {
             this.value = undefined;
         }
+        /**
+         * Nothing resolved to a real option — either the select was left empty
+         * (`Submit.setFieldValue` hands us `[]` for an untouched select) or
+         * `checkValueExists` dropped everything submitted. Represent that as
+         * "no value" rather than an empty array: an empty array would join into
+         * '' in `getSubmitValue()`, and an INSERT writes that verbatim, which
+         * MySQL rejects for int and enum columns.
+         */
+        if (this.value?.length === 0) {
+            this.value = undefined;
+        }
     }
     hasSqlNameAndValue() {
         return this.destinationDb === undefined;

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

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

package/dist/core/fields/selectMultiple.js

@@ -192,6 +192,15 @@ export class SelectMultipleField extends Field {
         else {
             this.value = value;
         }
+        /**
+         * Nothing resolved to a real option — the field was left empty, or every
+         * submitted value was dropped. Represent that as "no value" rather than an
+         * empty array: an empty array would join into '' in `getSubmitValue()`, and
+         * an INSERT writes that verbatim, which MySQL rejects for int columns.
+         */
+        if (this.value?.length === 0) {
+            this.value = undefined;
+        }
     }
     exportForClient() {
         return {

package/dist/core/helpers/background.d.ts

@@ -0,0 +1,18 @@
+import * as z from 'zod';
+/**
+ * Padding colour schema — shared by every field that resizes images, so the shape stays
+ * identical across them. Only meaningful alongside `fit: 'contain'`, where the image is padded
+ * out to the full box; fields fall back to `media.images.background` from the CMS config when
+ * it is omitted.
+ *
+ * `alpha: 0` only survives in formats with an alpha channel (webp, png). Encoding transparent
+ * padding to jpeg flattens it to black, so pick an opaque colour for jpeg output.
+ */
+export declare const backgroundSchema: z.ZodObject<{
+    r: z.ZodNumber;
+    g: z.ZodNumber;
+    b: z.ZodNumber;
+    alpha: z.ZodNumber;
+}, z.core.$strict>;
+export type Background = z.infer<typeof backgroundSchema>;
+//# sourceMappingURL=background.d.ts.map

package/dist/core/helpers/background.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background.d.ts","sourceRoot":"","sources":["../../../src/core/helpers/background.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAExB;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB;;;;;kBAO+C,CAAA;AAE5E,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA"}