@researchdatabox/sails-ng-common 5.0.3 → 5.0.4-beta.12498

package/dist/src/validation/validation-groups.fixtures.d.ts

@@ -0,0 +1,20 @@
+import { FormFieldValidationGroup, FormValidationGroups } from './form.model';
+import { FormValidationGroupsChangeInitial } from './validation-groups';
+/** @internal Shared client/server parity fixture. */
+export interface ValidationGroupCalculationFixture {
+    name: string;
+    currentValidationGroups: string[];
+    validationGroups: FormValidationGroups;
+    initial?: FormValidationGroupsChangeInitial;
+    groups?: FormFieldValidationGroup;
+    operationEnabledValidationGroups?: string[];
+    expectedGroups: string[];
+    expectedDiagnosticCodes?: string[];
+}
+/**
+ * Fixtures consumed by both sails-ng-common and Angular tests. They document
+ * the deliberately retained edge cases as executable compatibility data.
+ *
+ * @internal
+ */
+export declare const validationGroupCalculationFixtures: ValidationGroupCalculationFixture[];

package/dist/src/validation/validation-groups.fixtures.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validationGroupCalculationFixtures = void 0;
+const availableGroups = {
+    all: { description: 'All validators', initialMembership: 'all' },
+    none: { description: 'No validators', initialMembership: 'none' },
+    draft: { description: 'Draft validators', initialMembership: 'none' },
+    publish: { description: 'Publish validators', initialMembership: 'none' },
+};
+/**
+ * Fixtures consumed by both sails-ng-common and Angular tests. They document
+ * the deliberately retained edge cases as executable compatibility data.
+ *
+ * @internal
+ */
+exports.validationGroupCalculationFixtures = [
+    {
+        name: 'keeps an empty current group array',
+        currentValidationGroups: [],
+        validationGroups: availableGroups,
+        expectedGroups: [],
+    },
+    {
+        name: 'starts with every declared group in declaration order',
+        currentValidationGroups: ['draft'],
+        validationGroups: availableGroups,
+        initial: 'all',
+        expectedGroups: ['all', 'none', 'draft', 'publish'],
+    },
+    {
+        name: 'starts with no groups',
+        currentValidationGroups: ['all'],
+        validationGroups: availableGroups,
+        initial: 'none',
+        expectedGroups: [],
+    },
+    {
+        name: 'keeps current groups and applies include then exclude',
+        currentValidationGroups: ['all'],
+        validationGroups: availableGroups,
+        groups: { include: ['draft', 'all'], exclude: ['all'] },
+        expectedGroups: ['draft'],
+    },
+    {
+        name: 'retains unknown group names for authoritative configuration checks',
+        currentValidationGroups: ['all'],
+        validationGroups: availableGroups,
+        groups: { include: ['not-configured'] },
+        expectedGroups: ['all', 'not-configured'],
+    },
+    {
+        name: 'suppresses duplicate includes while preserving legacy current duplicates',
+        currentValidationGroups: ['draft', 'draft'],
+        validationGroups: availableGroups,
+        groups: { include: ['draft', 'publish'], exclude: ['draft'] },
+        expectedGroups: ['draft', 'publish'],
+    },
+    {
+        name: 'supports the deprecated empty alias',
+        currentValidationGroups: ['all'],
+        validationGroups: availableGroups,
+        initial: 'empty',
+        expectedGroups: [],
+        expectedDiagnosticCodes: ['validation-group-initial-empty-deprecated'],
+    },
+    {
+        name: 'applies the operation exact group set last',
+        currentValidationGroups: ['all'],
+        validationGroups: availableGroups,
+        initial: 'none',
+        groups: { include: ['draft'] },
+        operationEnabledValidationGroups: ['publish', 'publish'],
+        expectedGroups: ['publish'],
+    },
+    {
+        name: 'preserves an exact empty operation set',
+        currentValidationGroups: ['all'],
+        validationGroups: availableGroups,
+        operationEnabledValidationGroups: [],
+        expectedGroups: [],
+    },
+];
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidmFsaWRhdGlvbi1ncm91cHMuZml4dHVyZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvdmFsaWRhdGlvbi92YWxpZGF0aW9uLWdyb3Vwcy5maXh0dXJlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFlQSxNQUFNLGVBQWUsR0FBeUI7SUFDNUMsR0FBRyxFQUFFLEVBQUUsV0FBVyxFQUFFLGdCQUFnQixFQUFFLGlCQUFpQixFQUFFLEtBQUssRUFBRTtJQUNoRSxJQUFJLEVBQUUsRUFBRSxXQUFXLEVBQUUsZUFBZSxFQUFFLGlCQUFpQixFQUFFLE1BQU0sRUFBRTtJQUNqRSxLQUFLLEVBQUUsRUFBRSxXQUFXLEVBQUUsa0JBQWtCLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSxFQUFFO0lBQ3JFLE9BQU8sRUFBRSxFQUFFLFdBQVcsRUFBRSxvQkFBb0IsRUFBRSxpQkFBaUIsRUFBRSxNQUFNLEVBQUU7Q0FDMUUsQ0FBQztBQUVGOzs7OztHQUtHO0FBQ1UsUUFBQSxrQ0FBa0MsR0FBd0M7SUFDckY7UUFDRSxJQUFJLEVBQUUsb0NBQW9DO1FBQzFDLHVCQUF1QixFQUFFLEVBQUU7UUFDM0IsZ0JBQWdCLEVBQUUsZUFBZTtRQUNqQyxjQUFjLEVBQUUsRUFBRTtLQUNuQjtJQUNEO1FBQ0UsSUFBSSxFQUFFLHVEQUF1RDtRQUM3RCx1QkFBdUIsRUFBRSxDQUFDLE9BQU8sQ0FBQztRQUNsQyxnQkFBZ0IsRUFBRSxlQUFlO1FBQ2pDLE9BQU8sRUFBRSxLQUFLO1FBQ2QsY0FBYyxFQUFFLENBQUMsS0FBSyxFQUFFLE1BQU0sRUFBRSxPQUFPLEVBQUUsU0FBUyxDQUFDO0tBQ3BEO0lBQ0Q7UUFDRSxJQUFJLEVBQUUsdUJBQXVCO1FBQzdCLHVCQUF1QixFQUFFLENBQUMsS0FBSyxDQUFDO1FBQ2hDLGdCQUFnQixFQUFFLGVBQWU7UUFDakMsT0FBTyxFQUFFLE1BQU07UUFDZixjQUFjLEVBQUUsRUFBRTtLQUNuQjtJQUNEO1FBQ0UsSUFBSSxFQUFFLHVEQUF1RDtRQUM3RCx1QkFBdUIsRUFBRSxDQUFDLEtBQUssQ0FBQztRQUNoQyxnQkFBZ0IsRUFBRSxlQUFlO1FBQ2pDLE1BQU0sRUFBRSxFQUFFLE9BQU8sRUFBRSxDQUFDLE9BQU8sRUFBRSxLQUFLLENBQUMsRUFBRSxPQUFPLEVBQUUsQ0FBQyxLQUFLLENBQUMsRUFBRTtRQUN2RCxjQUFjLEVBQUUsQ0FBQyxPQUFPLENBQUM7S0FDMUI7SUFDRDtRQUNFLElBQUksRUFBRSxvRUFBb0U7UUFDMUUsdUJBQXVCLEVBQUUsQ0FBQyxLQUFLLENBQUM7UUFDaEMsZ0JBQWdCLEVBQUUsZUFBZTtRQUNqQyxNQUFNLEVBQUUsRUFBRSxPQUFPLEVBQUUsQ0FBQyxnQkFBZ0IsQ0FBQyxFQUFFO1FBQ3ZDLGNBQWMsRUFBRSxDQUFDLEtBQUssRUFBRSxnQkFBZ0IsQ0FBQztLQUMxQztJQUNEO1FBQ0UsSUFBSSxFQUFFLDBFQUEwRTtRQUNoRix1QkFBdUIsRUFBRSxDQUFDLE9BQU8sRUFBRSxPQUFPLENBQUM7UUFDM0MsZ0JBQWdCLEVBQUUsZUFBZTtRQUNqQyxNQUFNLEVBQUUsRUFBRSxPQUFPLEVBQUUsQ0FBQyxPQUFPLEVBQUUsU0FBUyxDQUFDLEVBQUUsT0FBTyxFQUFFLENBQUMsT0FBTyxDQUFDLEVBQUU7UUFDN0QsY0FBYyxFQUFFLENBQUMsT0FBTyxFQUFFLFNBQVMsQ0FBQztLQUNyQztJQUNEO1FBQ0UsSUFBSSxFQUFFLHFDQUFxQztRQUMzQyx1QkFBdUIsRUFBRSxDQUFDLEtBQUssQ0FBQztRQUNoQyxnQkFBZ0IsRUFBRSxlQUFlO1FBQ2pDLE9BQU8sRUFBRSxPQUFPO1FBQ2hCLGNBQWMsRUFBRSxFQUFFO1FBQ2xCLHVCQUF1QixFQUFFLENBQUMsMkNBQTJDLENBQUM7S0FDdkU7SUFDRDtRQUNFLElBQUksRUFBRSw0Q0FBNEM7UUFDbEQsdUJBQXVCLEVBQUUsQ0FBQyxLQUFLLENBQUM7UUFDaEMsZ0JBQWdCLEVBQUUsZUFBZTtRQUNqQyxPQUFPLEVBQUUsTUFBTTtRQUNmLE1BQU0sRUFBRSxFQUFFLE9BQU8sRUFBRSxDQUFDLE9BQU8sQ0FBQyxFQUFFO1FBQzlCLGdDQUFnQyxFQUFFLENBQUMsU0FBUyxFQUFFLFNBQVMsQ0FBQztRQUN4RCxjQUFjLEVBQUUsQ0FBQyxTQUFTLENBQUM7S0FDNUI7SUFDRDtRQUNFLElBQUksRUFBRSx3Q0FBd0M7UUFDOUMsdUJBQXVCLEVBQUUsQ0FBQyxLQUFLLENBQUM7UUFDaEMsZ0JBQWdCLEVBQUUsZUFBZTtRQUNqQyxnQ0FBZ0MsRUFBRSxFQUFFO1FBQ3BDLGNBQWMsRUFBRSxFQUFFO0tBQ25CO0NBQ0YsQ0FBQyJ9

