@dcupl/common 2.0.0-beta.15 → 2.0.0-beta.16

package/dist/esm/types/dcupl.types.d.ts

@@ -101,11 +101,13 @@ export type DcuplInitQualityConfig = {
     /**
      * Maximum number of stored error objects per (model, property, errorType)
      * group. Quality errors are still counted exactly beyond this limit and are
-     * reachable via `getErrorCounts()`; only the retained error objects (and the
-     * `$DcuplErrorTrackingErrors` model) are bounded. Default: 1000.
+     * reachable via `dcupl.quality.errors.summary()` or the
+     * `$DcuplErrorTrackingSummary` model; only the retained error objects (and
+     * the `$DcuplErrorTrackingErrors` model) are bounded. Retained records of a
+     * capped group carry `truncated: true` and `groupTotal`. Default: 1000.
      *
      * Note: for error groups whose true count exceeds `maxErrorsPerGroup`,
-     * partial-update cleanup may cause `getErrorCounts()` to slightly
+     * partial-update cleanup may cause the totals to slightly
      * over-report, since over-cap occurrences are counted but never stored as
      * error objects and therefore cannot be decremented on removal.
      */

package/dist/esm/types/quality.types.d.ts

@@ -68,6 +68,34 @@ export declare namespace QualityAnalyzer {
         type: DcuplErrorType;
         description?: string;
         meta?: any;
+        /**
+         * Exact number of occurrences in this error's (model, attribute, errorType)
+         * group, stamped when the error set is published (#204). Can exceed the
+         * number of stored records when the group hit `maxErrorsPerGroup`.
+         */
+        groupTotal?: number;
+        /** True when this error's group holds fewer stored records than `groupTotal`. */
+        truncated?: boolean;
+    };
+    /**
+     * Per-group error totals, independent of the `maxErrorsPerGroup` record cap
+     * (#204). Available via `dcupl.quality.errors.summary()` and as the
+     * `$DcuplErrorTrackingSummary` model.
+     */
+    type ErrorGroupSummary = {
+        /** `model::attribute::errorType` */
+        key: string;
+        model?: string;
+        attribute?: string;
+        errorGroup: string;
+        errorType: string;
+        type: DcuplErrorType;
+        /** Exact occurrence count. */
+        totalCount: number;
+        /** Records retained in `$DcuplErrorTrackingErrors` (≤ maxErrorsPerGroup). */
+        storedCount: number;
+        /** `totalCount > storedCount` */
+        truncated: boolean;
     };
     type InternalModelError = DcuplErrorBase & {
         type: 'model';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dcupl/common",
-  "version": "2.0.0-beta.15",
+  "version": "2.0.0-beta.16",
   "description": "Dcupl Common Code",
   "type": "module",
   "main": "dist/node/index.cjs",