@dynamic-entity/server 2.4.0 → 2.5.0

package/README.md

@@ -278,6 +278,13 @@ will name their zip `.csv`.
   comma-separated, so Excel in those locales opens them as one column — offer `xlsx` there.
 - **`.xlsx`** — through `exceljs`. Cells keep their types: a date cell arrives as a `Date` at
   UTC midnight and is read as the calendar date it is, in every timezone.
+- **Dates written as text.** `2026-09-05` is always read as written. A date in digits such as
+  `05/09/2026` reads two ways, so it is an error unless you say which: pass
+  `dateOrder: 'DMY'` (day first) or `'MDY'` (month first) to `createImportRouter` or
+  `runImport`. It is never guessed. Releases before 2.5.0 read it month first without
+  saying so; see the changelog if your sheets are day first. A preview response carries the
+  router's `dateOrder`, so the wizard reads its review the same way and refuses to commit if
+  it was told a different order.
 - A pre-2007 `.xls` and a UTF-16 file are **named** rather than parsed into nonsense.
 
 ---

package/express.d.mts

@@ -1,6 +1,6 @@
-import { EntityFormConfig, FormRule, ImportLookups } from '@dynamic-entity/core';
+import { EntityFormConfig, FormRule, ImportLookups, DateOrder } from '@dynamic-entity/core';
 import { Request, Router, Response } from 'express';
-import { B as BatchInfo, I as ImportLimits, T as TemplateFormat } from './write-template-CzKVVjgT.mjs';
+import { B as BatchInfo, I as ImportLimits, T as TemplateFormat } from './write-template-Dqu5b00D.mjs';
 import 'node:stream';
 
 /**
@@ -41,6 +41,12 @@ interface ImportRouterOptions {
     rules?: Record<string, readonly FormRule[]>;
     /** Values for every `listName` any config mentions. A server has no `LOOKUP_REGISTRY`. */
     lookups?: ImportLookups;
+    /**
+     * The order of a date written in digits, for every import and validation this router runs:
+     * `DMY` for day first, `MDY` for month first. Without it, a date that reads two ways
+     * (`05/09/2026`) fails its row. See `RunImportOptions.dateOrder`.
+     */
+    dateOrder?: DateOrder;
     /**
      * Where records go.
      *

package/express.d.ts

@@ -1,6 +1,6 @@
-import { EntityFormConfig, FormRule, ImportLookups } from '@dynamic-entity/core';
+import { EntityFormConfig, FormRule, ImportLookups, DateOrder } from '@dynamic-entity/core';
 import { Request, Router, Response } from 'express';
-import { B as BatchInfo, I as ImportLimits, T as TemplateFormat } from './write-template-CzKVVjgT.js';
+import { B as BatchInfo, I as ImportLimits, T as TemplateFormat } from './write-template-Dqu5b00D.js';
 import 'node:stream';
 
 /**
@@ -41,6 +41,12 @@ interface ImportRouterOptions {
     rules?: Record<string, readonly FormRule[]>;
     /** Values for every `listName` any config mentions. A server has no `LOOKUP_REGISTRY`. */
     lookups?: ImportLookups;
+    /**
+     * The order of a date written in digits, for every import and validation this router runs:
+     * `DMY` for day first, `MDY` for month first. Without it, a date that reads two ways
+     * (`05/09/2026`) fails its row. See `RunImportOptions.dateOrder`.
+     */
+    dateOrder?: DateOrder;
     /**
      * Where records go.
      *

package/express.js

@@ -812,6 +812,7 @@ async function runImport(options) {
     const result = core.applyMapping(rows, plan, config, {
       lang: options.lang,
       decimal,
+      dateOrder: options.dateOrder,
       rules: options.rules,
       lookups: options.lookups,
       firstRowNumber: firstRow
@@ -1068,6 +1069,9 @@ function createImportRouter(options) {
         rowCount: preview.rowCount,
         arrayBound: preview.arrayBound,
         ...preview.delimiter ? { delimiter: preview.delimiter } : {},
+        // The order every import through this router is read in, so the client reads its
+        // sample the same way and can refuse to commit when it was told another.
+        ...options.dateOrder ? { dateOrder: options.dateOrder } : {},
         engineVersion: core.CORE_VERSION
       };
       response.json(body);
@@ -1105,6 +1109,7 @@ function createImportRouter(options) {
       config,
       rules: routerOptions.rules && ownValue(routerOptions.rules, entity),
       lookups: routerOptions.lookups,
+      dateOrder: routerOptions.dateOrder,
       lang: language(request),
       limits: resolved,
       onBatch: write && ((records, info) => write(records, info, entity, config))