package/dist/src/validation/validation-groups.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VALIDATION_GROUP_UNKNOWN_INITIAL_DIAGNOSTIC = exports.VALIDATION_GROUP_EMPTY_INITIAL_DIAGNOSTIC = exports.formValidationGroupsChangeInitial = void 0;
+exports.calculateValidationGroups = calculateValidationGroups;
+const form_model_1 = require("./form.model");
+/** Initial source used by a validation-group change. */
+exports.formValidationGroupsChangeInitial = [...form_model_1.formValidationGroupMembership, 'current', 'empty'];
+exports.VALIDATION_GROUP_EMPTY_INITIAL_DIAGNOSTIC = 'validation-group-initial-empty-deprecated';
+exports.VALIDATION_GROUP_UNKNOWN_INITIAL_DIAGNOSTIC = 'validation-group-initial-unknown';
+function describeUnknownInitial(value) {
+    if (typeof value === 'string') {
+        const maxLength = 64;
+        const bounded = value.length > maxLength ? `${value.slice(0, maxLength)}...` : value;
+        return JSON.stringify(bounded);
+    }
+    if (value === null || typeof value === 'number' || typeof value === 'boolean') {
+        return String(value);
+    }
+    return `[${Array.isArray(value) ? 'array' : typeof value}]`;
+}
+/**
+ * Fold one validation-group change using the historical Angular semantics.
+ *
+ * Important compatibility behavior:
+ * - an empty resulting array is preserved (ValidatorsSupport interprets it as
+ *   all validators);
+ * - `none`/legacy `empty` start from an empty array, while the configured
+ *   `none` group is represented by the literal group name `none`;
+ * - includes append only missing names and excludes remove the first present
+ *   occurrence, matching the original client implementation;
+ * - unknown names are retained for the authoritative caller to diagnose;
+ * - an operation group array, when supplied, replaces the folded array last.
+ */
+function calculateValidationGroups(currentValidationGroups, validationGroups, initial = 'current', groups, operationEnabledValidationGroups) {
+    let enabledNames = [...currentValidationGroups];
+    const diagnostics = [];
+    switch (initial) {
+        case 'all':
+            enabledNames = Object.keys(validationGroups);
+            break;
+        case 'none':
+            enabledNames = [];
+            break;
+        case 'empty':
+            enabledNames = [];
+            diagnostics.push({
+                code: exports.VALIDATION_GROUP_EMPTY_INITIAL_DIAGNOSTIC,
+                severity: 'warning',
+                message: "Validation-group initial state 'empty' is deprecated; use 'none'.",
+            });
+            break;
+        case 'current':
+            break;
+        default:
+            diagnostics.push({
+                code: exports.VALIDATION_GROUP_UNKNOWN_INITIAL_DIAGNOSTIC,
+                severity: 'error',
+                message: `The validation-group initial state ${describeUnknownInitial(initial)} is not supported.`,
+            });
+    }
+    for (const name of groups?.include ?? []) {
+        if (!enabledNames.includes(name)) {
+            enabledNames.push(name);
+        }
+    }
+    for (const name of groups?.exclude ?? []) {
+        const index = enabledNames.indexOf(name);
+        if (index >= 0) {
+            enabledNames.splice(index, 1);
+        }
+    }
+    if (operationEnabledValidationGroups !== undefined) {
+        enabledNames = [];
+        for (const name of operationEnabledValidationGroups) {
+            if (!enabledNames.includes(name)) {
+                enabledNames.push(name);
+            }
+        }
+    }
+    return { enabledValidationGroups: enabledNames, diagnostics };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidmFsaWRhdGlvbi1ncm91cHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvdmFsaWRhdGlvbi92YWxpZGF0aW9uLWdyb3Vwcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFpREEsOERBMERDO0FBM0dELDZDQUlzQjtBQUd0Qix3REFBd0Q7QUFDM0MsUUFBQSxpQ0FBaUMsR0FBRyxDQUFDLEdBQUcsMENBQTZCLEVBQUUsU0FBUyxFQUFFLE9BQU8sQ0FBVSxDQUFDO0FBYXBHLFFBQUEseUNBQXlDLEdBQUcsMkNBQW9ELENBQUM7QUFDakcsUUFBQSwyQ0FBMkMsR0FBRyxrQ0FBMkMsQ0FBQztBQUV2RyxTQUFTLHNCQUFzQixDQUFDLEtBQWM7SUFDNUMsSUFBSSxPQUFPLEtBQUssS0FBSyxRQUFRLEVBQUUsQ0FBQztRQUM5QixNQUFNLFNBQVMsR0FBRyxFQUFFLENBQUM7UUFDckIsTUFBTSxPQUFPLEdBQUcsS0FBSyxDQUFDLE1BQU0sR0FBRyxTQUFTLENBQUMsQ0FBQyxDQUFDLEdBQUcsS0FBSyxDQUFDLEtBQUssQ0FBQyxDQUFDLEVBQUUsU0FBUyxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsS0FBSyxDQUFDO1FBQ3JGLE9BQU8sSUFBSSxDQUFDLFNBQVMsQ0FBQyxPQUFPLENBQUMsQ0FBQztJQUNqQyxDQUFDO0lBQ0QsSUFBSSxLQUFLLEtBQUssSUFBSSxJQUFJLE9BQU8sS0FBSyxLQUFLLFFBQVEsSUFBSSxPQUFPLEtBQUssS0FBSyxTQUFTLEVBQUUsQ0FBQztRQUM5RSxPQUFPLE1BQU0sQ0FBQyxLQUFLLENBQUMsQ0FBQztJQUN2QixDQUFDO0lBQ0QsT0FBTyxJQUFJLEtBQUssQ0FBQyxPQUFPLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFDLE9BQU8sQ0FBQyxDQUFDLENBQUMsT0FBTyxLQUFLLEdBQUcsQ0FBQztBQUM5RCxDQUFDO0FBRUQ7Ozs7Ozs7Ozs7OztHQVlHO0FBQ0gsU0FBZ0IseUJBQXlCLENBQ3ZDLHVCQUEwQyxFQUMxQyxnQkFBZ0QsRUFDaEQsVUFBNkMsU0FBUyxFQUN0RCxNQUFpQyxFQUNqQyxnQ0FBb0Q7SUFFcEQsSUFBSSxZQUFZLEdBQUcsQ0FBQyxHQUFHLHVCQUF1QixDQUFDLENBQUM7SUFDaEQsTUFBTSxXQUFXLEdBQWlDLEVBQUUsQ0FBQztJQUVyRCxRQUFRLE9BQU8sRUFBRSxDQUFDO1FBQ2hCLEtBQUssS0FBSztZQUNSLFlBQVksR0FBRyxNQUFNLENBQUMsSUFBSSxDQUFDLGdCQUFnQixDQUFDLENBQUM7WUFDN0MsTUFBTTtRQUNSLEtBQUssTUFBTTtZQUNULFlBQVksR0FBRyxFQUFFLENBQUM7WUFDbEIsTUFBTTtRQUNSLEtBQUssT0FBTztZQUNWLFlBQVksR0FBRyxFQUFFLENBQUM7WUFDbEIsV0FBVyxDQUFDLElBQUksQ0FBQztnQkFDZixJQUFJLEVBQUUsaURBQXlDO2dCQUMvQyxRQUFRLEVBQUUsU0FBUztnQkFDbkIsT0FBTyxFQUFFLG1FQUFtRTthQUM3RSxDQUFDLENBQUM7WUFDSCxNQUFNO1FBQ1IsS0FBSyxTQUFTO1lBQ1osTUFBTTtRQUNSO1lBQ0UsV0FBVyxDQUFDLElBQUksQ0FBQztnQkFDZixJQUFJLEVBQUUsbURBQTJDO2dCQUNqRCxRQUFRLEVBQUUsT0FBTztnQkFDakIsT0FBTyxFQUFFLHNDQUFzQyxzQkFBc0IsQ0FBQyxPQUFPLENBQUMsb0JBQW9CO2FBQ25HLENBQUMsQ0FBQztJQUNQLENBQUM7SUFFRCxLQUFLLE1BQU0sSUFBSSxJQUFJLE1BQU0sRUFBRSxPQUFPLElBQUksRUFBRSxFQUFFLENBQUM7UUFDekMsSUFBSSxDQUFDLFlBQVksQ0FBQyxRQUFRLENBQUMsSUFBSSxDQUFDLEVBQUUsQ0FBQztZQUNqQyxZQUFZLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxDQUFDO1FBQzFCLENBQUM7SUFDSCxDQUFDO0lBRUQsS0FBSyxNQUFNLElBQUksSUFBSSxNQUFNLEVBQUUsT0FBTyxJQUFJLEVBQUUsRUFBRSxDQUFDO1FBQ3pDLE1BQU0sS0FBSyxHQUFHLFlBQVksQ0FBQyxPQUFPLENBQUMsSUFBSSxDQUFDLENBQUM7UUFDekMsSUFBSSxLQUFLLElBQUksQ0FBQyxFQUFFLENBQUM7WUFDZixZQUFZLENBQUMsTUFBTSxDQUFDLEtBQUssRUFBRSxDQUFDLENBQUMsQ0FBQztRQUNoQyxDQUFDO0lBQ0gsQ0FBQztJQUVELElBQUksZ0NBQWdDLEtBQUssU0FBUyxFQUFFLENBQUM7UUFDbkQsWUFBWSxHQUFHLEVBQUUsQ0FBQztRQUNsQixLQUFLLE1BQU0sSUFBSSxJQUFJLGdDQUFnQyxFQUFFLENBQUM7WUFDcEQsSUFBSSxDQUFDLFlBQVksQ0FBQyxRQUFRLENBQUMsSUFBSSxDQUFDLEVBQUUsQ0FBQztnQkFDakMsWUFBWSxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQztZQUMxQixDQUFDO1FBQ0gsQ0FBQztJQUNILENBQUM7SUFFRCxPQUFPLEVBQUUsdUJBQXVCLEVBQUUsWUFBWSxFQUFFLFdBQVcsRUFBRSxDQUFDO0FBQ2hFLENBQUMifQ==

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@researchdatabox/sails-ng-common",
-  "version": "5.0.3",
+  "version": "5.0.4-beta.12498",
   "description": "Common models shared between Sails API endpoints and client-side Angular code",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
@@ -38,19 +38,19 @@
     "node": ">=20.0.0"
   },
   "devDependencies": {
-    "@tsconfig/node24": "24.0.4",
+    "@tsconfig/node24": "24.0.5",
     "@types/chai": "5.2.3",
-    "@types/lodash": "4.17.24",
+    "@types/lodash": "4.17.25",
     "@types/lodash-es": "4.17.12",
-    "@types/luxon": "3.7.1",
+    "@types/luxon": "3.7.5",
     "@types/mocha": "10.0.10",
-    "@types/node": "24.12.4",
+    "@types/node": "26.3.0",
     "chai": "6.2.2",
-    "jsonata": "2.2.1",
-    "mocha": "11.7.6",
+    "jsonata": "2.2.2",
+    "mocha": "11.8.0",
     "mocha-junit-reporter": "2.2.1",
     "nyc": "18.0.0",
-    "serialize-javascript": "7.0.5",
+    "serialize-javascript": "7.1.0",
     "typescript": "5.9.3"
   },
   "nyc": {
@@ -63,7 +63,11 @@
     "include": [
       "**/src/handlebars-helpers.*",
       "**/src/config/names/**/*.*",
-      "**/src/validation/**/*.*"
+      "**/src/validation/**/*.*",
+      "**/src/internal/plain-record.*",
+      "**/src/record-concurrency.model.*",
+      "**/src/record-diff.*",
+      "**/src/record-save.model.*"
     ],
     "reporter": [
       "lcov",
@@ -73,10 +77,11 @@
   },
   "dependencies": {
     "@jsonjoy.com/json-pointer": "18.28.0",
+    "handlebars": "4.7.9",
     "lodash": "4.18.1",
     "lodash-es": "4.18.1",
     "luxon": "3.7.2",
-    "marked": "18.0.5",
+    "marked": "18.0.11",
     "ts-json-schema-generator": "2.9.0"
   },
   "overrides": {
@@ -87,7 +92,7 @@
     }
   },
   "peerDependencies": {
-    "jsonata": "2.2.1"
+    "jsonata": "2.2.2"
   },
   "publishConfig": {
     "access": "public",