@pristine-ts/data-mapping-common 2.0.9 → 2.0.10

package/dist/lib/esm/types/data-mapper-error-reporter.type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data-mapper-error-reporter.type.js.map

package/dist/lib/esm/types/data-mapper-error-reporter.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-mapper-error-reporter.type.js","sourceRoot":"","sources":["../../../../src/types/data-mapper-error-reporter.type.ts"],"names":[],"mappings":""}

package/dist/lib/esm/types/types.js

@@ -1,4 +1,5 @@
 export * from "./array-member-type-factory-callback.type";
+export * from "./data-mapper-error-reporter.type";
 export * from "./data-normalizer-unique-key.type";
 export * from "./data-mapping-interceptor-unique-key.type";
 export * from "./type-factory-callback.type";

package/dist/lib/esm/types/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/types/types.ts"],"names":[],"mappings":"AAAA,cAAc,2CAA2C,CAAC;AAC1D,cAAc,mCAAmC,CAAC;AAClD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,8BAA8B,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/types/types.ts"],"names":[],"mappings":"AAAA,cAAc,2CAA2C,CAAC;AAC1D,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,8BAA8B,CAAC"}

package/dist/types/data-mapping-common.d.ts

@@ -8,4 +8,5 @@ export * from "./nodes/nodes";
 export * from "./normalizer-options/normalizer-options";
 export * from "./normalizers/normalizers";
 export * from "./options/options";
+export * from "./reporters/reporters";
 export * from "./types/types";

package/dist/types/mappers/data.mapper.d.ts

@@ -6,13 +6,27 @@ import { AutoDataMappingBuilder } from "../builders/auto-data-mapping.builder";
 import { AutoDataMappingBuilderOptions } from "../options/auto-data-mapping-builder.options";
 import { DataMapperOptions } from "../options/data-mapper.options";
 import { PrimitiveType } from "../enums/primitive-type.enum";
+import { DataMapperErrorReporter } from "../types/data-mapper-error-reporter.type";
 export declare class DataMapper {
     private readonly autoDataMappingBuilder;
     private readonly dataNormalizers;
     private readonly dataTransformerInterceptors;
     private readonly dataNormalizersMap;
     private readonly dataTransformerInterceptorsMap;
-    constructor(autoDataMappingBuilder: AutoDataMappingBuilder, dataNormalizers: DataNormalizerInterface<any, any>[], dataTransformerInterceptors: DataMappingInterceptorInterface[]);
+    /**
+     * Resolved error reporter — either the one passed to the constructor, or the built-in
+     * `console.error` fallback. Resolved once so the catch path doesn't ?? on every call.
+     */
+    private readonly errorReporter;
+    constructor(autoDataMappingBuilder: AutoDataMappingBuilder, dataNormalizers: DataNormalizerInterface<any, any>[], dataTransformerInterceptors: DataMappingInterceptorInterface[], 
+    /**
+     * Where `autoMap` should send errors when `logErrors: true` is set in the call options.
+     *
+     * Default: writes to `console.error`. Pass a custom function to route into your app's
+     * logger (e.g. the DI-wired DataMapper in `@pristine-ts/data-mapping` adapts this to
+     * `LogHandlerInterface`). Pass `() => {}` to silence reports even when `logErrors` is on.
+     */
+    errorReporter?: DataMapperErrorReporter);
     /**
      * This method takes an array of source and maps each item.
      *

package/dist/types/reporters/console-error.reporter.d.ts

@@ -0,0 +1,16 @@
+import { DataMapperErrorReporter } from "../types/data-mapper-error-reporter.type";
+/**
+ * Built-in default reporter. Writes a header line + the error + a structured context payload
+ * to `console.error`. Used when no custom reporter is supplied to DataMapper — gives the
+ * frontend (and any non-DI caller) useful output out of the box.
+ *
+ * Exposed as a class-with-static-method so callers can compose it from their own reporters,
+ * e.g. `(err, ctx) => { sendToSentry(err); ConsoleErrorReporter.report(err, ctx); }`.
+ */
+export declare class ConsoleErrorReporter {
+    /**
+     * Matches the `DataMapperErrorReporter` shape so a method reference (`ConsoleErrorReporter.report`)
+     * can be passed wherever the callback type is expected.
+     */
+    static readonly report: DataMapperErrorReporter;
+}

package/dist/types/reporters/reporters.d.ts

@@ -0,0 +1 @@
+export * from "./console-error.reporter";

package/dist/types/types/data-mapper-error-reporter.type.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Callback the DataMapper invokes when `autoMap` swallows an error and `logErrors: true`
+ * is set on the options.
+ *
+ * Defined as a plain function type so `data-mapping-common` stays free of a logging-framework
+ * dependency — important because this package is consumed by frontend bundles (Angular, etc.)
+ * where pulling `@pristine-ts/logging` and its transitive deps in would add weight for no
+ * functional benefit.
+ *
+ * Wiring options:
+ *   - Pass nothing to DataMapper → errors print via the built-in `ConsoleErrorReporter`.
+ *   - Pass a custom reporter → errors go where you want them.
+ *   - Pass `() => {}` (no-op) → errors are silently dropped even when `logErrors: true`.
+ *
+ * The DI-wired DataMapper in `@pristine-ts/data-mapping` provides an adapter that routes
+ * into the framework's `LogHandlerInterface`.
+ */
+export type DataMapperErrorReporter = (error: Error, context: {
+    source: unknown;
+    destinationType: unknown;
+}) => void;

package/dist/types/types/types.d.ts

@@ -1,4 +1,5 @@
 export * from "./array-member-type-factory-callback.type";
+export * from "./data-mapper-error-reporter.type";
 export * from "./data-normalizer-unique-key.type";
 export * from "./data-mapping-interceptor-unique-key.type";
 export * from "./type-factory-callback.type";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pristine-ts/data-mapping-common",
-  "version": "2.0.9",
+  "version": "2.0.10",
   "description": "",
   "module": "dist/lib/esm/data-mapping-common.js",
   "main": "dist/lib/cjs/data-mapping-common.js",
@@ -21,7 +21,7 @@
   },
   "dependencies": {
     "@pristine-ts/class-validator": "^2.0.4",
-    "@pristine-ts/common": "^2.0.9",
+    "@pristine-ts/common": "^2.0.10",
     "@pristine-ts/metadata": "^1.0.16",
     "class-transformer": "^0.5.1",
     "date-fns": "^3.3.1"
@@ -63,7 +63,7 @@
       "jest-extended/all"
     ]
   },
-  "gitHead": "760994a87a1207f1670d31c67c6b8cde4c5b09f4",
+  "gitHead": "3d0126d73d7a0dec99fcda3824981d893d1d0662",
   "repository": {
     "type": "git",
     "url": "https://github.com/magieno/pristine-ts.git",