nextjs-cms 0.9.6 → 0.9.8

package/dist/api/routers/simpleSection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"simpleSection.d.ts","sourceRoot":"","sources":["../../../src/api/routers/simpleSection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAOxB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBA2D66Z,CAAC;;;;;uBAAsE,CAAC;;;;;;uBAA2G,CAAC;;;;;;;;;;;;;;;GAD/na,CAAA"}
+{"version":3,"file":"simpleSection.d.ts","sourceRoot":"","sources":["../../../src/api/routers/simpleSection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAOxB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBA2Du4a,CAAC;;;;;uBAAuE,CAAC;;;;;;uBAA6G,CAAC;;;;;;;;;;;;;;;GAD5lb,CAAA"}

package/dist/cli/lib/db-config.js

@@ -140,16 +140,16 @@ export async function dbConfigSetup(options) {
         /**
          * Prepare new environment variables block
          */
-        const newEnvBlock = `
-
-####
-# generated by the init script
-####
-DB_HOST=${dbHost}
-DB_PORT=${dbPort}
-DB_NAME=${dbName}
-DB_USER=${dbUser}
-DB_PASSWORD='${dbPassword}'
+        const newEnvBlock = `
+
+####
+# generated by the init script
+####
+DB_HOST=${dbHost}
+DB_PORT=${dbPort}
+DB_NAME=${dbName}
+DB_USER=${dbUser}
+DB_PASSWORD='${dbPassword}'
 `;
         /**
          * Append the new credentials to the .env file

package/dist/core/db/table-checker/MysqlTable.js

@@ -22,10 +22,10 @@ export class MysqlTableChecker extends DbTableChecker {
         return _tables;
     }
     static async getColumns(tableName) {
-        const statement = sql `
-       SELECT COLUMN_NAME 
-      FROM information_schema.COLUMNS c
-      inner join information_schema.TABLES t ON t.TABLE_NAME = c.TABLE_NAME
+        const statement = sql `
+       SELECT COLUMN_NAME 
+      FROM information_schema.COLUMNS c
+      inner join information_schema.TABLES t ON t.TABLE_NAME = c.TABLE_NAME
       WHERE t.TABLE_NAME = ${tableName}`;
         const _cols = [];
         const _res = await db.execute(statement);
@@ -82,10 +82,10 @@ export class MysqlTableChecker extends DbTableChecker {
                     fullTextKeys.push({ name: key, columns: _fullTextKeyMap[key] });
             }
             // Foreign keys should be retrieved from information_schema
-            const [foreignKeys] = await db.execute(sql `
-            SELECT COLUMN_NAME, REFERENCED_TABLE_NAME, REFERENCED_COLUMN_NAME
-            FROM information_schema.KEY_COLUMN_USAGE
-            WHERE TABLE_NAME = ${table} AND CONSTRAINT_NAME != 'PRIMARY' AND REFERENCED_TABLE_NAME IS NOT NULL;
+            const [foreignKeys] = await db.execute(sql `
+            SELECT COLUMN_NAME, REFERENCED_TABLE_NAME, REFERENCED_COLUMN_NAME
+            FROM information_schema.KEY_COLUMN_USAGE
+            WHERE TABLE_NAME = ${table} AND CONSTRAINT_NAME != 'PRIMARY' AND REFERENCED_TABLE_NAME IS NOT NULL;
         `);
             return { primaryKeys, uniqueKeys, indexKeys, foreignKeys, fullTextKeys };
         }

package/dist/core/factories/FieldFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FieldFactory.d.ts","sourceRoot":"","sources":["../../../src/core/factories/FieldFactory.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAGnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AASlD,KAAK,eAAe,GACd;IACI,IAAI,EAAE,KAAK,CAAA;IACX,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,CAAC,EAAE,KAAK,CAAA;CACjB,GACD;IACI,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;CAC1B,CAAA;AAEP,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,MAAM,CAAyC;IACvD,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,aAAa,CAAa;IAClC,SAAS,CAAC,IAAI,EAAE,KAAK,GAAG,MAAM,CAAA;IAC9B,SAAS,CAAC,WAAW,EAAE,MAAM,CAAA;IAC7B,OAAO,CAAC,YAAY,CAA4B;IAGhD;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAY;IAEjD;;OAEG;gBACS,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,eAAe;IASnE;;OAEG;IACU,UAAU;YAUT,aAAa;YASb,qBAAqB;IAqInC;;;;OAIG;YACW,qBAAqB;IAsDnC;;;;OAIG;YACW,cAAc;IAuB5B;;;;;OAKG;YACW,YAAY;IAiB1B,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACU,cAAc;IAqB3B;;;OAGG;IACH,OAAO,CAAC,UAAU;IA4ElB;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;;OAGG;IACU,gBAAgB;;;;;;;;;;;;;;;;IAiF7B,OAAO,CAAC,0BAA0B;IA0DlC,IAAI,WAAW,IAAI,OAAO,GAAG,SAAS,CAErC;IACD,IAAI,YAAY,IAAI,MAAM,CAEzB;IACD,IAAI,KAAK,IAAI,OAAO,CAEnB;CACJ"}
+{"version":3,"file":"FieldFactory.d.ts","sourceRoot":"","sources":["../../../src/core/factories/FieldFactory.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAGnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AASlD,KAAK,eAAe,GACd;IACI,IAAI,EAAE,KAAK,CAAA;IACX,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,CAAC,EAAE,KAAK,CAAA;CACjB,GACD;IACI,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;CAC1B,CAAA;AAEP,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,MAAM,CAAyC;IACvD,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,aAAa,CAAa;IAClC,SAAS,CAAC,IAAI,EAAE,KAAK,GAAG,MAAM,CAAA;IAC9B,SAAS,CAAC,WAAW,EAAE,MAAM,CAAA;IAC7B,OAAO,CAAC,YAAY,CAA4B;IAGhD;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAY;IAEjD;;OAEG;gBACS,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,eAAe;IASnE;;OAEG;IACU,UAAU;YAUT,aAAa;YASb,qBAAqB;IAqInC;;;;OAIG;YACW,qBAAqB;IAsDnC;;;;OAIG;YACW,cAAc;IAuB5B;;;;;OAKG;YACW,YAAY;IAsB1B,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACU,cAAc;IAqB3B;;;OAGG;IACH,OAAO,CAAC,UAAU;IA4ElB;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;;OAGG;IACU,gBAAgB;;;;;;;;;;;;;;;;IAiF7B,OAAO,CAAC,0BAA0B;IA0DlC,IAAI,WAAW,IAAI,OAAO,GAAG,SAAS,CAErC;IACD,IAAI,YAAY,IAAI,MAAM,CAEzB;IACD,IAAI,KAAK,IAAI,OAAO,CAEnB;CACJ"}

package/dist/core/factories/FieldFactory.js

@@ -2,7 +2,7 @@ import { sql } from 'drizzle-orm';
 import { db } from '../../db/client.js';
 import { SectionFactory } from './SectionFactory.js';
 import { SimpleSection, HasItemsSection, CategorySection } from '../sections/index.js';
-import { checkboxField, SelectField, SelectMultipleField, TagsField } from '../fields/index.js';
+import { checkboxField, DateRangeField, SelectField, SelectMultipleField, TagsField } from '../fields/index.js';
 import { is } from '../helpers/index.js';
 import { cloneDeep } from 'lodash-es';
 import chalk from 'chalk';
@@ -256,6 +256,10 @@ export class FieldFactory {
         // Build the field to initialize it (e.g., fetch select options from DB)
         await field.build();
         if (this.type === 'edit') {
+            if (is(field, DateRangeField)) {
+                field.setRangeValues(this._values[field.startName], this._values[field.endName]);
+                return;
+            }
             /**
              * If it's an edit operation, get the value from the database and set it
              */

package/dist/core/factories/section-factory-with-esbuild.js

@@ -456,15 +456,15 @@ export class SectionFactory {
                             importErr.message.includes('Cannot find module') &&
                             importErr.message.includes('.section')) {
                             this.sectionProcessingErrors[file] ??= [];
-                            this.sectionProcessingErrors[file].push(`❌ Invalid section import detected.
-
-Sections MUST use extensionless relative imports:
-
-  ✅ import exampleSection from './example.section'
-  ❌ import exampleSection from './example.section.ts'
-  ❌ import exampleSection from './example.section.js'
-
-This file is bundled with esbuild, so Node never resolves the import directly.
+                            this.sectionProcessingErrors[file].push(`❌ Invalid section import detected.
+
+Sections MUST use extensionless relative imports:
+
+  ✅ import exampleSection from './example.section'
+  ❌ import exampleSection from './example.section.ts'
+  ❌ import exampleSection from './example.section.js'
+
+This file is bundled with esbuild, so Node never resolves the import directly.
 If you added an extension manually, remove it.`);
                             this.errorCount++;
                             continue;

package/dist/core/factories/section-factory-with-jiti.js

@@ -412,15 +412,15 @@ export class SectionFactory {
                             importErr.message.includes('Cannot find module') &&
                             importErr.message.includes('.section')) {
                             this.sectionProcessingErrors[file] ??= [];
-                            this.sectionProcessingErrors[file].push(`❌ Invalid section import detected.
-
-Sections MUST use extensionless relative imports:
-
-  ✅ import exampleSection from './example.section'
-  ❌ import exampleSection from './example.section.ts'
-  ❌ import exampleSection from './example.section.js'
-
-This file is bundled with jiti, so Node never resolves the import directly.
+                            this.sectionProcessingErrors[file].push(`❌ Invalid section import detected.
+
+Sections MUST use extensionless relative imports:
+
+  ✅ import exampleSection from './example.section'
+  ❌ import exampleSection from './example.section.ts'
+  ❌ import exampleSection from './example.section.js'
+
+This file is bundled with jiti, so Node never resolves the import directly.
 If you added an extension manually, remove it.`);
                             this.errorCount++;
                             continue;

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

@@ -0,0 +1,119 @@
+import type { BaseFieldConfig, FieldClientConfig } from './field.js';
+import { Field } from './field.js';
+import { entityKind } from '../helpers/index.js';
+import * as z from 'zod';
+import { SerializedDateBoundValue, type DateBoundValue } from '../../utils/date-bounds.js';
+declare const configSchema: z.ZodObject<{
+    startName: z.ZodString;
+    endName: z.ZodString;
+    format: z.ZodOptional<z.ZodEnum<{
+        date: "date";
+        datetime: "datetime";
+    }>>;
+    minDate: z.ZodOptional<z.ZodUnion<readonly [z.ZodDate, z.ZodLiteral<"now">]>>;
+    maxDate: z.ZodOptional<z.ZodUnion<readonly [z.ZodDate, z.ZodLiteral<"now">]>>;
+    defaultStartValue: z.ZodOptional<z.ZodDate>;
+    defaultEndValue: z.ZodOptional<z.ZodDate>;
+}, z.core.$strict>;
+type Config = z.infer<typeof configSchema>;
+/**
+ * DateRangeField stores two DB columns: startName and endName.
+ *
+ * Because Field expects a single `name`, we pass `startName` as `name` to the
+ * super constructor (used for label generation / identity only).
+ * The field opts out of the normal single-column SQL path via hasSqlNameAndValue()=false
+ * and instead exposes setValues() / getSqlNamesAndValues() which submit.ts calls
+ * via an is(field, DateRangeField) guard — the same pattern used for SelectField.
+ */
+export declare class DateRangeField extends Field<'date_range', Config> {
+    static readonly [entityKind]: string;
+    readonly startName: string;
+    readonly endName: string;
+    readonly format: 'date' | 'datetime';
+    readonly minDate: DateBoundValue | undefined;
+    readonly maxDate: DateBoundValue | undefined;
+    private startValue;
+    private endValue;
+    constructor(config: Omit<BaseFieldConfig<Config>, 'name'> & Config);
+    hasSqlNameAndValue(): boolean;
+    setRangeValues(startValue: any, endValue: any): void;
+    getSqlNamesAndValues(): Record<string, string | null>;
+    getValue(): {
+        from: string | null;
+        to: string | null;
+    };
+    exportForClient(): FieldClientConfig & {
+        type: 'date_range';
+        startName: string;
+        endName: string;
+        format: 'date' | 'datetime';
+        minDate?: SerializedDateBoundValue | undefined;
+        maxDate?: SerializedDateBoundValue | undefined;
+        startValue?: string | null;
+        endValue?: string | null;
+    };
+    checkRequired(): void;
+    prepareForSubmission(): Promise<void>;
+    private parseDate;
+    private formatDate;
+    private validateDateBounds;
+}
+export type DateRangeFieldClientConfig = ReturnType<DateRangeField['exportForClient']>;
+declare const optionsSchema: z.ZodObject<{
+    startName: z.ZodString;
+    endName: z.ZodString;
+    format: z.ZodOptional<z.ZodEnum<{
+        date: "date";
+        datetime: "datetime";
+    }>>;
+    minDate: z.ZodOptional<z.ZodUnion<readonly [z.ZodDate, z.ZodLiteral<"now">]>>;
+    maxDate: z.ZodOptional<z.ZodUnion<readonly [z.ZodDate, z.ZodLiteral<"now">]>>;
+    defaultStartValue: z.ZodOptional<z.ZodDate>;
+    defaultEndValue: z.ZodOptional<z.ZodDate>;
+    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.ZodArray<z.ZodCustom<import("../types/index.js").ConditionalRule, import("../types/index.js").ConditionalRule>>>;
+    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<{
+    /**
+     * Auto-computed as `${startName}|${endName}`.
+     * Satisfies the `FieldConfig` union constraint that every config has a `name` property.
+     * Never set manually — use `startName` and `endName` instead.
+     */
+    name: z.ZodString;
+    type: z.ZodLiteral<"date_range">;
+    build: z.ZodFunction<z.core.$ZodFunctionArgs, z.ZodCustom<DateRangeField, DateRangeField>>;
+    startName: z.ZodString;
+    endName: z.ZodString;
+    format: z.ZodOptional<z.ZodEnum<{
+        date: "date";
+        datetime: "datetime";
+    }>>;
+    minDate: z.ZodOptional<z.ZodUnion<readonly [z.ZodDate, z.ZodLiteral<"now">]>>;
+    maxDate: z.ZodOptional<z.ZodUnion<readonly [z.ZodDate, z.ZodLiteral<"now">]>>;
+    defaultStartValue: z.ZodOptional<z.ZodDate>;
+    defaultEndValue: z.ZodOptional<z.ZodDate>;
+    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.ZodArray<z.ZodCustom<import("../types/index.js").ConditionalRule, import("../types/index.js").ConditionalRule>>>;
+    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>;
+/**
+ * Helper to create a date range field configuration.
+ * Uses `startName` and `endName` instead of the usual `name`.
+ * The `name` property is auto-computed as `${startName}|${endName}`.
+ *
+ * @example
+ * dateRangeField({ startName: 'event_start', endName: 'event_end', label: 'Event Dates' })
+ */
+export declare function dateRangeField(field: z.infer<typeof optionsSchema>): DateRangeFieldConfig;
+export {};
+//# sourceMappingURL=date-range.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"date-range.d.ts","sourceRoot":"","sources":["../../../src/core/fields/date-range.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AACpE,OAAO,EAAE,KAAK,EAAyB,MAAM,YAAY,CAAA;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAExB,OAAO,EAKH,wBAAwB,EACxB,KAAK,cAAc,EACtB,MAAM,4BAA4B,CAAA;AAEnC,QAAA,MAAM,YAAY;;;;;;;;;;;kBAQhB,CAAA;AAEF,KAAK,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AAG1C;;;;;;;;GAQG;AACH,qBAAa,cAAe,SAAQ,KAAK,CAAC,YAAY,EAAE,MAAM,CAAC;IAC3D,gBAAyB,CAAC,UAAU,CAAC,EAAE,MAAM,CAAmB;IAEhE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAA;IACpC,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,CAAA;IAC5C,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,CAAA;IAE5C,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,QAAQ,CAAqB;gBAEzB,MAAM,EAAE,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,GAAG,MAAM;IAoBzD,kBAAkB,IAAI,OAAO;IAItC,cAAc,CAAC,UAAU,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,GAAG,IAAI;IAOpD,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IASrD,QAAQ,IAAI;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;IAO7C,eAAe,IAAI,iBAAiB,GAAG;QAC5C,IAAI,EAAE,YAAY,CAAA;QAClB,SAAS,EAAE,MAAM,CAAA;QACjB,OAAO,EAAE,MAAM,CAAA;QACf,MAAM,EAAE,MAAM,GAAG,UAAU,CAAA;QAC3B,OAAO,CAAC,EAAE,wBAAwB,GAAG,SAAS,CAAA;QAC9C,OAAO,CAAC,EAAE,wBAAwB,GAAG,SAAS,CAAA;QAC9C,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAC3B;IAaD,aAAa,IAAI,IAAI;IAOf,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB3C,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,kBAAkB;CAqB7B;AAED,MAAM,MAAM,0BAA0B,GAAG,UAAU,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC,CAAA;AAItF,QAAA,MAAM,aAAa;;;;;;;;;;;;;;;;;;kBAGjB,CAAA;AAEF,QAAA,MAAM,0BAA0B;IAE5B;;;;OAIG;;;;;;;;;;;;;;;;;;;;;kBAOL,CAAA;AAEF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAE7E;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,GAAG,oBAAoB,CAczF"}

package/dist/core/fields/date-range.js

@@ -0,0 +1,175 @@
+import { Field, baseFieldConfigSchema } from './field.js';
+import { entityKind } from '../helpers/index.js';
+import * as z from 'zod';
+import getString from '../../translations/index.js';
+import { dateBoundSchema, formatDateForField, resolveDateBoundValue, serializeDateBoundValue, } from '../../utils/date-bounds.js';
+const configSchema = z.strictObject({
+    startName: z.string().describe('The DB column name for the start date'),
+    endName: z.string().describe('The DB column name for the end date'),
+    format: z.enum(['date', 'datetime']).optional().describe('The format of the date columns'),
+    minDate: dateBoundSchema.optional().describe('Minimum allowed date. Accepts a Date or "now"'),
+    maxDate: dateBoundSchema.optional().describe('Maximum allowed date. Accepts a Date or "now"'),
+    defaultStartValue: z.date().optional().describe('Default value for the start date'),
+    defaultEndValue: z.date().optional().describe('Default value for the end date'),
+});
+/**
+ * DateRangeField stores two DB columns: startName and endName.
+ *
+ * Because Field expects a single `name`, we pass `startName` as `name` to the
+ * super constructor (used for label generation / identity only).
+ * The field opts out of the normal single-column SQL path via hasSqlNameAndValue()=false
+ * and instead exposes setValues() / getSqlNamesAndValues() which submit.ts calls
+ * via an is(field, DateRangeField) guard — the same pattern used for SelectField.
+ */
+export class DateRangeField extends Field {
+    static [entityKind] = 'DateRangeField';
+    startName;
+    endName;
+    format;
+    minDate;
+    maxDate;
+    startValue;
+    endValue;
+    constructor(config) {
+        // Pass startName as `name` so the base class label-generation / identity works
+        super({ ...config, name: config.startName }, 'date_range');
+        this.startName = config.startName;
+        this.endName = config.endName;
+        this.format = config.format ?? 'date';
+        this.minDate = config.minDate;
+        this.maxDate = config.maxDate;
+        this.startValue = config.defaultStartValue ?? undefined;
+        this.endValue = config.defaultEndValue ?? undefined;
+        const minDate = resolveDateBoundValue(this.minDate);
+        const maxDate = resolveDateBoundValue(this.maxDate);
+        if (minDate && maxDate && minDate.getTime() > maxDate.getTime()) {
+            throw new Error(getString('fieldDateBoundsMismatch', this.language, { field: this.getLocalizedLabel() }));
+        }
+    }
+    // ─── Opt out of single-column SQL path ────────────────────────────────────
+    hasSqlNameAndValue() {
+        return false;
+    }
+    setRangeValues(startValue, endValue) {
+        this.startValue = startValue;
+        this.endValue = endValue;
+    }
+    // ─── Dual-column SQL output (called by submit.ts) ─────────────────────────
+    getSqlNamesAndValues() {
+        return {
+            [this.startName]: this.formatDate(this.startValue),
+            [this.endName]: this.formatDate(this.endValue),
+        };
+    }
+    // ─── Standard Field interface ─────────────────────────────────────────────
+    getValue() {
+        return {
+            from: this.formatDate(this.startValue),
+            to: this.formatDate(this.endValue),
+        };
+    }
+    exportForClient() {
+        return {
+            ...super.exportForClient(),
+            startName: this.startName,
+            endName: this.endName,
+            format: this.format,
+            minDate: serializeDateBoundValue(this.minDate),
+            maxDate: serializeDateBoundValue(this.maxDate),
+            startValue: this.formatDate(this.startValue),
+            endValue: this.formatDate(this.endValue),
+        };
+    }
+    checkRequired() {
+        if (!this.required)
+            return;
+        if (!this.parseDate(this.startValue) || !this.parseDate(this.endValue)) {
+            throw new Error(getString('fieldIsRequired', this.language, { field: this.getLocalizedLabel() }));
+        }
+    }
+    async prepareForSubmission() {
+        const start = this.parseDate(this.startValue);
+        const end = this.parseDate(this.endValue);
+        if (this.required && (!start || !end)) {
+            throw new Error(getString('invalidDatePleaseProvideValid', this.language, { field: this.getLocalizedLabel() }));
+        }
+        if (start) {
+            this.validateDateBounds(start);
+            this.startValue = start.toISOString();
+        }
+        if (end) {
+            this.validateDateBounds(end);
+            this.endValue = end.toISOString();
+        }
+    }
+    // ─── Helpers ──────────────────────────────────────────────────────────────
+    parseDate(value) {
+        if (value === undefined || value === null || value === '')
+            return null;
+        const date = new Date(value);
+        return isNaN(date.getTime()) ? null : date;
+    }
+    formatDate(value) {
+        const date = this.parseDate(value);
+        if (!date)
+            return null;
+        return formatDateForField(date, this.format);
+    }
+    validateDateBounds(date) {
+        const minDate = resolveDateBoundValue(this.minDate);
+        if (minDate && date.getTime() < minDate.getTime()) {
+            throw new Error(getString('fieldDateMinValueError', this.language, {
+                field: this.getLocalizedLabel(),
+                min: formatDateForField(minDate, this.format),
+            }));
+        }
+        const maxDate = resolveDateBoundValue(this.maxDate);
+        if (maxDate && date.getTime() > maxDate.getTime()) {
+            throw new Error(getString('fieldDateMaxValueError', this.language, {
+                field: this.getLocalizedLabel(),
+                max: formatDateForField(maxDate, this.format),
+            }));
+        }
+    }
+}
+// ─── Config schema & factory ──────────────────────────────────────────────────
+const optionsSchema = z.strictObject({
+    ...baseFieldConfigSchema.omit({ name: true }).shape,
+    ...configSchema.shape,
+});
+const dateRangeFieldConfigSchema = z.strictObject({
+    ...optionsSchema.shape,
+    /**
+     * Auto-computed as `${startName}|${endName}`.
+     * Satisfies the `FieldConfig` union constraint that every config has a `name` property.
+     * Never set manually — use `startName` and `endName` instead.
+     */
+    name: z.string(),
+    type: z.literal('date_range').describe('The type of the field'),
+    build: z
+        .function()
+        .output(z.instanceof(DateRangeField))
+        .describe('Build a DateRangeField instance from this config'),
+});
+/**
+ * Helper to create a date range field configuration.
+ * Uses `startName` and `endName` instead of the usual `name`.
+ * The `name` property is auto-computed as `${startName}|${endName}`.
+ *
+ * @example
+ * dateRangeField({ startName: 'event_start', endName: 'event_end', label: 'Event Dates' })
+ */
+export function dateRangeField(field) {
+    const result = optionsSchema.safeParse(field);
+    if (!result.success) {
+        throw new Error(`[DateRangeField: ${field.startName}/${field.endName}]: ${z.prettifyError(result.error)}`);
+    }
+    return {
+        ...field,
+        name: `${field.startName}|${field.endName}`,
+        type: 'date_range',
+        build() {
+            return new DateRangeField(field);
+        },
+    };
+}

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

@@ -2,18 +2,21 @@ import type { BaseFieldConfig } from './field.js';
 import { Field } from './field.js';
 import { entityKind } from '../helpers/index.js';
 import * as z from 'zod';
+import { type DateBoundValue } from '../../utils/date-bounds.js';
 declare const configSchema: z.ZodObject<{
     format: z.ZodOptional<z.ZodEnum<{
         date: "date";
         datetime: "datetime";
         timestamp: "timestamp";
     }>>;
+    minDate: z.ZodOptional<z.ZodUnion<readonly [z.ZodDate, z.ZodLiteral<"now">]>>;
+    maxDate: z.ZodOptional<z.ZodUnion<readonly [z.ZodDate, z.ZodLiteral<"now">]>>;
     /**
      * The default value of the field.
      * If set, the field will be pre-populated with this value when the form is loaded.
      * If `adminGenerated` is not true, the field will be included when submitting the form with this value.
      */
-    defaultValue: z.ZodOptional<z.ZodCustom<Date, Date>>;
+    defaultValue: z.ZodOptional<z.ZodDate>;
 }, z.core.$strict>;
 type Config = z.infer<typeof configSchema>;
 export declare class DateField extends Field<'date', Config> {
@@ -24,6 +27,8 @@ export declare class DateField extends Field<'date', Config> {
      * 2- time format should be added as well.
      */
     readonly format: 'date' | 'datetime' | 'timestamp';
+    readonly minDate: DateBoundValue | undefined;
+    readonly maxDate: DateBoundValue | undefined;
     private readonly _defaultValue;
     constructor(config: BaseFieldConfig<Config>);
     /**
@@ -38,6 +43,8 @@ export declare class DateField extends Field<'date', Config> {
     getValue(): string | null;
     exportForClient(): {
         format: "date" | "datetime" | "timestamp";
+        minDate: string | undefined;
+        maxDate: string | undefined;
         type: "date";
         name: string;
         label: string;
@@ -55,6 +62,7 @@ export declare class DateField extends Field<'date', Config> {
      * Normalizes the value to ISO string format for storage
      */
     prepareForSubmission(): Promise<void>;
+    private validateDateBounds;
 }
 export type DateFieldClientConfig = ReturnType<DateField['exportForClient']>;
 declare const optionsSchema: z.ZodObject<{
@@ -63,12 +71,14 @@ declare const optionsSchema: z.ZodObject<{
         datetime: "datetime";
         timestamp: "timestamp";
     }>>;
+    minDate: z.ZodOptional<z.ZodUnion<readonly [z.ZodDate, z.ZodLiteral<"now">]>>;
+    maxDate: z.ZodOptional<z.ZodUnion<readonly [z.ZodDate, z.ZodLiteral<"now">]>>;
     /**
      * The default value of the field.
      * If set, the field will be pre-populated with this value when the form is loaded.
      * If `adminGenerated` is not true, the field will be included when submitting the form with this value.
      */
-    defaultValue: z.ZodOptional<z.ZodCustom<Date, Date>>;
+    defaultValue: z.ZodOptional<z.ZodDate>;
     name: z.ZodString;
     label: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
     required: z.ZodOptional<z.ZodBoolean>;
@@ -85,12 +95,14 @@ declare const dateFieldConfigSchema: z.ZodObject<{
         datetime: "datetime";
         timestamp: "timestamp";
     }>>;
+    minDate: z.ZodOptional<z.ZodUnion<readonly [z.ZodDate, z.ZodLiteral<"now">]>>;
+    maxDate: z.ZodOptional<z.ZodUnion<readonly [z.ZodDate, z.ZodLiteral<"now">]>>;
     /**
      * The default value of the field.
      * If set, the field will be pre-populated with this value when the form is loaded.
      * If `adminGenerated` is not true, the field will be included when submitting the form with this value.
      */
-    defaultValue: z.ZodOptional<z.ZodCustom<Date, Date>>;
+    defaultValue: z.ZodOptional<z.ZodDate>;
     name: z.ZodString;
     label: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
     required: z.ZodOptional<z.ZodBoolean>;

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

@@ -1 +1 @@
-{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../../src/core/fields/date.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,EAAE,KAAK,EAAyB,MAAM,YAAY,CAAA;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAIxB,QAAA,MAAM,YAAY;;;;;;IAEd;;;;OAIG;;kBAEL,CAAA;AAEF,KAAK,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AAE1C,qBAAa,SAAU,SAAQ,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC;IAChD,gBAAyB,CAAC,UAAU,CAAC,EAAE,MAAM,CAAc;IAE3D;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,CAAA;IAClD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkB;gBACpC,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC;IAU3C;;;OAGG;IACH,OAAO,CAAC,SAAS;IAQjB;;;OAGG;IACH,QAAQ,IAAI,MAAM,GAAG,IAAI;IAsBhB,eAAe;;;;;;;;;;;;IAOxB,aAAa;IAYJ,kBAAkB,IAAI,OAAO;IAOtC;;;OAGG;IACG,oBAAoB;CAS7B;AAED,MAAM,MAAM,qBAAqB,GAAG,UAAU,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC,CAAA;AAE5E,QAAA,MAAM,aAAa;;;;;;IA/Gf;;;;OAIG;;;;;;;;;kBA8GL,CAAA;AAEF,QAAA,MAAM,qBAAqB;;;;;;;;IApHvB;;;;OAIG;;;;;;;;;kBAoHL,CAAA;AAEF;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEnE;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,GAAG,eAAe,CAmB/E"}
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../../src/core/fields/date.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,EAAE,KAAK,EAAyB,MAAM,YAAY,CAAA;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAExB,OAAO,EAKH,KAAK,cAAc,EACtB,MAAM,4BAA4B,CAAA;AAEnC,QAAA,MAAM,YAAY;;;;;;;;IAId;;;;OAIG;;kBAEL,CAAA;AAEF,KAAK,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AAE1C,qBAAa,SAAU,SAAQ,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC;IAChD,gBAAyB,CAAC,UAAU,CAAC,EAAE,MAAM,CAAc;IAE3D;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,CAAA;IAClD,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,CAAA;IAC5C,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,CAAA;IAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkB;gBACpC,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC;IAkB3C;;;OAGG;IACH,OAAO,CAAC,SAAS;IAQjB;;;OAGG;IACH,QAAQ,IAAI,MAAM,GAAG,IAAI;IAShB,eAAe;;;;;;;;;;;;;;IASxB,aAAa;IAYJ,kBAAkB,IAAI,OAAO;IAOtC;;;OAGG;IACG,oBAAoB;IAa1B,OAAO,CAAC,kBAAkB;CAqB7B;AAED,MAAM,MAAM,qBAAqB,GAAG,UAAU,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC,CAAA;AAE5E,QAAA,MAAM,aAAa;;;;;;;;IAvIf;;;;OAIG;;;;;;;;;kBAsIL,CAAA;AAEF,QAAA,MAAM,qBAAqB;;;;;;;;;;IA5IvB;;;;OAIG;;;;;;;;;kBA4IL,CAAA;AAEF;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEnE;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,GAAG,eAAe,CAmB/E"}

package/dist/core/fields/date.js

@@ -1,16 +1,18 @@
 import { Field, baseFieldConfigSchema } from './field.js';
 import { entityKind } from '../helpers/index.js';
 import * as z from 'zod';
-import dayjs from 'dayjs';
 import getString from '../../translations/index.js';
+import { dateBoundSchema, formatDateForField, resolveDateBoundValue, serializeDateBoundValue, } from '../../utils/date-bounds.js';
 const configSchema = z.strictObject({
     format: z.enum(['date', 'datetime', 'timestamp']).optional().describe('The format of the date field'),
+    minDate: dateBoundSchema.optional().describe('Minimum allowed date. Accepts a Date or "now"'),
+    maxDate: dateBoundSchema.optional().describe('Maximum allowed date. Accepts a Date or "now"'),
     /**
      * The default value of the field.
      * If set, the field will be pre-populated with this value when the form is loaded.
      * If `adminGenerated` is not true, the field will be included when submitting the form with this value.
      */
-    defaultValue: z.custom().optional().describe('The default value of the field'),
+    defaultValue: z.date().optional().describe('The default value of the field'),
 });
 export class DateField extends Field {
     static [entityKind] = 'DateField';
@@ -20,15 +22,24 @@ export class DateField extends Field {
      * 2- time format should be added as well.
      */
     format;
+    minDate;
+    maxDate;
     _defaultValue;
     constructor(config) {
         super(config, 'date');
         this.format = config.format || 'date';
+        this.minDate = config.minDate;
+        this.maxDate = config.maxDate;
         /**
-         * Set the default date if not provided
+         * Set the default date when provided
          */
         this.value = config.defaultValue ?? undefined;
         this._defaultValue = config.defaultValue;
+        const minDate = resolveDateBoundValue(this.minDate);
+        const maxDate = resolveDateBoundValue(this.maxDate);
+        if (minDate && maxDate && minDate.getTime() > maxDate.getTime()) {
+            throw new Error(getString('fieldDateBoundsMismatch', this.language, { field: this.getLocalizedLabel() }));
+        }
     }
     /**
      * Parse the raw value into a Date object
@@ -50,25 +61,14 @@ export class DateField extends Field {
         if (!date) {
             return null;
         }
-        switch (this.format) {
-            case 'timestamp':
-                return dayjs(date).format('YYYY-MM-DD HH:mm:ss.SSS');
-            case 'datetime':
-                /**
-                 * Return the date in ISO string format
-                 * Example: 2025-12-18T12:00:00.000Z
-                 */
-                return dayjs(date).format('YYYY-MM-DD HH:mm:ss');
-            case 'date':
-            default:
-                // Return YYYY-MM-DD format
-                return dayjs(date).format('YYYY-MM-DD');
-        }
+        return formatDateForField(date, this.format);
     }
     exportForClient() {
         return {
             ...super.exportForClient(),
             format: this.format,
+            minDate: serializeDateBoundValue(this.minDate),
+            maxDate: serializeDateBoundValue(this.maxDate),
         };
     }
     checkRequired() {
@@ -95,6 +95,7 @@ export class DateField extends Field {
     async prepareForSubmission() {
         const date = this.parseDate();
         if (date) {
+            this.validateDateBounds(date);
             this.value = date.toISOString();
         }
         else if (this.required) {
@@ -102,6 +103,22 @@ export class DateField extends Field {
         }
         // If not required and no valid date, keep value as-is (null/undefined)
     }
+    validateDateBounds(date) {
+        const minDate = resolveDateBoundValue(this.minDate);
+        if (minDate && date.getTime() < minDate.getTime()) {
+            throw new Error(getString('fieldDateMinValueError', this.language, {
+                field: this.getLocalizedLabel(),
+                min: formatDateForField(minDate, this.format),
+            }));
+        }
+        const maxDate = resolveDateBoundValue(this.maxDate);
+        if (maxDate && date.getTime() > maxDate.getTime()) {
+            throw new Error(getString('fieldDateMaxValueError', this.language, {
+                field: this.getLocalizedLabel(),
+                max: formatDateForField(maxDate, this.format),
+            }));
+        }
+    }
 }
 const optionsSchema = z.strictObject({
     ...baseFieldConfigSchema.shape,